Ejecutar la Migración

Esta guía se aplica a migraciones a SuiteCRM 8.7.0 y versiones posteriores. Si está migrando a una versión entre 8.2.0 y 8.6.x, consulte la Guía de migración para 8.2.0–8.6.x.

Ejecute la migración únicamente si su instancia de SuiteCRM 7.x ya está en la última versión 7.14.x.

1. Descargue el paquete de migración

  1. Descargue el paquete de migración de SuiteCRM 8 para la versión de destino (por ejemplo, 8.7.0 Upgrade from 7.14.x) desde la página de descargas de SuiteCRM.

  2. Descomprima el contenido del paquete en la carpeta de destino de SuiteCRM 8, por ejemplo, /var/www/<SuiteCRM8-folder>.

  3. Vuelva a establecer los permisos si es necesario.

2. Copie su instancia de SuiteCRM 7.14.x

  1. Copie la carpeta de su instancia de SuiteCRM 7.14.x en la carpeta public del destino de SuiteCRM 8, por ejemplo, /var/www/<SuiteCRM8-folder>/public/<SuiteCRM7-folder>.

  2. Cambie el nombre de la carpeta copiada a legacy, obteniendo /var/www/<SuiteCRM8-folder>/public/legacy.

  3. Vuelva a establecer los permisos si es necesario.

3. Aplique los archivos necesarios del paquete de migración

A partir de SuiteCRM 8.7.x, algunas carpetas y archivos deben actualizarse manualmente antes de ejecutar los scripts de migración.

  1. Reemplace /var/www/<SuiteCRM8-folder>/public/legacy/vendor por la carpeta vendor de tmp/package/upgrade/legacy-migration/vendor.

  2. Reemplace /var/www/<SuiteCRM8-folder>/public/legacy/include por la carpeta include de tmp/package/upgrade/legacy-migration/include.

  3. Reemplace /var/www/<SuiteCRM8-folder>/public/legacy/deprecated.php por el archivo deprecated.php de tmp/package/upgrade/deprecated.php.

4. Establezca los permisos

Establezca los permisos de forma que el usuario de línea de comandos tenga acceso de lectura y escritura a los archivos de la instancia.

5. Ejecute el comando de preparación de la migración

  1. Desde la raíz de su instancia de SuiteCRM 8, ejecute:

    ./bin/console suitecrm:app:setup-legacy-migration

  2. Cuando se le solicite, actualice los siguientes valores en la configuración legacy:

    • session_dir — configúrelo como ''. Puede volver a configurar esto después de la migración. Consulte Configuración de Sesiones.

    • site_url — configúrelo con la dirección que está utilizando para acceder a esta instancia de SuiteCRM 8. Si su vhost no apunta directamente a la carpeta public, añada /public (por ejemplo, https://your-host/crm/public).

  3. Cuando se le solicite, actualice el RewriteBase en el .htaccess legacy:

    • Si su vhost apunta directamente a la carpeta public: configure RewriteBase /legacy

    • En caso contrario, anteponga la ruta hasta la carpeta public (por ejemplo, RewriteBase /crm/public/legacy)

6. Ejecute el comando de actualización

Desde la raíz de su instancia de SuiteCRM 8:

./bin/console suitecrm:app:upgrade -t SuiteCRM-8.7.0

Reemplace SuiteCRM-8.7.0 con el nombre del paquete que ha descargado.

7. Ejecute el comando posterior a la actualización

Si su instancia tiene personalizaciones, asegúrese de que su código personalizado cumple con la versión mínima de PHP indicada en la Matriz de Compatibilidad.

./bin/console suitecrm:app:upgrade-finalize

Consulte Modos de Fusión de Metadatos para conocer las opciones que controlan cómo se gestionan las personalizaciones de metadatos de vistas durante este paso.

8. Vuelva a establecer los permisos

Si ejecutó los comandos de migración con un usuario diferente al usuario del servidor web (por ejemplo, como root), vuelva a establecer los permisos para que el servidor web pueda leer y escribir los archivos.

9. Reinicie el servidor (opcional)

Si utiliza opcache, apcu u otras cachés de PHP, reinicie su servidor web para limpiar la caché.

10. Abra su instancia

Una vez completados todos los pasos, debería poder iniciar sesión en su instancia de SuiteCRM 8.

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.