Zimbra: Upgrade ZCS 8.6 a ZCS 8.7 sobre Ubuntu 14.04 LTS

Bien amigos, con Zimbra 8.7 llega la hora de actualizar y hacer upgrade de nuestras Infraestructuras a la última Release, ya que la cantidad de Bugs resueltos, así cómo las nuevas funcionalidades merecen el esfuerzo.

En este post vamos a abordar la actualización de un entorno Single-Server con 8.6 que corre sobre Ubuntu 14.04 LTS 64bit.

[alert style=”green”]Antes de nada, por favor realizar un Backup de todo vuestro entorno, o un Snapshot.[/alert]

Notas Previas

Comprobación de la Integridad de la Base de Datos

Zimbra nos recomienda siempre realizar una Comprobación de la Integridad de la Base de Datos, yo lo recomiendo también, en ocasiones tenemos problemas que no detectamos hasta que no realizamos migraciones de estas características, arrastrando y haciendo más grande el problema. Durante la instalación nos preguntará acerca de esta comprobación.

Sistema Operativo

Zimbra nos recomienda encarecidamente estar en las siguientes versiones de Sistema Operativo antes de hacer el upgrade a 8.7.0:

Ubuntu OS

• BETA Ubuntu 16.04 LTS Server Edition (64-bit)
• Ubuntu 14.04 LTS Server Edition (64-bit)
• Ubuntu 12.04 LTS Server Edition (64-bit), parche 4 o posterior. El kernel saucy o superior es requerido.

[alert style=”red”]Si la instalación original se realizó sobre Ubuntu 12.04.2 o anterior, se requiere una intervención manual para cambiar al kernel saucy o superior.Más información en https://wiki.ubuntu.com/Kernel/LTSEnablementStack.[/alert]

Red Hat Enterprise Linux OS/CentOS Linux

• Red Hat® Enterprise Linux® 7, AS/ES (64-bit).
• CentOS Linux® 7
• Red Hat Enterprise Linux 6, AS/ES (64-bit), parche 4 o posterior.
• CentOS Linux 6, parche 4 o posterior.

Verificación de la Fecha de Expiración del Certificado

Zimbra Collaboration requiere un certificado SSL auto-firmado o un certificado SSL válido comercial para la comunicación entre los diferentes componentes. El certificado auto-firmado se genera automáticamente y se crea durante la instalación.

Si tienes una instalación de Zimbra Collaboration que está cerca al año de antigüedad, seguramente tengas que actualizar los certificados SSL inmediatamente antes de realizar el upgrade.

Con estos comandos tendremos el certificado listo en pocos segundos, re-generando el SSL:

sudo zmcertmgr createca -new
sudo zmcertmgr deployca
sudo zmcertmgr deploycrt self -new

Instrucciones para el Upgrade

Lo primero que tendremos que hacer es descargar la versión correspondiente a nuestro entorno, recordemos que usaremos Ubuntu 14.04 LTS:

• Descarga de la versión Open Source Edition
• Descarga de la versión Network Edition

Entrar como root en una carpeta que queramos, en mi caso /root y realizar la descarga de la versión correspondiente:

wget https://files.zimbra.com/downloads/8.7.0_GA/zcs-NETWORK-8.7.0_GA_1659.UBUNTU14_64.20160628202904.tgz

tar xzvf zcs-NETWORK-8.7.0_GA_1659.UBUNTU14_64.20160628202904.tgz

Proxy y memcached, necesarios antes de actualizar

Desde Zimbra Collaboration 8.7, los servicios de Proxy y memcached son necesarios, no es nada nuevo, ya que añadir el Proxy mejora el rendimiento global de las sesiones web, y gracias a memcached las sesiones tardan menos tiempo en loguearse, etc. Vamos a comprobar de manera muy básica si tenemos proxy y memcached instalado y funcionando o no:

Si ejecutamos el siguiente comando y los servicios no se encuentran allí, proxy y memcache:

zimbra@zimbra86:~$ zmcontrol status
Host zimbra86.zimbra.io
amavis                  Running
antispam                Running
antivirus               Running
ldap                    Running
logger                  Running
mailbox                 Running
mta                     Running
opendkim                Running
service webapp          Running
snmp                    Running
spell                   Running
stats                   Running
zimbra webapp           Running
zimbraAdmin webapp      Running
zimlet webapp           Running
zmconfigd               Running

Y además, para una segunda comprobación, podemos lanzar los siguientes comandos para verificarlo, comprobar que proceso escucha por el puerto 443:

root@zimbra86:~# lsof -i :443
COMMAND   PID   USER   FD   TYPE DEVICE SIZE/OFF NODE NAME
java    12592 zimbra  102u  IPv4 110805      0t0  TCP *:https (LISTEN)

Y cual por el puerto 11211, de memcached

root@zimbra86:~# lsof -i :11211

Si vuestros resultados son como los míos, es que NO tenéis Proxy y memcached instalado.

Para instalar Proxy y memcached, deberemos ejecutar el instalador de Zimbra Collaboration 8.6 y marcar la opción para instalar estos dos componentes:

Do you wish to upgrade? [Y] y
Install zimbra-memcached [N] y
Install zimbra-proxy [N] y

Una vez hemos instalado estos dos servicios, tenemos todavía que realizar unas operaciones para tener los dos servicios funcionando correctamente, se trata de redirigir las peticiones de HTTP, HTTPS, IMAP y POP3 por el Proxy, y además habilitar Zimbra para que use el zimbraMailReferMode em reverse-proxied:

./libexec/zmproxyconfig -e -w -o -a 8080:80:8443:443 -x https -H `zmhostname`
./libexec/zmproxyconfig -e -m -o -i 7143:143:7993:993 -p 7110:110:7995:995 -H `zmhostname`
zmprov ms `zmhostname` zimbraMailReferMode reverse-proxied
zmprov gs `zmhostname` zimbraMailReferMode
# name zimbra86.zimbra.io
zimbraMailReferMode: reverse-proxied
zmcontrol restart

Si volvemos a lanzar las comprobaciones, ya veremos que tenemos Proxy y memcached escuchando por los puertos necesarios

root@zimbra86:/opt/zimbra/libexec# lsof -i :443
COMMAND   PID   USER   FD   TYPE  DEVICE SIZE/OFF NODE NAME
nginx   24824 zimbra   10u  IPv4 4700279      0t0  TCP *:https (LISTEN)
nginx   24826 zimbra   10u  IPv4 4700279      0t0  TCP *:https (LISTEN)
nginx   24827 zimbra   10u  IPv4 4700279      0t0  TCP *:https (LISTEN)
nginx   24828 zimbra   10u  IPv4 4700279      0t0  TCP *:https (LISTEN)
nginx   24829 zimbra   10u  IPv4 4700279      0t0  TCP *:https (LISTEN)

root@zimbra86:/opt/zimbra/libexec# lsof -i :11211
COMMAND     PID   USER   FD   TYPE  DEVICE SIZE/OFF NODE NAME
memcached 24730 zimbra   26u  IPv4 4699181      0t0  TCP *:11211 (LISTEN)
memcached 24730 zimbra   27u  IPv6 4699182      0t0  TCP *:11211 (LISTEN)
memcached 24730 zimbra   28u  IPv4 4699185      0t0  UDP *:11211
memcached 24730 zimbra   29u  IPv6 4699186      0t0  UDP *:11211
memcached 24730 zimbra   30u  IPv4 4699271      0t0  TCP zimbra86.zimbra.io:11211->localhost:38786 (ESTABLISHED)
memcached 24730 zimbra   31u  IPv4 4699272      0t0  TCP zimbra86.zimbra.io:11211->localhost:38788 (ESTABLISHED)
memcached 24730 zimbra   32u  IPv4 4699273      0t0  TCP zimbra86.zimbra.io:11211->localhost:38790 (ESTABLISHED)
memcached 24730 zimbra   33u  IPv4 4699274      0t0  TCP zimbra86.zimbra.io:11211->localhost:38792 (ESTABLISHED)
nginx     24826 zimbra   13u  IPv4 4699270      0t0  TCP localhost:38786->zimbra86.zimbra.io:11211 (ESTABLISHED)
nginx     24827 zimbra   15u  IPv4 4700292      0t0  TCP localhost:38792->zimbra86.zimbra.io:11211 (ESTABLISHED)
nginx     24828 zimbra   17u  IPv4 4700290      0t0  TCP localhost:38788->zimbra86.zimbra.io:11211 (ESTABLISHED)
nginx     24829 zimbra   19u  IPv4 4700291      0t0  TCP localhost:38790->zimbra86.zimbra.io:11211 (ESTABLISHED)

Realizar el Upgrade

Usaremos screen, para que en caso de que haya una desconexión, el proceso continúe

screen ./install.sh

El proceso de instalación hará una comprobación rápida de la licencia

Operations logged to /tmp/install.log.CRTFSla1
Checking for existing installation...
zimbra-ldap...FOUND zimbra-ldap-8.6.0.GA.1153.UBUNTU14.64
zimbra-logger...FOUND zimbra-logger-8.6.0.GA.1153.UBUNTU14.64
zimbra-mta...FOUND zimbra-mta-8.6.0.GA.1153.UBUNTU14.64
zimbra-dnscache...NOT FOUND
zimbra-snmp...FOUND zimbra-snmp-8.6.0.GA.1153.UBUNTU14.64
zimbra-store...FOUND zimbra-store-8.6.0.GA.1153.UBUNTU14.64
zimbra-apache...FOUND zimbra-apache-8.6.0.GA.1153.UBUNTU14.64
zimbra-spell...FOUND zimbra-spell-8.6.0.GA.1153.UBUNTU14.64
zimbra-convertd...NOT FOUND
zimbra-memcached...FOUND zimbra-memcached-8.6.0.GA.1153.UBUNTU14.64
zimbra-proxy...FOUND zimbra-proxy-8.6.0.GA.1153.UBUNTU14.64
zimbra-archiving...NOT FOUND
zimbra-core...FOUND zimbra-core-8.6.0.GA.1153.UBUNTU14.64
ZCS upgrade from 8.6.0 to 8.7.0 will be performed.
Checking for existing proxy service in your environment
Checking for existing memcached service in your environment
Validating existing license is not expired and qualifies for upgrade
License is valid and supports this upgrade.  Continuing.
Validating ldap configuration
LDAP validation succeeded.  Continuing.
Checking for available license file...
Current Users=10000 Licensed Users=10000

Y entonces tendremos que aceptar las dos EULA:

Do you agree with the terms of the software license agreement? [N] Y
Do you agree with the terms of the software license agreement? [N] Y

Pasados unos segundos, el proceso de actualización, nos preguntará acerca de la comprobación de la Base de Datos, recomiendo marcar Y

Checking current number of databases...
Checking for a recent backup

Do you want to verify message store database integrity? [Y]

Y pasados unos minutos, u horas, dependiendo del tamaño de la Base de Datos, nos mostrará este mensaje:

Verifying integrity of message store databases.  This may take a while.
mysqld is alive
No errors found

Llega el momento donde nos pregunta si queremos instalar Zimbra usando el repositorio de Zimbra, por defecto pulsaremos Y

Checking for installable packages

Found zimbra-core
Found zimbra-ldap
Found zimbra-logger
Found zimbra-mta
Found zimbra-dnscache
Found zimbra-snmp
Found zimbra-store
Found zimbra-apache
Found zimbra-spell
Found zimbra-convertd
Found zimbra-memcached
Found zimbra-proxy
Found zimbra-archiving

Use Zimbra's package repository [Y]

Un paso más después de la comprobación, seleccionaremos Y

Importing Zimbra GPG key
Configuring package repository

The Zimbra Collaboration Server appears to already be installed.
It can be upgraded with no effect on existing accounts,
or the current installation can be completely removed prior
to installation for a clean install.

Do you wish to upgrade? [Y]

Scanning for any new or additional packages available for installation
Existing packages will be upgraded
Upgrading zimbra-core
Upgrading zimbra-ldap
Upgrading zimbra-logger
Upgrading zimbra-mta
Upgrading zimbra-snmp
Upgrading zimbra-store
Upgrading zimbra-apache
Upgrading zimbra-spell
Upgrading zimbra-memcached
Upgrading zimbra-proxy

Una vez pasa la comprobación de los paquetes, algunos como dns-cache no tengo instalados por ejemplo, nos preguntará si queremos continuar:

Installing:
zimbra-core
zimbra-ldap
zimbra-logger
zimbra-mta
zimbra-snmp
zimbra-store
zimbra-apache
zimbra-spell
zimbra-memcached
zimbra-proxy

The system will be modified.  Continue? [N] Y

Y el proceso continuará, primero descargará los paquetes desde el repositorio de Zimbra, tarda un poco dependiendo de vuestro ancho de banda:

Removing deployed webapp directories
Installing packages

Local packages  zimbra-core zimbra-ldap zimbra-logger zimbra-mta zimbra-snmp zimbra-store zimbra-apache zimbra-spell zimbra-proxy selected for installation
Monitor /tmp/install.log.CRTFSla1 for package installation progress
Remote package installation started
Installing zimbra-core-components  zimbra-ldap-components zimbra-mta-components zimbra-snmp-components zimbra-store-components zimbra-apache-components zimbra-spell-components zimbra-memcached zimbra-proxy-components....

Pasados unos minutos comenzará la actualización de los paquetes

Local package installation started
Installing  zimbra-core zimbra-ldap zimbra-logger zimbra-mta zimbra-snmp zimbra-store zimbra-apache zimbra-spell zimbra-proxy...done

Setting defaults from saved config in /opt/zimbra/.saveconfig/config.save
HOSTNAME=zimbra86.zimbra.io
LDAPHOST=zimbra86.zimbra.io
LDAPPORT=389
SNMPTRAPHOST=zimbra86.zimbra.io
[email protected]
[email protected]
SNMPNOTIFY=yes
SMTPNOTIFY=yes
LDAPROOTPW=*
LDAPZIMBRAPW=*
LDAPPOSTPW=*
LDAPREPPW=*
LDAPAMAVISPW=*
LDAPNGINXPW=*
Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml...done
Operations logged to /tmp/zmsetup.20160718-075809.log
Adding /opt/zimbra/conf/ca/ca.pem to cacerts
Upgrading from 8.6.0_GA_1153 to 8.7.0_GA_1659
Stopping zimbra services...done.
This appears to be 8.6.0_GA
Starting mysql...done.
Checking ldap status...not running.
Checking ldap status...not running.
Starting ldap...done.
Checking ldap status...already running.
Schema upgrade required from version 103 to 107.
Running /opt/zimbra/libexec/scripts/migrate20150401-ZmgDevices.pl
Mon Jul 18 07:58:55 2016: Verified schema version 103.
Mon Jul 18 07:58:55 2016: Verified schema version 103.
Mon Jul 18 07:58:55 2016: Updating DB schema version from 103 to 104.
Running /opt/zimbra/libexec/scripts/migrate20150515-DataSourcePurgeTables.pl
Mon Jul 18 07:58:58 2016: Verified schema version 104.
Mon Jul 18 07:59:52 2016: Verified schema version 104.
Mon Jul 18 07:59:52 2016: Updating DB schema version from 104 to 105.
Running /opt/zimbra/libexec/scripts/migrate20150623-ZmgDevices.pl
Mon Jul 18 07:59:55 2016: Verified schema version 105.
Mon Jul 18 07:59:56 2016: Verified schema version 105.
Mon Jul 18 07:59:56 2016: Updating DB schema version from 105 to 106.
Running /opt/zimbra/libexec/scripts/migrate20150702-ZmgDevices.pl
Mon Jul 18 07:59:59 2016: Verified schema version 106.
Mon Jul 18 08:00:01 2016: Verified schema version 106.
Mon Jul 18 08:00:01 2016: Updating DB schema version from 106 to 107.
Stopping mysql...done.
Updating from 8.6.1_GA
Updating from 8.7.0_BETA1
Updating mailboxd_java_options to remove deprecated PermSize and MaxPermSize java options.
Updating from 8.7.0_BETA2
Updating from 8.7.0_RC1
Updating from 8.7.0_RC2
Updating from 8.7.0_GA
Updating global config and COS's with attributes introduced after 8.6.0_GA...done.
Stopping ldap...done.
Upgrade complete.

El proceso ahora ejecutará los últimos ajustes a la configuración:

Checking ldap status....not running.
Starting ldap...done.
Setting defaults...done.
Setting defaults from existing config...done.
Checking for port conflicts
Setting defaults from ldap...done.
Saving config in /opt/zimbra/config.22385...done.
Operations logged to /tmp/zmsetup.20160718-075809.log
Setting local config values...done.
Initializing core config...Setting up CA...done.
Deploying CA to /opt/zimbra/conf/ca ...done.
Setting replication password...done.
Setting Postfix password...done.
Setting amavis password...done.
Setting nginx password...done.
Creating server entry for zimbra86.zimbra.io...already exists.
Setting Zimbra IP Mode...done.
Saving CA in ldap...done.
Saving SSL Certificate in ldap...done.
Setting spell check URL...done.
Setting service ports on zimbra86.zimbra.io...done.
Setting Keyboard Shortcut Preferences...done.
Setting zimbraFeatureTasksEnabled=TRUE...done.
Setting zimbraFeatureBriefcasesEnabled=TRUE...done.
Setting TimeZone Preference...done.
Initializing mta config...done.
Setting services on zimbra86.zimbra.io...done.
Adding zimbra86.zimbra.io to zimbraMailHostPool in default COS...done.
Creating user [email protected] exists.
Creating user [email protected] exists.
Creating user [email protected] exists.
Setting spam training and Anti-virus quarantine accounts...done.
Configuring SNMP...done.
Setting up syslog.conf...done.
Looking for valid license to install...license already installed.
Activating license...license activated.
Starting servers...done.

Y por último instalará los nuevos Zimlets, para la versión Open Source, así cómo para la versión Network Edition:

Checking for deprecated zimlets...done.
Installing common zimlets...
com_zimbra_clientuploader...done.
com_zimbra_phone...done.
com_zimbra_srchhighlighter...done.
com_zimbra_attachmail...done.
com_zimbra_viewmail...done.
com_zimbra_bulkprovision...done.
com_zimbra_adminversioncheck...done.
com_zimbra_tooltip...done.
com_zimbra_url...done.
com_zimbra_mailarchive...done.
com_zimbra_email...done.
com_zimbra_date...done.
com_zimbra_webex...done.
com_zimbra_proxy_config...done.
com_zimbra_ymemoticons...done.
com_zimbra_attachcontacts...done.
com_zimbra_cert_manager...done.
Finished installing common zimlets.
Installing network zimlets...
com_zimbra_ucconfig...done.
com_zimbra_convertd...done.
com_zimbra_hsm...done.
com_zimbra_voiceprefs...done.
com_zimbra_delegatedadmin...done.
com_zimbra_click2call_cisco...done.
com_zimbra_backuprestore...done.
com_zimbra_smime_cert_admin...done.
com_zimbra_license...done.
com_zimbra_click2call_mitel...done.
com_zimbra_mobilesync...done.
com_zimbra_two_factor_auth...done.
com_zimbra_smime...done.
Finished installing network zimlets.
Getting list of all zimlets...done.
Updating non-standard zimlets...
Finished updating non-standard zimlets.

El último paso, si todo ha ido bien será el reinicio automático del servicio mailboxd, pulsaremos Enter al finalizar

Restarting mailboxd...

Skipping creation of default domain GAL sync account - existing install detected.
Setting up zimbra crontab...done.

Moving /tmp/zmsetup.20160718-075809.log to /opt/zimbra/log

Configuration complete - press return to exit

Comprobamos que todo esta bien como usuario zimbra:

zimbra@zimbra86:~$ zmcontrol -v
Release 8.7.0.GA.1659.UBUNTU14.64 UBUNTU14_64 NETWORK edition.
zimbra@zimbra86:~$ zmcontrol status
Host zimbra86.zimbra.io
amavis                  Running
antispam                Running
antivirus               Running
ldap                    Running
logger                  Running
mailbox                 Running
memcached               Running
mta                     Running
opendkim                Running
proxy                   Running
service webapp          Running
snmp                    Running
spell                   Running
stats                   Running
zimbra webapp           Running
zimbraAdmin webapp      Running
zimlet webapp           Running
zmconfigd               Running
zimbra@zimbra86:~$

Recomendaciones desde Zimbra

Una vez tenemos ya Zimbra Collaboration 8.7 correctamente funcionando después del upgrade , Zimbra nos recomienda lanzar los siguientes comandos, algunos de ellos por por ejemplo el de sendmail, sin él, tendremos problemas a la hora de recibir mensajes del sistema, etc:

zmprov mcf zimbraMtaCommandDirectory /opt/zimbra/common/sbin
zmprov mcf zimbraMtaDaemonDirectory /opt/zimbra/common/libexec
zmprov mcf zimbraMtaMailqPath /opt/zimbra/common/sbin/mailq
zmprov mcf zimbraMtaManpageDirectory /opt/zimbra/common/share/man
zmprov mcf zimbraMtaNewaliasesPath /opt/zimbra/common/sbin/newaliases
zmprov mcf zimbraMtaSendmailPath /opt/zimbra/common/sbin/sendmail
zmcontrol restart

Recomendaciones adicionales

En Zimbra Collaboration 8.7 DSPAM está deprecado, ya no funciona y podemos tener errores, por lo tanto hay que desactivarlo en caso de lo que estuvierais usando:

zmprov ms `zmhostname`
zimbraAmavisDSPAMEnabled FALSE