PRODAT PUBLIC

h1. Einrichtung "Prodat lokal starten"

{{toc}}

h2. Config.Servers:

eintragen: (ganz oben als erstes)

<pre><code class="ini">

[RunLocal]

AllowInstall=True 

</code></pre>

!clipboard-202506050914-3ejh7.png!

* Hinweis:

** Die Einstellung @AllowInstall=True@ stammt aus einer älteren Beschreibung.

** Die Aktivierung des Buttons *@Lokal installieren@* erfolgt im aktuellen Ablauf nicht mehr ausschließlich über @AllowInstall@.

** Maßgeblich ist aktuell vor allem, ob PRODAT lokal oder remote gestartet wurde bzw. ob ein Dev-/Debug-Fall vorliegt.

** Die bestehende Dokumentation zu @AllowInstall@ und @ForceAllowInstall@ ist deshalb nur noch eingeschränkt aktuell und sollte als Altverhalten betrachtet werden.

h2. RunLocal

* RunLocal erlaubt aus dem (Prodat) Login-Dialog heraus eine "RunLocal Installation"

** {{collapse(Aufklappen)

!clipboard-202503251606-cwjr4.png!

 

!clipboard-202503251630-0azh4.png!

 

!clipboard-202503251630-k6yt1.png!

 

}} 

** "Hilfe":https://redmine.prodat-sql.de/projects/prodat-v12-public/wiki/105_Prodat_Lokales_Start_Script_(RunLocal)

* AllowInstall:

** Sofern nicht innerhalb einer RDP-Session (Remote-Session)

** Sofern kein C:\ProdatERP existiert

** Sofern AllowInstall= True

** => Aktiviere Button

* ForceAllowInstall:

** Sofern ForceAllowInstall=True, aktiviere Button, egal welche anderen Umständer/Flags gesetzt sind

* Aktueller Hinweis:

** Der Button *@Lokal installieren@* startet technisch @ProdatRunLocal.exe@ mit einem Silent-Install-Parameter.

** Die eigentliche Installation und Aktualisierung erfolgt danach über den bestehenden RunLocal-/Batch-Ablauf.

Sonderfall: zB auf RDP testen:

<pre><code class="ini">

[RunLocal]

AllowInstall=True

--ForceAllowInstall=True

</code></pre>

Herkunft ##16585 *Video* hier in Anhängen: > https://redmine.prodat-sql.de/attachments/23547

h2. Hintergründe

Prodat über VPN oder bei langsamen WLan zu starten, dauert zu lange. Hintergrund ist, dass ~1GB an Bibliotheken geladen werden.

h3. Standard-Installation

* Das Einrichtungs-Setup bietet 2 automatische Einrichtungen mit Standardwerten an

** *Variante 1 Standard* : benutzt die folgenden Werte für die Konfiguration und das lokale Verzeichnis und führt die einzelnen Menu-Optionen des Setup als 'Programm' aus

*** @\\Server\ProdatShare\RunLocal_Setup.bat@ starten und 1 drücken

*** lokales Verzeichnis: *C:\ProdatERP\*

*** Programm: *ProdatERP.exe*

*** Parameter: <keine Parameter>

*** Quelle: Verzeichniss der RunLocal_Setup.bat (ohne \Administration\RunLocal\) welche ausgeführt wird

** Variante 2 BDE : benutzt die folgenden Werte für die Konfiguration und das lokale Verzeichnis und führt die einzelnen Menu-Optionen des Setup als 'Programm' aus

*** @\\Server\ProdatShare\RunLocal_Setup.bat@ starten und 2 drücken

*** lokales Verzeichnis: *C:\ProdatERP\*

*** Programm: *ProdatERP.exe*

*** Parameter: *-REMEMBER_SERVER 1 -L -U "BDE" -M 11 -UniqueName PRODAT-BDE-UNIQUEHANDLE*

*** Quelle: Verzeichniss der RunLocal_Setup.bat (ohne \Administration\RunLocal\) welche ausgeführt wird

* Ausserdem können beide Standard-Installationen ohne Benutzer-Interaktion mittels Parameter ausgeführt werden:

** @\\Server\ProdatShare\RunLocal_Setup.bat SILENT_INSTALL_DEFAULT@

** @\\Server\ProdatShare\RunLocal_Setup.bat SILENT_INSTALL_DEFAULTBDE@

* Die Installation führt dabei eine *Synchronisierung* des lokalen Ordners mit dem Remote(Server)-Ordner aus !!!

** Lokale Dateien und Ordner welche nicht auf der Remote-Seite existieren, werden glöscht

** Nachfolgende Update ziehen nur noch neuere Dateien vom Server

h3. Erläuterung

* Prodat wird aus einem zentralen Verzeichnis im Netzwerk in ein lokales Verzeichnis kopiert

* In diesem lokalen Verzeichnis wird eine Konfigurations-Datei angelegt (..\Administration\RunLocal\SetCfgVariables.bat) welche folgende Werte enthält

** Programm (Default ist ProdatERP.exe)

** Parameter (Default ist -REMEMBER_SERVER:1)

** Quelle (Default ist der Pfad in dem RunLocal_Setup.bat liegt (ohne \Administration\RunLocal\), welches gestartet wird - diese und die anderen zugehörigen reinen Setup-Batch-Scripte sind von der Synchronisierung aussgeschlossen)

** Remote-Pfad als @VarCfg_RemoteDir@

* Desweiteren werden eine Batch für das manuelle Aktualisieren mittels eines Shortcuts auf dem Desktop angelegt (..\Administration\RunLocal\RunLocal_Setup_Shortcut.bat)

* Sowie eine Batch welche mittels der Windows-Aufgabenverwaltung täglich um 23 Uhr gestartet wird - dieses ruft das Batch-Script für den Shortcut auf - Working-Path Problem beim Einrichten von Windows-Tasks mittels SCHTASKS.exe (..\Administration\RunLocal\RunLocal_WinTaskScript.bat)

* ProdatRunLocal.exe, welche das eigentliche Batch-Script startet

** Um zu vermeiden, dass Benutzer in der Lage sind das Batch-Script anzuhalten indem in das Console-Fenster geklickt wird

** !clipboard-202503251641-u5n9c.png!

** !clipboard-202503251641-erjh5.png!

* Beide Batch-Scripte terminieren alle Programm-Instanzen, aktualisieren das lokale Prodat und starten das Programm neu

h3. Updating Mechanics

h4. `CheckAndUpdateProdatRunLocal` in ProdatERP.exe - behavior summary

* Detects whether Prodat is running from the local `C:\` installation or from the remote/location copy by checking `ParamStr(0)`.

* Reads the configured remote directory from `Administration\RunLocal_SetCfgVariables.bat` by parsing `SET VarCfg_RemoteDir=...`.

* Checks whether the remote marker file is accessible by calling `ProdatRunLocal_SafeCheck.exe`.

** If the remote marker cannot be reached, the method stops without updating anything.

** If it can be reached, the marker content is read as Base64 and also decoded for logging/debugging.

* Compares local and remote marker state.

** If the local marker file is missing, the local installation is treated as out of sync.

** If the local marker can be read, it compares:

*** marker file content

*** last-write timestamp

* If local and remote are already in sync, nothing is updated.

* If the local copy is out of sync:

** It first verifies that the configured remote path matches the location from which Prodat was actually started.

** If the paths do not match, it shows a confirmation message and cancels the update.

** If the paths match, it copies the remote `ProdatRunLocal.exe` to the local `ProdatRunLocal.exe` with retry logic.

** After the copy attempt, it starts the local sync binary via `ShellExecute`, using the binary’s own directory as working directory.

* The method is heavily logged at info/error/debug level for:

** execution mode detection

** resolved paths

** remote accessibility

** marker comparison results

** copy success/failure

** final exit

* Ergänzung:

** Für die Update-Entscheidung der lokalen Installation wird @Prodat.INSTALL.MARKER@ verwendet.

** Verglichen werden:

*** Inhalt der Marker-Datei

*** Last-Write-Zeitstempel der Marker-Datei

** Der Marker wird serverseitig erzeugt und in die installierte Struktur übernommen.

h4. `ProdatRunLocal.exe` summary

* On startup it performs its own self-update check via `USelfUpdate.CheckAndPerformUpdate`.

* It compares local and remote `ProdatRunLocal.exe` by:

** file size

** last-write timestamp

* If local and remote are identical, nothing happens.

* If they differ:

** a `_update.exe` variant is written locally

** the updater starts the updated executable with the original command line

** the current process terminates after launching the new one

* There is also a special `_update.exe` startup mode:

** `_update.exe` replaces the original `.exe`

** then relaunches the original executable

* The startup splash screen triggers this update flow before starting the normal RunLocal command/script.

h4. Fallback bei geändertem Serverpfad

* Problem:

** @RunLocal@ speichert den Remote-Pfad lokal in @RunLocal_SetCfgVariables.bat@ als @VarCfg_RemoteDir@.

** Wenn sich dieser Serverpfad später ändert, zeigt die lokale Installation weiterhin auf den alten Pfad.

** Ist dieser alte Pfad nicht mehr erreichbar, kann die normale Marker-Prüfung beim Start nicht mehr ausgeführt werden.

* Lösung:

** Nach erfolgreichem Login kann aus den Einstellungen ein Ersatzpfad gelesen werden:

*** @RunLocal__New_RemoteDir@

** Wenn der bisher gespeicherte @VarCfg_RemoteDir@ nicht erreichbar ist und @RunLocal__New_RemoteDir@ gesetzt sowie erreichbar ist:

*** wird der neue Pfad lokal als neuer @VarCfg_RemoteDir@ gespeichert

*** der Benutzer erhält einen Hinweis

*** PRODAT wird automatisch neu gestartet

*** beim nächsten Start läuft die normale RunLocal-Prüfung wieder über den bestehenden Standardablauf

* Wichtig:

** In derselben Sitzung wird bewusst *keine* zweite Marker-/Update-Prüfung direkt nach dem Login erzwungen.

** Ziel ist, die bestehende Startlogik unverändert weiterzuverwenden.

h4. Automatischer Neustart

* Wenn nach dem Login ein neuer @RunLocal__New_RemoteDir@ übernommen wurde, erhält der Benutzer einen Hinweis.

* Nach Bestätigung wird PRODAT automatisch beendet und über @AutoRestart.exe@ sofort neu gestartet.

* Bei einem sofortigen Neustart mit Parameter @0@ wird kein sichtbares Wartefenster angezeigt.

* Der Neustart wurde außerdem so erweitert, dass das neu gestartete PRODAT-Fenster wieder in den Vordergrund geholt wird.

 

 

h1. Manuelles Setup / Installation

{{collapse(Manuelles Setup)

*Script - welches PRODAT in ein lokales Verzeichnis kopiert und aktuell hält*

* *Auf dem Rechner, auf dem Prodat in Zukunft lokal ausgeführt werden soll, dass Script \\<Server>\<Prodat-Installation\Administration\RunLocal\RunLocal_Setup.bat ausführen.*

**  z.B.: 

*** Pfad zur Prodat-Installation auf dem Server (Remote) ist \\192.168.1.100\Prodat-ERP\

*** Auf dem Rechner dann Eingabeaufforderung starten 

*** \\192.168.1.100\Prodat-ERP\Administration\RunLocal\RunLocal_Setup.bat starten

* Damit wird alles konfiguriert und eingerichtet.

 

 

* RunLocal_Setup bietet ein Menu an

* Die einzelenen Menu-Punkte werden mit einem einzelnen Buchstaben angesteuert, welcher in [] vorweggestellt ist

* Nach Ausführung eines einzelnen Menu-Punktes, wird jeweils wieder das Menu angezeigt

** [S] Setze lokales Verzeichniss für weitere Ops

** [Q] Setze (cfg) Quell-Verzeichniss (Remote-Directory)

** [P] Setze (cfg) Programm

** [A] Setze (cfg) Programm-Paramter

** [Z] Zeige Konfiguration und lokales Verzeichniss

** [M] Schreibe Konfiguration-Datei

** [N] Lade Konfiguration-Datei

** [K] Kopiere Prodat nach lokal (Down-Sync)

** [E] Erstelle Windows-Task (automatisches Update von Lokal)

** [L] Lösche Windows-Task

** [C] Erstelle Shortcut (Prodat Instanzen beenden, Updaten, Starten)

** [D] Lösche Shortcut

** [X] Exit

 

 

* Die einzelnen Schritte

# [S] Geben Sie das lokale Verzeichniss an

#* Muss nach jedem Start von RunLocal_Setup erneut anegegeben werden

#* Prodat wird vom Server (Remote) in dieses Verzeichniss kopiert

#* In diesem Verzeichniss unter \Administration\RunLocal\ wird die Konfigurations-Datei gespeichert als auch weitere Scripts

# [Q] Geben Sie das Quell-Verzeichniss an

#* Wie in dem obigen Beispiel, wäre dies z.B: \\192.168.1.100\Prodat-ERP\

#* Sollten vor Ort statt UNC-Pfaden Laufwerke verwendet werden (z.B. mittels Login-Script verbunden), ist dies natürlich auch möglich (z.B: S:\Prodat-ERP\)

# Menu-Punkt [P] muss normalerweise nicht ausgeführt werden, da das Setup, dass zu startende Programm bereits standardmäßig auf ProdatSQL.exe setzt

#* Grundsätzlich ist es möglich ein anderes Programm anzugeben, welches gestartet/beendet (Task/Manuell) (nach Aktualisierung des lokalen Verzeichnisses) werden soll

# [A] Geben sie die Parameter an, mit denen Prodat gestartet werden soll

#* Der Standardwert ist -REMEMBER_SERVER:1 wird also für die meisten Fälle nicht ausreichend sein

#* Um herauszufinden welche Parameter nötig sind, schauen Sie am besten in die Eigenschaften der Startverknüpfung der bestehenden Prodat-Installation (welche via Server startet)

# [Z] Lassen Sie sich die momentanen Werte der Konfiguration anzeigen, um diese zu kontrollieren

# [M] Wenn Sie die korrekten Konfigurations-Werte angegeben haben, schreiben Sie diese in die lokale Konfigurations-Datei

# Der Menu-Punkt [N] lädt eine Konfigurations-Datei, muss also während der ersten Einrichtung nicht aufgerufen werden

#* Kann nur ausgeführt werden, sofern eine lokale Konfigurations-Datei existiert und das lokale Verzeichniss nach dem Start von RunLocal_Setup.bat angegeben wurde

#* Falls man die Konfigurations-Datei manuell bearbeitet hat z.B.

#* Wenn man das RunLocal_Setup bereits ausgeführt hatte, eine Konfigurations-Datei erstellt wurde und dann RunLocal_Setup erneut startet

# [K] Führt eine Synchronisierung des lokalen Verzeichnisses mit dem Quell-Verzeichniss aus

#* Dies ist eine echte Synchronisierung, d.h. dannach ist der Inhalt des lokalen Ordners EXAKT GLEICH mit dem Inhalt des Quell-Ordners mit Ausnahme der in der \Administration\RunLocal\exclude_default.rcj angegebenen Excludes

#* Unterordner \Administration\RunLocalder enthält zusätzlich die Konfigurations-Datei und nur die Scripte die benötigt werden

#* Die Ordner \Backup, \Temp und \Help werden nicht heruntergeladen (exclude_default.rcj)

#* *.7z und *.zip Dateien werden nicht heruntergeladen (exclude_default.rcj)

#* Sollten im lokalen Verzeichniss Dateien/Verzeichnisse existieren, welche nicht im Quell-Verzeichniss existieren (und welche nicht in exclude_default.rcj als excluded aufgeführt sind), werden diese gelöscht !!!

# [E] Erstellt eine Windows-Task (Windows Aufgabe, taskschd.msc)

#* Da der Arbeitspfad ("Starten in" Parameter in der Task) nicht mittels Kommandozeile gesetzt werden kann, MUSS dies manuell gesetzt werden

#** Entweder Aufgabenverwaltung über Windows-Starmenu starten 

#** oder taskschd.msc starten

#*** "Ausführen" über das Windows-Startmenu wählen und taskschd.msc eingeben

#*** oder über Eingabeaufforderung taskschd.msc starten

#** "Starten in" auf das Verzeichniss setzen, in dem sich das Script welches als Task ausgeführt wird, befindet (Verzeichniss-Teil - ohne den Dateiname - des angegebenen Scriptes einfach kopieren)

#* Diese Task wird täglich um 23 Uhr ausgeführt

#* Die Task führt folgende Schritte aus

#** Fährt ALLE Programm-Instanzen (mittels [P] angegebenes Programm) herunter

#** Aktualisiert das lokale Verzeichniss (Update - keine Synchronisierung, in exclude_default.rcj angegebene Excludes werden berücksichtigt)

#** Startet Programm neu (Programm welches mit [P] Konfiguriert wurde, mit den Paramtern welche mittels [A] konfiguriert wurden)

# Falls es nicht mehr gewünscht wird, dass automatisch das Update-Script ausgeführt wird, kann mit [L] die Windows-Task wieder gelöscht werden

# [C] Erstellt auf dem Desktop einen Shortcut, welcher das Update-Script startet (ALLE Programm-Instanzen beenden, lokales Verzeichniss aktualisieren, Programm starten)

# [D] Löscht den Shortcut vom Desktop

# [X] Beendet RunLocal_Setup (wird automatisch nach 30 Sekunden ohne Benutzer-Aktivität ausgeführt)

}}

h2. Silent Install

* RunLocal_Setup.bat kann mit 2 Parametern gestartet werden, um eine non-user-interaktive Installation eine der beiden Standard-Installationen auszuführen

** @RunLocal_Setup.bat SILENT_INSTALL_DEFAULT@

*** Führt die Batch aus, als ob der Benutzer @1@ im Menu gedrückt hätte und dannach @x@

** @RunLocal_Setup.bat SILENT_INSTALL_DEFAULTBDE@

*** Führt die Batch aus, als ob der Benutzer @2@ im Menu gedrückt hätte und dannach @x@

h3. Automatisierung (Standard 1)

* Mittels @HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce@ kann @\\Server\ProdatShare\Administration\RunLocal\RunLocal_Setup.bat SILENT_INSTALL_DEFAULT@ aufgerufen werden, um auf der Maschine Prodat-RunLocal zu installieren

* Der Shortcut zum starten wird auf dem Desktop des Benutzers angelegt, welcher das Setup tatsächlich ausführt

** Diesen Shortcut @Prodat Lokal - Aktualisieren und neustarten@ entweder auf den öffentlichen Desktop verschieben

** Oder eigenen ShortCut im öffentlichen Desktop erstellen mit Ziel: 'C:\ProdatERP\Administration\RunLocal\ProdatRunLocal.exe'

siehe auch:

https://redmine.prodat-sql.de/projects/prodat-v-x/wiki/Konfiguration_(CONFIGSERVERS)_Start_Parameter_Link#RunLocal

[RunLocal]

AllowInstall=False