Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Verfügbare Parameter

...

Available parameters

All executables of all Connect editions support the following parameters to control log output:

Parameter

BeschreibungDescription

loggingSteuert die Aufgabe von Protokollinformationen. Die Angabe mehrerer durch Komma oder Semikolon getrennter Werte ist möglich. Derzeit werden folgende Werte unterstützt

Controls the task of logging information. It is possible to specify multiple values separated by comma or semicolon. Currently the following values are supported:

console (oder or c): Ausgabe auf der KonsoleOutput to the console

debug (oder or d): Ausgabe an einen Debug ListenerOutput to a debug listener

eventlog (oder or e): Ausgabe in das Windows Ereignisprotokoll (nur unter Output to the Windows event log (only under Windows)

file (oder or f): 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 Diest, 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

...

Output to a file

If this parameter is not specified, logging is done with the mode "console,debug". If the Connect application runs as Windows Diest, 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

Start of a Connect Server (platform: "windows-x64") under Windows with log output to the console and to the event log:

Code Block
languagepowershell
.\GalileoGroup.Connect.Server.exe --logging=console,eventlog

Start eines of a Connect Servers Server (Plattformplatform: “portable”"portable") unter 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 mussunder 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 installed.

Code Block
languagepowershell
dotnet .\GalileoGroup.Connect.Server.dll --logging=eventlog --logname="Connect" --logsource="{ProcessName}"

Start eines of a Connect Servers Server (Plattformplatform: linux-x64) unter Linux mit Protokollausgabe in eine Datei im Verzeichnis under Linux with log output to a file in the directory /home/connect/log. 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) erfolgenThe 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).

Code Block
languagebash
./GalileoGroup.Connect.Server --logging=file --logdir=/home/connect/log

Start eines a Connect Servers Server (Plattformplatform: “portable”"portable") 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) erfolgenon 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).

Code Block
languagebash
dotnet ./GalileoGroup.Connect.Server.dll --logging=console

...