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 del Log Server

April 27, 2026
Grazie al contributo di: 
C C
  1. Scaricare l’immagine del container Docker del Log Server 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 è fortemente raccomandato 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

# Installazione in modalità https con porta 8443 e percorso predefinito
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443

# Installazione in modalità http con porta 8080 e percorso predefinito
./InstallLogServer --port 8080

# Comando per modificare il percorso di configurazione e il percorso dei dati a scelta in modalità https
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443 --config /Path/LogServer/Config --database /Path/LogServer/Data

# Comando per modificare il percorso di configurazione e il percorso dei dati a scelta in modalità http
./InstallLogServer --port 8080 --config /Path/LogServer/Config --database /Path/LogServer/Data
<!--NeedCopy-->

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

# In Linux, verranno generati script .sh

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 il Log Server sia stato avviato correttamente.

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

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

Se il Log Server è 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 del Log Server 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 Log Server.

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

Nota:

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

#Installazione in modalità https con porta 8443 e percorso predefinito
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443

#Installazione in modalità http con porta 8080 e percorso predefinito
InstallLogServer.exe --port 8080
#Comando per modificare il percorso di configurazione e il percorso dei dati a scelta in modalità https
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443 --config C:\LogServer\Config --database C:\LogServer\Data

#Installazione con percorso di configurazione e percorso dei dati specifici
InstallLogServer.exe --port 8080 --config C:\LogServer\Config --database C:\LogServer\Data
<!--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 Log Server.

#In Windows, gli script .bat verranno generati nella stessa directory in cui sono stati salvati i file del programma di installazione.

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

Utilizzare StartLogServer.bat per avviare il Log Server.

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

Quando i log mostrano quanto segue, significa che il Log Server è stato avviato correttamente.

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

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

Se il Log Server è 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 del Log Server in DDC, Storefront, VDA, ecc.
  • Di solito, l’avvio su Windows richiede da 1 a 10 minuti a seconda dell’hardware.

Verificare il Log Server

Aprire il browser sul Log Server 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 la porta predefinita e modificare http in https se installato in modalità HTTPS:

Se la verifica del Log Server 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 reale. Modificare C:\Users\YourUserName\LogServer con il percorso di installazione effettivo se non si utilizza quello predefinito)

Configurazione avanzata del Log Server

Eseguire docker stop logserver per arrestare il Log Server

Per impostazione predefinita, il Log Server è 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 del Log Server Valore predefinito Intervallo di valori Descrizione
MAX_RESERVE_DAYS 7 1~30 Il 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 Il Log Server monitora la percentuale di utilizzo dello spazio di archiviazione dei dati. Se la percentuale di utilizzo supera il 90%, il 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 il 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 al Log Server.

Avviare il Log Server, utilizzando ./StartLogServer.sh su Linux Avviare il Log Server utilizzando StartLogServer.bat su Windows.

Per verificare se le modifiche sono state considerate

Installazione e configurazione del Log Server
April 27, 2026
Grazie al contributo di: 
C C
April 27, 2026
Grazie al contributo di: 
C 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.