Upgrade der VMware Cloud Director-Appliance mithilfe eines Update-Pakets

Sie können die VMware Cloud Director-Appliance mithilfe eines Update-Pakets auf die neueste Version aktualisieren oder Patches auf die VMware Cloud Director-Appliance anwenden.

Während die Bereitstellung der VMware Cloud Director-Appliance aktualisiert wird, funktioniert der VMware Cloud Director-Dienst nicht mehr und es kann zu einem Ausfall kommen. Die Dauer des Ausfalls richtet sich nach dem Zeitraum, den Sie zum Aktualisieren aller VMware Cloud Director-Appliances und Ausführen des Upgrade-Skripts der VMware Cloud Director-Datenbank benötigen. Die Anzahl der funktionierenden Zellen in der VMware Cloud Director-Servergruppe wird reduziert, bis Sie den VMware Cloud Director-Dienst auf der letzten VMware Cloud Director-Appliance beenden. Ein ordnungsgemäß konfigurierter Lastausgleichsdienst vor den VMware Cloud Director-HTTP-Endpoints sollte das Routing des Datenverkehrs zu den beendeten Zellen stoppen.

Nachdem Sie das Upgrade auf jede VMware Cloud Director-Appliance angewendet haben und das Datenbank-Upgrade abgeschlossen ist, müssen Sie jede VMware Cloud Director-Appliance neu starten.

Voraussetzungen

Erstellen Sie einen Snapshot der primären VMware Cloud Director-Appliance.

Wenn bei einem Upgrade von Version 10.1 oder höher bzw. beim Anwenden von Patches das automatische Failover im Falle eines Ausfalls des primären Datenbankdienstes aktiviert ist, ändern Sie den Failover-Modus während des Upgrades in Manual. Nach dem Upgrade können Sie den Failover-Modus auf Automatic festlegen. Weitere Informationen finden Sie im Automatisches Failover der VMware Cloud Director-Appliance.
Melden Sie sich bei der vCenter Server-Instanz an, auf der sich die primäre VMware Cloud Director-Appliance Ihres Hochverfügbarkeits-Clusters der Datenbank befindet.
Navigieren Sie zur primären VMware Cloud Director-Appliance, klicken Sie mit der rechten Maustaste darauf und klicken Sie auf Stromversorgung > Gastbetriebssystem herunterfahren.
Klicken Sie mit der rechten Maustaste auf die Appliance und klicken Sie auf Snapshots > Snapshot erstellen. Geben Sie einen Namen und optional eine Beschreibung für den neuen Snapshot ein und klicken Sie auf OK.
Klicken Sie mit der rechten Maustaste auf die VMware Cloud Director-Appliance und klicken Sie auf Stromversorgung > Einschalten.
Vergewissern Sie sich, dass sich alle Knoten in der Hochverfügbarkeitskonfiguration Ihrer Datenbank in einem ordnungsgemäßen Zustand befinden. Weitere Informationen finden Sie im Anzeigen des Clusterzustands und des Failover-Modus der VMware Cloud Director-Appliance.
Machen Sie sich mit dem Sicherungsverfahren für die VMware Cloud Director-Appliance vertraut. Weitere Informationen finden Sie im Sichern der eingebetteten Datenbank der VMware Cloud Director-Appliance.

Prozedur

Melden Sie sich in einem Webbrowser bei der Appliance-Verwaltungsbenutzeroberfläche einer VMware Cloud Director-Appliance-Instanz an, um die primäre Appliance, https://appliance_ip_address: 5480 zu identifizieren.
Notieren Sie sich den Namen der primären Appliance. Sie müssen das Upgrade der primären Appliance durchführen, bevor Sie die Upgrades für die Standby- und Anwendungszellen durchführen. Sie müssen beim Sichern der Datenbank den Namen der primären Appliance verwenden.
Fahren Sie auf allen Appliances im Cluster VMware Cloud Director herunter und führen Sie den folgenden Befehl aus:
```
/opt/vmware/vcloud-director/bin/cell-management-tool -u <admin_username> cell --shutdown
```
Laden Sie das Update-Paket in die Appliance herunter, für die Sie das Upgrade durchführen.

Hinweis: Sie müssen zuerst das Upgrade der primären Appliance durchführen.
VMware Cloud Director wird als ausführbare Datei mit einem Namen im Format VMware_Cloud_Director_v verteilt.v.v.v- nnnnnnnn_update. tar.gz verteilt, wobei v. v. v. v die Produktversion und nnnnnnnn die Build-Nummer darstellt. Beispiel: VMware_Cloud_Director_10.1.0.4424-14420378_update.tar.gz.
Erstellen Sie das Verzeichnis local-update-package, in dem das Updatepaket extrahiert werden soll.
```
mkdir /tmp/local-update-package
```

Extrahieren Sie das Updatepaket in das neu erstellte Verzeichnis.

 tar -zxf VMware_Cloud_Director_v.v.v.v-nnnnnnnn_update.tar.gz \
				-C /tmp/local-update-package

Legen Sie das Verzeichnis local-update-package als Update-Repository fest.
```
vamicli	update --repo file:///tmp/local-update-package
```
Suchen Sie nach Updates, um sicherzustellen, dass Sie das Repository ordnungsgemäß eingerichtet haben.
```
vamicli update --check
```
Die Upgrade-Version wird als verfügbares Update angezeigt.
Erstellen Sie eine Sicherung mithilfe der Verwaltungsoberfläche der primären oder Standby-Appliance.
Sie können die Anwendungszelle nicht zum Durchführen einer Sicherung verwenden.
Wenden Sie das verfügbare Upgrade an.
```
vamicli update --install latest
```
Wiederholen Sie die Schritte 3–7 und 9 für die verbleibenden Standby- und Anwendungszellen.
Führen Sie von jeder Appliance aus das VMware Cloud Director-Datenbank-upgrade-Dienstprogramm aus.
```
/opt/vmware/vcloud-director/bin/upgrade
```
Starten Sie die VMware Cloud Director-Appliance neu.
```
shutdown -r now
```

Nächste Maßnahme

Stellen Sie sicher, dass das Upgrade erfolgreich durchgeführt wurde.
- Melden Sie sich beim VMware Cloud Director Service Provider Admin Portal an.
- Melden Sie sich bei der Verwaltungsbenutzeroberfläche der VMware Cloud Director-Appliance an und bestätigen Sie, dass alle Appliances mit dem Status Healthy angezeigt werden.
Stellen Sie sicher, dass in den Protokollen während des Upgrades keine Fehler bei der Zertifikatskonvertierung angezeigt werden. Wenn Fehler bei der Zertifikatskonvertierung in den Protokollen vorhanden sind, können Sie die VMware Cloud Director-Appliance nicht sichern. Wenn Fehler angezeigt werden, wiederholen Sie das Upgrade nicht. Beheben Sie das Problem je nach Fehler manuell, bevor Sie den Befehl „convert“ erneut ausführen.
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates --convert
```
Je nach Fehler stehen verschiedene Problemumgehungen zur Verfügung, wie z. B.:
- Wenn die folgende Ausnahme während der Konvertierung der Zertifikate in /opt/vmware/var/log/vami/updatecli.log angezeigt wird, finden Sie weitere Informationen im KB-Artikel 88372.
```
 <JAVA_HOME>/lib/ext exists, extensions mechanism no longer supported; Use -classpath instead.
             .Error: Could not create the Java Virtual Machine.
              Error: A fatal exception has occurred. Program will exit. 
```
- Wenn die Datei /opt/vmware/var/log/vami/updatecli.log Fehler aus der Konvertierung der Zertifikate aufweist, die auf einen fehlerhaften Schlüssel zurückzuführen sind, oder in der Datei keine Gründe für die Fehler angegeben werden, stehen folgende Problemumgehungen zur Verfügung:
  - Wenn keine Dateien vom Typ .pem und .key bereitstehen, stellen Sie sicher, dass die Keystore-Datei vorhanden ist. Der Speicherort der Keystore-Datei befindet sich in der Datei global.properties.
  - Wenn VMware Cloud Director die Keystore-Datei findet, extrahieren Sie die Dateien .pem und .key mithilfe des Dienstprogramms keytool oder des OpenSSL-Tools aus dem Keystore.
  - Wenn VMware Cloud Director die Keystore-Datei nicht findet, konfigurieren Sie die Zertifikate vollständig neu. Weitere Informationen zum Erstellen von Zertifikaten finden Sie unter Erstellen und Verwalten von SSL-Zertifikaten der VMware Cloud Director-Appliance.
  - Wenn auf die Platzhalterzertifikate bezogene Dateien vom Typ .pem und .key vorhanden sind, verwenden Sie den Befehl „certificate“ des Zellenverwaltungstools, um die vorhandenen Zertifikate im Knoten durch die Platzhalterzertifikate zu ersetzen.
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -j --cert /opt/vmware/vcloud-director/data/transfer/user.http.pem --key /opt/vmware/vcloud-director/data/transfer/user.http.key --key-password key_password
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -p --cert /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.pem --key /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.key --key-password key_password
```
Wenn das Upgrade erfolgreich durchgeführt wurde, können Sie den Snapshot der VMware Cloud Director-Appliance löschen.
Wenn das Upgrade nicht erfolgreich ist, können Sie die VMware Cloud Director-Appliance auf den Snapshot zurücksetzen, den Sie vor dem Upgrade erstellt haben. Weitere Informationen finden Sie im Rollback einer VMware Cloud Director-Appliance, wenn ein Upgrade fehlschlägt.