Installation:
Update How to:
Open the Docker Command Line Interface for the Docker container "requisis-toolbox-docker_server" by clicking on the button CLI.
Change to the directory home/<yourusername>/reqif-manager-int you may need to log in with an appropriate user.
Stop the Docker container with the command docker-compose stop This will take a short moment.
Now you need to edit the .env file. To do this, enter the following command: vi .env This opens the VI Editor with the file. Navigate to the end of the line that starts with REQIF_MANAGER_IMAGE.
If you are not familiar with the VI Editor, search the Internet for "vi cheat sheet".
Now you change the version tag. There are two possible ways to do this.
- To update to a specific version write out the tag completely for example: 2.9.03-stable for the
version 2.9.03 - If you want to have automatic updates for your version use the following tag: 2.9-stable As soon as there is an update to version 2.9.04 you will get it automatically.
The end of the edited line will look like this /reqif-manager:2.9.03-stable resp. /reqif-manager:2.9-stable
Save and close the file and the VI Editor.
Optionally, you can open the startDocker.cmd script to check the used user and password in the docker login line and adjust them if necessary.
Running the startDocker.cmd script will check if you are currently using the latest version configured in your .env file and update it if not. Afterwards, the Docker containers are started up again. This may take some time due to the update. This depends on how many DNG modules are used. As soon as you can see the interface of the Reqif Manager in the browser again, the update is finished.
With the command docker-compose logs -f server you can follow the process of update and migration.
Installation:
Bevor Sie mit der Installation beginnen können benötigen Sie:
- DNG 6.06 oder höher
- eine Docker Installation auf dem System auf dem der requisis_ReqIF Manager installiert werden soll
- eine Email vom Produkt Support mit ihren Lizenz- und Feature-Informationen.
- eine Email vom Produkt Support mit ihren Harbor Accountinformationen
- den Download des initialen requisis_reqif-manager-X.x.zip Paketes / Evaluationspacket
Entpacken Sie das initiale zip-Paket im gewünschten Installtionspfad auf ihrem System. Im Unterordner Administrator-Manual befindet sich eine pdf-Datei mit einer ausführlicheren Installationsanleitung.
Öffnen Sie die Datei .env mit einem Editor wie Notepad++ oder Visual Studio Code etc.
- In der Zeile HARBOR_USER= fügen Sie ihren Harbor Usernamen hinzu. Falls diese Zeile fehlt ergänzen Sie diese am Ende der Datei. Bsp.: HARBOR_USER=robot$meineFirma
- In der Zeile PW= fügen Sie das Passwort des Harbor Users hinzu. Falls diese Zeile fehlt ergänzen Sie diese unter der Zeile HARBOR_USER. Bsp.: PW=<sehrLangeZeichenkette>
Speichern Sie die Datei .env und öffnen Sie die Datei startDocker.cmd
- Fügen Sie die Zeile docker Login ein, mit Username und PW Diese Zeile muss vor dem Docker pull Commands stehen. Bsp.: docker login -u %HARBOR_USER% -p %PW% https://harbor.requisis.com:443
Speichern Sie die Datei startDocker.cmd. Sobald Sie die startDocker.cmd ausführen wird der ReqIF Manger installiert. Zu den Einstellungen des DNG Servers lesen Sie das Kapitel Configuration im Administrator-Manual.
Update So gehts:
Öffnen Sie das Docker Command Line Interface für den Dockercontainer "requisis-toolbox-docker_server" durch Klick auf den Button CLI.
Wechseln Sie in das Verzeichnis home/<IhrBenutzername>/reqif-manager-int evtl. müssen Sie sich mit einem entsprechenden Benutzer anmelden.
Stoppen Sie den Docker-Container mit dem Befehl docker-compose stop Dies dauert einen kurzen Augenblick.
Jetzt muss die Datei .env editiert werden. Dazu geben Sie folgendes Commando ein: vi .env Es öffnet sich der VI Editor mit der Datei. Navigieren Sie an das Ende der Zeile die mit REQIF_MANAGER_IMAGE beginnt.
Falls Sie sich nicht mit dem VI Editor auskennen suchen Sie im Internet nach "vi cheat sheet".
Sie ändern nun den Versions Tag hierzu gibt es zwei mögliche Varianten.
- Um auf eine bestimmte Version upzudaten schreiben Sie den Tag komplett aus zum Beispiel: 2.9.03-stable für die
Version 2.9.03 - Möchten Sie hingegeben automatische Updates für Ihre Version haben benutzen Sie folgenden Tag: 2.9-stable So bald es ein Update auf die Version 2.9.04 gibt werden Sie dieses automatisch erhalten.
Das Ende der editierten Zeile sieht dann so aus /reqif-manager:2.9.03-stable bzw. /reqif-manager:2.9-stable
Speichern und schließen Sie Datei und den VI Editor.
Optional können Sie noch das Skript startDocker.cmd Öffnen um in der Zeile docker login den verwendeten User und Passwort zu überprüfen und ggf. anzupassen.
Durch Ausführen des Skripts startDocker.cmd wird überprüft ob Sie aktuell die neuste bei sich in der .env Datei konfiguriete Version verwenden und updatet diese falls nicht. Im Anschluss werden die Docker Container wieder hochgefahren. Dies kann aufgrund des Updates etwas Zeit in anspruch nehmen. Dies hängt davon ab wieviele DNG Module verwendet werden. So bald Sie das Interface des Reqif Managers wieder im Browser sehen können ist das Update beendet.
Mit dem Kommando docker-compose logs -f server können Sie den Prozess des Updates und Migration verfolgen.