Dans la première étape, remplacez les images BI Point par des images conformes à la version (les fichiers portant le nom bipoint-images-(…)). Après avoir remplacé les images, effectuez la même opération pour le script update-images.sh en le remplaçant dans le dossier du BI Point déjà installé. Vous n’aurez plus besoin des fichiers précédents qui peuvent être supprimés.
Une fois le script et les images BI Point remplacés, lancez la commande suivante :
| sh update-images.sh |
Après avoir lancé le script, le message ci-dessous s’affichera que vous devez valider avec la touche Entrée:
Ensuite, indiquez le chemin des images en version 11.3.1. S’il a été remplacé dans le même dossier où se trouve le script update-images.sh, il faut valider le chemin par défaut avec la touche Entrée.
Après le chargement de différentes images :
Les scripts secondaires seront mis à jour :
Le fichier docker-compose.yml sera aussi mise à jour, conformément à l’information suivante, affichée au cours d’exécution du script de mise à jour :
Dans le cadre de l’étape ci-dessus de mise à jour :
Le numéro de l’image BI Point a été remplacé dans le fichier docker-compose
Dans l’étape suivante, désactivez les conteneurs pour mettre à jour la base. Après avoir lancé la commande docker-compose down, les conteneurs seront supprimés :
| docker-compose down |
Ensuite, supprimez le conteneur ae_db (à l’exécution suivante de la commande docker-compose, le volume total de données sera créé de nouveau en version compatible avec Postgre 12) ; dans le cas décrit, la commande prendra la forme suivante :
La dernière étape consiste à migrer la base de BI Point :
Afin d’effectuer la migration, il faut d’abord supprimer les conteneurs :
| docker-compose -f docker-compose.yml -f docker-compose.migrator.yml down |
Ensuite, on lance uniquement l’image « bipoint_db »
| docker-compose -f docker-compose.yml -f docker-compose.migrator.yml up -d bipoint_db |
On attend que « bipoint_db » soit lancé et qu’il soit en état « healthy » (on vérifie avec docker-compose ps). Ensuite, on lance le conteneur migrateur :
| docker-compose -f docker-compose.yml -f docker-compose.migrator.yml up bipoint_migrator |
Le conteneur de base de données et le conteneur bipoint_migrator qui applique les scripts et les plug-ins de migration sont alors lancés.
Une fois la migration terminée, le conteneur bipoint_migrator sera désactivé. Les conteneurs BI Point peuvent alors être redémarrés à l’aide de la commande suivante :
| docker-compose up -d |
2. Mise à jour manuelle
Avant de commencer la migration, il faut faire une copie de sauvegarde de la base de données. Dans le conteneur, exécutez la commande suivante :
| docker exec -u postgres <nom du conteneur de l’ancienne base> pg_dump -d bipoint > ./dump |
La commande ci-dessus va créer une copie de la base.
Une fois la copie de la base créée, modifiez docker-compose.yml et remplacez les valeurs ci-dessous, conformément à la capture d’écran présentée ci-dessous (une commande exemplaire de l’éditeur de texte) :
| Nano docker-compose.yml |
Après la modification de docker-compose.yml, lancez le script update-images.sh.
| sh update-images.sh |
Une fois le script exécuté, il faut exécuter la commande:
| docker-compose down |
Ensuite, redémarrez uniquement le conteneur de base de données:
| docker-compose up -d bipoint_db |
Ensuite, réalisez les pas suivants:
| echo « drop database bipoint; » | docker exec -i -u postgres <nom du conteneur> psql
echo « create database bipoint; » | docker exec -i -u postgres <nom du conteneur> psql cat ./dump | docker exec -i -u postgres <nom du conteneur> psql -d bipoint |
Après la restauration de la copie à partir du fichier dump, vous pouvez passer à l’étape du migrateur.
Pour effectuer la migration, supprimez en premier lieu les conteneurs :
| docker-compose -f docker-compose.yml -f docker-compose.migrator.yml down |
Ensuite, démarrez uniquement l’image bipoint_db
| docker-compose -f docker-compose.yml -f docker-compose.migrator.yml up -d bipoint_db |
Après avoir démarré l’image bipoint_db (le statut de l’image peut être vérifié à l’aide de la commande docker-compose ps). Si son statut a changé pour healthy, vous pouvez démarrer l’image du migrateur :
| docker-compose -f docker-compose.yml -f docker-compose.migrator.yml up bipoint_migrator |
Suite à la migration correcte, le message suivant est affiché :
La dernière étape consiste à démarrer les conteneurs avec la commande :
| sudo docker-compose up -d |