Zum Inhalt

Zimbra Upgrade

Vorbereitung

  • Deaktiviere die SMTP-Ports für die Zimbra-Umgebung in den Firewalleinstellungen, um die Einlieferung von eMail nach dem Erstellen der VM-Backups zu verhindern und im Fall einer notwendigen Wiederherstellung der VMs aus den Backups, den Verlust von eMail zu verhindern.
  • Erstelle ein VM-Backup aller Zimbra-Nodes, backup bzw. kopiere alle (Config-)Dateien eigener oder von 3rd-Party Zimbra-Modifikationen, um diese ggf. nach dem Upgrade, mauell, wieder nachzuziehen, falls die Anpassungen nicht upgradestabil sind.
  • Stelle sicher, dass alle Zimbra-Nodes auf aktuellem Stand sind:
    $ sudo apt update 
$ sudo apt upgrade

Upgrade Ubuntu-OS 18.04 LTS --> 20.04 LTS

Prüfe installierte OS- und Zimbra-Version, als user zimbra. Für Ubuntu 18.04 und Zimbra 8.8.15 P36 sollte das so aussehen:

    $ sudo su - zimbra
    $ zmcontrol -v
    Release 8.8.15.GA.3869.UBUNTU16.64 UBUNTU18_64 FOSS edition, Patch 8.8.15_P36.

    $ lsb_release -a
    No LSB modules are available.
    Distributor ID: Ubuntu
    Description:    Ubuntu 18.04.6 LTS
    Release:        18.04
    Codename:       bionic

Prüfe, ob genug Speicherplatz in / für den Download und die Installation der Ubuntu 20.04 Pakete vorhanden ist, bzw. falls eine dedizierte /boot/ Partition existiert, dass diese ebenfalls über genug freien Speicherplatz verfügt.

  • Stoppe alle Zimbra-Dienste auf den Zimbra-Nodes als user zimbra:

    $ sudo su - zimbra
$ zmcontrol stop

  • Nachdem alle Zimbra-Dienste herunter gefahren sind, aktualisiere das OS:

In einer Multiserver-Umgebung, aktualisiere die Nodes in dieser Reihenfolge:

1. Node mit primärem LDAP
2. Node mit LDAP-Replica (falls existent)
3. Mailbox Node(s)
4. Rest (MTAs/ Proxies/etc.)

OS-Upgrade per Zimbra Node:

Stelle sicher, dass ab jetzt alle weiteren Operationen in einem Screen ausgeführt werden:

Werde root und starte das Ubuntu OS-Upgrade:

    $ sudo -s
    $ apt update  && apt upgrade
    $ do-release-upgrade

Wenn die folgende Meldung erscheint, detache den screen, bzw. wechsle zu einer anderen ssh-Session auf der Node:

    Informationen zu Paketquellen werden aktualisiert

    Paketquellen von Drittanbietern deaktiviert

    Einige Paketquellen von Drittanbietern wurden deaktiviert. Sie können 
    diese nach der Systemaktualisierung mit dem Programm 
    »Software-Paketquellen« oder mit »Synaptic« wieder aktivieren.

    Um fortzufahren, drücken Sie [ENTER]

  • Als root, offne die Datei "/etc/apt/sources.list.d/zimbra.list" und aktiviere die auskommentieren Sourcen wieder:

    $ vi /etc/apt/sources.list.d/zimbra.list

#deb [arch=amd64] https://repo.zimbra.com/apt/87 focal zimbra # Bei Aktualisierung zu bionic deaktiviert Bei Aktualisierung zu focal deaktiviert
#deb [arch=amd64] https://repo.zimbra.com/apt/8815 focal zimbra # Bei Aktualisierung zu bionic deaktiviert Bei Aktualisierung zu focal deaktiviert
#deb-src [arch=amd64] https://repo.zimbra.com/apt/87 focal zimbra # Bei Aktualisierung zu bionic deaktiviert Bei Aktualisierung zu focal deaktiviert

  • Speichere die Änderungen, der Inhalt sollte dann so aussehen:

    deb [arch=amd64] https://repo.zimbra.com/apt/87 focal zimbra
deb [arch=amd64] https://repo.zimbra.com/apt/8815 focal zimbra
deb-src [arch=amd64] https://repo.zimbra.com/apt/87 focal zimbra

  • Wechsle zurück zum Screen, in welchem das OS-Upgrade läuft und drücke "ENTER" um mit dem Upgrade Prozess fortzufahren.

  • Im nächsten Prompt werden die gesammelten Informationen zum Upgrade-Prozess angezeigt:

    Möchten Sie die Systemaktualisierung starten?

XXX Pakete werden nicht mehr von Canonical unterstützt. Sie können 
allerdings immer noch Hilfe von der Gemeinschaft erhalten.

XXX Pakete werden entfernt. 130 neue Pakete werden installiert. XXX 
Pakete werden aktualisiert.

Insgesamt müssen XXXX M heruntergeladen werden. Diese Übertragung 
wird mit einer 1-MBit-DSL-Verbindung etwa 2 Stunden 16 Minuten dauern 
oder ungefähr 1 Tag 17 Stunden mit einem 56K-Modem.

Das Herunterladen und Installieren der Systemaktualisierung kann 
mehrere Stunden dauern. Sobald das Herunterladen abgeschlossen ist, 
kann der Vorgang nicht mehr abgebrochen werden.

Fortsetzen [j/N]  Details [d]

  • Nach eventueller Prüfung (d), weiter mit "j"

Prompts während der Aktualisierung bzgl. config files:

  • Im Zweifel die existierenden Dateien immer beibehalten (N), und nach Abschluss des Upgrades die Änderungen prüfen und ggf. anpassen, z.B.
    /etc/security/limits.conf

Nach Abschluss der Aktualisierung wird die Node neu gestartet.

  • Prüfe nach dem Wiederhochfahren, die installierte OS- und Zimbra Version. Das Ergebnis sollte so aussehen:

    $ sudo su - zimbra
$ zmcontrol -v
Release 8.8.15.GA.4179.UBUNTU20.64 UBUNTU20_64 NETWORK edition, Patch 8.8.15_P36

$ lsb_release -a
Distributor ID: Ubuntu
Description:    Ubuntu 20.04.5 LTS
Release:        20.04
Codename:       focal

  • Prüfe, ob alle Zimbra-Dienste gestartet wurden und laufen...

    sudo su - zimbra
zmcontrol status

  • bzw. falls nicht, führe einen manuellen restart aus:

    zmcontrol restart

Nachdem alle Zimbra-Dienste laufen, ist das OS-Upgrade abgeschlossen.

Troubleshooting:

Nach OS-Upgrade wird inkorrete/ UKNOWN Version angezeigt

    $ zmcontrol -v
    Release 8.8.15.GA.3869.UBUNTU16.64 UBUNTUUNKNOWN_64 FOSS edition, Patch 8.8.15_P38

Lösung

Stoppen aller Zimbra-Dienste 

    $ sudo su - zimbra
    $ zmcontrol stop

Herunterladen und Ausführen des Zimbra Installers 8.8.15 für Ubuntu 20.04.

    $ cd /tmp/
    $ wget https://files.zimbra.com/downloads/8.8.15_GA/zcs-NETWORK-8.8.15_GA_4177.UBUNTU20_64.20211112014220.tgz
    $ sudo -s
    $ tar xvfz zcs-8.8.15_GA_4179.UBUNTU20_64.20211118033954.tgz
    $ cd zcs-8.8.15_GA_4179.UBUNTU20_64.20211118033954
    $ ./install.sh

Abhängig von der installierten Version, die obige Download-URL für wget entsprechend anpassen:

- OSE:<br/> 
```
https://files.zimbra.com/downloads/8.8.15_GA/zcs-8.8.15_GA_4179.UBUNTU20_64.20211118033954.tgz
```
- Network Edition:<br/>
```
https://files.zimbra.com/downloads/8.8.15_GA/zcs-NETWORK-8.8.15_GA_4177.UBUNTU20_64.20211112014220.tgz
```

Auf die folgenden Prompts, wie nachfolgend angegeben, reagieren:

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



    Checking current number of databases...

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


    Use Zimbra's package repository [Y] Y

    ...

    Found ..

    < Liste der installierten Zimbra Komponenten >

    ...

    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]  Y

  • Auf die folgenden Fragen bzgl. der Installation zusätzlicher Komponenten, immer mit "N" antworten bis zu folgendem Prompt:

    Installing:

<Liste der zu re-installierenden Zimbra Komponenten>

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

  • Nach Abschluss der Installation wird die Zimbra Version jetzt korrekt angezeigt:

    $ su - zimbra
$ zmcontrol -v
Release 8.8.15.GA.4179.UBUNTU20.64 UBUNTU20_64 FOSS edition.

Da es sich bei der installierten Version um die Version des Installers handelt, ist diese noch nicht auf dem nötigen Patchlevel und einige Diente, z.B: Mailbox werden noch nicht starten.

Nachziehen des Patchlevels

  • Beim Versuch der die Paketaktualisierung (also root) wird nun folgende Fehlermeldung zurück gegeben:

    $ apt update
$ apt upgrade
Paketlisten werden gelesen... Fertig
Abhängigkeitsbaum wird aufgebaut.       
Statusinformationen werden eingelesen.... Fertig
Probieren Sie »apt --fix-broken install«, um dies zu korrigieren.
Die folgenden Pakete haben unerfüllte Abhängigkeiten:
zimbra-mta-patch : Hängt ab von: zimbra-common-core-jar (>= 8.8.15.1676020603-1.u20) aber 8.8.15.1634917408-1.u20 ist installiert
                Hängt ab von: zimbra-common-core-libs (>= 8.8.15.1663926687-1.u20) aber 8.8.15.1626439528-1.u20 ist installiert
zimbra-patch : Hängt ab von: zimbra-common-core-libs (>= 8.8.15.1663926687-1.u20) aber 8.8.15.1626439528-1.u20 ist installiert
                Hängt ab von: zimbra-mbox-store-libs (>= 8.8.15.1663926687-1.u20) aber 8.8.15.1626439528-1.u20 ist installiert
                Hängt ab von: zimbra-common-core-jar (>= 8.8.15.1676020603-1.u20) aber 8.8.15.1634917408-1.u20 ist installiert
                Hängt ab von: zimbra-mbox-webclient-war (>= 8.8.15.1676019993-1.u20) aber 8.8.15.1635813854-1.u20 ist installiert
                Hängt ab von: zimbra-timezone-data (>= 2.0.1.1667816429-1.u20) aber 2.0.1.1618576642-1.u20 ist installiert
                Hängt ab von: zimbra-mbox-admin-console-war (>= 8.8.15.1676019834-1.u20) aber 8.8.15.1624007059-1.u20 ist installiert
                Hängt ab von: zimbra-mbox-war (>= 8.8.15.1655458176-1.u20) aber 8.8.15.1634917408-1.u20 ist installiert
                Hängt ab von: zimbra-common-mbox-conf-msgs (>= 8.8.15.1652703447-1.u20) aber 8.8.15.1556130968-1.u20 ist installiert
                Hängt ab von: zimbra-common-mbox-conf-attrs (>= 8.8.15.1652767386-1.u20) aber 8.8.15.1571124020-1.u20 ist installiert
zimbra-proxy-patch : Hängt ab von: zimbra-common-core-jar (>= 8.8.15.1676020603-1.u20) aber 8.8.15.1634917408-1.u20 ist installiert
                Hängt ab von: zimbra-common-core-libs (>= 8.8.15.1663926687-1.u20) aber 8.8.15.1626439528-1.u20 ist installiert
E: Unerfüllte Abhängigkeiten. Versuchen Sie »apt --fix-broken install« ohne Angabe eines Pakets (oder geben Sie eine Lösung an).

  • Beheben wie vorgeschlagen:

    $ apt --fix-broken install

  • Jetzt noch die Patch-Pakete manuell "reinstallieren":

    $ apt install --reinstall zimbra-ldap-patch zimbra-patch zimbra-proxy-patch zimbra-mta-patch

  • Nach Abschluss, wie angegeben, die Zimbra-Dienste neu starten:

    $ su - zimbra
$ zmcontrol restart

  • Nachdem der Neustart der Zimbra-Dienste beendet ist, läuft auf der Mailbox-Dienst wieder und die korrekte Version mit Patchlevel wird angezeigt (z.B. OSE):

    $ zmcontrol -v
Release 8.8.15.GA.4179.UBUNTU20.64 UBUNTU20_64 FOSS edition, Patch 8.8.15_P38.