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.

  1. To update to a specific version write out the tag completely for example: 2.9.03-stable for the 
    version 2.9.03
  2. 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.

Kopieren Sie die Datei features.yml aus der Email in den Unterordner store/toolbox/config

Öffnen Sie die Datei .env im Hauptverzeichnis mit einem Editor

  • 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

Ö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. Dies dauert mehrere Minuten. Zu den Einstellungen des DNG Servers lesen Sie das Kapitel Configuration im Administrator-Manual.

Update So gehts:

Um ein Update auf eine neue Version des requisis_ReqIF-Managers anzustoßen führen Sie folgende Schritte durch:

Stoppen Sie den Docker-Container "requisis-toolbox-docker_server" zum Beispiel mit dem Befehl docker-compose stop  Dies dauert einen kurzen Augenblick.

Öffnen Sie die Datei .env im Hauptverzeichnis mit einem Editor

In der Zeile REQIF_MANAGER_IMAGE= ändern Sie am Ende nun den Versions Tag hierzu gibt es zwei mögliche Varianten:

  1. 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 Bsp.: /reqif-manager:2.9.03-stable
  2. 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. Bsp.: /reqid-manager:2.9-stable

Speichern Sie die Datei .env

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.