Actualizar el Servidor Perfecto ISPConfig de Debian 11 a Debian 12

Este tutorial te llevará a través de la actualización de un servidor gestionado por ISPConfig de Debian 11 (bullseye) a Debian 12 (bookworm). Esta guía sirve tanto para configuraciones monoservidor como multiservidor. Sólo tienes que repetir los mismos pasos en cada servidor.

Ten en cuenta que el proceso de actualización puede causar algún tiempo de inactividad.

Requisitos previos

  • Asegúrate de que has iniciado sesión como usuario root

1. Actualizar el sistema de Debian 11 a Debian 12

Consulta primero la guía sobre la actualización de la propia Debian: https://www.howtoforge.com/how-to-upgrade-from-debian-11-to-debian-12/

2. Instalar los paquetes PHP que faltan

Debian 12 viene con PHP 8.2 como versión de PHP por defecto, así que tenemos que instalarlo:

apt-get install php8.2 php8.2-cli php8.2-cgi php8.2-fpm php8.2-gd php8.2-mysql php8.2-imap php8.2-curl php8.2-intl php8.2-pspell php8.2-sqlite3 php8.2-tidy php8.2-xsl php8.2-zip php8.2-mbstring php8.2-soap php8.2-opcache libonig5 php8.2-common php8.2-readline php8.2-xml curl

No olvides ajustar los archivos de configuración de PHP si es necesario.

Si aún quieres utilizar PHP 7.4 para algunos sitios web, instálalo como versión adicional siguiendo https://www.howtoforge.com/ispconfig-php-debian/

4. Ejecuta una actualización forzada de ISPConfig

Para reconfigurar los servicios de forma que estén correctamente configurados para Debian 12, necesitamos ejecutar el script de actualización de ISPConfig y dejar que reconfigure los servicios. Ejecuta el script desde la línea de comandos con

ispconfig_update.sh --force

Sigue los pasos de actualización. Cuando te pregunte si quieres reconfigurar los servicios o no, pulsa intro. Si te saltas este paso respondiendo «no», ISPConfig no configurará tus servicios para Debian 12 y algunos servicios podrían estar rotos.

5. Actualiza las rutas para usar PHP 8.2 como versión de PHP por defecto

Como PHP 8.2 es la versión PHP por defecto que viene con Debian 12, necesitamos actualizar las rutas PHP en ISPConfig.

Entra en el panel como usuario administrador y ve a Sistema -> Configuración del Servidor -> servidor1.ejemplo.com (el nombre de host de tu servidor) -> Web -> Configuración PHP

Sustituye las referencias a 7.4 por 8.2, para que quede así:

Apache php.ini path: /etc/php/8.2/apache2/php.ini
CGI php.ini path: /etc/php/8.2/cgi/php.ini
PHP-FPM init script: php8.2-fpm
PHP-FPM php.ini path: /etc/php/8.2/fpm/php.ini
PHP-FPM pool directory: /etc/php/8.2/fpm/pool.d
PHP-FPM socket directory: /var/lib/php8.2-fpm

Ten en cuenta que todos los sitios web de este servidor que utilicen la versión de PHP «Predeterminada» utilizarán ahora PHP 8.2 en lugar de la versión antigua.

También tenemos que dejar que el sistema utilice PHP 8.2 como gestor PHP por defecto para las acciones que no sean de ISPConfig. Para ello, ejecuta:

update-alternatives --config php

Si necesitas seleccionar una versión de PHP, selecciona PHP 8.2. A continuación, ejecuta

update-alternatives --config php-cgi

Si necesitas seleccionar una versión de PHP, selecciona también PHP 8.2. Por último, ejecuta

update-alternatives --config php-fpm.sock

Si necesitas seleccionar una versión de PHP, vuelve a seleccionar PHP 8.2.

Para servidores con Apache2 instalado, tenemos que desactivar PHP-FPM 7.4 como gestor de PHP por defecto y activar PHP-FPM 8.2 ejecutando estos comandos:

a2disconf php7.4-fpm
a2enconf php8.2-fpm
systemctl restart apache2

6. Actualizar phpMyAdmin (opcional)

Si tienes phpMyAdmin instalado, te recomendamos que actualices tu instalación, ya que muchos usuarios tienen instalada una versión obsoleta.

Ejecuta este comando para ejecutar nuestro script de actualización de phpMyAdmin:

curl https://git.ispconfig.org/ispconfig/tools/-/raw/master/auto_update_phpmyadmin.sh -sL | sh

Puedes mantener phpMyAdmin actualizado automáticamente a partir de ahora utilizando este mismo script. Consulta este mensaje del foro para obtener más información: https://www.howtoforge.com/community/threads/keep-your-phpmyadmin-installation-up-to-date-automatically.88495/

¡Ya está! Si tienes algún problema, abre un hilo de conversación en el foro.

También te podría gustar...