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

Markierung: 2017-Quelltext-Bearbeitung
 
(24 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 den ü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\Kunde1\AlexExe\Bfx.Alex.Update.Daemon.exe
   Verzeichnis: D:\BitFactory\Produktiv\AlexExe\Bfx.Alex.Update.Daemon.exe
   Dienstname:  Kunde1AlexExe_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]].
 
== Überprüfung Update Dienst ==
Sollte der Dienst für mehr als 5 Minuten nicht laufen bekommen Benutzer die den ALEX-Client starten einen Warnhinweis angezeigt.


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


== Automatische Aktionen vor der Aktualisierung ==
== Optionale Automatische Aktionen vor der Aktualisierung ==
Automatische ausgeführte Aktionen(Batchdatei) können vor und nach dem Update durchgeführt werden: [[VersionUpgrade_ControlNetworkShare]]
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]].

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.