RunLocal flow¶

This page documents the two ways RunLocal can be entered and what each side checks or starts.

Remote means the normal network installation of ProdatERP.exe.
Local means the copied installation under C:\ProdatERP\ with Administration\RunLocal beside it.

«The drawio macro is deprecated, use the drawio_attach macro instead»

Short version¶

• The login dialog in the remote ProdatERP.exe has the RunLocal button.
• That button starts ProdatRunLocal.exe from the network installation with SILENT_INSTALL_DEFAULT.
• ProdatRunLocal.exe checks whether it must self-update, then either runs the installer batch or the shortcut/update batch.
• The batch files create or refresh the local copy, the shortcuts, and the scheduled task.
• On later starts, ProdatERP.exe can also verify that the local RunLocal copy is current and, if needed, switch into the local launcher.

Entry points and behavior¶

Side	Launch point	What is checked	What is initiated
Remote	Login dialog button in ProdatERP.exe	Button is enabled only when the app is not already running from a local installation, unless dev/debug mode is active.	Launches ProdatRunLocal.exe with SILENT_INSTALL_DEFAULT.
Remote	Startup path in ProdatERP.exe	Checks whether RunLocal must be updated and whether the remote source is accessible. Compares marker data and the configured remote root.	If needed, copies the current ProdatRunLocal.exe to the local RunLocal folder and starts the local launcher.
Remote or Local	ProdatRunLocal.exe startup	Refuses to run from network/UNC without the silent-install parameter. Performs its own update check against the remote RunLocal copy.	Starts RunLocal_Setup.bat for the initial install, or RunLocal_ShortcutScript.bat for normal use.
Local	RunLocal_Setup.bat	Reads or writes RunLocal_SetCfgVariables.bat, validates directories, and checks Robocopy availability.	Creates the local directory tree, syncs files, creates the task script, and creates shortcuts.
Local	RunLocal_UpdateLocal.bat	Uses Prodat.INSTALL.MARKER and the configured paths to decide the sync mode.	Mirrors remote to local, kills running ProdatERP.exe instances, and optionally starts the local app again.

Remote login button flow¶

1. User is in the remote installation and clicks RunLocal in the login dialog.
2. The login dialog checks whether the current executable is local or remote.
3. If the current executable is remote, the button is enabled and ProdatRunLocal.exe is started with SILENT_INSTALL_DEFAULT.
4. ProdatRunLocal.exe then runs the setup batch and creates or refreshes the local installation.

Startup update flow in ProdatERP.exe¶

1. ProdatERP.exe starts from either the network share or the local copy.
2. The startup code checks whether it is running in the remote or local case.
3. It reads the configured remote root from RunLocal_SetCfgVariables.bat.
4. It checks accessibility with the safe-check helper.
5. It compares Prodat.INSTALL.MARKER content and timestamp between local and remote.
6. If the local copy is outdated and the remote root matches the configuration, it copies the current ProdatRunLocal.exe into the local RunLocal folder.
7. It then launches the local ProdatRunLocal.exe to continue the local flow.

What the batch files do¶

• RunLocal_Setup.bat
  • Writes RunLocal_SetCfgVariables.bat.
  • Creates the local Administration\RunLocal structure.
  • Creates the shortcut helper script and the scheduled-task script.
  • Calls RunLocal_UpdateLocal.bat SYNC to mirror the installation.
  • Creates the desktop shortcut and the local restart/update shortcut.

• RunLocal_UpdateLocal.bat
  • Reads the config file.
  • Validates source and destination paths.
  • Runs Robocopy mirror operations.
  • Uses Prodat.INSTALL.MARKER as a content/timestamp identity marker.
  • Restarts ProdatERP.exe unless DONTSTARTPRODAT was passed.

• RunLocal_Setup_Task.bat
  • Creates or deletes the scheduled task CIMPCS\ProdatERP - Run Lokal - Update.

• RunLocal_Setup_Shortcut.vbs
  • Creates or deletes the .lnk files for the local restart and the desktop entry.

Important files¶

• PRODAT\Application\ProdatRunLocal\280\ProdatRunLocal.dpr
• PRODAT\Application\ProdatRunLocal\USelfUpdate.pas
• PRODAT\Prodat\Prodat-SQL\udbs.pas
• PRODAT\Prodat\Prodat-SQL\UP2005Start.pas
• ExternKomponenten\RUNTIME-Dirs\Administration\RunLocal\RunLocal_Setup.bat
• ExternKomponenten\RUNTIME-Dirs\Administration\RunLocal\RunLocal_UpdateLocal.bat
• ExternKomponenten\RUNTIME-Dirs\Administration\RunLocal\RunLocal_Setup_Task.bat
• ExternKomponenten\RUNTIME-Dirs\Administration\RunLocal\RunLocal_Setup_Shortcut.vbs