Update zu openQRM 5.1 auf Debian Wheezy

Version 1.0
Letzte Bearbeitung 01. Oktober 2013
Autor Matt Rechenburg

Dieses HowTo beschreibt, wie man eine bestehende openQRM-Umgebung der Version 4.9 oder 5.0 auf die neueste openQRM 5.1 auf Debian 7, auch bekannt als Wheezy, aktualisiert.

Anforderungen

eine bestehende openQRM-Installation < Version 5.1 (z.B. 4.9 oder 5.0)

Sichern Sie Ihre bestehende openQRM-Umgebung

Hier ein Screenshot einer bestehenden, vollständig konfigurierten openQRM 5.0-Installation:

Hier ein Screenshot der Versionsdetails dieser openQRM 5.0-Installation

openQRM besteht aus “Dateien” und einer “Datenbank”. Ein Backup beider Teile ermöglicht es, das Update zu jedem Zeitpunkt “rückgängig zu machen”.

Alle Dateien in openQRM befinden sich im openQRM-Basisverzeichnis (normalerweise /usr/share/openqrm). Um ein einfaches Backup zu erstellen, führen Sie bitte die folgenden Befehle als ‘root’ auf Ihrem openQRM-Server aus:

cp -aR /usr/share/openqrm /usr/share/openqrm-5.0.before-update

Um den Inhalt der openQRM-Datenbank zu sichern (unter der Annahme, dass mysql als Datenbank-Backend verwendet wird), führen Sie bitte aus:

mysqldump openqrm -p > /usr/share/openqrm-5.0.before-update/openqrm-db.sql

Dieser Befehl wird nach dem Passwort der openQRM-Datenbank fragen.

Bitte beachten Sie!

Zu jedem Zeitpunkt in diesem HowTo können Sie zu Ihrer bestehenden openQRM-Umgebung zurückkehren, indem Sie als ‘root’ ausführen:

mv /usr/share/openqrm /usr/share/openqrm-update-rolled-back && mv /usr/share/openqrm-5.0.before-update /usr/share/openqrm && /etc/init.d/openqrm restart

Darüber hinaus bietet openQRM ein ‘State-Backup’, das den vollständigen Zustand (alle Konfigurationsdateien und den Inhalt der Datenbanken) erfasst. Ein ‘State-Backup’ von openQRM ermöglicht es ebenfalls, das Update zu jedem Zeitpunkt “rückgängig zu machen”. Um ein State-Backup durchzuführen, führen Sie bitte aus:

/usr/share/openqrm/bin/openqrm state backup -n 5.0.before-update

Um alle State-Backups aufzulisten, führen Sie bitte aus:

/usr/share/openqrm/bin/openqrm state list

Um ein State-Backup anzuwenden/wiederherzustellen, führen Sie z.B. aus:

/usr/share/openqrm/bin/openqrm state restore -n [backup-name]

Hier die Befehle, die für ein Standard-Backup vor einem Update anzuwenden sind:

Update openQRM auf Version 5.1

Holen Sie sich die openQRM 5.1-Version

Dieses HowTo zum Aktualisieren einer bestehenden openQRM-Umgebung auf openQRM 5.1 funktioniert für die openQRM Community Edition genauso wie für die openQRM Enterprise Edition.

Das Updateverfahren für openQRM 5.1 ist unkompliziert.

Holen Sie sich die openQRM 5.1 Community Edition unter http://sourceforge.net/projects/openqrm/ oder die openQRM Enterprise Edition von http://www.openqrm-enterprise.com/

Als ‘root’ wechseln Sie in das ../src-Verzeichnis und führen Sie aus:

make && make update

Die ‘make’-Phase lädt die neuen Komponenten für die openQRM 5.1-Version herunter und bereitet den Quellcode für eine Installation oder ein Update vor. Die ‘make update’-Phase führt tatsächlich die folgenden Aktionen aus, um die bestehende openQRM-Installation zu aktualisieren:

Im ersten Schritt erstellt das Updateverfahren ein aktuelles State-Backup, wie oben beschrieben.

Im zweiten Schritt wird ein ‘Mirror’-Verzeichnis /usr/share/openqrm_pre_update erstellt. Dies dient dazu, den Inhalt aller Konfigurationsdateien in einem späteren Schritt zu vergleichen.

Im dritten Schritt wird die Installationsaktion ausgeführt, die dann den aktuellen Inhalt von /usr/share/openqrm überschreibt.

Im vierten Schritt überprüft das Updateverfahren alle Konfigurationsdateien und wendet die aktuell konfigurierten Werte auf die neue Installation an.

Im fünften Schritt werden gegebenenfalls Datenbankschema-Updates angewendet.

Im letzten Schritt werden die Kernel-Initrd-Dateien (die von der Netzwerkbereitstellung verwendet werden) aktualisiert und openQRM neu gestartet.

Bitte beachten Sie!

Nach dem Update ist es erforderlich, den ‘openqrm-client’ auf allen integrierten Systemen neu zu starten!

Nur für die openQRM Enterprise Edition (überspringen, wenn Sie die openQRM Community Edition verwenden)

Die openQRM Enterprise Edition leitet zum Lizenz-Upload weiter.

Bitte wählen Sie die Enterprise Public-, Server- und gegebenenfalls Client-Lizenzschlüssel aus und klicken Sie auf “Absenden”.

Bitte beachten Sie!

Mit openQRM 5.1 wurden die folgenden Plugins zusammengeführt:

citrix + citrix-storage zu citrix

kvm + kvm-storage zu kvm

xen + xen-storage zu xen

Die folgenden Plugins wurden umbenannt:

lxc-storage zu lxc

openvz-storage zu lxc

Für diese Plugins hat sich das Verzeichnis für die VM-Konfiguration von /var/lib/[plugin-name]-storage zu /var/lib/[plugin-name] geändert. z.B. für das KVM-Storage-Plugin ist es erforderlich, das vorherige VM-Konfigurationsverzeichnis /var/lib/kvm-storage nach /var/lib/kvm zu verschieben. Für KVM-Storage führen Sie bitte den folgenden Befehl als ‘root’ aus, um die Verzeichnismigration durchzuführen.

mv /var/lib/kvm-storage /var/lib/kvm

Das Updateverfahren wird dies nicht automatisch tun, da empfohlen wird, dieses Verzeichnis von einem NAS zu mounten!

Bitte beachten Sie!

Wenn Sie eines der oben genannten Plugins verwenden, ist der sicherste Weg, das Update auf 5.1 durchzuführen, alle Appliances und VM-Ressourcen zu stoppen und zu entfernen (nur die VM-Images zu behalten), und dann das Update durchzuführen. Die Version 5.1 bietet eine einfache Möglichkeit, die Images wieder in openQRM zu bringen. Erstellen Sie dann einfach neue VM-Ressourcen und fügen Sie neue Server mit den vorhandenen VM-Images hinzu.

Hier ein Screenshot der openQRM-Benutzeroberfläche nach dem erfolgreichen Update auf openQRM 5.1