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.
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.
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
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
Sollte die automatische Aktualisierung mit dem Skript update.ps1
fehlschlagen, können folgende Schritte zur
Aktualisierung der trax-Installation verwendet werden.
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
...
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!
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
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
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.