Actualización manual del núcleo de Drupal

Antes de comenzar

Si aún no lo ha hecho, se recomienda leer esta introducción, que resume brevemente todas las opciones que puede elegir al actualizar Drupal 8.

¡PD! Este procedimiento de actualización también está descrito en la guía del usuario.

Si ha instalado módulos adicionales con dependencias externas mediante Composer, deberá utilizar diferentes opciones de actualización, ya que estas instrucciones sobrescribirán el directorio vendor/.

Actualización del núcleo de Drupal 8

Pasos para actualizar el núcleo de Drupal 8 mediante instalación manual y línea de comandos (shell):

1. Realice una copia de seguridad de sus archivos y base de datos. Una copia completa facilita regresar a una versión anterior en caso de que la actualización falle.

Opcionalmente, si ha hecho cambios manuales en archivos como .htaccess, composer.json o robots.txt, cópielos a un lugar fácil de encontrar. Porque después de instalar el nuevo núcleo de Drupal, tendrá que reaplicar esos cambios. Por ejemplo, Acquia Dev Desktop coloca el archivo .htaccess en el directorio raíz, y sin él solo funcionará la página principal de su sitio.

Siempre vuelva a la copia de seguridad si recibe un error fatal durante el proceso de actualización.

2. Inicie sesión en Drupal con un usuario que tenga permiso para «Administrar actualizaciones de software».

3. Ponga su sitio en modo de mantenimiento desde Drupal. Para ello:

           - Vaya a través de la interfaz administrativa a Administración > Configuración > Desarrollo > Modo de mantenimiento.

           - Marque la casilla «Poner sitio en modo de mantenimiento».

           - Haga clic en «Guardar configuración (Save configuration)».

4. Elija una de las dos opciones siguientes para eliminar los archivos en el directorio raíz, así como en los directorios «core» y «vendor», dejando intactos los directorios «modules», «profile», «sites» y «themes»:

      Uso de la consola

         1. Vaya a su instalación de Drupal.

cd /ruta/a/su/directorio/drupal

         2. Elimine los directorios 'core' y 'vendor'

rm -rf core vendor

         3. Elimine todos los archivos en el directorio raíz.

rm -f *.* .[a-z]*

      Uso de un cliente FTP

         1. Vaya al directorio de Drupal.
         2. Seleccione todos los archivos en el directorio raíz (incluidos los archivos ocultos que comienzan con punto), así como los directorios «core» y «vendor» y elimínelos. No elimine los directorios 'modules', 'profiles', 'sites' y 'themes'.

5. Opcionalmente, algunas actualizaciones incluyen cambios en el archivo default.settings.php. Esto se indicará en las notas de la versión. Puede encontrar las notas de la versión para su versión en https://www.drupal.org/project/drupal. Al final de la página del proyecto, en la sección «Descargas» use el enlace de su versión de Drupal para ver las notas de la versión. Si su versión no aparece, use el enlace «Ver todas las versiones». En esa página puede desplazarse o filtrar para encontrar su versión y las notas correspondientes. Si la actualización incluye cambios en el archivo default.settings.php, siga estos pasos.

• Copie las líneas personalizadas y específicas de su sitio desde la copia de seguridad que hizo al nuevo archivo settings.php. Definitivamente necesitará las líneas que contienen la información de la base de datos, y también querrá copiar cualquier otra configuración que haya añadido.
• Haga una copia del nuevo archivo default.settings.php y renómbrelo a settings.php (sobrescribiendo su archivo settings.php anterior).
• Haga una copia de seguridad de su archivo settings.php con otro nombre.
• Localice el archivo settings.php en el directorio /sites/*. (Normalmente en sites/default.)

6. Elija una de las siguientes dos opciones para obtener los nuevos archivos en el directorio raíz y los directorios «core» y «vendor»:

      Uso de la consola

         1. En una típica línea de comandos Unix/Linux, use los siguientes comandos para descargar y extraer:

wget https://ftp.drupal.org/files/projects/drupal-x.y.z.tar.gz
tar zxf drupal-x.y.z.tar.gz

         2. Este comando creará un nuevo directorio drupal-x.y.z/, que contiene todos los archivos y directorios de Drupal. Ingrese a ese nuevo directorio y copie los directorios «core» y «vendor», así como los archivos del directorio raíz, al directorio de instalación de Drupal:

cd drupal-x.y.z
cp -R core vendor /ruta/a/su/directorio/drupal
cp *.* .[a-z]* /ruta/a/su/directorio/drupal

      Uso del navegador y cliente FTP

• Descargue la última versión de Drupal 8.x.x desde el sitio web https://www.drupal.org/download a un directorio fuera de su webroot.
• Extraiga el archivo.
• Use un cliente FTP para cargar los directorios «core» y «vendor», así como los archivos del directorio raíz al directorio de Drupal.

7. Si es necesario, reaplique manualmente cualquier cambio en archivos como .htaccess, composer.json o robots.txt.

8. En su navegador, ejecute update.php visitando http://www.example.com/update.php (reemplace www.example.com por su nombre de dominio). Esto actualizará las tablas principales de la base de datos.

        Opcionalmente, si no ha iniciado sesión como un usuario con permiso de «Administrar actualizaciones de software» o con la cuenta de mantenimiento del sitio (creada durante la instalación), no podrá acceder a update.php. Estos son los pasos para evitar esa limitación:

              - Abra el archivo settings.php con un editor de texto.
              - Busque esta línea

$settings['update_free_access'] = FALSE;

              - Cambie el valor FALSE a TRUE:

$settings['update_free_access'] = TRUE;

              - Visite la página /update.php nuevamente.
              - Después de completar todos los pasos anteriores, es importante por seguridad cambiar la configuración de nuevo a FALSE.

9. En su navegador, inicie sesión como administrador de Drupal y vaya a «Administración»> «Informes»> «Informe de estado» (Administration > Reports > Status report). Asegúrese de que todo funcione correctamente.

10. Todavía en el navegador, inicie sesión como administrador de Drupal y vaya a Administration > Configuration > Development > Maintenance mode. Desmarque la casilla «Poner sitio en modo de mantenimiento» y haga clic en el botón «Guardar».

11. Después de la actualización, elimine la versión de Drupal que descargó y extrajo anteriormente:

rm drupal-x.y.z.tar.gz
rm -rf drupal-x.y.z/

12. Listo. Ha actualizado con éxito el núcleo de Drupal 8 usando instalación manual y shell/navegador. :)