Installation et configuration du serveur de journaux

1. Téléchargez l’image du conteneur Docker du serveur de journaux depuis Téléchargements Citrix.
2. Placez les fichiers téléchargés dans le même répertoire.
3. Exécutez le programme d’installation dans le répertoire avec le terminal (Linux) ou l’invite de commandes (Windows) et suivez les instructions :

Remarque :

• Pour un déploiement sécurisé, HTTPS est fortement recommandé car il assure une communication chiffrée entre les clients et les serveurs. L’utilisation de HTTP est à la discrétion du client.
• Assurez-vous que le port sélectionné n’est pas déjà utilisé.
• Évitez d’utiliser les ports privilégiés (0–1023) car ils nécessitent des autorisations d’administrateur ou de niveau système.
• Vérifiez que les règles du pare-feu autorisent le trafic sur le port choisi.
• Utilisez un numéro de port dans la plage valide (0-65535), mais évitez les ports couramment utilisés par les services système pour éviter les conflits.

Installation sous Linux

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-->

Après l’installation, certains fichiers de script utiles sont générés :

# In Linux, sh scripts will be generated

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

Utilisez ./StartLogServer.sh pour démarrer le serveur. Vérifiez votre configpath/weblogs.txt pour confirmer que LogServer a démarré avec succès.

Si le LogServer démarre avec succès, vous verrez le message ci-dessous dans le fichier weblogs. Le port 5000 est utilisé par LogServer en interne dans les conteneurs Docker avec le protocole http ou https sélectionné.

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

Si le serveur de journaux a été installé en mode HTTP, les journaux réussis devraient afficher ce qui suit :

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

Remarque :

• Le port configuré à l’étape d’installation (8080 ou 8443 ou tout autre port spécifié) doit être utilisé lors de la configuration de l’URL du LogServer dans DDC, Storefront™, VDA, etc.
• Il faut généralement 30 à 60 secondes pour démarrer sous Linux.

Installation sous Windows

Étape 1 : Installez Docker Desktop (un abonnement peut être requis) pour Windows sur la VM du serveur de journaux.

Étape 2 : Exécutez les commandes ci-dessous pour poursuivre l’installation.

Remarque :

L’emplacement par défaut des dossiers Config et Database (Données) est créé sous C:\Users<username>\LogServer. Vous pouvez les modifier avec les commandes ci-dessous :

#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-->

Après l’installation, quelques fichiers de script utiles sont générés dans le même répertoire où vous avez enregistré les fichiers d’installation.

Remarque :

Vous pouvez déplacer ces fichiers vers un autre emplacement. Cependant, n’oubliez pas le nouvel emplacement, car ils seront à nouveau nécessaires lors de la configuration du serveur de journaux.

#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-->

Utilisez StartLogServer.bat pour démarrer le serveur de journaux.

Vérifiez votre configpath\weblogs.txt pour confirmer que LogServer a démarré avec succès

Lorsque les journaux affichent ce qui suit, cela signifie que le serveur de journaux a démarré avec succès.

Si le LogServer démarre avec succès, vous verrez le message ci-dessous dans le fichier weblogs. Le port 5000 est utilisé par LogServer en interne dans les conteneurs Docker avec le protocole http ou https sélectionné.

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

Si le serveur de journaux a été installé en mode HTTP, les journaux réussis devraient afficher ce qui suit :

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

Remarque :

• Le port configuré lors de l’étape d’installation (8080 ou 8443 ou tout autre port spécifié) doit être utilisé lors de la configuration de l’URL du LogServer dans DDC, Storefront, VDA, etc.
• Généralement, cela prend 1 à 10 minutes en fonction du matériel sous Windows.

Vérifier le serveur de journaux

Ouvrez votre navigateur sur le serveur de journaux, le VDA ou le DDC, et visitez http://YourLogServerFQDN:8080/Ping Une chaîne de réponse « Pong UTC:08/19/2025 01:03:29 » s’affichera dans le navigateur.

Remarque :

Changez le port 8080 par votre port configuré si vous n’utilisez pas le port par défaut, et changez http en https si l’installation a été faite en mode HTTPS :

Si la vérification du serveur de journaux échoue, veuillez vérifier les journaux suivants : Exécutez docker logs logserver pour vérifier les journaux Docker. Pour Linux - $HOME/LogServer/Config/weblogs.txt (remplacez $HOME/LogServer par votre chemin d’installation réel si vous n’utilisez pas celui par défaut)

Pour Windows - C:\Users\YourUserName\LogServer\Config\weblogs.txt (Remplacez YourUserName par le nom d’utilisateur réel. Remplacez C:\Users\YourUserName\LogServer par votre chemin d’installation réel si vous n’utilisez pas celui par défaut)

Configuration avancée du serveur de journaux

Exécutez docker stop logserver pour arrêter le serveur de journaux

Par défaut, le serveur de journaux est configuré avec les valeurs ci-dessous. Pour apporter des modifications, modifiez le StartLogServer.sh ou le StartLogServer.bat s’il est installé sous Windows.

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

Démarrez le serveur de journaux, en utilisant./StartLogServer.sh sur Linux Démarrez le serveur de journaux en utilisant StartLogServer.bat sur Windows.

Pour vérifier si les modifications sont prises en compte