Quelltext der Seite ALEX-Config-File

Ein '''{{Alex}}Config-File''' beinhaltet Informationen die Alex benötigt um:

*Die richtigen Model bzw. UI- Plugins zu laden
*Eine Datenbank im Standalone-Modus zu betreiben
*Eine Datenbank im Client/Server-Modus zu betreiben
*Seinen HTTP-Server zu starten
*Die Server-Logfiles abzulegen
*Den [[ComputationAustria-Reparaturmodus]] durchzuführen
*[[ALEX-Ports]] einzustellen

Beispeilhafte Beschreibung des Inhaltes eines Config-Files :

 { "db" :
   { "connectionInfo" : "C:/TEST.mongo"
   , "backupTime" : "02:30"               //Zeitpunkt der automatischen Mongo-Sicherung und Rotation des Mongo Logfiles(wenn nichts eingetragen -> 03:00) 
   , "backupCopyTo" : "E:/Sicherungen"    //Pfad an dem die Sicherung kopiert wird nachdem diese erstellt wurde
   }
 , "mongo" :
   { "showMongod" : "true"
   , "wiredTigerCacheSizeGB" : "1.0"      //Wired Tiger Hauptspeichergrenze 1.0 GB
   , "minPoolSize": "0"                   //Verbindungen zur Datenbank die gehalten werden wenn sie einmal erzeugt wurden (default = 0 -> deaktiviert) -> https://mongocxx.org/mongocxx-v3/connection-pools/
   , "maxPoolSize": "100"                 //Maximale Anzahl von Verbindungen zur Datenbank (default=100)
   }
 , "modelServer" :
   { "host" : "IP-Adresse"
   , "port" : "4400"
   , "ports" : [ "80", "443" ]           //(ab 2025.21.90.67) zusätzliche Ports auf denen der modelServer lauscht (z.B.: http/LetsEncrypt, https/AlexApp)
   , "dnsName": "NAME.DES.SERVERS"       //Wird für Aktive Benutzer und Generierung von Links(z.B.: Genehmigungsverfahren, Sicherer Login) verwendet anstelle der IP wenn angegeben("adresses->homepage" wird bevorzugt)
   , "leasedDuration" : "120"            //Zeit in Minuten nachdem eine inaktive Session abgemeldet wird - Eine zu lange Dauer kann den Hauptspeicherbedarfs des ALEX-Servers negativ beeinflussen
   , "keepAlive" : "true"                //Windows Client + Stempeluhr halten Verbindung aufrecht(Bessere Performance bei schlechter Verbindungslatenz) - ab v2019.22 möglich
   , "splitDaemons" : "true"             //um ServerDaemons am WebServer in geteilte Prozesse aufzuteilen
   }
 , "certificate" :
   { "directory" : "c:/SSL"              // Angepasster Pfad für [[Verschlüsselung|SSL-Zertifkate("server.crt" + "server.key" + "dh2048.pem")]], Standard Pfad ist "AlexEXE/../../ssl"
   , "letsencrypt" : "true"              // Zertifikat für "dnsName" wird automatisch bezogen, webServer muss auf ports 80/443 laufen!
   }                                     // -> Wenn Zertifikat/Schlüssel vorhanden wird die Kommunikation mit modelServer/webServer/httpServer verschlüsselt abgehandelt
 , "httpServer" :
   { "port" : "4480"
   , "plainSessions" : "true"            // Standard "true", Erlauben/Verbieten von unverschlüsselten Verbindungen bei aktivierter Verschlüsselung
   }
 , "webServer" :
   { "port" : "8080"
   , "sslport" : "4430"
   , "redirecthttp" : "true"
   , "threads" : "20"                    // Anzahl der Threads für WebServer(ohne Angabe Wt Default = 10)
   , "throttleDownloads" : "true"        // Standard: "false" - 10MBit/s Limit für Downloads ein/aus (z.B. CurrentVersion.zip für Updates Stempeluhren/Update Daemon)
   , "enabled" : "true"                  //(ab 2025.21.90.69) Standard: "true" - "false" verhindert laden von Wt-WebServer Daemon (Bfx.Web.UI.Daemon.dll)
   }
 , "adresses" :
   { "homepage" : "https://alex.kunde.org"           // Seite(anstelle von www.bitfactory.at) anpassen die kommt wenn man sich in WebUI abmeldet, wird bevorzugt für Links(z.B.: Genehmigungsverfahren, Sicherer Login) verwendet wenn angegeben
   }
 , "service" :
   { "name" : "TESTService"
   , "dependencies" : "NameVomDBService"      // bei uns am SRVDB könnte man hier z.B. "MSSQL$MSSQL_2008R2" eintragen
   }
 , "computationAustriaModel" :
   { "showAdditionalAmounts":"false"            // ab 2018.21.90.43 ohne Wirkung, alles immer sichtbar
   , "showSpecialAmounts": "false"              // Standard "false" / für KV Tankstelle  (steuerfreie/steuerpflichtige Nachtzulage) "true"
   , "12x" : "125"                              // NICHT mehr setzen in neuen DBs!
   , "useWeeklyRecalculationPeriodSettlement" : // Standard "false" / für KV Tankstelle  (Wochendurchrechnugskonten sichtbar) "true"
   }
 , "webUIFont" :
   { "useVerdana"        : "false" // Standard, true, wenn Kunde mit 'Montserrat' Problem hat
                                   // Dann wird für Navigator, Stammdaten, Menues,... Verdana verwendet. Der Plan wird weiter in Montserrat dargestellt. 
   }
 , "modelPlugins" :
   { "1" : "Model1.dll"
   , "2" : "Model2.dll"
   , "3" : "Model3.dll"
   }
 , "uiPlugins" :
   { "1" : "UI1.dll"
   , "2" : "UI2.dll"
   , "3" : "UI3.dll"
   }
 , "webuiPlugins" :
   { "1" : "WebUI1.dll"
   , "2" : "WebUI2.dll"
   , "3" : "Bfx.Alex.UI.Web.dll"
   }
 , "httpServicePlugins" :
   { "1" : "httpService1.dll"
   , "2" : "httpService2.dll"
   }
 , "architectureuiPlugins" :
  { "1" : "ArchitectureUI.dll"
  }
 , "serverDaemonPlugins" :
   { "1" : "serverDaemon1.dll"
   , "2" : "serverDaemon2.dll"
   , "3" : "serverDaemon3.dll"
   }
 , "serverDaemonHostPlugins" : // Key = Computer-Name des Host-Servers, Value = Array von Plugins
  { "SERVER_DAEMON_HOST1" : [ "serverDaemon1.dll", "serverDaemon2.dll", "serverDaemon3.dll" ] 
  , "SERVER_DAEMON_HOST2" : [ "serverDaemon1.dll", "serverDaemon3.dll" ]
  , "SERVER_DAEMON_HOST3" : [ "serverDaemon2.dll" ]
  }
 , "attendanceRecorderClient" :
   { "noFullscreen" : "false"
   }
 , "qa" : 
   { "tolerance" : "0.05"
   }
 , "freeze" : 
   { "time" : "TT.MM.JJJJ HH:MM" 
   }
 , "logging" : 
   { "awsLogLevel" : "0"          // LogLevel des AWS-SDKs - Off = 0, Fatal = 1, Error = 2, Warn = 3, Info = 4, Debug = 5, Trace = 6
   , "traceLockedObject" : "true" // Wenn sperren eines Objekts nicht möglich ist weil es von anderem Benutzer gesperrt ist wird ein Stacktrace geloggt 
   }// ^^^Standard jeweils false bzw. 0! Wenn true bzw. 5 muss das Programm auf das Verzeichnis schreiben dürfen, wo das config-File liegt!
 , "updateService" : { "postfix" : "...postfix" }
 , "mail" : { "allTo" : "zum.beispiel@irgend.wo" } // wenn gesetzt, werden ALLE Emails via test.bitfactory@gmail.com und smtp.gmail.com auf diese Adresse geschickt (Funktioniert nur wenn in Postausgang - Server irgendwas eingetragen ist)
 , "testSystem" : // Unterscheidung automatisches Upgrade Echt-/Testsystem, siehe [[Automatisches_Upgrade]]
   { "sourceBackupPath" : "D:/BitFactory/Backupverzeichnis" //- Siehe [[Automatische_Aktualisierung_Testsystem]]
   , "autoUpdateDB" : "false/true"
   , "timeUpdateDB" : "01:00" 
   }
 , "debug" :                              //-- Nur nach Absprache mit Technik
   { "dontCatch"                     : "true"   //- Achtung CoRo! Programm bei jedem Fehler abstürzen lassen anstelle einer Fehlermeldung(oder Logeintrags)
   , "dontCatchUnknown"              : "true"   //- Programm bei jedem "unbekannten Fehler" abstürzen lassen anstelle einer Fehlermeldung(oder Logeintrags)
   , "dontCatchWin32"                : "true"   //- Programm bei Win32 Exceptions abstürzen lassen(z.B.: Daemons)
   , "dontUseEMailCrashReport"       : "true"   //- Fehlerbericht via E-Mail unterdrücken und Programm abstürzen lassen
   , "terminateOnExit"               : "true"   //- Lässt Client Abstürzen wenn dieser über BitFactory::Exit() beendet wird
   , "terminateDaemonOnComputingOld" : "true"   //- Lässt Server Daemon Abstürzen wenn dieser SavedComputed Konten zu weit in der Vergangenheit berechnet(>3 Jahre)
   }
 , "wt": //-- Nur nach Absprache mit Technik
    {   "debug"        : "true"   //- Javascript-Exception wird im ChromeDebugger geöffnet. (default == false)
    ,   "timeout"      : "300"    //- Session-Timeout: Zeitspanne in Sekunden nach der eine Wt-Session nach Untätigkeit/Langer Interaktion automatisch abgemeldet wird. Chrome-Tab schließen, Langes "warte auf Server". (default == 300sec == 5min)
    ,   "dailyRestart" : "true"   //- WebUI wird täglich um 03:00 neu gestartet (default == false)
    ,   "logLevel" : "* -info -debug" //- Wt Log Konfiguration anpassen - [https://www.webtoolkit.eu/wt/doc/reference/html/classWt_1_1WLogger.html#a567c5b28fee703e37523898d30016f40 siehe Wt Doc]
    }
 , "windowsDefaultStartPage": 
    {   "useLocal": "true" // Blog wird von AlexEXE Ordner geladen offline
    ,   "hide": "true"     // Blog wird nicht angezeigt...
    }
 , "alexWebUI" :
    { "alexApp" : "true" // Es wird automatisch von /Alex auf /AlexApp umgeleitet für die QML Oberfläche
    , "maxResponseSize" : "10" // --nur Nach Absprache mit Technik
    , "behindReverseProxy" : "false" // wenn Alex über Deploy Path/Port + /ModelServer kommunizieren soll (ab 2025.7.90.48)
    }
 , "alexWinUI" :
    { "alexApp" : "true" // Es wird automatisch von Bfx.Alex.Client(.Signed).exe auf Bfx.Alex.Client(.Signed).QML.exe umgeleitet
    }
 }

'''Besonderheiten:'''

*Wenn ein File exakt '_.bfx_config' heißt und im EXE-Verzeichnis liegt, wird dieses File bei einem Doppelklick auf eine EXE (die ein ConfigFile benötigt) automatisch zum Starten verwendet.
**bedeutet: ConfigFile wird beim Starten dem EXE als erster Kommandozeilen -Parameter übergeben. Das ist gleichbedeutend mit dem Anlegen einer Verknüpfung und spezifizieren des ConfigFiles im 'Ziel-Feld'
*Andere Möglichkeiten für Dateinamen sind: 'xxx.bfx_config_7', 'xxx.bfx_config_7_6', 'xxx.bfx_config_7_6_01'
**Wozu man das braucht? (erklärt dir ein "älterer" Kollege gerne auf Anfrage)
*"db": "connectionInfo":
**Slashes statt Backslashes schreiben
**Pfad darf keine Leerzeichen enthalten
*Kommentare sind nicht erlaubt

===Vorhandene AddOns===

[[Intern:ALEX-Config-File-AddOns|Interne Seite: Vorhandene AddOns]]