File di configurazione dell'agente - Gestore di sessioni Amazon DCV

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

File di configurazione dell'agente

Il file di configurazione dell'agente (/etc/dcv-session-manager-agent/agent.confper Linux e macOS e C:\Program Files\NICE\DCVSessionManagerAgent\conf\agent.conf per Windows) include parametri che possono essere configurati per personalizzare la funzionalità di Session Manager. È possibile modificare il file di configurazione utilizzando l'editor di testo preferito.

La tabella seguente elenca i parametri nel file di configurazione dell'agente.

Nome del parametro Richiesto Valore predefinito Description
agent.broker_host Sì Specifica il nome DNS dell'host del broker.
agent.broker_port Sì 8445 Speciifica la porta tramite la quale comunicare con il broker.
agent.ca_file No Necessario solo se tls_strict è impostato su. true Speciifica il percorso del file del certificato (.pem) necessario per convalidare il certificato TLS. Copia il certificato autofirmato dal broker all'agente.
agent.init_folder No

  • /var/lib/dcv-session-manager-agent/init (Linux)

 Speciifica il percorso di una cartella sul server host utilizzata per archiviare gli script personalizzati autorizzati a inizializzare le sessioni del server Amazon DCV al momento della creazione. È necessario specificare un percorso assoluto. La cartella deve essere accessibile e i file devono essere eseguibili dagli utenti che utilizzano il parametro di InitFilerichiesta dell'CreateSessionsAPI.
agent.tls_strict No true Indica se è necessario utilizzare una convalida TLS rigorosa.
agent.software_statement_path No Necessaria solo se non viene utilizzata l'istruzione software predefinita. Speciifica il percorso del file di istruzioni del software. Per ulteriori informazioni, consulta generate-software-statement.
agent.tags_folder No

  • /etc/dcv-session-manager-agent(Linux/macOS)

  • C:\Program Files\NICE\DCVSessionManagerAgent\conf\tags (Windows)

 Speciifica il percorso della cartella in cui si trovano i file dei tag. Per ulteriori informazioni, consulta Utilizzo dei tag per indirizzare i server Amazon DCV.
agent.autorun_folder No

  • /var/lib/dcv-session-manager-agent/autorun (Linux)

  • C:\ProgramData\NICE\DcvSessionManagerAgent\autorun (Windows)

 Speciifica il percorso di una cartella sul server host utilizzata per archiviare script e app che possono essere eseguiti automaticamente all'avvio della sessione. È necessario specificare un percorso assoluto. La cartella deve essere accessibile e i file devono essere eseguibili dagli utenti che utilizzano il parametro di AutorunFilerichiesta dell'CreateSessionsAPI.
agent.max_virtual_sessions No -1 (nessun limite) Il numero massimo di sessioni virtuali che possono essere create su un server Amazon DCV utilizzando Amazon DCV Session Manager.
agent.max_concurrent_sessions_per_user No 1 Il numero massimo di sessioni virtuali che possono essere create su un server Amazon DCV da un singolo utente utilizzando Amazon DCV Session Manager.
agent.broker_update_interval No 30 Speciifica la quantità di secondi di attesa prima di inviare dati aggiornati al broker. I dati inviati includono lo stato del server e dell'host Amazon DCV, oltre a informazioni aggiornate sulla sessione. I valori più bassi rendono il Session Manager più consapevole delle modifiche che avvengono nel sistema su cui viene eseguito l'agente, ma aumentano il carico del sistema e il traffico di rete. Valori più alti riducono il carico del sistema e della rete, ma il Session Manager diventa meno reattivo alle modifiche del sistema, quindi valori superiori a quelli non 120 sono consigliati.
agent.enable_query_logged_in_users No true Abilita la registrazione degli utenti su Windows. Se impostato su true, interroga il sistema per individuare gli utenti effettivamente registrati. Se falso, restituisce «sconosciuto»
agent.preferred_network_interface No Speciifica il nome dell'interfaccia di rete da utilizzare per il rilevamento dell'IP dell'host. Esempi: eth0 (Linux), Ethernet 4 (Windows). Linux/macOS i nomi fanno distinzione tra maiuscole e minuscole, i nomi di Windows non distinguono tra maiuscole e minuscole. Se non viene specificata o se l'interfaccia di rete specificata non viene trovata, viene selezionata la prima interfaccia non loopback.
log.level No info Speciifica il livello di dettaglio dei file di registro. Sono disponibili i seguenti livelli di dettaglio:

  • error—Fornisce il minimo dettaglio. Include solo gli errori.

  • warning—Include errori e avvisi.

  • info—Il livello di verbosità predefinito. Include errori, avvisi e messaggi informativi.

  • debug—Fornisce il maggior numero di dettagli. Fornisce informazioni dettagliate utili per la risoluzione dei problemi.
log.directory No

  • /var/log/dcv-session-manager-agent/(Linux/macOS)

  • C:\ProgramData\NICE\DCVSessionManagerAgent\log (Windows)

 Speciifica la directory in cui creare i file di registro.
log.rotation No daily Speciifica la rotazione del file di registro. I valori validi sono:

  • hourly—I file di registro vengono ruotati ogni ora.

  • daily—I file di registro vengono ruotati giornalmente.
log.max-file-size No 10485760 Quando la dimensione di un file di registro raggiunge la dimensione specificata in byte, viene ruotata. Verrà creato un nuovo file di registro e ulteriori eventi di registro verranno inseriti nel nuovo file.
log.rotate No 9 Il numero massimo di file di registro conservati durante la rotazione. Ogni volta che si verifica una rotazione e viene raggiunto questo numero, il file di registro più vecchio verrà eliminato.