Ubuntu Upgrades

Ubuntu Upgrades

   KB 21374        Last updated on 2023-03-24  




0.00
(0 votes)

Upgrade Ubuntu 10.04 64bit to Ubuntu 12.04 64bit and update ZCS 8.0.8

Stopping the Zimbra Collaboration Services

The first step in this Upgrade guide is stop our Zimbra Collaboration Services:

    zimbra@help:/home/# su - zimbra -c 'zmcontrol stop'

Once we have stopped the Zimbra Collaboration services and we have a full Backup or Snapshot, we can continue.

Upgrading the Ubuntu Version

In Ubuntu 10, we need to install the update-manager-core if isn´t installed.

   root@zimbralab03:/# sudo apt-get install update-manager-core

Next we need to be sure that in the update manager are only selected LTS versions, check the next file, and the prompt line must be prompt=lts

   root@zimbralab03:/# sudo vi /etc/update-manager/release-upgrades

Update all the packages and dependencies before do a upgrade with the next command

   root@zimbralab03:/# sudo apt-get update && sudo apt-get upgrade && sudo apt-get autoremove

Now is time for start the Upgrade proces with the next command

   root@zimbralab03:/# sudo do-release-upgrade

In case of this command fails somehow, please use the next command to start the upgrade

   sudo apt-get update && sudo apt-get upgrade

The process will start and do some previous questions, for example about create an alternate SSH daemon, just in case if we lose the actual SSH connection:

   Continue running under SSH? 
   This session appears to be running under ssh. It is not recommended 
   to perform a upgrade over ssh currently because in case of failure it 
   is harder to recover. 
   If you continue, an additional ssh daemon will be started at port 
   '1022'. 
   Do you want to continue? 
   Continue [yN] y
   Starting additional sshd 
   To make recovery in case of failure easier, an additional sshd will 
   be started on port '1022'. If anything goes wrong with the running 
   ssh you can still connect to the additional one. 
   To continue please press [ENTER]

After a while checking packages, the wizard will ask about the total MB to download and will require our answer, in this case we will write Y and press ENTER:

   Do you want to start the upgrade? 
   5 packages are going to be removed. 69 new packages are going to be 
   installed. 234 packages are going to be upgraded. 
   You have to download a total of 158 M. This download will take about 
   1 minute with your connection. 
   Installing the upgrade can take several hours. Once the download has 
   finished, the process cannot be canceled. 
   Continue [yN]  Details [d]y

During the proccess, have questions like this or others, we need to take careful and select the default answer, so only need to press ENTER all time:

   Configuration file `/etc/sysctl.conf'
   ==> Modified (by you or by a script) since installation.
   ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
   Y or I  : install the package maintainer's version
   N or O  : keep your currently-installed version
     D     : show the differences between the versions
     Z     : start a shell to examine the situation
   The default action is to keep your current version.
   *** sysctl.conf (Y/I/N/O/D/Z) [default=N] ? 

During the proccess will have questions prompt about delete packages, again select the default option:

   Remove obsolete packages? 
   18 packages are going to be removed. 
   Continue [yN]  Details [d]y

And after a while, the final and good message, reboot time: System upgrade is complete.

   Restart required 
   To finish the upgrade, a restart is required. 
   If you select 'y' the system will be restarted. 
   Continue [yN] y

Update Zimbra 8.0.8 with Ubuntu 12.04 package

The first step is download now the correct version for our new OS, Ubuntu 14.04 LTS:

   [1]Open Source Edition Download 
   [2]Network Edition Download

Go into a root session and download the new version package:

   root@zimbralab03:~# wget http://files2.zimbra.com/downloads/8.0.8_GA/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850.tgz
   --2014-10-25 01:40:19--  http://files2.zimbra.com/downloads/8.0.8_GA/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850.tgz
   Resolving files2.zimbra.com (files2.zimbra.com)... 54.230.10.252, 54.230.10.250, 54.230.9.119, ...
   Connecting to files2.zimbra.com (files2.zimbra.com)|54.230.10.252|:80... connected.
   HTTP request sent, awaiting response... 200 OK
   Length: 887979105 (847M) [binary/octet-stream]
   Saving to: `zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850.tgz'
   100%[=============================================================================================================================>] 887,979,105 12.1M/s   in 44s

Once downloaded the package, extract it:

   root@zimbralab03:~# tar xzvf zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850.tgz

Before launch the Zimbra installation, need to install some new depencies for Ubuntu 12.04

   root@zimbralab03:~/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850# apt-get install libgmp3c2 libperl5.14

Now launch the installation process with the -s flag option (Software only installation)

   root@zimbralab03:~/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850#./install.sh -s --skip-activation-check

Select yes in the 2 questions about the Software License:

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

Important! In the next step please skip it, will launch the database integrity check later:

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

Select Yes to this question

   Do you wish to upgrade? [Y] 

Select yes to this question

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

When have this message, means that the install.sh -s finished

   Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml...done
   Software Installation complete!
   Operations logged to /tmp/install.log.3954
   Run /opt/zimbra/libexec/zmsetup.pl to configure the system

Now launch the install.sh script, but this time without the -s option

   root@zimbralab03:~/zcs-8.0.8_GA_6184.UBUNTU12_64.20140925165850# ./install.sh

Operations logged to /tmp/install.log.13242 The Zimbra install process will check about the packages.

   Checking for existing installation...
   zimbra-ldap...FOUND zimbra-ldap-8.0.8.GA.6184.UBUNTU12.64
   zimbra-logger...FOUND zimbra-logger-8.0.8.GA.6184.UBUNTU12.64
   zimbra-mta...FOUND zimbra-mta-8.0.8.GA.6184.UBUNTU12.64
   zimbra-snmp...FOUND zimbra-snmp-8.0.8.GA.6184.UBUNTU12.64
   zimbra-store...FOUND zimbra-store-8.0.8.GA.6184.UBUNTU12.64
   zimbra-apache...FOUND zimbra-apache-8.0.8.GA.6184.UBUNTU12.64
   zimbra-spell...FOUND zimbra-spell-8.0.8.GA.6184.UBUNTU12.64
   zimbra-convertd...NOT FOUND
   zimbra-memcached...NOT FOUND
   zimbra-proxy...NOT FOUND
   zimbra-archiving...NOT FOUND
   zimbra-cluster...NOT FOUND
   zimbra-core...FOUND zimbra-core-8.0.8.GA.6184.UBUNTU12.64
   ZCS upgrade from 8.0.8 to 8.0.8 will be performed.

Answer yes to the 2 questons about the Software License

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

The process will check about the prerequisites

   Checking for prerequisites...
    FOUND: NPTL
    FOUND: netcat-openbsd-1.89-4ubuntu1
    FOUND: sudo-1.8.3p1-1ubuntu3.6
    FOUND: libidn11-1.23-2
    FOUND: libpcre3-8.12-4
    FOUND: libgmp3c2-2:4.3.2+dfsg-2ubuntu1
    FOUND: libexpat1-2.0.1-7.2ubuntu1.1
    FOUND: libstdc++6-4.6.3-1ubuntu5
    FOUND: libperl5.14-5.14.2-6ubuntu2.4
    FOUND: libaio1-0.3.109-2ubuntu1
    Checking for suggested prerequisites...
    FOUND: pax
    FOUND: perl-5.14.2
    FOUND: sysstat
    FOUND: sqlite3
   Prerequisite check complete.

And now, we can run without problem the Database integrity, is a good practice do it before Upgrade Zimbra packages from Ubuntu 10.04 to Ubuntu 12.04

   Checking current number of databases...
   Do you want to verify message store database integrity? [Y] 
   Verifying integrity of message store databases.  This may take a while.
   Starting mysqld...done.
   mysqld is alive
   No errors found
   mysqld is alive
   Stopping mysqld... done.

The process will ask about if continues, press yes

   The Zimbra Collaboration Server appears already to 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] 

Select the packages that you want to install, in this example, without the memcached and proxy packages

   Select the packages to install
   Upgrading zimbra-core
   Upgrading zimbra-ldap
   Upgrading zimbra-logger
   Upgrading zimbra-mta
   Upgrading zimbra-snmp
   Upgrading zimbra-store
   Upgrading zimbra-apache
   Upgrading zimbra-spell
   Install zimbra-memcached [N] 
   Install zimbra-proxy [N] 
   Checking required space for zimbra-core
   Checking space for zimbra-store

The last question before start the installation process

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

And the process will start

   Shutting down zimbra mail
   Backing up the ldap database...done.
   Removing existing packages
   zimbra-ldap...done
   zimbra-logger...done
   zimbra-mta...done
   zimbra-snmp...done
   zimbra-store...done
   zimbra-spell...done
   zimbra-apache...done
   zimbra-core...done
   Removing deployed webapp directories
   Installing packages
   zimbra-core......zimbra-core_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
   zimbra-ldap......zimbra-ldap_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
   zimbra-logger......zimbra-logger_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
   zimbra-mta......zimbra-mta_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
   zimbra-snmp......zimbra-snmp_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
   zimbra-store......zimbra-store_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
   zimbra-apache......zimbra-apache_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done
   zimbra-spell......zimbra-spell_8.0.8.GA.6184.UBUNTU12.64_amd64.deb...done

The system will start to update, we can see all the progress in interactive way

Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml...done
Operations logged to /tmp/zmsetup.10252014-014753.log
Running zmldapapplyldif...done.
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.23712...done.
Operations logged to /tmp/zmsetup.10252014-014753.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 zimbralab03.zimbra.lab...already exists.
Setting Zimbra IP Mode...done.
Saving CA in ldap ...done.
Saving SSL Certificate in ldap ...done.
Setting spell check URL...done.
[...]
Updating non-standard zimlets...
Finished updating non-standard zimlets.
Restarting mailboxd...done.
Skipping creation of default domain GAL sync account - existing install detected.

In the end of the Installation, the wizard will ask us about Notify Zimbra, is always appreciated and good idea if we can do it:

You have the option of notifying Zimbra of your installation.
    This helps us to track the uptake of the Zimbra Collaboration Server.
    The only information that will be transmitted is:
	The VERSION of zcs installed (8.0.8_GA_6184_UBUNTU12_64)
	The ADMIN EMAIL ADDRESS created (admin@zimbralab03.zimbra.lab)

    Notify Zimbra of your installation? [Yes] yes
    Setting up zimbra crontab...done.

And now we will have Zimbra 8.0.8 and Ubuntu 12.04 working together. We can check all the log here:

   Moving /tmp/zmsetup.10252014-014753.log to /opt/zimbra/log
   Configuration complete - press return to exit 

Upgrade Ubuntu 12.04 64bit to Ubuntu 14.04 64bit and update ZCS 8.0.9

Stopping the Zimbra Collaboration Services

The first step in this Upgrade guide is stop our Zimbra Collaboration Services:

    zimbra@help:/home/# su - zimbra -c 'zmcontrol stop'

Once we have stopped the Zimbra Collaboration services and we have a full Backup or Snapshot, we can continue.

Upgrading the Ubuntu Version

Now is time for start the Upgrade proces with the next command

   root@zimbra-sn-u12-01:/home/oper# do-release-upgrade

The process will start and do some previous questions, for example about create an alternate SSH daemon, just in case if we lose the actual SSH connection:

   Continue running under SSH? 
   This session appears to be running under ssh. It is not recommended 
   to perform a upgrade over ssh currently because in case of failure it 
   is harder to recover. 
   If you continue, an additional ssh daemon will be started at port 
   '1022'. 
   Do you want to continue? 
   Continue [yN] y
   Starting additional sshd 
   To make recovery in case of failure easier, an additional sshd will 
   be started on port '1022'. 
   Do you want to continue? 
   Continue [yN] y

After a while checking packages, the wizard will ask about the total MB to download and will require our answer, in this case we will write Y and press ENTER:

   Do you want to start the upgrade? 
   2 packages are going to be removed. 104 new packages are going to be 
   installed. 362 packages are going to be upgraded. 
   You have to download a total of 204 M. This download should take 
   about 1 minute with your connection. 
   Installing the upgrade can take several hours. Once the download has 
   finished, the process cannot be cancelled. 
   Continue [yN]  Details [d]y

During the proccess, have questions like this or others, we need to take careful and select the default answer, so only need to press ENTER all time:

   Configuration file `/etc/security/limits.conf'
   ==> Modified (by you or by a script) since installation.
   ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
   Y or I  : install the package maintainer's version
   N or O  : keep your currently-installed version
   D     : show the differences between the versions
   Z     : start a shell to examine the situation
   The default action is to keep your current version.
   *** limits.conf (Y/I/N/O/D/Z) [default=N] ? 

During the proccess will have questions prompt about delete packages, again select the default option:

   Remove obsolete packages? 
   18 packages are going to be removed. 
   Continue [yN]  Details [d]y

And after a while, the final and good message, reboot time: System upgrade is complete.

   Restart required 
   To finish the upgrade, a restart is required. 
   If you select 'y' the system will be restarted. 
   Continue [yN] y

Update Zimbra 8.0.9 with Ubuntu 14.04 package

The first step is download now the correct version for our new OS, Ubuntu 14.04 LTS:

   [3]Open Source Edition Download 
   [4]Network Edition Download

Go into a root session and download the new version package:

   root@zimbralab03:~# wget http://files2.zimbra.com/downloads/zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539.tgz
   --2014-10-25 01:40:19--  http://files2.zimbra.com/downloads/8zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539.tgz
   Resolving files2.zimbra.com (files2.zimbra.com)... 54.230.10.252, 54.230.10.250, 54.230.9.119, ...
   Connecting to files2.zimbra.com (files2.zimbra.com)|54.230.10.252|:80... connected.
   HTTP request sent, awaiting response... 200 OK
   Length: 887979105 (847M) [binary/octet-stream]
   Saving to: `zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539.tgz'
   100%[=============================================================================================================================>] 887,979,105 12.1M/s   in 44s

Once downloaded the package, extract it:

   root@zimbra-sn-u12-01:/home/oper# tar xzvf zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539.tgz

Before launch the Zimbra installation, need to install some new depencies for Ubuntu 12.04

   root@zimbralab03:~/# apt-get install unzip libperl5.18

Now launch the installation process with the -s flag option (Software only installation)

   root@zimbralab03:~/zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539#./install.sh -s --skip-activation-check

Select yes in the 2 questions about the Software License:

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

Important! In the next step please skip it, will launch the database integrity check later:

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

Select No to this question

   Do you wish to upgrade? [Y] 

Select yes to this question

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

When have this message, means that the install.sh -s process has finished

   Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml...done
   Software Installation complete!
   Operations logged to /tmp/install.log.3954
   Run /opt/zimbra/libexec/zmsetup.pl to configure the system

Now launch the install.sh script, but this time without the -s option

   root@zimbralab03:~/zcs-8.0.9_GA_6191.UBUNTU14_64.20141103151539# ./install.sh

Operations logged to /tmp/install.log.13242 The Zimbra install process will check about the packages. Checking for existing installation...

   zimbra-ldap...FOUND zimbra-ldap-8.0.9.GA.6191.UBUNTU12.64
   zimbra-logger...FOUND zimbra-logger-8.0.9.GA.6191.UBUNTU12.64
   zimbra-mta...FOUND zimbra-mta-8.0.9.GA.6191.UBUNTU12.64
   zimbra-snmp...FOUND zimbra-snmp-8.0.9.GA.6191.UBUNTU12.64
   zimbra-store...FOUND zimbra-store-8.0.9.GA.6191.UBUNTU12.64
   zimbra-apache...FOUND zimbra-apache-8.0.9.GA.6191.UBUNTU12.64
   zimbra-spell...FOUND zimbra-spell-8.0.9.GA.6191.UBUNTU12.64
   zimbra-convertd...NOT FOUND
   zimbra-memcached...NOT FOUND
   zimbra-proxy...NOT FOUND
   zimbra-archiving...NOT FOUND
   zimbra-cluster...NOT FOUND
   zimbra-core...FOUND zimbra-core-8.0.9.GA.6191.UBUNTU12.64

ZCS upgrade from 8.0.9 to 8.0.9 will be performed Answer yes to the 2 questions about the Software License

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

The process will check about the prerequisites

   Checking for prerequisites...
    FOUND: NPTL
    FOUND: netcat-openbsd-1.105-7ubuntu1
    FOUND: sudo-1.8.9p5-1ubuntu1
    FOUND: libidn11-1.28-1ubuntu2
    FOUND: libpcre3-1:8.31-2ubuntu2
    FOUND: libgmp10-2:5.1.3+dfsg-1ubuntu1
    FOUND: libexpat1-2.1.0-4ubuntu1
    FOUND: libstdc++6-4.8.2-19ubuntu1
    FOUND: libperl5.18-5.18.2-2ubuntu1
    FOUND: libaio1-0.3.109-4
    FOUND: unzip-6.0-9ubuntu1
   Checking for suggested prerequisites...
    FOUND: pax
    FOUND: perl-5.18.2
    FOUND: sysstat
    FOUND: sqlite3
   Prerequisite check complete.

And now, we can run without problem the Database integrity, is a good practice do it before Upgrade Zimbra packages from Ubuntu 12.04 to Ubuntu 14.04

   Checking current number of databases...
   Do you want to verify message store database integrity? [Y] 
   Verifying integrity of message store databases.  This may take a while.
   Starting mysqld...done.
   mysqld is alive
   No errors found
   mysqld is alive
   Stopping mysqld... done.

The process will ask about if continues, press yes

   The Zimbra Collaboration Server appears already to 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] 

Select the packages that you want to install, in this example, without the memcached and proxy packages

   Select the packages to install
   Upgrading zimbra-core
   Upgrading zimbra-ldap
   Upgrading zimbra-logger
   Upgrading zimbra-mta
   Upgrading zimbra-snmp
   Upgrading zimbra-store
   Upgrading zimbra-apache
   Upgrading zimbra-spell
   Install zimbra-memcached [N] 
   Install zimbra-proxy [N] 
   Checking required space for zimbra-core
   Checking space for zimbra-store

The last question before start the installation process

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

And the process will start

   Shutting down zimbra mail
   Backing up the ldap database...done.
   Removing existing packages
   zimbra-ldap...done
   zimbra-logger...done
   zimbra-mta...done
   zimbra-snmp...done
   zimbra-store...done
   zimbra-spell...done
   zimbra-apache...done
   zimbra-core...done
   Removing deployed webapp directories
   Installing packages
   zimbra-core......zimbra-core_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
   zimbra-ldap......zimbra-ldap_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
   zimbra-logger......zimbra-logger_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
   zimbra-mta......zimbra-mta_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
   zimbra-snmp......zimbra-snmp_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
   zimbra-store......zimbra-store_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
   zimbra-apache......zimbra-apache_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done
   zimbra-spell......zimbra-spell_8.0.9.GA.6191.UBUNTU14.64_amd64.deb...done

The system will start to update, we can see all the progress in interactive way

Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml...done
Operations logged to /tmp/zmsetup.10252014-014753.log
Running zmldapapplyldif...done.
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.23712...done.
Operations logged to /tmp/zmsetup.10252014-014753.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 zimbralab03.zimbra.lab...already exists.
Setting Zimbra IP Mode...done.
Saving CA in ldap ...done.
Saving SSL Certificate in ldap ...done.
Setting spell check URL...done.
[...]
Updating non-standard zimlets...
Finished updating non-standard zimlets.
Restarting mailboxd...done.
Skipping creation of default domain GAL sync account - existing install detected.

In the end of the Installation, the wizard will ask us about Notify Zimbra, is always appreciated and good idea if we can do it:

You have the option of notifying Zimbra of your installation.
    This helps us to track the uptake of the Zimbra Collaboration Server.
    The only information that will be transmitted is:
	The VERSION of zcs installed (8.0.9_GA_6191_UBUNTU14_64)
	The ADMIN EMAIL ADDRESS created (admin@zimbralab03.zimbra.lab)

    Notify Zimbra of your installation? [Yes] yes
    Setting up zimbra crontab...done.

And now we will have Zimbra 8.0.9 and Ubuntu 14.04 working together. We can check all the log here (your log name will be different):

   Moving /tmp/zmsetup.10252014-014753.log to /opt/zimbra/log
   Configuration complete - press return to exit 

Upgrade Zimbra Collaboration 8.0.7 to 8.5.0 - Ubuntu 12.04

Verifying the expiration date of the SSL Certificate

Zimbra Collaboration requires always, at least, a Self-Signed SSL Certificate for do the communication between the different components. The Self-Signed SSL certificate is auto-deployed once we install Zimbra Collaboration.

Is highly recommend check the SSL Certificate expiration's date, with the next command:

/opt/zimbra/bin/zmcertmgr viewdeployedcrt

If the date is near to expires, is extremely recommended re-generate the Self-Signed SSL Certificate before do the Upgrade:

root@help:/opt/zimbra/ssl/zimbra# /opt/zimbra/bin/zmcertmgr createca -new
root@help:/opt/zimbra/ssl/zimbra# /opt/zimbra/bin/zmcertmgr createcrt -new -days 365
root@help:/opt/zimbra/ssl/zimbra# /opt/zimbra/bin/zmcertmgr deploycrt self

Upgrade Instructions

The first thing that need to to, is download the proper Zimbra Collaboration Version, in this case for Ubuntu 12.04 LTS:

   [5]Open Source Edition Downloads
   [6]Network Edition Downloads

Like root user, in this case /tmp, download the package to this folder:

    root@help:/tmp# wget http://files2.zimbra.com/downloads/8.5.0_GA/zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548.tgz
    HTTP request sent, awaiting response… 200 OK
    Length: 964955796 (920M) [binary/octet-stream]
    Saving to: `zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548.tgz’

    100%[=============================================================================================================================>] 964,955,796 3.11M/s   in 5m 33s

    2014-10-08 13:47:52 (2.76 MB/s) – `zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548.tgz’ saved [964955796/964955796]
    root@help:/tmp#

Once we've download it, is time to extract the file:

    root@help:/tmp# tar xzvf zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548.tgz 

The extract may take some time, depends on which Storage we are working. Before continue with the Upgrade, we need to install a new depedency for Zimbra 8.5, the dependency is unzip:

    root@help:/tmp/zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548# apt-get install unzip

Now we can continue with the Upgrade, is time to execute the install.sh script:

    root@help:/tmp/zcs-8.5.0_GA_3040.UBUNTU12_64.20140816142548# ./install.sh
    Operations logged to /tmp/install.log.895
    Checking for existing installation…
    zimbra-ldap…FOUND zimbra-ldap-8.0.7.GA.6020.UBUNTU12.64
    zimbra-logger…FOUND zimbra-logger-8.0.7.GA.6020.UBUNTU12.64
    zimbra-mta…FOUND zimbra-mta-8.0.7.GA.6020.UBUNTU12.64
    zimbra-dnscache…NOT FOUND
    zimbra-snmp…FOUND zimbra-snmp-8.0.7.GA.6020.UBUNTU12.64
    zimbra-store…FOUND zimbra-store-8.0.7.GA.6020.UBUNTU12.64
    zimbra-apache…FOUND zimbra-apache-8.0.7.GA.6020.UBUNTU12.64
    zimbra-spell…FOUND zimbra-spell-8.0.7.GA.6020.UBUNTU12.64
    zimbra-convertd…NOT FOUND
    zimbra-memcached…NOT FOUND
    zimbra-proxy…NOT FOUND
    zimbra-archiving…NOT FOUND
    zimbra-cluster…NOT FOUND
    zimbra-core…FOUND zimbra-core-8.0.7.GA.6020.UBUNTU12.64
    ZCS upgrade from 8.0.7 to 8.5.0 will be performed.

Saving existing configuration file to /opt/zimbra/.saveconfig

Once we pass all the checks, without errors, we can see the new EULA, we will write Yes or press ENTER in the end, default option:

    PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THE SOFTWARE.
    ZIMBRA, INC. (“ZIMBRA”) WILL ONLY LICENSE THIS SOFTWARE TO YOU IF YOU
    FIRST ACCEPT THE TERMS OF THIS AGREEMENT. BY DOWNLOADING OR INSTALLING
    THE SOFTWARE, OR USING THE PRODUCT, YOU ARE CONSENTING TO BE BOUND BY
    THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS
    AGREEMENT, THEN DO NOT DOWNLOAD, INSTALL OR USE THE PRODUCT.
    License Terms for the Zimbra Collaboration Suite:

    http://www.zimbra.com/license/zimbra-public-eula-2-5.html

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

Now Zimbra Collaboration will check all of the Zimbra Collaboration prerequisites:

    Checking for prerequisites…
    FOUND: NPTL
    FOUND: netcat-openbsd-1.89-4ubuntu1
    FOUND: sudo-1.8.3p1-1ubuntu3.4
    FOUND: libidn11-1.23-2
    FOUND: libpcre3-8.12-4
    FOUND: libgmp3c2-2:4.3.2+dfsg-2ubuntu1
    FOUND: libexpat1-2.0.1-7.2ubuntu1.1
    FOUND: libstdc++6-4.6.3-1ubuntu5
    FOUND: libperl5.14-5.14.2-6ubuntu2.4
    FOUND: libaio1-0.3.109-2ubuntu1
    FOUND: resolvconf-1.63ubuntu16
    FOUND: unzip-6.0-4ubuntu2

    Checking for suggested prerequisites…
    FOUND: pax
    FOUND: perl-5.14.2
    FOUND: sysstat
    FOUND: sqlite3
    Prerequisite check complete.
    Checking current number of databases…

We always recommend do the Database Integrity Check. We can take some minutes, sometimes hours, depends of the size and the number of errors, in case that we have, keep calm:

    Do you want to verify message store database integrity? [Y]
    Verifying integrity of message store databases.  This may take a while.
    Starting mysqld…done.
    mysqld is alive
    No errors found
    mysqld is alive
    Stopping mysqld… done.

In this step we can add some additional packages in case that we want it, in this case, we will not select any new package:

    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-memcached
    Found zimbra-proxy

If we are totally sure that everything is allright, and we can continue with the Upgrade, then we need to select Yes.

    The Zimbra Collaboration Server appears already to 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]

    Select the packages to install
    Upgrading zimbra-core
    Upgrading zimbra-ldap
    Upgrading zimbra-logger
    Upgrading zimbra-mta

    Install zimbra-dnscache [N]
    Upgrading zimbra-snmp
    Upgrading zimbra-store
    Upgrading zimbra-apache
    Upgrading zimbra-spell

    Install zimbra-memcached [N]

    Install zimbra-proxy [N]
    Checking required space for zimbra-core
    Checking space for zimbra-store
    Checking required packages for zimbra-store
    zimbra-store package check complete.

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

Once again, Zimbra do double check, and if we are complete sure that we want to upgrade, please write Y for continue with the process:

    The system will be modified.  Continue? [N] y
    Shutting down zimbra mail
    Backing up the ldap database…done.
    Removing existing packages
    zimbra-ldap…done
    zimbra-logger…done
    zimbra-mta…done
    zimbra-snmp…done
    zimbra-store…done
    zimbra-spell…done
    zimbra-apache…done
    zimbra-core…done

Removing deployed webapp directories
Installing packages

zimbra-core……zimbra-core_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done
zimbra-ldap……zimbra-ldap_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done
zimbra-logger……zimbra-logger_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done
zimbra-mta……zimbra-mta_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done
zimbra-snmp……zimbra-snmp_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done
zimbra-store……zimbra-store_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done
zimbra-apache……zimbra-apache_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done
zimbra-spell……zimbra-spell_8.5.0.GA.3040.UBUNTU12.64_amd64.deb…done

Zimbra Collaboration starts to upgrading, also the LDAP, etc, we can follow all the process in interactive way:

    Upgrading from 8.0.7_GA_6020 to 8.5.0_GA_3040
    Stopping zimbra services…done.
    This appears to be 8.0.7_GA
    Starting mysql…done.
    Checking ldap status…not running.
    Checking ldap status…not running.
    Starting ldap…done.
    Checking ldap status…already running.
    Running mysql_upgrade…done.
    Schema upgrade required from version 92 to 103.
    Running /opt/zimbra/libexec/scripts/migrate20130226_alwayson.pl
    Tue Aug 26 18:59:38 2014: Verified schema version 92.
    Tue Aug 26 18:59:39 2014: Verified schema version 92.
    Tue Aug 26 18:59:39 2014: Updating DB schema version from 92 to 100.
    Running /opt/zimbra/libexec/scripts/migrate20140319-MailItemPrevFolders.pl
    Tue Aug 26 18:59:42 2014: Verified schema version 100.
    Tue Aug 26 18:59:43 2014: Migrating mboxgroup1.  This can take a substantial amount of time…
    Tue Aug 26 18:59:44 2014: done.

Near the end, we can see from which Versions we can upgrade, just info:

    Stopping mysql…done.
    Updating from 8.0.8_GA
    Updating from 8.5.0_BETA1
    Updating from 8.5.0_BETA2
    Updating from 8.5.0_BETA3
    Updating from 8.5.0_GA
    Updating global config and COS’s with attributes introduced after 8.0.7_GA…done.
    Stopping ldap…done.
    Upgrade complete.

In the end of the Installation, the wizard will ask us about Notify Zimbra, is always appreciated and good idea if we can do it.

    You have the option of notifying Zimbra of your installation.
    This helps us to track the uptake of the Zimbra Collaboration Server.
    The only information that will be transmitted is:
    The VERSION of zcs installed (8.5.0_GA_3040_UBUNTU12_64)
    The ADMIN EMAIL ADDRESS created (admin@YYYYYIIII.es)
    Notify Zimbra of your installation? [Yes] yes

The last message is the pat to the Log file if we can check or save our process:

    Moving /tmp/zmsetup08262014-185850.log to /opt/zimbra/log
    Configuration complete – press return to exit 

Upgrade Ubuntu 12.04 to Ubuntu 14.04 and update ZCS 8.5.0

Template:Note Is very important before continue with this process, take a Snapshot or do a Full Backup of your System.

Stopping the Zimbra Collaboration Services

The first step in this Upgrade guide is stop our Zimbra Collaboration Services:

    zimbra@help:/home/# su - zimbra -c 'zmcontrol stop'

Once we have stopped the Zimbra Collaboration services and we have a full Backup or Snapshot, we can continue.

Upgrading the Ubuntu Version

For Upgrade the Ubuntu version, in root session we will execute this command:

    root@help:/home/# do-release-upgrade

This process will start and do some previous questions, for example it will ask us about create an alternate SSH daemon, just in case if we lose the actual SSH connection:

    Continue running under SSH?
    This session appears to be running under ssh. It is not recommended
    to perform a upgrade over ssh currently because in case of failure it
    is harder to recover.
    If you continue, an additional ssh daemon will be started at port
    ‘1022’.
    Do you want to continue?
    Continue [yN] y
    Starting additional sshd
    To make recovery in case of failure easier, an additional sshd will
    be started on port ‘1022’. If anything goes wrong with the running
    ssh you can still connect to the additional one.
    If you run a firewall, you may need to temporarily open this port. As
    this is potentially dangerous it’s not done automatically. You can
    open the port with e.g.:
    ‘iptables -I INPUT -p tcp –dport 1022 -j ACCEPT’
    To continue please press [ENTER]

After a while checking packages, the wizard will ask about the total MB to download and will require our answer, in this case we will write Y and press ENTER:

    Do you want to start the upgrade?
    2 packages are going to be removed. 113 new packages are going to be
    installed. 380 packages are going to be upgraded.
    You have to download a total of 216 M. This download will take about
    5 minutes with your connection.
    Installing the upgrade can take several hours. Once the download has
    finished, the process cannot be canceled.
    Continue [yN]  Details [d]y

The Wizard will ask us during the process some questions with Yes or No for answer it, we will let the default Answer:

    Unpacking replacement libc6 …
    Processing triggers for ureadahead …
    Processing triggers for man-db …
    Setting up libc6 (2.19-0ubuntu6.1) …
    Generating locales…
    en_AG.UTF-8… done
    en_AU.UTF-8… done
    en_BW.UTF-8… done
    en_CA.UTF-8… done
    en_DK.UTF-8… done
    en_GB.UTF-8… done
    en_HK.UTF-8… done
    en_IE.UTF-8… done
    en_IN.UTF-8… done
    en_NG.UTF-8… done
    en_NZ.UTF-8… done
    en_PH.UTF-8… done
    en_SG.UTF-8… done
    en_US.UTF-8… done
    en_ZA.UTF-8… done
    en_ZM.UTF-8… done
    en_ZW.UTF-8… done
    Generation complete.

We will have questions like this, we need to take careful and select the default answer, so we only need to press ENTER all time:

    Configuration file `/etc/security/limits.conf’
    ==> Modified (by you or by a script) since installation.
    ==> Package distributor has shipped an updated version.
    What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer’s version
    N or O  : keep your currently-installed version
    D     : show the differences between the versions
    Z     : start a shell to examine the situation
    The default action is to keep your current version.
    *** limits.conf (Y/I/N/O/D/Z) [default=N] ? 

Also, we will have questions prompt us about delete packages, again we will select the default answer:

    Remove obsolete packages?
    22 packages are going to be removed.
    Continue [yN]  Details [d]

And after a while, the final and good message, reboot time:

    System upgrade is complete.
    Restart required
    To finish the upgrade, a restart is required.
    If you select ‘y’ the system will be restarted.
    Continue [yN] y

Once we do a reboot, we will have Ubuntu 14.04 LTS running in our System:

    Distributor ID: Ubuntu
    Description:    Ubuntu 14.04.1 LTS
    Release:        14.04
    Codename:       trusty

Update Zimbra 8.5.0 with Ubuntu 14.04 package

The first step is download now the correct version for our new OS, Ubuntu 14.04 LTS:

   [7]Open Source Edition Download 
   [8]Network Edition Download

Go into a root session and download the new version package, in this example I will use the /home folder:

    root@help:/home# wget http://files2.zimbra.com/downloads/8.5.0_GA/zcs-8.5.0_GA_3040.UBUNTU14_64.20140816142548.tgz
    HTTP request sent, awaiting response… 200 OK
    Length: 964955796 (920M) [binary/octet-stream]
    Saving to: `zcs-8.5.0_GA_3040.UBUNTU14_64.20140816142548.tgz’

    100%[=============================================================================================================================>] 964,955,796 3.11M/s   in 5m 33s

    2014-10-08 14:47:52 (2.76 MB/s) – `zcs-8.5.0_GA_3040.UBUNTU14_64.20140816142548.tgz’ saved [964955796/964955796]
    root@help:/home#
<pre>
Once we've downloaded the package, is time for extract it:
<pre>
    root@help:/home/# tar xzvf zcs-8.5.0_GA_3040.UBUNTU14_64.20140816142548.tgz 

We need to install also a new dependency, perl5.18, if not we will obtain an error during the install process:

    root@help:/home# apt-get install libperl5.18

And now, we are ready to launch the install.sh script:

    Operations logged to /tmp/install.log.1821
    Checking for existing installation…
    zimbra-ldap…FOUND zimbra-ldap-8.5.0.GA.3040.UBUNTU12.64
    zimbra-logger…FOUND zimbra-logger-8.5.0.GA.3040.UBUNTU12.64
    zimbra-mta…FOUND zimbra-mta-8.5.0.GA.3040.UBUNTU12.64
    zimbra-dnscache…NOT FOUND
    zimbra-snmp…FOUND zimbra-snmp-8.5.0.GA.3040.UBUNTU12.64
    zimbra-store…FOUND zimbra-store-8.5.0.GA.3040.UBUNTU12.64
    zimbra-apache…FOUND zimbra-apache-8.5.0.GA.3040.UBUNTU12.64
    zimbra-spell…FOUND zimbra-spell-8.5.0.GA.3040.UBUNTU12.64
    zimbra-convertd…NOT FOUND
    zimbra-memcached…NOT FOUND
    zimbra-proxy…NOT FOUND
    zimbra-archiving…NOT FOUND
    zimbra-cluster…NOT FOUND
    zimbra-core…FOUND zimbra-core-8.5.0.GA.3040.UBUNTU12.64
    ZCS upgrade from 8.5.0 to 8.5.0 will be performed.

    Saving existing configuration file to /opt/zimbra/.saveconfig

Once the wizard complete the check, we can see the EULA, we need to write Y and press ENTER:

    PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THE SOFTWARE.
    ZIMBRA, INC. (“ZIMBRA”) WILL ONLY LICENSE THIS SOFTWARE TO YOU IF YOU
    FIRST ACCEPT THE TERMS OF THIS AGREEMENT. BY DOWNLOADING OR INSTALLING
    THE SOFTWARE, OR USING THE PRODUCT, YOU ARE CONSENTING TO BE BOUND BY
    THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS
    AGREEMENT, THEN DO NOT DOWNLOAD, INSTALL OR USE THE PRODUCT.

License Terms for the Zimbra Collaboration Suite:

http://www.zimbra.com/license/zimbra-public-eula-2-5.html

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

Is time now for check if all the prerequisites are installed already:

    Checking for prerequisites…
    FOUND: NPTL
    FOUND: netcat-openbsd-1.105-7ubuntu1
    FOUND: sudo-1.8.9p5-1ubuntu1
    FOUND: libidn11-1.28-1ubuntu2
    FOUND: libpcre3-1:8.31-2ubuntu2
    FOUND: libgmp10-2:5.1.3+dfsg-1ubuntu1
    FOUND: libexpat1-2.1.0-4ubuntu1
    FOUND: libstdc++6-4.8.2-19ubuntu1
    FOUND: libperl5.18-5.18.2-2ubuntu1
    FOUND: libaio1-0.3.109-4
    FOUND: resolvconf-1.69ubuntu1.1
    FOUND: unzip-6.0-9ubuntu1

Checking for suggested prerequisites…
FOUND: pax
FOUND: perl-5.18.2
FOUND: sysstat
FOUND: sqlite3
Prerequisite check complete.

We can run again the Database Integrity Check, it will takes some minutes or hours, depends of the size of it and also if the system found some errors:

    Checking current number of databases
    Do you want to verify message store database integrity? [Y] y

Once again, we can add some new packages to our system, but the regular way is not install any new package during this Upgrade time:

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-memcached
    Found zimbra-proxy

The Zimbra Collaboration Server appears already to 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.

The wizard will ask us if we are sure that we want to Upgrade, per default is Y we only need to press ENTER,also here we can add the additional packages if we want:

    Do you wish to upgrade? [Y]

    Select the packages to install
    Upgrading zimbra-core
    Upgrading zimbra-ldap
    Upgrading zimbra-logger
    Upgrading zimbra-mta

    Install zimbra-dnscache [N]
    Upgrading zimbra-snmp
    Upgrading zimbra-store
    Upgrading zimbra-apache
    Upgrading zimbra-spell

    Install zimbra-memcached [N]

    Install zimbra-proxy [N]
    Checking required space for zimbra-core
    Checking space for zimbra-store
    Checking required packages for zimbra-store
    zimbra-store package check complete.

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

The double check of zimbra will ask us again if we are really sure that we want to Upgrade the Zimbra Collaboration System:

    The system will be modified.  Continue? [N] y
    Shutting down zimbra mail
    Backing up the ldap database…done.
    Removing existing packages
    zimbra-ldap…done
    zimbra-logger…done
    zimbra-mta…done
    zimbra-snmp…done
    zimbra-store…done
    zimbra-spell…done
    zimbra-apache…done
    zimbra-core…done
    Removing deployed webapp directories
    Installing packages
    zimbra-core……zimbra-core_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done
    zimbra-ldap……zimbra-ldap_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done
    zimbra-logger……zimbra-logger_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done
    zimbra-mta……zimbra-mta_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done
    zimbra-snmp……zimbra-snmp_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done
    zimbra-store……zimbra-store_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done
    zimbra-apache……zimbra-apache_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done
    zimbra-spell……zimbra-spell_8.5.0.GA.3040.UBUNTU14.64_amd64.deb…done

The system will start to update, we can see all the progress in interactive way:

    Restoring existing configuration file from /opt/zimbra/.saveconfig/localconfig.xml…done
    Operations logged to /tmp/zmsetup08272014-130758.log
    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.12706…done.
    Operations logged to /tmp/zmsetup08272014-130758.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 help.zimbra.com…already exists.
    Setting Zimbra IP Mode…done.
    Saving CA in ldap …done.
    Saving SSL Certificate in ldap …done.
    Setting spell check URL…done.
    [...]
    Finished updating non-standard zimlets.
    Restarting mailboxd…done.
    Skipping creation of default domain GAL sync account – existing install detected.

In the end of the Installation, the wizard will ask us about Notify Zimbra, is always appreciated and good idea if we can do it:

    You have the option of notifying Zimbra of your installation.
    This helps us to track the uptake of the Zimbra Collaboration Server.
    The only information that will be transmitted is:
    The VERSION of zcs installed (8.5.0_GA_3040_UBUNTU14_64)
    The ADMIN EMAIL ADDRESS created (admin@help.zimbra.com)
    Notify Zimbra of your installation? [Yes] 

And now we will have Zimbra 8.5.0 and Ubuntu 14.04 working together. We can check all the log here:

    Setting up zimbra crontab…done.
    Moving /tmp/zmsetup08272014-130758.log to /opt/zimbra/log
    Configuration complete – press return to exit 

Upgrade Ubuntu 14.x to Ubuntu 16.x and update ZCS 8.7 & above

Template:Note Is very important before continue with this process, take a Snapshot or do a Full Backup of your System.

Stopping the Zimbra Collaboration Services

The first step in this Upgrade guide is stop our Zimbra Collaboration Services:

    zimbra@help:/home/# su - zimbra -c 'zmcontrol stop'

Backup configuration files, installed zimbra package list and ldap

Take backup of .install_history and localconfig.xml file

    mkdir -p /opt/{zimbra_backup/.saveconfig,ldap_backup}  
    chown zimbra:zimbra /opt/{zimbra_backup,ldap_backup} -R
    cp -pvr /opt/zimbra/.install_history /opt/zimbra_backup/.saveconfig/.install_history
    cp -pvr /opt/zimbra/conf/localconfig.xml /opt/zimbra_backup/.saveconfig/localconfig.xml

Backup installed zimbra package list

    apt list --installed | grep -i 'zimbra-' | cut -d'/' -f1 > /opt/zimbra_backup/.saveconfig/.installedPackages

Backup ldap

    su - zimbra
    /opt/zimbra/libexec/zmslapcat -c /opt/ldap_backup/
    /opt/zimbra/libexec/zmslapcat -a /opt/ldap_backup/
    /opt/zimbra/libexec/zmslapcat /opt/ldap_backup/

Install sysv-rc-conf to check and enable/disable zimbra service at boot time

    apt-get install sysv-rc-conf
    sysv-rc-conf zimbra off
    sysv-rc-conf --list zimbra
     zimbra       0:off      1:off   2:off    5:off    6:off

Upgrading the Ubuntu packages and Release Version

apt-get update && apt-get dist-upgrade
init 6

Edit "/etc/update-manager/release-upgrades" using your favorite editor and set "Prompt=lts"

For Upgrade the Ubuntu version, in root session we will execute this command:

    do-release-upgrade

This process will start and do some previous questions, for example it will ask us about create an alternate SSH daemon, just in case if we lose the actual SSH connection:

    Reading cache

Checking package manager

Continue running under SSH?

This session appears to be running under ssh. It is not recommended
to perform a upgrade over ssh currently because in case of failure it
is harder to recover.

If you continue, an additional ssh daemon will be started at port
'1022'.
Do you want to continue?

Continue [yN] y                                                                                                                                                                                 
Starting additional sshd

To make recovery in case of failure easier, an additional sshd will
be started on port '1022'. If anything goes wrong with the running
ssh you can still connect to the additional one.
If you run a firewall, you may need to temporarily open this port. As
this is potentially dangerous it's not done automatically. You can
open the port with e.g.:
'iptables -I INPUT -p tcp --dport 1022 -j ACCEPT'

To continue please press [ENTER]

After a while checking packages, the wizard will ask about the total MB to download and will require our answer, in this case we will write Y and press ENTER:

Do you want to start the upgrade?

14 installed packages are no longer supported by Canonical. You can
still get support from the community.

101 packages are going to be removed. 147 new packages are going to
be installed. 405 packages are going to be upgraded.

You have to download a total of 264 M. This download will take about
1 minute with your connection.

Installing the upgrade can take several hours. Once the download has
finished, the process cannot be canceled.

 Continue [yN]  Details [d]

We will have questions like this, we need to take careful and select the default answer, so we only need to press ENTER all time:

    Configuration file `/etc/security/limits.conf’
    ==> Modified (by you or by a script) since installation.
    ==> Package distributor has shipped an updated version.
    What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer’s version
    N or O  : keep your currently-installed version
    D     : show the differences between the versions
    Z     : start a shell to examine the situation
    The default action is to keep your current version.
    *** limits.conf (Y/I/N/O/D/Z) [default=N] ? 

Also, we will have questions prompt us about delete packages, again we will select the default answer:

    Remove obsolete packages?
    22 packages are going to be removed.
    Continue [yN]  Details [d]

And after a while, the final and good message, reboot time:

    System upgrade is complete.
    Restart required
    To finish the upgrade, a restart is required.
    If you select ‘y’ the system will be restarted.
    Continue [yN] y

Once we do a reboot, we will have Ubuntu 14.04 LTS running in our System:

    Distributor ID: Ubuntu
    Description:    Ubuntu 14.04.1 LTS
    Release:        14.04
    Codename:       trusty

Update Zimbra 8.7 and above with Ubuntu 16.x package

The first step is download and extract the correct version for our new OS, Ubuntu 16.x LTS:

   [9]Open Source Edition Download 
   [10]Network Edition Download

Now, we are ready to launch the install.sh script:

./install.sh -s --skip-activation-check

**Remember that if it ask to delete /opt/zimbra directory say No

Configuring package repository

Checking for installable packages

Found zimbra-core (local)
Found zimbra-ldap (local)
Found zimbra-logger (local)
Found zimbra-mta (local)
Found zimbra-dnscache (local)
Found zimbra-snmp (local)
Found zimbra-store (local)
Found zimbra-apache (local)
Found zimbra-spell (local)
Found zimbra-convertd (local)
Found zimbra-memcached (repo)
Found zimbra-proxy (local)
Found zimbra-archiving (local)
Found zimbra-chat (repo)
Found zimbra-drive (repo)
Found zimbra-imapd (local)
Found zimbra-license-tools (local)
Found zimbra-license-extension (local)
Found zimbra-network-store (local)
Found zimbra-network-modules-ng (local)


The Zimbra Collaboration Server does not appear to be installed,
yet there appears to be a ZCS directory structure in /opt/zimbra.

Would you like to delete /opt/zimbra before installing? [N] N

Now as usual it will ask to install packages, say Y to the packages you had before release upgrade The system will start to update, we can see all the progress in interactive way.

Now copy "install_history" and "localconfig.xml" files from the backup location which we took, without this step do not start ZCS upgrade step else installer will behave like a fresh installation.

cp -pvr /opt/zimbra_backup/zimbra/.install_history /opt/zimbra/.install_history  
cp -pvr /opt/zimbra/zimbra_backup/conf/localconfig.xml /opt/zimbra/conf/localconfig.xml

Run "/opt/zimbra/libexec/zmsetup.pl" to complete configuration part, this step will take only few minutes to complete configuration.

And now we will have Zimbra 8.7 or above and Ubuntu 16 working together.

Upgrade Ubuntu 16.x to Ubuntu 18.x and update ZCS 8.8.15 & above

Template:Note Is very important before continue with this process, take a Snapshot or do a Full Backup of your System.

Stopping the Zimbra Collaboration Services

The first step in this Upgrade guide is stop our Zimbra Collaboration Services:

    zimbra@help:/home/# su - zimbra -c 'zmcontrol stop'

Backup configuration files, installed zimbra package list and ldap

Take backup of .install_history and localconfig.xml file

    mkdir -p /opt/{zimbra_backup/.saveconfig,ldap_backup}  
    chown zimbra:zimbra /opt/{zimbra_backup,ldap_backup} -R
    cp -pvr /opt/zimbra/.install_history /opt/zimbra_backup/.saveconfig/.install_history
    cp -pvr /opt/zimbra/conf/localconfig.xml /opt/zimbra_backup/.saveconfig/localconfig.xml

Backup installed zimbra package list

    apt list --installed | grep -i 'zimbra-' | cut -d'/' -f1 > /opt/zimbra_backup/.saveconfig/.installedPackages

Backup ldap

    su - zimbra
    /opt/zimbra/libexec/zmslapcat -c /opt/ldap_backup/
    /opt/zimbra/libexec/zmslapcat -a /opt/ldap_backup/
    /opt/zimbra/libexec/zmslapcat /opt/ldap_backup/

Install sysv-rc-conf to check and enable/disable zimbra service at boot time

    apt-get install sysv-rc-conf
    sysv-rc-conf zimbra off
    sysv-rc-conf --list zimbra
     zimbra       0:off      1:off   2:off    5:off    6:off

Upgrading the Ubuntu packages and Release Version

apt-get update && apt-get dist-upgrade
init 6

Edit "/etc/update-manager/release-upgrades" using your favorite editor and set "Prompt=lts"

For Upgrade the Ubuntu version, in root session we will execute this command:

    do-release-upgrade

This process will start and do some previous questions, for example it will ask us about create an alternate SSH daemon, just in case if we lose the actual SSH connection:

    Reading cache

Checking package manager

Continue running under SSH?

This session appears to be running under ssh. It is not recommended
to perform a upgrade over ssh currently because in case of failure it
is harder to recover.

If you continue, an additional ssh daemon will be started at port
'1022'.
Do you want to continue?

Continue [yN] y                                                                                                                                                                                 
Starting additional sshd

To make recovery in case of failure easier, an additional sshd will
be started on port '1022'. If anything goes wrong with the running
ssh you can still connect to the additional one.
If you run a firewall, you may need to temporarily open this port. As
this is potentially dangerous it's not done automatically. You can
open the port with e.g.:
'iptables -I INPUT -p tcp --dport 1022 -j ACCEPT'

To continue please press [ENTER]

After a while checking packages, the wizard will ask about the total MB to download and will require our answer, in this case we will write Y and press ENTER:

Do you want to start the upgrade?

14 installed packages are no longer supported by Canonical. You can
still get support from the community.

101 packages are going to be removed. 147 new packages are going to
be installed. 405 packages are going to be upgraded.

You have to download a total of 264 M. This download will take about
1 minute with your connection.

Installing the upgrade can take several hours. Once the download has
finished, the process cannot be canceled.

 Continue [yN]  Details [d]

We will have questions like this, we need to take careful and select the default answer, so we only need to press ENTER all time:

    Configuration file `/etc/security/limits.conf’
    ==> Modified (by you or by a script) since installation.
    ==> Package distributor has shipped an updated version.
    What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer’s version
    N or O  : keep your currently-installed version
    D     : show the differences between the versions
    Z     : start a shell to examine the situation
    The default action is to keep your current version.
    *** limits.conf (Y/I/N/O/D/Z) [default=N] ? 

Also, we will have questions prompt us about delete packages, again we will select the default answer:

    Remove obsolete packages?
    22 packages are going to be removed.
    Continue [yN]  Details [d]

And after a while, the final and good message, reboot time:

    System upgrade is complete.
    Restart required
    To finish the upgrade, a restart is required.
    If you select ‘y’ the system will be restarted.
    Continue [yN] y

Once we do a reboot, we will have Ubuntu 18.04 LTS running in our System:

    Distributor ID: Ubuntu
    Description:    Ubuntu 18.04.3 LTS
    Release:        18.04
    Codename:       trusty

Update Zimbra 8.8.15 and above with Ubuntu 16.x package

The first step is download and extract the correct version for our new OS, Ubuntu 18.x LTS:

   [11]Open Source Edition Download 
   [12]Network Edition Download

Now, we are ready to launch the install.sh script:

./install.sh -s --skip-activation-check

**Remember that if it ask to delete /opt/zimbra directory say No

Configuring package repository

Checking for installable packages

Found zimbra-core (local)
Found zimbra-ldap (local)
Found zimbra-logger (local)
Found zimbra-mta (local)
Found zimbra-dnscache (local)
Found zimbra-snmp (local)
Found zimbra-store (local)
Found zimbra-apache (local)
Found zimbra-spell (local)
Found zimbra-convertd (local)
Found zimbra-memcached (repo)
Found zimbra-proxy (local)
Found zimbra-archiving (local)
Found zimbra-drive (repo)
Found zimbra-imapd (local)
Found zimbra-patch (repo)
Found zimbra-mta-patch (repo)
Found zimbra-proxy-patch (repo)
Found zimbra-license-tools (local)
Found zimbra-license-extension (local)
Found zimbra-network-store (local)
Found zimbra-network-modules-ng (local)


The Zimbra Collaboration Server does not appear to be installed,
yet there appears to be a ZCS directory structure in /opt/zimbra.

Would you like to delete /opt/zimbra before installing? [N] N

Now as usual it will ask to install packages, say Y to the packages you had before release upgrade The system will start to update, we can see all the progress in interactive way.

Now copy "install_history" and "localconfig.xml" files from the backup location which we took, without this step do not start ZCS upgrade step else installer will behave like a fresh installation.

cp -pvr /opt/zimbra_backup/.saveconfig/.install_history /opt/zimbra/.install_history  
cp -pvr /opt/zimbra_backup/.saveconfig/localconfig.xml /opt/zimbra/conf/localconfig.xml

Run "/opt/zimbra/libexec/zmsetup.pl" to complete configuration part, this step will take only few minutes to complete configuration.

And now we will have Zimbra 8.8.15 or above and Ubuntu 18 working together.

Special Notes about Licensing

License Activation is required when upgrading to ZCS 7 or later.

The ZCS Network upgrade will automatically attempt to activate the current license as long as the activation server can be contacted.

You can obtain a manual activation key and re-run the upgrade by specifying the -a activation.xml option.

A manual license activation key can be obtained by either visiting the Zimbra support portal or contacting Zimbra support or sales.

Attention.png - This article is NOT official Zimbra documentation. It is a user contribution and may include unsupported customizations, references, suggestions, or information. This Step-by-Step is not taking care about the Apache, or other kind of Software that you maybe have inside the Server. This steps are just for Upgrade Zimbra Collaboration
Verified Against: ZCS 7 and ZCS 8 Date Created: 12/13/2014
Article ID: https://wiki.zimbra.com/index.php?title=Ubuntu_Upgrades Date Modified: 2023-03-24



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search