Installation von Comarch BI Point Linux

Ahtung: Die folgende beispielhafte Installation wurde auf einer Ubuntu-Distribution ausgeführt. Um die Installation auszulösen, führen Sie das Installation-Skript im Ordner, der mit einem Bild von einem Installer versehen ist, mit dem folgenden Befehl aus:
 sh first-setup.sh
Sollte das Skript von einem Benutzer ohne Adminrechte (root) aktiviert werden, schreiben Sie zum Befehl „sudo“ hinzu (diese Funktionsrechte sind für das Ausführen der Installation erforderlich):
sudo sh first-setup.sh
Nach dem Befehlsaufruf der BI Point-Installer prüft, ob alle erforderlichen Komponenten installiert wurden. Der Installer benötigt das Curl-Webtool. Es ermöglicht das Ausführen von Anfragen und Netzbefehlen. Achtung: Im Falle der andren Distributionen laden Sie einen richtigen Befehl im Zuge der Paketinstallation herunter. Um das Curl-Tool zu installieren, führen Sie den Befehl aus (nachstehend ein beispielhafter Befehl von der Debian- und Ubuntu-Distribution):
sudo apt install curl
Eine Installation besteht aus mehreren Schritten. Wurden die jeweiligen Komponente schon installiert, sie werden vom Skript ausgelassen.
  • Docker
  • Docker – compose
  • Installation von Hilfsskripten
  • Erstellung von docker-compose.yml Datei
  • Installation von BI Point-Image
Im ersten Schritt wird das Docker-Installationsskript gestartet. Als Nächstes wird Docker-compose installiert: Danach werden die Images installiert: Der Benutzer wird angefordert den Pfad zum Paket mit BI Point-Images auf dem Server anzugeben. Geben Sie den Speicherort der Datei mit der .tar.gz Erweiterung an (wenn das Installationsskript aus dem Ordner aufgerufen wurde, wo sich das BI Point-Image befindet [.tar.gz Datei], bestätigen Sie den vorgeschlagenen Pfad mit Enter). Nach der Bestätigung der Installer wird die folgenden Prozesse durchführen:
  • Hochladen von BI Point-Images
Nach dem Hochladen von Images wird es möglich den Schlüsselmanager zusammen mit der BI Point-Installation zu starten. Nach der Bestätigung wird die Schlüsselmanager-Anwendung auf Linux installiert. Achtung: Je Netzwerk ist nur eine Schlüsselmanager-Instanz notwendig. Wenn der Schlüsselmanager mit der BI Point-Lizenz auf einem anderen Server (Windows oder Linux) installiert wurde, kann dieser Schritt ausgelassen werden (stattdessen „n“ einfügen). Im weiteren Schritt der Installation geben Sie die richtigen Parameter (von Server und Schlüsselnummer) an. Wurde der Schlüsselmanager zu docker-compose.yml während des Skriptausführens hinzugefügt, dann fügen Sie den Lizenzschlüssel aus dem Schlüsselmanager-Image nach der ersten Inbetriebnahme aus docker-compose mit dem Manager-Tool hinzu. Vor dem Befehlsaufruf berücksichtigen Sie die Containernamen des Schlüsselmanagers.
  • Lizenzschlüssel hinzufügen
 docker exec -i Containername_MK  manager addkey clientid=<iKundennummer> pin=<pin> key=<Schlüsselnummer>
  • Lizenzschlüssel löschen
docker exec -i Containername_MK    manager deleteinstallation key=12341241234
  • Lizenz freigeben
docker exec -i Containername_MK   manager releaseuser user="<user>"
  Achtung: Der Status ist in einem Browser unter folgender Adresse zu sehen: http://<server>:5150/key/<Schlüsselnummer> - z.B.: http://localhost:5150/key/12341241234 Im nächsten Schritt installieren Sie die Hilfsskripte: Im nächsten Schritt der Benutzer wird angefordert um den Konfigurationsparameter der Anwendung einzufügen. Installationsparameter:
  • BI Point-Anwendungsport,
  • BI Point-Version (Altum BI, CEE BI, Optima6 BI, XL BI, XL BI Start, BI Point Standalone),
  • Lizenz des Schlüsselmanagerservers (abhängig davon, was im Schritt [4] ausgewählt wurde).
  • Lizenzschlüsselnummer
Nach der Angabe von Konfigurationsparameter der Anwendung rufen sie den folgenden Befehl aus:
 sudo docker-compose up -d
Er ist für das Starten von Container und Volumen zuständig. Nach der Containeraktivierung, fängt der Importprozess von Verbindungen, Datenmodellen und Standardberichten an. Nach dem Installationsabschluss kann die BI Point Website in Browser aktiviert werden.  Admin wird als der Standardbenutzer verwendet (Kennwort - admin).

Importstatus prüfen

Um den aktuellen Importstatus von den Standardanwendungsinhalten von BI Point zu prüfen, verifizieren Sie den Namen des entsprechenden Containers mit dem Befehl:
sudo docker ps
Dann rufen Sie das letzte Element des mit dem Befehlt angezeigten Containers an:
 sudo docker logs bipoint_bipoint1 --tail 10
Die oben angezeigte Meldung informiert, dass der Importprozess abgeschlossen wurde.

Aktualisierung von Comarch BI Point Linux

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