Bfx.Alex.Update.Daemon: Unterschied zwischen den Versionen

Markierung: 2017-Quelltext-Bearbeitung
 
(26 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
Dieses Programm ermöglicht es dezentrale ALEX-Installationen zu betreiben die automatisch aktualisiert werden.
Dieses Programm ermöglicht es dezentrale ALEX-Installationen zu betreiben die automatisch aktualisiert werden.


== Installation ==
== Dezentrale Installation ==
Zum einrichten des Update Dienstes auf einer dezentralen Installation reicht es aus "Bfx.Alex.Update.Daemon.exe" als Administrator zu starten.
Eine dezentrale Installation ist ein ALEX-Exe Ordner auf einem Rechner ungleich dem ALEX-Server.
Der Dienst wird dann automatisch angelegt und muss nur noch gestartet werden. Der Dienstname wird aus dem übergeordneten Ordnernamen generiert.
 
== Einrichten Bfx.Alex.Update.Daemon ==
Wenn noch keine Kopie von ALEX vorhanden ist kann das AlexEXE-Verzeichnis vom ALEX-Server als Installationsquelle verwendet werden. Wenn eine Installation von einem ZIP-Archiv(z.B.: ALEX_2017_16_0_0_x64.zip) durchgeführt wird ist es erforderlich die Konfigurationsdatei "_.bfx_CONFIG" vor dem Einrichten des Dienstes vom Server ins Zielverzeichnis(selber Ordner wie Bfx.Alex.Update.Daemon.exe) zu kopieren.
 
Zum Einrichten des Update Dienstes auf einer dezentralen Installation reicht es aus "Bfx.Alex.Update.Daemon.exe" als Administrator zu starten.
Der Dienst wird dann automatisch angelegt und gestartet. Der Dienstname wird aus den übergeordneten Ordnernamen generiert.
Die korrekte Ordnerstruktur kann aus angeführtem Beispiel entnommen werden. "
  Beispiel:
  Beispiel:
   Verzeichnis: D:\BitFactory\AlexExeKunde1\Bfx.Alex.Update.Daemon.exe
   Verzeichnis: D:\BitFactory\Produktiv\AlexExe\Bfx.Alex.Update.Daemon.exe
   Dienstname:  AlexExeKunde1_Updater
  Dienstname:  ProduktivAlexExe_Updater
  Verzeichnis: D:\BitFactory\Test\AlexExe\Bfx.Alex.Update.Daemon.exe
   Dienstname:  TestAlexExe_Updater
 
Wichtig: Wenn mehrere Instanzen am selben Server ausgeführt werden dürfen die AlexExe Ordner nicht im selben Verzeichnis liegen.
  '''Negativbeispiel''' welches '''NICHT''' funktionieren würde:
  Installation 1 in: D:\BitFactory\AlexExe\Produktiv\Bfx.Alex.Update.Daemon.exe
  Installation 2 in: D:\BitFactory\AlexExe\Test\Bfx.Alex.Update.Daemon.exe
 
Wichtig: Um dem Daemon Prozess einen Platz für das "ALEX.zip" zur Verfügung zu stellen, muss zumindest <Laufwerk>:\'''BitFactory'''\Alex\Bfx.Alex.Update.Daemon.exe angelegt werden
 
Dem generierten Servicename kann im Configfile ein eindeutiger Postfix angehängt werden:
"updateService" : { "postfix" : "...postfix" }
Dieser darf sich danach nicht mehr ändern!
 
Wenn der Server geändert wurde, muss am Terminalserver der UpdateDaemon neu gestartet werden!
 
Der Dienst prüft minütlich die {{Alex}} Version am Server mit der Version des Clients gegen.
 
== Funktion prüfen ==
<code>Bfx.Alex.Update.Daemon.log</code> prüfen:
<pre>
1 [2023-Nov-17 09:40:39.152645] [0x000013fc] [0x00001c50] [info] ShutdownAction::Reset...
2 [2023-Nov-17 09:40:39.153160] [0x000013fc] [0x00001c50] [info] Starting UpdateService V 2024.1.90.23 (64 bit)
</pre>
So sieht ein erfolgreicher Start aus.
 
Des weiteren muss die Verbindung für den Download der aktuellen Version vom Server geprüft werden.
Dazu reicht es im Browser die CurrentVersion.zip vom Server herunterzuladen: <code>http://<Server-IP>:<WebPort Standard 8080>/CurrentVersion.zip</code>


== Versionsupdate ==
== Versionsupdate ==
Der Dienst kopiert neue Versionen nachdem diese vom Client an den Server übertragen wurden. Der Kopiervorgang dauert mindestens 15 Minuten, daher sollte nach dem einspielen einer Version der "Neustart" mit ausreichendem Abstand festgelegt werden.
Der Dienst kopiert neue Versionen nachdem der Server seine Version gewechselt hat. Der Kopiervorgang dauert mindestens 15 Minuten. Hier gibts Infos zum [[Version_einspielen|Versionsupgrade]].
Hinweis: Beim Updateprozess werden alle ALEX-Clients(unabhängig vom Installationsort) auf dem Computer beendet!


== Überprüfung Update Dienst ==
== Synchronisierung Konfiguration ==
Sollte der Dienst für mehr als 5 Minuten nicht laufen bekommen Benutzer die den ALEX-Client starten einen Warnhinweis angezeigt.
Die Konfigurationsdatei wird minütlich synchronisiert, Änderungen von dieser müssen somit nur am Server erfolgen.


== Synchronisierung Konfiguration ==
== Optionale Automatische Aktionen vor der Aktualisierung ==
Die Konfigurationdatei wird minütlich synchronisiert, Änderungen von dieser müssen somit nur am Server erfolgen.
Automatische ausgeführte Aktionen(Batchdatei) können vor und nach dem Update durchgeführt werden: [[VersionUpgrade_ControlNetworkShare]]


== Automatische Aktionen vor der Aktualisierung ==
= Weiterführende Links =
Nach dem erstmaligem Start des Dienstes ist im AlexEXE Ordner eine Datei "bfx_StopNetworkShare.bat" zu finden.
Generelle Anleitung für die [[Installation]].
In dieser Datei ist der Befehl hinterlegt der vor dem Update alle ALEX-Clients erzwungen beendet.
Sollten andere Aktionen gewünscht sein vor dem Upgrade kann diese Datei beliebig angepasst werden.

Aktuelle Version vom 17. November 2023, 09:48 Uhr

Update Dienst für dezentrale Installation

Dieses Programm ermöglicht es dezentrale ALEX-Installationen zu betreiben die automatisch aktualisiert werden.

Dezentrale Installation

Eine dezentrale Installation ist ein ALEX-Exe Ordner auf einem Rechner ungleich dem ALEX-Server.

Einrichten Bfx.Alex.Update.Daemon

Wenn noch keine Kopie von ALEX vorhanden ist kann das AlexEXE-Verzeichnis vom ALEX-Server als Installationsquelle verwendet werden. Wenn eine Installation von einem ZIP-Archiv(z.B.: ALEX_2017_16_0_0_x64.zip) durchgeführt wird ist es erforderlich die Konfigurationsdatei "_.bfx_CONFIG" vor dem Einrichten des Dienstes vom Server ins Zielverzeichnis(selber Ordner wie Bfx.Alex.Update.Daemon.exe) zu kopieren.

Zum Einrichten des Update Dienstes auf einer dezentralen Installation reicht es aus "Bfx.Alex.Update.Daemon.exe" als Administrator zu starten. Der Dienst wird dann automatisch angelegt und gestartet. Der Dienstname wird aus den übergeordneten Ordnernamen generiert. Die korrekte Ordnerstruktur kann aus angeführtem Beispiel entnommen werden. "

Beispiel:
 Verzeichnis: D:\BitFactory\Produktiv\AlexExe\Bfx.Alex.Update.Daemon.exe
 Dienstname:  ProduktivAlexExe_Updater
 Verzeichnis: D:\BitFactory\Test\AlexExe\Bfx.Alex.Update.Daemon.exe
 Dienstname:  TestAlexExe_Updater
Wichtig: Wenn mehrere Instanzen am selben Server ausgeführt werden dürfen die AlexExe Ordner nicht im selben Verzeichnis liegen.
 Negativbeispiel welches NICHT funktionieren würde:
  Installation 1 in: D:\BitFactory\AlexExe\Produktiv\Bfx.Alex.Update.Daemon.exe
  Installation 2 in: D:\BitFactory\AlexExe\Test\Bfx.Alex.Update.Daemon.exe
Wichtig: Um dem Daemon Prozess einen Platz für das "ALEX.zip" zur Verfügung zu stellen, muss zumindest <Laufwerk>:\BitFactory\Alex\Bfx.Alex.Update.Daemon.exe angelegt werden

Dem generierten Servicename kann im Configfile ein eindeutiger Postfix angehängt werden:

"updateService" : { "postfix" : "...postfix" }

Dieser darf sich danach nicht mehr ändern!

Wenn der Server geändert wurde, muss am Terminalserver der UpdateDaemon neu gestartet werden!

Der Dienst prüft minütlich die Alex® Version am Server mit der Version des Clients gegen.

Funktion prüfen

Bfx.Alex.Update.Daemon.log prüfen:

1 [2023-Nov-17 09:40:39.152645] [0x000013fc] [0x00001c50] [info] ShutdownAction::Reset...
2 [2023-Nov-17 09:40:39.153160] [0x000013fc] [0x00001c50] [info] Starting UpdateService V 2024.1.90.23 (64 bit)

So sieht ein erfolgreicher Start aus.

Des weiteren muss die Verbindung für den Download der aktuellen Version vom Server geprüft werden. Dazu reicht es im Browser die CurrentVersion.zip vom Server herunterzuladen: http://<Server-IP>:<WebPort Standard 8080>/CurrentVersion.zip

Versionsupdate

Der Dienst kopiert neue Versionen nachdem der Server seine Version gewechselt hat. Der Kopiervorgang dauert mindestens 15 Minuten. Hier gibts Infos zum Versionsupgrade.

Synchronisierung Konfiguration

Die Konfigurationsdatei wird minütlich synchronisiert, Änderungen von dieser müssen somit nur am Server erfolgen.

Optionale Automatische Aktionen vor der Aktualisierung

Automatische ausgeführte Aktionen(Batchdatei) können vor und nach dem Update durchgeführt werden: VersionUpgrade_ControlNetworkShare

Weiterführende Links

Generelle Anleitung für die Installation.