Installieren und Konfigurieren des Log-Servers

1. Laden Sie das Docker-Container-Image des Log-Servers von Citrix Downloads herunter.
2. Legen Sie die heruntergeladenen Dateien im selben Verzeichnis ab.
3. Führen Sie das Installationsprogramm im Verzeichnis mit Terminal (Linux) oder der Eingabeaufforderung (Windows) aus und befolgen Sie die Anweisungen:

Hinweis:

• Für eine sichere Bereitstellung wird HTTPS dringend empfohlen, da es eine verschlüsselte Kommunikation zwischen Clients und Servern gewährleistet. Die Verwendung von HTTP liegt im Ermessen des Kunden.
• Stellen Sie sicher, dass der ausgewählte Port nicht bereits verwendet wird.
• Vermeiden Sie die Verwendung privilegierter Ports (0–1023), da diese Administrator- oder Systemberechtigungen erfordern.
• Überprüfen Sie, ob die Firewall-Regeln den Datenverkehr auf dem gewählten Port zulassen.
• Verwenden Sie eine Portnummer innerhalb des gültigen Bereichs (0–65535), aber vermeiden Sie Ports, die häufig von Systemdiensten verwendet werden, um Konflikte zu verhindern.

Linux-Installation

chmod +x ./InstallLogServer

# Install with https mode with port 8443 with default path
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443

# Install with http mode, with port 8080 with default path
./InstallLogServer --port 8080

# Command to change the config path and data path of your choice with https mode
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443 --config /Path/LogServer/Config --database /Path/LogServer/Data

# Command to change the config path and data path of your choice with http mode
./InstallLogServer --port 8080 --config /Path/LogServer/Config --database /Path/LogServer/Data
<!--NeedCopy-->

Nach der Installation werden einige nützliche Skriptdateien generiert:

# In Linux, sh scripts will be generated

DownloadLogsByTime.sh
DownloadLogsByWords.sh
GetAuthKey.sh
ListMachines.sh
StartLogServer.sh
<!--NeedCopy-->

Verwenden Sie ./StartLogServer.sh, um den Server zu starten. Überprüfen Sie Ihre configpath/weblogs.txt, um zu bestätigen, dass der LogServer erfolgreich gestartet wurde.

Wenn der LogServer erfolgreich startet, wird die folgende Meldung in der weblogs-Datei angezeigt. Port 5000 wird vom LogServer intern in Docker-Containern mit dem ausgewählten HTTP- oder HTTPS-Protokoll verwendet.

Now listening on: https://[::]:5000
<!--NeedCopy-->

Wenn der Log-Server im HTTP-Modus installiert wurde, sollten erfolgreiche Protokolle Folgendes anzeigen:

Now listening on: http://[::]:5000
<!--NeedCopy-->

Hinweis:

• Der im Installationsschritt konfigurierte Port (8080 oder 8443 oder ein beliebiger angegebener Port) sollte bei der Konfiguration der LogServer-URL in DDC, Storefront™, VDA usw. verwendet werden.
• Normalerweise dauert der Start unter Linux 30 bis 60 Sekunden.

Windows-Installation

Schritt 1: Installieren Sie Docker Desktop (Abonnement kann erforderlich sein) für Windows auf der Log-Server-VM.

Schritt 2: Führen Sie die folgenden Befehle aus, um die Installation fortzusetzen.

Hinweis:

Der Standardspeicherort der Ordner Config und Database (Data) wird unter C:\Users<username>\LogServer erstellt. Sie können diese mit den folgenden Befehlen ändern:

#Install with https mode with port 8443 with default path
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443

#Install with http mode, with port 8080 with default path
InstallLogServer.exe --port 8080
#Command to change the config path and data path of your choice with https mode
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443 --config C:\LogServer\Config --database C:\LogServer\Datacmd

#Install with specific config path and data path
InstallLogServer.exe --port 8080 --config C:\LogServer\Config --database C:\LogServer\Datacmd
<!--NeedCopy-->

Nach der Installation werden einige nützliche Skriptdateien in demselben Verzeichnis generiert, in dem Sie die Installationsdateien gespeichert haben.

Hinweis:

Sie können diese Dateien an einen anderen Speicherort verschieben. Merken Sie sich jedoch den neuen Speicherort, da sie bei der Konfiguration des Log Servers erneut benötigt werden.

#In Windows, bat scripts will be generated in the same directory where you saved the installer files.

DownloadLogsByTime.bat
DownloadLogsByWords.bat
GetAuthKey.bat
ListMachines.bat
StartLogServer.bat
<!--NeedCopy-->

Verwenden Sie StartLogServer.bat, um den Log-Server zu starten.

Überprüfen Sie Ihre configpath\weblogs.txt, um zu bestätigen, dass der LogServer erfolgreich gestartet wurde.

Wenn die Protokolle das Folgende anzeigen, bedeutet dies, dass der Log Server erfolgreich gestartet wurde.

Wenn der LogServer erfolgreich startet, sehen Sie die folgende Meldung in der Weblogs-Datei. Port 5000 wird vom LogServer intern in Docker-Containern mit dem ausgewählten HTTP- oder HTTPS-Protokoll verwendet.

Now listening on: https://[::]:5000
<!--NeedCopy-->

Wenn der Log-Server im HTTP-Modus installiert wurde, sollten erfolgreiche Protokolle Folgendes anzeigen:

Now listening on: http://[::]:5000
<!--NeedCopy-->

Hinweis:

• Der im Installationsschritt konfigurierte Port (8080 oder 8443 oder ein beliebiger angegebener Port) sollte bei der Konfiguration der LogServer-URL in DDC, Storefront, VDA usw. verwendet werden.
• Normalerweise dauert es 1 bis 10 Minuten, abhängig von der Hardware unter Windows.

Log-Server überprüfen

Öffnen Sie Ihren Browser auf dem Log-Server, VDA oder DDC und besuchen Sie http://YourLogServerFQDN:8080/Ping Eine Antwortzeichenfolge „Pong UTC:08/19/2025 01:03:29“ wird im Browser angezeigt.

Hinweis:

Ändern Sie Port 8080 in Ihren konfigurierten Port, wenn Sie nicht den Standardport verwenden, und ändern Sie http in https, wenn Sie im HTTPS-Modus installiert haben:

Wenn die Überprüfung des Log-Servers fehlschlägt, überprüfen Sie bitte die folgenden Protokolle: Führen Sie docker logs logserver aus, um Docker-Protokolle zu überprüfen. Für Linux - $HOME/LogServer/Config/weblogs.txt (ändern Sie $HOME/LogServer in Ihren tatsächlichen Installationspfad, wenn Sie nicht den Standardpfad verwenden)

Für Windows – C:\Users\YourUserName\LogServer\Config\weblogs.txt (Ändern Sie YourUserName in den tatsächlichen Benutzernamen. Ändern Sie C:\Users\YourUserName\LogServer in Ihren tatsächlichen Installationspfad, wenn Sie nicht den Standardpfad verwenden)

Erweiterte Konfiguration des Log-Servers

Führen Sie docker stop logserver aus, um den Log-Server zu stoppen

Standardmäßig ist der Log-Server mit den unten stehenden Werten konfiguriert. Um die Änderungen vorzunehmen, bearbeiten Sie die StartLogServer.sh oder StartLogServer.bat, wenn unter Windows installiert.

-e MAX_RESERVE_DAYS=7 -e MAX_DISK_USAGE_PERCENTAGE=90 -e LOCAL_DOWN_ONLY=true -e OPENSEARCH_JAVA_OPTS=”-Xms2G -Xmx2G”

Starten Sie den Log Server unter Linux mit ./StartLogServer.sh Starten Sie den Log Server unter Windows mit StartLogServer.bat.

Um zu überprüfen, ob die Änderungen berücksichtigt werden