Mise à jour vers openQRM 5.1 sur Debian Wheezy

Version 1.0
Dernière modification le 01 octobre 2013
Auteur Matt Rechenburg

Ce HowTo concerne la mise à jour d’un environnement openQRM existant version 4.9 ou 5.0 vers la dernière version openQRM 5.1 sur Debian 7 alias Wheezy.

Exigences

une installation openQRM existante < version 5.1 (par exemple 4.9 ou 5.0)

Sauvegarder votre environnement openQRM existant

Voici une capture d’écran d’une configuration openQRM 5.0 existante et entièrement configurée :

Voici une capture d’écran des détails de version de cette configuration openQRM 5.0

openQRM se compose de “fichiers” et d’une “base de données”. Avoir une sauvegarde des deux parties permet de “revenir en arrière” sur la mise à jour à tout moment.

Tous les fichiers dans openQRM sont situés dans le répertoire de base openQRM (normalement /usr/share/openqrm). Pour créer une simple sauvegarde, veuillez exécuter les commandes suivantes en tant que ‘root’ sur votre serveur openQRM :

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

Pour sauvegarder le contenu de la base de données openQRM (en supposant mysql comme backend de base de données), veuillez exécuter :

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

Cette commande demandera le mot de passe de la base de données openQRM.

Veuillez noter !

À tout moment dans ce howto, vous pouvez revenir à votre environnement openQRM existant en exécutant en tant que ‘root’

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

De plus, openQRM fournit une ‘sauvegarde d’état’ qui capture l’état complet (tous les fichiers de configuration et le contenu des bases de données). Une ‘sauvegarde d’état’ d’openQRM permet également de “revenir en arrière” sur la mise à jour à tout moment. Pour exécuter une sauvegarde d’état, veuillez exécuter :

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

Pour lister toutes les sauvegardes d’état, veuillez exécuter :

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

Pour appliquer/restaurer une sauvegarde d’état, veuillez exécuter par exemple :

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

Voici les commandes à appliquer pour une sauvegarde standard avant une mise à jour :

Mettre à jour openQRM vers la version 5.1

Obtenir la version openQRM 5.1

Ce howto pour mettre à jour un environnement openQRM existant vers openQRM 5.1 fonctionne pour l’édition communautaire openQRM de la même manière que pour l’édition entreprise openQRM.

La procédure de mise à jour pour openQRM 5.1 est simple.

Obtenez l’édition communautaire openQRM 5.1 sur http://sourceforge.net/projects/openqrm/ ou obtenez l’édition entreprise openQRM sur http://www.openqrm-enterprise.com/

En tant que ‘root’, changez de répertoire vers ../src et exécutez :

make && make update

La phase ‘make’ télécharge les nouveaux composants pour la version openQRM 5.1 et prépare la source pour une installation ou une mise à jour. La phase ‘make update’ effectue en fait les actions suivantes pour mettre à jour la configuration openQRM existante :

Comme première étape, la procédure de mise à jour crée une sauvegarde d’état actuelle comme décrit ci-dessus.

Comme deuxième étape, elle crée un répertoire ‘mirror’ /usr/share/openqrm_pre_update. Cela sert à comparer le contenu de tous les fichiers de configuration à une étape ultérieure.

Comme troisième étape, elle exécute l’action d’installation qui écrase ensuite le contenu actuel de /usr/share/openqrm.

Comme quatrième étape, la procédure de mise à jour vérifie tous les fichiers de configuration et applique les valeurs configurées actuelles à la nouvelle installation.

Comme cinquième étape, elle applique éventuellement des mises à jour du schéma de base de données.

Comme dernière étape, elle met à jour les fichiers initrd du noyau (utilisés par le déploiement réseau) et redémarre openQRM

Veuillez noter !

Après la mise à jour, il est nécessaire de redémarrer le ‘openqrm-client’ sur tous les systèmes intégrés !

Uniquement pour l’édition entreprise openQRM (ignorez si vous utilisez l’édition communautaire openQRM)

L’édition entreprise openQRM redirige vers le téléchargement de la licence.

Veuillez sélectionner les clés de licence publiques, serveur et éventuellement clients de l’entreprise et cliquez sur soumettre.

Veuillez noter !

Avec openQRM 5.1, les plugins suivants ont été fusionnés :

citrix + citrix-storage en citrix

kvm + kvm-storage en kvm

xen + xen-storage en xen

Les plugins suivants ont été renommés :

lxc-storage en lxc

openvz-storage en lxc

Pour ces plugins, le répertoire de configuration de la VM a changé de /var/lib/[plugin-name]-storage à /var/lib/[plugin-name]. par exemple, pour le plugin KVM-Storage, il est nécessaire de déplacer le précédent répertoire de configuration de la VM /var/lib/kvm-storage vers /var/lib/kvm. Pour KVM-Storage, veuillez exécuter la commande suivante en tant que ‘root’ pour effectuer la migration du répertoire.

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

La procédure de mise à jour ne le fera pas automatiquement car il est recommandé d’avoir ce répertoire monté depuis un NAS !

Veuillez noter !

Si vous utilisez l’un des plugins ci-dessus, la manière la plus sûre de faire la mise à jour vers 5.1 est d’arrêter et de supprimer tous les appareils et ressources VM (en gardant simplement les images VM), puis de faire la mise à jour. La version 5.1 fournit un moyen facile de récupérer les images dans openQRM. Ensuite, créez simplement de nouvelles ressources VM et ajoutez de nouveaux serveurs avec les images VM existantes.

Voici une capture d’écran de l’interface utilisateur openQRM après la mise à jour réussie vers openQRM 5.1