Actualización de versión¶

Versión del paquete zentyal-core¶

Para poder actualizar el servidor Zentyal a la versión 8.0 necesitaremos tener instalada la versión 7.1.1 o superior del paquete zentyal-core:

dpkg -l zentyal-core

Errores en los logs¶

Una de las tareas más importantes es confirmar que en los archivos de log más críticos del sistema no haya errores. Los archivos que deberemos revisar como mínimo serán:

• /var/log/zentyal/zentyal.log
• /var/log/syslog

Espacio en disco¶

Al ser una actualizar major, el tamaño en disco necesario mínimo es de 3 GB para la partición / y 250 MB para la partición /boot

df -h

Acceso a Internet¶

Para poder descargar los paquetes necesarios para realizar la actualización es necesario que el servidor tenga acceso a Internet:

ping -c5 google.com

Acceso a los repositorios¶

Otra de las tareas críticas a revisar es el acceso a los repositorios de Ubuntu y Zentyal. Para ello, bastará con ejecutar el siguiente comando para confirmar que no hay errores:

sudo apt update

Paquetes disponibles¶

Para revisar si el sistema operativo está actualizado, tendremos que ejecutar los siguientes comandos:

sudo apt update
sudo apt list --upgradable

Paquetes rotos¶

Es imperativo que revisemos que no haya ningún paquete roto, de lo contrario, la actualización nos fallará.

dpkg -l | egrep -v '^(ii|rc)'

En caso de haber paquetes en mal estado, en la sección de Troubleshooting [4] se explica como tratar de repararlos.

Errores en las bases de datos¶

Otra tarea importante a revisar si hay algún error en las bases de datos alojadas en MySQL que usa Zentyal para sus módulos:

mysqlcheck -u root -p$(sudo cat /var/lib/zentyal/conf/zentyal-mysql.passwd) --all-databases 2> /dev/null

En caso de usar el módulo controlador de dominio [5], también es altamente recomendable confirmar su estado:

sudo samba-tool dbcheck --cross-ncs

En caso de detectar un error en esta última base de datos, tendremos que seguir [6] este enlace.

Intefaces virtuales¶

La funcionalidad de interfaces virtuales está deprecated en Zentyal 8.0, por lo que antes de proceder con la actualización es importante revisar que no haya ninguna interfaz de red configurada con dicha funcionalidad.

Reporte del sistema¶

Podemos obtener los resultados de las comprobaciones mencionadas en este apartado y muchas más información generando un reporte del sistema [7] y analizándolo antes de programar la actualización del servidor.

Estado actual del servidor¶

Para confirmar el estado del servidor tras el fallo durante la actualización, primero deberemos revisar el archivo de log /var/log/zentyal/upgrade.log. Después, podremos hacernos las siguientes preguntas para determinar si tenemos que restaurar una copia de seguridad.

1. ¿La versión de Ubuntu sigue siendo 20.04 y los paquetes de Zentyal son 7.1?

Si la respuesta es afirmativa y no hay paquetes rotos, no será necesario restaurar la copia de seguridad.

2. ¿Se actualizó la versión de Ubuntu a una diferente de 22.04?

Si la respuesta es afirmativa, habrá que restaurar una copia de seguridad, ya que Zentyal 8.0 se basa en Ubuntu 22.04.

3. ¿Se llegó a actualizar algún paquete de Zentyal?

Si ningún paquete llegó a actualizarse pero Ubuntu se se actualizó a 22.04, podremos analizar el archivo de log /var/log/zentyal/upgrade.log y ejecutar el script de actualización de nuevo para tratar de actualizar Zentyal.

4. ¿Se actualizaron los paquetes de Zentyal a una versión distinta de 8.0?

En caso afirmativo, habrá que restaurar la copia de seguridad.

5. ¿Hay paquetes rotos?

Si Ubuntu y Zentyal se actualizaron pero hay paquetes rotos, podremos tratar de solucionarlos sin necesidad de restaurar una copia de seguridad.

Paquetes rotos¶

Si tenemos paquetes rotos, podremos tratar de solucionarlos con los siguientes comandos.

Para solucionar todos los paquetes a la vez:

sudo dpkg --configure --force-confdef -a

En caso de que no haya funcionado, habrá que hacerlo de paquete en paquete:

sudo dpkg --configure --force-confdef nombre_del_paquete

Base de datos MySQL¶

Si tenemos errores en el archivo de log /var/log/zentyal/zentyal.log con el servicio mysql como el siguiente:

2024/04/26 11:04:02 ERROR> MyDBEngine.pm:200 EBox::MyDBEngine::_connect - Connection DB Error: Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)
at Connection DB Error: Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)
at /usr/share/perl5/EBox/MyDBEngine.pm line 200

Y el servicio está parado:

sudo systemctl status mysql

Tendremos que comprobar si el directorio /var/log/mysql/ existe, en caso de que no exista:

sudo mkdir -v -m 0750 /var/log/mysql
sudo chown -R mysql:adm /var/log/mysqll

En caso de que exista, tendremos que ejecutar los siguientes comandos:

sudo chown -R mysql:adm /var/log/mysql
sudo chmod -R 0750 /var/log/mysql

Finalmente, reiniciamos el servicio. En caso de que el error persista, habrá que analizar los archivos de log /var/log/syslog y /var/log/mysql/error.log:

sudo systemctl restart mysql
sudo systemctl status mysql

Módulo de antivirus¶

Tras actualizar a Zentyal 8.0, si el módulo de Antivirus nos sale como STOPPED y en el log /var/log/clamav/clamav.log vemos el siguiente mensaje:

ERROR: LOCAL: Socket file /var/run/clamav/clamd.ctl could not be bound: Permission denied

Lo que tenemos que hacer es modificar el propietario del directorio /var/run/clamav/ y posteriormente, reconfigurar el paquete, para ello, ejecutaremos los siguientes comandos:

sudo -i
chown clamav:clamav /var/run/clamav/
echo "clamav-daemon     clamav-daemon/debconf boolean false" | debconf-set-selections
DEBIAN_FRONTEND=noninteractive dpkg-reconfigure clamav-daemon

Una vez que tenemos el paquete reconfigurado, ya sólo nos quedará reiniciar el módulo:

sudo zs antivirus restart