Documentazione dei prodotti
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Visualizza PDF

Installazione e configurazione di Log Server

January 23, 2026
Grazie al contributo di: 
C
  1. Scaricare l’immagine del container Docker del server di log da Citrix downloads.
  2. Posizionare i file scaricati nella stessa directory.
  3. Eseguire il programma di installazione nella directory tramite terminale (Linux) o prompt dei comandi (Windows) e seguire le istruzioni:

Nota:

  • Per una distribuzione sicura, HTTPS è vivamente consigliato in quanto garantisce una comunicazione crittografata tra client e server. L’uso di HTTP è a discrezione del cliente.
  • Assicurarsi che la porta selezionata non sia già in uso.
  • Evitare di utilizzare porte privilegiate (0–1023) in quanto richiedono autorizzazioni a livello di amministratore o di sistema.
  • Verificare che le regole del firewall consentano il traffico sulla porta scelta.
  • Utilizzare un numero di porta all’interno dell’intervallo valido (0–65535), ma evitare le porte comunemente utilizzate dai servizi di sistema per prevenire conflitti.

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

Dopo l’installazione, vengono generati alcuni file script utili:

# In Linux, sh scripts will be generated

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

Utilizzare ./StartLogServer.sh per avviare il server. Controllare il file configpath/weblogs.txt per confermare che LogServer sia stato avviato correttamente.

Se LogServer si avvia correttamente, verrà visualizzato il messaggio seguente nel file weblogs. La porta 5000 viene utilizzata da LogServer internamente nei container Docker con il protocollo http o https selezionato.

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

Se il server di log è stato installato in modalità HTTP, i log di successo dovrebbero mostrare quanto segue:

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

Nota:

  • La porta configurata nella fase di installazione (8080 o 8443 o qualsiasi porta specificata) deve essere utilizzata durante la configurazione dell’URL di LogServer in DDC, Storefront™, VDA, ecc.
  • Di solito, l’avvio su Linux richiede da 30 a 60 secondi.

Installazione su Windows

Passaggio 1: Installare Docker Desktop (potrebbe essere richiesto un abbonamento) per Windows sulla VM del server di log.

Passaggio 2: Eseguire i comandi seguenti per continuare l’installazione.

Nota:

La posizione predefinita delle cartelle Config e Database (Data) è C:\Users\<username>\LogServer. È possibile modificarle con i comandi seguenti:

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

Dopo l’installazione, alcuni file script utili vengono generati nella stessa directory in cui sono stati salvati i file del programma di installazione.

Nota:

È possibile spostare questi file in una posizione diversa. Tuttavia, ricordarsi della nuova posizione, poiché saranno nuovamente richiesti durante la configurazione del server di log.

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

Utilizzare StartLogServer.bat per avviare il server di log.

Controllare il file configpath\weblogs.txt per confermare che LogServer sia stato avviato correttamente.

Quando i log mostrano quanto segue, significa che il server di log è stato avviato correttamente.

Se LogServer si avvia correttamente, verrà visualizzato il messaggio seguente nel file weblogs. La porta 5000 viene utilizzata da LogServer internamente nei container Docker con il protocollo http o https selezionato.

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

Se il server di log è stato installato in modalità HTTP, i log di successo dovrebbero mostrare quanto segue:

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

Nota:

  • La porta configurata nella fase di installazione (8080 o 8443 o qualsiasi porta specificata) deve essere utilizzata durante la configurazione dell’URL di LogServer in DDC, Storefront, VDA, ecc.
  • Di solito, l’avvio su Windows richiede da 1 a 10 minuti, a seconda dell’hardware.

Verificare il server di log

Aprire il browser sul server di log o VDA o DDC, visitare http://YourLogServerFQDN:8080/Ping Nel browser verrà visualizzata una stringa di risposta “Pong UTC:08/19/2025 01:03:29“.

Nota:

Modificare la porta 8080 con la porta configurata se non si utilizza quella predefinita e modificare http in https se installato in modalità HTTPS:

Se la verifica del server di log fallisce, controllare i seguenti log: Eseguire docker logs logserver per controllare i log di Docker. Per Linux - $HOME/LogServer/Config/weblogs.txt (modificare $HOME/LogServer con il percorso di installazione effettivo se non si utilizza quello predefinito)

Per Windows - C:\Users\YourUserName\LogServer\Config\weblogs.txt (Modificare YourUserName con il nome utente effettivo. Modificare C:\Users\YourUserName\LogServer con il percorso di installazione effettivo se non si utilizza quello predefinito)

Configurazione avanzata di Log Server

Eseguire docker stop logserver per arrestare il server di log.

Per impostazione predefinita, il server di log è configurato con i valori seguenti. Per apportare le modifiche, modificare StartLogServer.sh o StartLogServer.bat se installato in Windows.

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

Opzioni di configurazione di LogServer Valore predefinito Intervallo di valori Descrizione
MAX_RESERVE_DAYS 7 1~30 Log Server memorizza le voci di log per un numero massimo di giorni in base al campo TimeStamp. I log inseriti 7 giorni fa verranno eliminati. Controllo ogni 10 minuti.
MAX_DISK_USAGE_PERCENTAGE 90 10~90 Log Server monitora la percentuale di utilizzo dello spazio di archiviazione dati. Se la percentuale di utilizzo supera il 90%, Log Server eliminerà i log più vecchi giorno per giorno fino a quando la percentuale di utilizzo non sarà inferiore al 90%. Controllo ogni 10 minuti.
LOCAL_DOWN_ONLY true true/false Se true, solo la macchina su cui è installato Log Server può accedere alle API /Download/*. Se false, altre macchine con AuthKey possono accedere alle API /Download/*.
OPENSEARCH_JAVA_OPTS “-Xms2G -Xmx2G” 2G ~ MaxMem/2 Configurazioni della memoria di Opensearch. Fornire più memoria se ci sono molte macchine che invierebbero log a Log Server.

Avviare il server di log, utilizzando ./StartLogServer.sh su Linux. Avviare il server di log utilizzando StartLogServer.bat su Windows.

Per verificare se le modifiche sono state applicate

Installazione e configurazione di Log Server
January 23, 2026
Grazie al contributo di: 
C
January 23, 2026
Grazie al contributo di: 
C

In questo articolo

Feedback sito | Your privacy choices footer linkScelte di privacy | Privacy e condizioni legali | Preferenze cookie | Impostazioni di consenso | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.