Versions Compared

Key

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

...

Der Connect Launcher ist unter folgendem Pfad zu finden:

Plattform

Pfad

Linux / macOS

[Installationsverzeichnis]/bin/launcher/[Version]/[Plattform]/GalileoGroup.Connect.Launcher

Windows

[Installationsverzeichnis]\bin\launcher\[Version

...

]\[

...

Plattform

...

]\GalileoGroup.Connect.Launcher.exe

Portable / Docker

[Installationsverzeichnis]/bin/launcher/[Version]/[Plattform]/GalileoGroup.Connect.Launcher.dll

(unter Windows muss das Pfadtrennzeichen / durch das Zeichen \ ersetzt werden.)

Der Connect Launcher unterstützt folgen Kommandozeilen-Parameter:

Parameter

Beschreibung

logging

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

console (oder c): Ausgabe auf der Konsole

debug (oder d): Ausgabe an einen Debug Listener

eventlog (oder e): Ausgabe in das Windows Ereignisprotokoll (nur unter Windows)

file (oder 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 Log-Ausgabe 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 Log-Ausgabe 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 Log-Ausgabe 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 Log-Ausgabe 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 Log-Dateien in das Programmverzeichnis geschrieben werden, sofern die entsprechende Berechtigung vorhanden ist.

logfile

Nur bei Log-Ausgabe 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.

config

Spezifiziert den Pfad zur Konfiguration der aktuellen Connect Installation.

host

Definiert den Namen des aktuellen Hosts in der Konfiguration. Der Wert dieses Parameters bestimmt, welche Dienste aus der Konfiguration auf dem aktuellen Host gestartet werden.

logging, loghost, logname, logsource, logdir, logfile

Diese Parameter steuern die Aufgabe von Protokollinformationen. Eine detaillierte beschreibung befindet sich hier: Konfiguration des Ziels für Protokollausgaben (Connect 2022).

startmode

Steuert die Art und Weise, auf die neue Prozesse gestartet werden. Dies hat insbesondere unter Windows Auswirkungen, da sich beim Startmodus “dotnet” alle Prozesse ein Konsolenfenster teilen und beim Startmodus “shell“ jeder Prozess sein eigenes Konsolenfenster bekommt. Folgende Werte werden unterstützt:

dotnet: Start neuer Prozesse mittels des .NET Frameworks

shell: Start neuer Prozesse mit Hilfe der Shell

Wird dieser Parameter nicht angegeben, so wird der Startmodus “dotnet” verwendet. Eine Ausnahme bildet der Start innerhalb eines Debuggers: Hier wird “shell” als Standardwert verwendet.

Beispiel

Startet den Connect Launcher (Plattform: windows-x64) unter Windows. Die Protokollierung erfolgt in Protokolldateien.

Code Block
languagepowershell
.\GalileoGroup.Connect.Launcher.exe --config=..\..\..\..\..\cfg\config.json --host=connect01 --logging=file --logdir=..\..\..\..\..\log