Aktualisieren von TTS trax

Updates von trax werden über das Docker Repository, erreichbar per HTTPS unter registry.tts-trax.com, verteilt. Die aktuelle Version ist auf dem trax Dashboard einsehbar.

¶Log-Ausgaben des trax-Containers einsehen

Beim Update auf eine neue Version von TTS trax gibt der Container einige Statusmeldungen in Form von Log-Ausgaben aus. Diese können Sie, sobald der Container gestartet wurde, mit dem folgenden Befehl sowohl unter Linux als auch unter Windows Server einsehen:

$ docker-compose logs -f trax

Durch die Option -f werden fortlaufend die neusten Meldungen ausgegeben. Dieser Modus kann mit der Tastenkombination Strg+C wieder verlassen werden.

¶Aktualisierung auf Linux-Server

Im trax-Verzeichnis befindet sich das Skript update.sh. Falls nicht bereits geschehen, muss das Skript ausführbar gemacht werden:

$ chmod +x ./update.sh

Anschließend kann das Skript ausgeführt werden:

$ ./update.sh [--no-restart] [<version>]

Der optionale Parameter --no-restart verhindert, dass trax nach dem Download automatisch neu gestartet wird. Die Zielversion, auf die aktualisiert werden soll, wird als Argument übergeben. Dies ist nur nötig, wenn auf ein neues Release aktualisiert werden soll. Zur Installation der aktuellen Patches kann dieser Parameter weggelassen werden.

Beispiel um trax auf die Version 2.2 zu aktualisieren und automatisch neu zu starten:

$ ./update.sh 2.2

Wurde der Parameter --no-restart mit angegeben, muss trax nach dem Download des Updates manuell neu gestartet werden.

$ ./restart.sh

¶Aktualisierung auf Windows-Server

Im trax-Verzeichnis befindet sich das Skript update.ps1, welches wie folgt ausgeführt werden kann:

.\update.ps1 [-NoRestart] [<version>]

Der optionale Parameter -NoRestart verhindert, dass trax nach dem Download automatisch neu gestartet wird. Die Zielversion, auf die aktualisiert werden soll, wird als Argument übergeben. Dies ist nur nötig, wenn auf ein neues Release aktualisiert werden soll. Zur Installation der aktuellen Patches kann dieser Parameter weggelassen werden.

Beispiel um trax auf die Version 2.2 zu aktualisieren und automatisch neu zu starten:

.\update.ps1 2.2

Wurde der Parameter -NoRestart mit angegeben, muss trax nach dem Download des Updates manuell neu gestartet werden.

docker-compose up -d --no-deps trax

¶Manuelle Aktualisierung unter Windows-Server

Sollte die automatische Aktualisierung mit dem Skript update.ps1 fehlschlagen, können folgende Schritte zur Aktualisierung der trax-Installation verwendet werden.

¶Neue Version auswählen (nur für Release-Update)

Wenn ein neues Release installiert werden soll, muss diese zunächst in der Datei docker-compose.yml hinterlegt werden.

Von der Verwendung von Notepad zum Bearbeiten dieser Datei wird abgeraten. Es sollte ein Editor verwendet werden, der mit UNIX-Zeilenumbrüchen umgehen kann. Ein solcher Editor, der standardmäßig in einer Windows-Server-Installation vorhanden ist, ist die Powershell ISE.

In folgendem Abschnitt ist die Version, hier am Beispiel eines Updates von Version 2.1 auf Version 2.2, entsprechend von 2.1 auf 2.2 anzuheben:

...
trax:
    image: registry.tts-trax.com/trax-win:2.1
...

...
trax:
    image: registry.tts-trax.com/trax-win:2.2
...

¶Proxy aktivieren (wenn erforderlich)

Sollte der Server nur über einen HTTP-Proxy mit dem Internet kommunizieren können, ist dieser nun zu aktivieren. Folgende Schritte sind in einer privilegierten Powershell auszuführen. Dabei sind <HTTP_PROXY_ADDRESSE> sowie <HTTPS_PROXY_ADDRESSE> durch die Adresse des Proxyservers zu ersetzen.

[System.Environment]::SetEnvironmentVariable("HTTP_PROXY", "<HTTP_PROXY_ADDRESSE>", [EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "<HTTPS_PROXY_ADDRESSE>", [EnvironmentVariableTarget]::Machine)

Restart-Service docker

Der Neustart des Docker-Services ist zwingend erforderlich!

¶Herunterladen des trax-Images

Zum Herunterladen des Docker-Images für die ausgewählte trax-Version ist Folgendes in der privilegierten Powershell auszuführen.

Wird lediglich eine Major und eine Minor-Version in der docker-compose.yml spezifiziert (also bspw. 2.1) so wird automatisch die aktuelle Patch-Version heruntergeladen (z.B. 2.1.5).

docker-compose pull trax

¶Proxy deaktivieren (wenn erforderlich)

Bevor die neue trax-Version aktiviert werden kann, muss zunächst wieder die Proxy-Konfiguration für Docker mit folgenden Befehlen in der privilegierten Powershell entfernt werden:

[System.Environment]::SetEnvironmentVariable("HTTP_PROXY", $null, [EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", $null, [EnvironmentVariableTarget]::Machine)

Restart-Service docker

¶Neue trax-Version starten

Zum Start der aktualisierten trax-Version ist folgender Befehl zu verwenden:

docker-compose up -d --no-deps trax

Damit wird sichergestellt, dass ausschließlich der trax-Container neu gestartet wird. Beim Neustart wird automatisch die aktuellste geladene Version ausgewählt.