Available parameters
...
Verfügbare Parameter
Alle ausführbaren Dateien sämtlicher Connect Editionen unterstützen folgende Parameter zur Steuerung der Protokollausgabe:
Parameter | DescriptionBeschreibung |
---|---|
loggingControls the task of logging information. It is possible to specify multiple values separated by comma or semicolon. Currently the following values are supported | Steuert die Aufgabe von Protokollinformationen. Die Angabe mehrerer durch Komma oder Semikolon getrennter Werte ist möglich. Derzeit werden folgende Werte unterstützt: console (or oder c): Output to the consoleAusgabe auf der Konsole debug (or oder d): Output to a debug listenerAusgabe an einen Debug Listener eventlog (or oder e): Output to the Windows event log (only under Ausgabe in das Windows Ereignisprotokoll (nur unter Windows) file (or oder f): Output to a file If this parameter is not specified, logging is done with the mode "console,debug". If the Connect application runs as a Windows Service, the mode "console,debug,eventlog" is used. |
loghost | Only when logging to the Windows event log: If the output is to be to the event log of another host, the name of the desired host can be specified here. Please note that the user running the Connect Launcher must have the appropriate rights to write to the event log of this host. |
logname | Only when logging to the Windows event log: If the output is not to be in the "Application" log, the desired log name can be specified here. The string {ProcessName} is automatically replaced by the name of the logging process. |
logsource | Only when logging to the Windows event log: If a source other than ".NET Runtime" is to be used for output, the desired source name can be specified here. The string {ProcessName} is automatically replaced by the name of the logging process. |
logdir | Only when logging to a file: This parameter specifies the directory where the log files are created. If a fully qualified file name for the log is specified by means of the logfile parameter, the logdir parameter is ignored. It is recommended to always specify this parameter if logging to a file is desired. Otherwise, log files could be written to the program directory if the appropriate permission exists. |
logfile | Only when logging to a file: This parameter specifies the name of the generated log file. If it is a fully qualified file name, the logdir parameter is ignored. If this parameter is not specified, a name is generated from the process name and the UTC timestamp. |
Examples
...
Ausgabe in eine Datei Wird dieser Parameter nicht angegeben, so erfolgt die Protokollierung mit dem Modus “console,debug”. Läuft die Connect Anwendung als Windows Dienst, so wird der Modus “console,debug,eventlog” verwendet. | |
loghost | Nur bei Protokollierung in das Windows Ereignisprotokoll: Soll die Ausgabe in das Ereignisprotokolls eines anderen Hosts erfolgen, so kann hier der Name des gewünschten Hosts spezifiziert werden. Bitte beachten Sie, dass der Benutzer, welche der Connect Launcher ausführt, die entsprechenden Rechte zum Schreiben in das Ereignisprotokolls dieses Hosts besitzen muss. |
logname | Nur bei Protokollierung in das Windows Ereignisprotokoll: Soll die Ausgabe nicht in das Protokoll “Anwendung” erfolgen, so kann hier der gewünschte Protokollname spezifiziert werden. Der String {ProcessName} wird hierbei automatisch durch den Namen des protokollierenden Prozesses ersetzt. |
logsource | Nur bei Protokollierung in das Windows Ereignisprotokoll: Soll für Ausgabe eine andere Quelle als “.NET Runtime” verwendet werden, so kann hier der gewünschte Quellenname spezifiziert werden. Der String {ProcessName} wird hierbei automatisch durch den Namen des protokollierenden Prozesses ersetzt. |
logdir | Nur bei Protokollierung in eine Datei: Dieser Parameter legt das Verzeichnis fest, in dem die Protokolldateien erzeugt werden. Wird mittels des Parameters logfile ein vollqualifizierter Dateiname für das Protokoll festgelegt, so wird der Parameter logdir ignoriert. Es wird empfohlen diesem Parameter immer zu spezifizieren, wenn die Protokollierung in eine Datei gewünscht ist. Andernfalls könnten Protokolldateien in das Programmverzeichnis geschrieben werden, sofern die entsprechende Berechtigung vorhanden ist. |
logfile | Nur bei Protokollierung in eine Datei: Dieser Parameter legt den Namen der erzeugten Protokolldatei fest. Handelt es sich um einen vollqualifizierten Dateinamen, so wird der Parameter logdir ignoriert. Wird dieser Parameter nicht spezifiziert, so wird ein Name aus dem Prozessnamen sowie dem UTC Zeitstempel erzeugt. |
Beispiele
Start eines Connect Servers (Plattform: “windows-x64”) unter Windows mit Protokollausgabe auf der Konsole und in das Ereignisprotokoll:
Code Block | ||
---|---|---|
| ||
.\GalileoGroup.Connect.Server.exe --logging=console,eventlog |
Start of a eines Connect Server Servers (platformPlattform: "portable"“portable”) under Windows with log output to a separate event log named "Connect". The process name is used as the event source. Please note that the corresponding process needs administrator permissions to create the event log as well as the event sources. Alternatively, the event log and event sources can be created manually beforehand using the New-EventLog PowerShell command. Note that to use the portable version, the latest version of .NET 6 must be installedunter Windows mit Protokollausgabe in ein eigenes Ereignisprotokoll mit dem Namen “Connect”. Der Prozessname wir als Ereignisquelle verwendet. Bitte beachten Sie, dass der entsprechende Prozess Administratorberechtigungen benötigt, um das Ereignisprotokoll sowie die Ereignisquellen anzulegen. Alternativ können das Ereignisprotokoll und die Ereignisquellen vorher manuell mit Hilfe des PowerShell-Kommandos New-EventLog angelegt werden. Beachten Sie, dass für die Verwendung der Portable-Version die aktuelle Version von .NET 6 installiert sein muss.
Code Block | ||
---|---|---|
| ||
dotnet .\GalileoGroup.Connect.Server.dll --logging=eventlog --logname="Connect" --logsource="{ProcessName}" |
Start of a eines Connect Server Servers (platformPlattform: linux-x64) under Linux with log output to a file in the directory unter Linux mit Protokollausgabe in eine Datei im Verzeichnis /home/connect/log. The file name of the log is generated from the process name and the UTC timestamp. If a port <1024 is to be used, the start may have to be done with administrator rights (sudo)Der Dateiname des Protokolls wird aus dem Prozessnamen sowie dem UTC Zeitstempel erzeugt. Soll hierbei ein Port <1024 verwendet werden, so muss der Start ggf. mit Administratorrechten (sudo) erfolgen.
Code Block | ||
---|---|---|
| ||
./GalileoGroup.Connect.Server --logging=file --logdir=/home/connect/log |
Start a eines Connect Server Servers (platformPlattform: "portable"“portable”) on Linux with log output to the console. Note that for the use of the portable version the current version of .NET 6 must be installed. If a port <1024 is to be used here, the start may have to be performed with administrator rights (sudo)unter Linux mit Protokollausgabe auf der Konsole. Beachten Sie, dass für die Verwendung der Portable-Version die aktuelle Version von .NET 6 installiert sein muss. Soll hierbei ein Port <1024 verwendet werden, so muss der Start ggf. mit Administratorrechten (sudo) erfolgen.
Code Block | ||
---|---|---|
| ||
dotnet ./GalileoGroup.Connect.Server.dll --logging=console |
...