Aktualisierung
Der erste Schritt besteht darin, die BI Point-Image-Datei durch neue Dateien zu ersetzen, die der aktuellen Version entsprechen (Dateiname: bipoint-images-(…)). Das gleiche Verfahren sollte dann für das Skript update-images.sh im Verzeichnis des bereits installierten BI Point durchgeführt werden. Die alten Dateien werden nicht mehr benötigt und können gelöscht werden.
Nach dem Ersetzen des Skripts und der BI Point-Bilder ist der folgende Befehl auszuführen:
sh update-images.sh
Nach dem Starten des Skripts erscheint eine Meldung, die mit der Eingabetaste zu bestätigen ist:
Anschließend ist der Bild-Pfad von der Version 11.5 auszuwählen. Wenn der Pfad in demselben Verzeichnis ersetzt wurde, in dem sich das Skript update-images.sh befindet, bestätigen Sie den Standardpfad mit der Eingabetaste.
Nach dem Hochladen der einzelnen Bilder:
werden Hilfsskripte aktualisiert:
Anschließend erfolgt die Aktualisierung von docker-compose.yml. Der Benutzer wird darüber während des Ausführens des Skripts informiert:
In dieser Aktualisierungsphase wird die Nummer des BI Point-Bildes in der Datei docker-compose überschrieben.
docker-compose down
Um die Datenbank zu aktualisieren, sollen in der nächsten Phase Container deaktiviert werden. Nach dem Starten des Befehls docker-compose down werden die Container gelöscht:
In der nächsten Phase ist der Container ae_db zu entfernen (nach dem erneuten Starten des Befehls docker-compose wird die Datenmenge in der mit Postgres 12 kompatiblen Version neu erstellt).
Der letzte Schritt ist die Migration der BI Point-Datenbank:
Zur Durchführung der Migration werden zuerst die Container entfernt:
docker-compose -f docker-compose.yml -f docker-compose.migrator.yml down
Danach wird nur das Image „bipoint_db“ gestartet:
docker-compose -f docker-compose.yml -f docker-compose.migrator.yml up -d bipoint_db
Es wird gewartet, bis „bipoint_db“ startet und den Status healthy erreicht (dies kann mit docker-compose ps überprüft werden). Anschließend wird der Migrator-Container gestartet:
docker-compose -f docker-compose.yml -f docker-compose.migrator.yml up bipoint_migrator
Dann werden der Datenbank-Container und der bipoint_migrator-Container gestartet, welcher die Migrationsskripte und -plugins anwendet.
Nach Abschluss der Migration wird der bipoint_migrator-Container deaktiviert. Danach können die BI Point-Container mit dem Befehl erneut gestartet werden:
docker-compose up -d
Manuelle Aktualisierung
Vor dem Starten der Migration soll eine Sicherungskopie der Datenbank erstellt werden. Für den Container ist der folgende Befehl auszuführen:
docker exec -u postgres <Name des alten Basiscontainers> pg_dump -d bipoint > ./dump
Dadurch wird eine Kopie der Datenbank erstellt.
Im nächsten Schritt soll docker-compose.yml bearbeitet und die folgenden Werte wie nachfolgend abgebildet überschrieben werden (beispielhafter Befehl des Texteditors):
Nano docker-compose.yml
Nach der Änderung von docker-compose.yml ist das Skript update-images.sh auszuführen.
sh update-images.sh
Darauf soll der folgende Befehl ausgeführt werden:
docker-compose down
Anschließend ist nur noch der Datenbank-Container erneut zu starten:
docker-compose up -d bipoint_db
Danach sind folgende Schritte durchzuführen:
echo "drop database bipoint;" | docker exec -i -u postgres <Containername> psql echo "create database bipoint;" | docker exec -i -u postgres <Containername> psql cat ./dump | docker exec -i -u postgres <Containername> psql -d bipoint
Nach dem Wiederherstellen der Kopie aus der dump-Datei kann die Migration gestartet werden.
Zuerst sollen die Container gelöscht werden:
docker-compose -f docker-compose.yml -f docker-compose.migrator.yml down
Darauf wird nur das Image bipoint_db gestartet:
docker-compose -f docker-compose.yml -f docker-compose.migrator.yml up -d bipoint_db
Der Status des Images kann über den Befehl docker-compose ps überprüft werden. Ist der Status healthy, kann der Migrator ausgelöst werden:
docker-compose -f docker-compose.yml -f docker-compose.migrator.yml up bipoint_migrator
Wird die Migration erfolgreich abgeschlossen, erscheint die folgende Meldung:
Im letzten Schritt sind Container mit dem folgenden Befehl zu starten:
sudo docker-compose up -d