Guía de Actualización de Vinyl¶

Introducción¶

Esta es la guía de instrucciones para actualizar una instalación existente de Vinyl a la versión 3.1+. Si está instalando por primera vez, consulte las instrucciones de instalación de su versión Vinyl y sistema de servidor.

Esta guía asume que el directorio raíz de la versión actualmente instalada de Vinyl es C:\inetpub\wwwroot\Vinyl y que el sistema ya tenga instalado y configurado el software y el marco prerrequisito.

Requisitos Previos¶

Se requiere Microsoft .NET Framework 4.8 o superior para Vinyl 3.1 o superior. Las versiones anteriores de .NET Framework no son compatibles con Vinyl 3.1 o superior. Este prerrequisito debe verificarse si está actualizando desde Vinyl 3.0 o una versión anterior y confirmarse antes de actualizar a la versión actual de Vinyl.

Para comprobar la versión de .NET instalada actualmente:

• Comando Powershell para verificar la versión .NET:

  Get-ChildItem "HKLM:SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\" | GetItemPropertyValue -Name Release | ForEach-Object
  

• Si el comando Powershell no funciona, siga el artículo de Microsoft para comprobar y determinar la versión:

  https://docs.microsoft.com/en-us/dotnet/framework/migration-guide/how-to-determine-what-versions-are-installed

También debe asegurarse de que esté instalado ASP.NET Core Runtime Hosting Bundle para 2.1. Descargue el paquete de alojamiento.

Cambios con Respecto a la Versión Anterior¶

• Se requiere .NET Framework 4.8 (ver arriba)

• Se requiere el paquete de alojamiento ASP.NET Core Runtime (ver arriba)

Cambios en la Estructura del Directorio¶

Hay cambios en la estructura de la ruta del directorio en Vinyl 3.1 con respecto a versiones anteriores de Vinyl. Es importante tener esto en cuenta al actualizar y puede afectar las rutas de origen de datos existentes configuradas previamente. La ruta exacta del directorio utilizada dependerá de dónde se haya instalado Vinyl en su ambiente y puede diferir de esta documentación.

Después de la actualización, revise las rutas de origen de datos configuradas que dependan de una directiva de ruta de directorio y realice las actualizaciones necesarias para reflejar los cambios 3.1. Por ejemplo: sistema de archivos local

• Los registros ahora están en {Vinyl Install Path}\Vinyl\logs vs. {Vinyl Install Path}\Vinyl\App_Data

  • Para Elastic Beanstalk la ruta recomendada es: C:\inetpub\AspNetCoreWebApps\Vinyl\logs

• Para todos los demás ambientes, la ruta recomendada es: C:\inetpub\wwwroot\Vinyl\logs

• El directorio de datos ahora está en {Vinyl Install Path}\Vinyl\data vs. {Vinyl Install Path}\Vinyl\App_Data

  • Para Elastic Beanstalk la ruta recomendada es: C:\inetpub\AspNetCoreWebApps\Vinyl\data

• Para todos los demás ambientes, la ruta recomendada es: C:\inetpub\wwwroot\Vinyl\data

• Las claves de cifrado en el disco ahora están disponibles {Vinyl Install Path}\Vinyl\keys vs. {Vinyl Install Path}\Vinyl\App_Data\keys

  • Para Elastic Beanstalk la ruta recomendada es: C:\inetpub\AspNetCoreWebApps\Vinyl\keys

• Para todos los demás ambientes, la ruta recomendada es: C:\inetpub\wwwroot\Vinyl\keys

• La configuración ahora está en appsettings.json frente a la configuración en web.config, así como en el directorio de configuración. Vinyl se envía con appsettings.default.json; cambie el nombre a appsettings.json si aún no tiene un archivo llamado appsettings.json.

• Copiará el contenido del directorio temporal directamente al C:\inetpub\wwwroot\Vinyl carpeta, o a C:\inetpub\AspNetCoreWebApps\Vinyl si estás en Elastic Beanstalk

Cambios en AWS Elastic Beanstalk¶

Algunas de las propiedades del ambiente en Elastic Beanstalk han cambiado. Aquí hay capturas de pantalla que muestran la versión anterior y la nueva:

Sin Alterar¶

• Información de conexión

Renombrado¶

(Valor anterior → Nuevo para 3.1 y valor recomendado)

• Cifrado de datos: Almacenamiento de claves → Cifrado de datos: Almacenamiento de claves
• DataEncryptionKeyS3BucketEndpoint → DataEncryption:S3BucketEndpoint
• Cifrado de datosKeyS3KeyPrefix → Cifrado de datos:S3KeyPrefix
• ForwardedClientIpHeader → ReverseProxy: ForwardedClientIpHeader
• ForwardedPortHeader → ReverseProxy: ForwardedPortHeader
• Encabezado de esquema reenviado → Proxy inverso: Encabezado de esquema reenviado
• SharedStateProvider → SharedState:Proveedor
• RedisConnectionString → EstadoCompartido: RedisConnectionString
• RedisPrefix → EstadoCompartido:RedisPrefix

Se recomienda la última plataforma (Windows Server 2019/2.6.2):

Si usa Elastic Beanstalk y aún no está ejecutando Windows Server 2019/2.6.2, deberá reconstruir su imagen AMI y/o usar la imagen base de Jitterbit más reciente.

Cambios de Configuración Locales¶

Todos los ajustes de configuración ahora se pueden establecer dentro C:\inetpub\wwwroot\Vinyl\appsettings.json

Vinyl 3.1 seguirá leyendo el archivo Connection.xml para conocer las propiedades de conexión si se encuentra aquí: C:\inetpub\wwwroot\Vinyl\connection.xml

Instrucciones de Actualización¶

Preparándose para la Actualización¶

1. Tome nota de la versión actual de Vinyl que está ejecutando, en caso de que necesite restaurarla a esta versión.

2. Detenga IIS. Puede hacerlo ingresando al Administrador de IIS, seleccionando el servidor web apropiado y haciendo clic en el botón Detener en la parte superior derecha del panel Acciones.

3. Haga una copia de seguridad de su(s) base(s) de datos en caso de que necesite recuperarlas más adelante.

Despliegue de Nuevo Software¶

1. Descargue el archivo (vinyl-3.1.xxxxx.zip).

   • Para obtener el archivo .ZIP correcto, si su ambiente es Elastic Beanstalk, Linux o si ha incluido complementos adicionales de terceros, correo a vinylinfo@jitterbit.com. De lo contrario, el archivo .ZIP está disponible en el Foro de la comunidad de Vinyl en Lanzamientos de Vinyl.

2. Después de mover el archivo al servidor web, asegúrese de que la "marca de la web" (MOTW) se elimine del archivo zip, haciendo clic derecho en el archivo y verificando las propiedades y seleccionando "Desbloquear" si es necesario.

   

3. Mueva el contenido de su directorio raíz de Vinyl anterior a una carpeta de respaldo.

4. Extraiga el nuevo archivo a un directorio temporal (p. ej. C:\vinyl-3.1.xxxxx)

5. Copie el contenido del directorio del sitio web al directorio raíz de la aplicación Vinyl (p. ej. C:\inetpub\wwwroot\Vinyl).

   Nota

   Copiará el contenido del directorio temporal directamente al C:\inetpub\wwwroot\Vinyl carpeta. Esto es diferente de los lanzamientos anteriores de Vinyl.

6. Actualización C:\inetpub\wwwroot\appsettings.json archivo con información de conexión O copie el archivo Connection.xml de su directorio de respaldo al directorio raíz de Vinyl. (C:\inetpub\wwrwroot\Vinyl – esto es diferente de lanzamientos anteriores de Vinyl).

7. Si tiene alguna personalización en el directorio Config, realizará estos cambios en appsettings.json. Póngase en contacto con el soporte si tiene alguna pregunta.

8. Elimine el directorio temporal que creó.

Configuración¶

1. Abra el Administrador de IIS

2. Expanda la carpeta Vinyl.

3. Haga clic derecho en la carpeta datos y elija la opción Editar permisos....

4. Seleccione la pestaña Seguridad.

5. Haga clic en el botón Editar para iniciar el cuadro de diálogo Permisos para datos.

6. Haga clic en el botón Agregar... para iniciar el cuadro de diálogo Seleccionar usuarios o grupos.

7. Proporcione el nombre IIS AppPool\Vinyl en el campo inferior.

8. Marque Permitir control total en el campo Permisos, luego haga clic en el botón Aceptar para cerrar el cuadro de diálogo Permisos para datos.

9. Haga clic en el botón Aceptar para cerrar el cuadro de diálogo Propiedades de datos.

10. Repita los pasos 3 a 9 para los directorios keys y logs también.

    Nota

    Este paso es fundamental para completar una actualización exitosa.

11. Reinicie IIS seleccionando el servidor y haciendo clic en el botón Iniciar en el panel Acciones.

Secuencia de Prueba Sugerida¶

1. Inicie su navegador web.

2. Navega a http://localhost/Vinyl/.

3. Vinyl actualizará automáticamente la(s) base(s) de datos. El sistema comenzará a responder normalmente una vez que se complete la actualización.