Documentazione dei prodotti
Citrix DaaS™
Visualizza PDF

Cache host locale

May 4, 2026
Grazie al contributo di: 
C C

Questo articolo fornisce una panoramica completa della funzionalità Cache host locale (LHC), concentrandosi sulla sua capacità di mantenere la continuità operativa. Spiega la funzionalità di LHC sia durante le normali operazioni che quando la modalità LHC si attiva. Inoltre, l’articolo offre indicazioni sui controlli di configurazione, la risoluzione dei problemi, i comandi PowerShell per la gestione di LHC e il monitoraggio del registro eventi per la salute di LHC.

Panoramica

LHC mantiene l’accesso degli utenti finali ad app e desktop quando i Cloud Connector perdono la connettività con Citrix Cloud™ a causa di un’interruzione di rete o di un problema con Citrix Cloud. Le sessioni attive non vengono interrotte quando la modalità LHC si attiva e le nuove sessioni vengono mediate tramite il broker LHC in esecuzione sui Cloud Connector.

LHC è abilitato per impostazione predefinita, ma è importante assicurarsi che l’ambiente sia configurato correttamente per LHC. Sebbene le configurazioni errate potrebbero non interrompere la normale mediazione, possono ostacolare le prestazioni di LHC causando interruzioni agli utenti finali quando la modalità LHC è attiva. Per garantire una funzionalità LHC ottimale, controllare il nodo Zone in Studio per errori e avvisi relativi alle zone rilevati da Citrix. Inoltre, consultare la guida Verificare le configurazioni di resilienza e l’articolo Evitare configurazioni errate comuni che possono influire negativamente sulla resilienza di DaaS per un elenco di controllo completo della configurazione LHC.

Importante:

  • LHC si attiva solo se i Cloud Connector ricevono traffico da StoreFront o se la Continuità del servizio è abilitata. Per ulteriori informazioni su come la Continuità del servizio può utilizzare la Cache host locale per mantenere l’accesso degli utenti ad app e desktop durante le interruzioni del servizio, vedere Continuità del servizio.

  • Come funziona

Durante le normali operazioni, il servizio Remote Broker Provider su un Cloud Connector comunica con Citrix Cloud per tutte le operazioni di mediazione. Il servizio Citrix Config Synchronizer (CSS) verifica regolarmente la presenza di modifiche alla configurazione in Citrix Cloud e sincronizza questi dati con il broker LHC sul Cloud Connector. Se i Cloud Connector perdono la connettività con Citrix Cloud o Citrix Cloud sta riscontrando un problema, la modalità LHC si attiva e garantisce l’accesso continuo ad applicazioni e desktop.

Durante la normale operazione di mediazione

  • Durante la normale operazione di mediazione

  • Il servizio Citrix Remote Broker Provider su un Cloud Connector accetta le richieste di connessione da StoreFront. Il servizio Remote Broker Provider comunica con Citrix Cloud per connettere gli utenti ai VDA registrati con Citrix Cloud.
  • Il CSS verifica con il broker Cloud in Citrix Cloud circa ogni 5 minuti per vedere se sono state apportate modifiche alla configurazione. Tali modifiche possono essere avviate dall’amministratore (come la modifica di una proprietà di un gruppo di consegna) o azioni di sistema (come le assegnazioni di macchine).

  • Se si è verificata una modifica alla configurazione dall’ultimo controllo, il CSS sincronizza le informazioni con il broker LHC sul Cloud Connector. (Il broker LHC è anche chiamato servizio di alta disponibilità, o broker HA).

    Tutti i dati di configurazione vengono copiati, non solo gli elementi modificati dall’ultimo controllo. Il CSS importa i dati di configurazione in un database Microsoft SQL Server Express LocalDB sul Cloud Connector. Questo database è chiamato database della Cache host locale. Il CSS garantisce che le informazioni nel database della Cache host locale corrispondano alle informazioni nel database del sito in Citrix Cloud.

    Microsoft SQL Server Express LocalDB (utilizzato dal database LHC) viene installato automaticamente quando si installa un Cloud Connector. Il database LHC non può essere condiviso tra i Cloud Connector. Non è necessario eseguire il backup del database LHC. Viene ricreato ogni volta che viene rilevata una modifica alla configurazione.

  • Se non sono state apportate modifiche dall’ultimo controllo, i dati di configurazione non vengono copiati.

Quando la modalità LHC diventa attiva

  • Quando la modalità LHC diventa attiva

  • Il broker LHC inizia ad ascoltare le informazioni di connessione e a elaborare le richieste di connessione.
  • Quando i Cloud Connector perdono per la prima volta la connettività con Citrix Cloud, il broker LHC non dispone dei dati di registrazione VDA correnti, ma quando un VDA comunica con esso, viene attivato un processo di registrazione. Durante tale processo, il broker LHC ottiene anche le informazioni sulla sessione corrente per quel VDA.

  • Mentre il broker LHC gestisce le connessioni, il servizio Remote Broker Provider continua a monitorare la connessione a Citrix Cloud. Quando la connessione viene ripristinata, il servizio Remote Broker Provider istruisce il broker LHC a smettere di ascoltare le informazioni di connessione e Citrix Cloud riprende le operazioni di mediazione. La prossima volta che un VDA comunica con Citrix Cloud tramite il servizio Remote Broker Provider, viene attivato un processo di registrazione. Il broker LHC rimuove tutte le registrazioni VDA rimanenti da quando la modalità LHC era attiva. Il CSS riprende la sincronizzazione delle informazioni quando apprende che si sono verificate modifiche alla configurazione in Citrix Cloud.

  • Nell’improbabile eventualità che LHC si avvii durante una sincronizzazione, l’importazione corrente viene scartata e viene utilizzata l’ultima configurazione nota.

  • Il registro eventi indica quando si verificano le sincronizzazioni e quando la modalità LHC si attiva.

  • Non è imposto alcun limite di tempo per il funzionamento in modalità LHC.

  • È anche possibile attivare manualmente la modalità LHC. Vedere Forzare la modalità LHC per i dettagli sul perché e come farlo.

Zone con più Cloud Connector

  • Tra le altre attività, il CSS fornisce regolarmente al broker LHC informazioni su tutti i Cloud Connector nella zona. Avendo tali informazioni, ogni broker LHC conosce tutti i broker LHC peer in esecuzione su altri Cloud Connector nella zona.

  • I broker LHC comunicano tra loro su un canale separato. Tali broker utilizzano un elenco alfabetico di nomi FQDN delle macchine su cui sono in esecuzione per determinare (eleggere) quale broker LHC medierà le operazioni nella zona se la zona entra in modalità LHC. Durante la modalità LHC, tutti i VDA si registrano nuovamente con il broker LHC eletto. I broker LHC non eletti nella zona rifiutano attivamente le richieste di connessione in entrata e di registrazione VDA.

  • Importante:

  • I connettori all’interno di una zona devono essere in grado di raggiungersi reciprocamente all’indirizzo http://<FQDN_OF_PEER_CONNECTOR>:80/Citrix/CdsController/ISecondaryBrokerElection. Se i connettori non riescono a comunicare a questo indirizzo, potrebbero essere eletti più broker e potrebbero verificarsi errori di avvio in modalità LHC.

Durante la modalità LHC, se un Cloud Connector viene riavviato o il broker LHC si guasta:

  • Se quel Cloud Connector non è il broker LHC eletto, il riavvio non ha alcun impatto.
  • Se quel Cloud Connector è il broker LHC eletto, viene eletto il broker LHC sul Cloud Connector successivo, causando la registrazione dei VDA. L’ordine di elezione si basa sull’ordine alfabetico del FQDN dei Cloud Connector. Una volta che il broker LHC torna attivo, le operazioni LHC continuano sul primo connettore in ordine alfabetico, il che può causare una nuova registrazione dei VDA. In questo scenario, le prestazioni possono essere influenzate durante le registrazioni.

Vedere registri eventi per ulteriori informazioni sugli eventi relativi alle elezioni del broker LHC.

Contenuto dei dati della cache host locale

Il database LHC include i seguenti dati, che sono un sottoinsieme dei dati presenti nel database principale:

  • Identità degli utenti e dei gruppi a cui sono assegnati i diritti alle risorse pubblicate dal sito.
  • Identità degli utenti che stanno attualmente utilizzando, o che hanno recentemente utilizzato, risorse pubblicate dal sito.
  • Identità delle macchine VDA (incluse le macchine Remote PC Access) configurate nel sito.
  • Identità (nomi e indirizzi IP) delle macchine client dell’app Citrix Workspace™ attivamente utilizzate per connettersi alle risorse pubblicate.

Contiene inoltre le seguenti informazioni per le connessioni attualmente attive stabilite in modalità LHC:

  • Risultati di qualsiasi analisi degli endpoint delle macchine client eseguita dall’app Citrix Workspace.
  • Identità delle macchine dell’infrastruttura (come i server Citrix Gateway e StoreFront) coinvolte nel sito.
  • Date, orari e tipi di attività recenti degli utenti

Stati della cache host locale

Esistono diversi stati durante l’intero ciclo di ingresso e uscita dalla modalità LHC. Il seguente diagramma descrive gli stati per l’ingresso e l’uscita dalla modalità LHC.

Stati LHC

  • Durante lo stato Funzionamento normale, tutti i componenti sono integri e tutte le transazioni di brokering sono gestite dal broker Cloud. - - Il CSS replica attivamente le configurazioni dal broker Cloud ai Cloud Connector. Se un controllo di integrità fallisce, i Cloud Connector passano allo stato HA in sospeso. In questo stato, viene avviato un controllo di integrità completo per determinare la successiva linea d’azione. I connettori interagiscono con altri connettori nella zona per determinarne lo stato di integrità.
    • La decisione di passare da HA in sospeso a HA iniziale si basa sullo stato di integrità di tutti i connettori in una data zona. Se i controlli di integrità hanno esito positivo, i connettori/controller tornano allo stato Funzionamento normale. In alternativa, se i controlli di integrità continuano a fallire, i connettori/controller passano allo stato HA iniziale.
    • Durante lo stato HA iniziale, il broker LHC sul connettore eletto assume le responsabilità di brokering. Tutti i VDA nella zona corrente che erano stati registrati in precedenza si registreranno ora con il broker LHC sul Cloud Connector. Possono essere necessari fino a 5 minuti affinché tutti i VDA si registrino nuovamente con il servizio HA. Al termine di HA iniziale, vengono avviati i controlli di integrità. Se tutti i controlli di integrità hanno esito positivo, lo stato passa a Ripristino in sospeso, altrimenti lo stato passa a HA esteso.
  • I controlli di integrità continuano a verificarsi durante il periodo di HA esteso. Quando i controlli di integrità hanno esito positivo durante l’HA esteso, lo stato passa a Ripristino in sospeso. Non esiste una durata massima per un connettore per rimanere nello stato di HA esteso.
  • Ripristino in sospeso funge da periodo cuscinetto per garantire che i servizi siano completamente integri prima di uscire dalla modalità LHC. Se uno qualsiasi dei controlli di integrità fallisce durante il Ripristino in sospeso, lo stato torna a HA esteso.
  • Se tutti i controlli di integrità hanno esito positivo durante l’intero periodo di 10 minuti di Ripristino in sospeso, lo stato passa a Funzionamento normale. Con questa transizione, la modalità LHC termina e tutti i VDA nella zona che erano registrati con il broker LHC si registrano ora nuovamente con il broker Cloud. Questa nuova registrazione può richiedere nuovamente fino a 5 minuti.

Considerazioni importanti durante la modalità LHC

Durante la modalità LHC, considerare i seguenti impatti:

Aspetto Impatto durante la modalità LHC
Accesso a Studio Potrebbe essere inaccessibile, a seconda della natura dell’interruzione. I VDA nelle zone che operano in modalità LHC vengono visualizzati come Non registrati in Studio perché sono registrati con il broker LHC.
Accesso all’SDK PowerShell remoto


Accesso limitato.
Impostare l’autenticazione SDK: Eseguire Get-XDAuthentication -ProfileName WindowsCurrentUser per impedire al proxy SDK di reindirizzare le chiamate cmdlet. Dopo aver apportato queste modifiche, è possibile utilizzare tutti i cmdlet Get-Broker.
Nota: Includere il parametro -AdminAddress localhost:89 nella chiamata cmdlet iniziale.
Esempio: Get-BrokerMachine -AdminAddress localhost:89
Dati di monitoraggio Le funzioni di monitoraggio non mostrano attività da quando la modalità LHC è attiva. Un sottoinsieme dei dati di monitoraggio è disponibile nella dashboard della cache host locale della pagina tendenze in Monitor.
Credenziali hypervisor Non possono essere ottenute dal servizio host. Macchine in uno stato di alimentazione sconosciuto, nessuna operazione di alimentazione possibile. VM accese utilizzabili per le connessioni.
Macchine assegnate Utilizzabili solo se assegnate durante le normali operazioni. Nuove assegnazioni sono impossibili in modalità LHC.
Macchine Remote PC Access Registrazione e configurazione automatiche non supportate. Le macchine registrate e configurate durante il normale funzionamento sono utilizzabili.
Limiti di sessione per applicazioni e desktop ospitati su server Gli utenti potrebbero utilizzare più sessioni rispetto ai limiti di sessione configurati, se le risorse si trovano in zone diverse.
Comportamento della zona Ogni zona agisce in modo indipendente. Se la funzionalità controllo di integrità avanzato di StoreFront è abilitata, StoreFront è in grado di instradare le richieste di avvio alla zona appropriata durante la modalità LHC ed evitare errori di avvio della sessione.
Riavvi VDA pianificati Se la modalità LHC si attiva prima dell’inizio di un riavvio pianificato per i VDA in un gruppo di consegna, i riavvii iniziano quando la modalità LHC termina e le normali operazioni di brokering riprendono, causando potenzialmente riavvii imprevisti quando la zona esce dalla modalità LHC. Per ulteriori informazioni e configurazioni che possono alterare questo comportamento, vedere Riavvi pianificati ritardati a causa di un’interruzione del database.
Preferenza di zona Le configurazioni di preferenza di zona non vengono considerate per l’avvio della sessione.
Restrizioni tag Per i gruppi di consegna con VDA in più zone, le restrizioni tag possono causare errori di avvio se i VDA con tag non sono presenti in tutte le zone.

Nota:

    • L’uso di $XDSDKAuth per l’autenticazione SDK è deprecato a partire da giugno 2025. Per i dettagli, vedere Deprecazione.

Supporto per applicazioni e desktop

LHC supporta i seguenti tipi di VDA e modelli di consegna:

|Tipo di VDA|Modello di consegna|Disponibilità VDA durante la modalità LHC| |—|—|—|

  • SO multi-sessione Applicazioni e desktop Sempre disponibile.
    • SO single-sessione statico (assegnato) Desktop Sempre disponibile.
    • SO single-sessione gestito dall’alimentazione casuale (in pool) Desktop Disponibile per una sola sessione per impostazione predefinita.
    • ^^ ^^ ^^ È possibile configurarli in modo che siano sempre disponibili per nuove sessioni durante LHC. Per maggiori informazioni, vedere Abilitare l’uso di Studio e Abilitare l’uso di PowerShell.
    • ^^ ^^ ^^ Importante: L’abilitazione dell’accesso a macchine pooled a sessione singola con gestione dell’alimentazione può causare la presenza di dati e modifiche delle sessioni utente precedenti nelle sessioni successive.

Nota:

L’abilitazione dell’accesso ai VDA desktop con gestione dell’alimentazione nei gruppi di consegna pooled non influisce sul funzionamento della proprietà configurata ShutdownDesktopsAfterUse durante le normali operazioni. Quando l’accesso a questi desktop durante LHC è abilitato, i VDA non si riavviano automaticamente dopo il ritorno alle normali operazioni di brokering. I VDA desktop con gestione dell’alimentazione nei gruppi di consegna pooled possono conservare i dati delle sessioni precedenti fino al riavvio dei VDA. Un riavvio del VDA può verificarsi quando un utente si disconnette dal VDA durante operazioni non-LHC o quando gli amministratori riavviano il VDA.

Abilitare LHC per VDA pooled di OS a sessione singola con gestione dell’alimentazione tramite Studio

Tramite Studio, è possibile rendere tali macchine disponibili per nuove connessioni durante la modalità LHC su base per gruppo di consegna:

Nota:

Questa impostazione è disponibile in Studio solo per i gruppi di consegna di desktop in pool che distribuiscono VDA con gestione energetica.

Abilitare LHC per VDA in pool con SO a sessione singola e gestione energetica tramite PowerShell

Per abilitare LHC per i VDA in un gruppo di consegna specifico, seguire questi passaggi:

  1. Abilitare questa funzionalità a livello di sito eseguendo questo comando:

    
Set-BrokerSite -ReuseMachinesWithoutShutdownInOutageAllowed $true

<!--NeedCopy-->

  2. Abilitare LHC per un gruppo di consegna eseguendo questo comando con il nome del gruppo di consegna specificato:

    
Set-BrokerDesktopGroup -Name "name" -ReuseMachinesWithoutShutdownInOutage $true

<!--NeedCopy-->

Per modificare la disponibilità LHC predefinita per i gruppi di consegna in pool di nuova creazione con VDA con gestione energetica, eseguire il comando seguente:


Set-BrokerSite -DefaultReuseMachinesWithoutShutdownInOutage $true

<!--NeedCopy-->

Nota:

La modifica dell’impostazione predefinita non modifica l’impostazione per i gruppi di consegna esistenti e influisce solo sui gruppi di consegna creati tramite PowerShell.

Configurazione di StoreFront

  • Se si utilizza una distribuzione StoreFront locale, esaminare quanto segue:

  • Se si utilizza un server virtuale di bilanciamento del carico, configurare il server virtuale per monitorare i connettori in base alle capacità di brokering (ad esempio, utilizzare il monitor CITRIX-XD-DDC integrato su un NetScaler® per il bilanciamento del carico del connettore).
  • Includere tutti i Cloud Connector all’interno di un singolo tenant Cloud come un unico feed di risorse in StoreFront.
  • Visualizzare le configurazioni di NetScaler Gateway in StoreFront e assicurarsi che tutti i connettori siano elencati come server STA. Esaminare gli appliance NetScaler e assicurarsi che tutti gli STA elencati in StoreFront siano nello stesso formato nel server virtuale NetScaler Gateway. Lo stato del servizio STA può essere monitorato anche nel server virtuale Gateway.
  • Aggiungere tutti i connettori al feed di risorse in StoreFront e assicurarsi che StoreFront possa comunicare con tutti i Cloud Connector sulla porta designata nel feed di risorse.

Nota:

Per i clienti con molti connettori, potrebbe essere utile configurare un server virtuale di bilanciamento del carico per ogni zona per ridurre il sovraccarico di gestione e semplificare la risoluzione dei problemi. Per ulteriori informazioni, consultare Citrix TIPs: Integrating Citrix Virtual Apps and Desktops service and StoreFront.

  • Convalidare il funzionamento della cache host locale

    • Per verificare che LHC sia configurato e funzioni correttamente:

    • Assicurarsi che le importazioni di sincronizzazione vengano completate correttamente. Controllare i registri eventi per ulteriori informazioni su come monitorare le sincronizzazioni LHC.
    • Assicurarsi che il database della cache host locale sia stato creato su ogni Cloud Connector. Ciò conferma che il servizio di alta disponibilità può subentrare, se necessario.
    • Sul server Cloud Connector, passare a c:\Windows\ServiceProfiles\NetworkService.
    • Verificare che HaDatabaseName.mdf e HaDatabaseName_log.ldf siano stati creati.
  • Forzare la modalità LHC su tutti i Cloud Connector nella zona: Dopo aver verificato che la cache host locale funziona, ricordarsi di riportare tutti i Cloud Connector in modalità normale. Vedere Stati della cache host locale per ulteriori informazioni sul tempo necessario per uscire dalla modalità LHC.

Monitorare la cache host locale

Registri eventi

I registri eventi forniscono informazioni critiche sulla salute e le prestazioni di LHC.

Servizio di sincronizzazione della configurazione

Durante le normali operazioni, i seguenti eventi possono verificarsi quando il CSS importa i dati di configurazione nel database LHC utilizzando il broker LHC.

ID evento Descrizione
503 Indica che il CSS ha ricevuto una configurazione aggiornata. Questo evento si verifica ogni volta che viene ricevuta una configurazione aggiornata da Citrix Cloud. Ciò indica l’inizio del processo di sincronizzazione.
504 Indica che il CSS ha importato una configurazione aggiornata. L’importazione della configurazione è stata completata correttamente.
505 Indica che il CSS ha fallito un’importazione. L’importazione della configurazione non è stata completata correttamente. Se è disponibile una configurazione precedente riuscita, viene utilizzata se si entra in modalità LHC. Tuttavia, sarà obsoleta rispetto alla configurazione corrente. Se non è disponibile alcuna configurazione precedente, il servizio non può partecipare al brokering di sessione durante la modalità LHC. In questo caso, consultare la sezione Risoluzione dei problemi e contattare il supporto Citrix.
507 Indica che il CSS ha abbandonato un’importazione perché il sistema è in modalità LHC e il broker LHC viene utilizzato per il brokering. Il servizio ha ricevuto una nuova configurazione, ma l’importazione è stata abbandonata perché è stata attivata la modalità LHC. Questo è il comportamento previsto.
510 Indica che nessun dato di configurazione CSS è stato ricevuto dal servizio di configurazione primario.
517 Indica che si è verificato un problema di comunicazione con il servizio broker primario.
518 Indica che lo script CSS è stato interrotto perché il broker LHC (servizio di alta disponibilità) non è in esecuzione.

Servizio di alta disponibilità

Questo servizio è anche noto come broker LHC.

ID evento Descrizione
3502 Indica che si è verificata un’interruzione e che il broker LHC sta eseguendo operazioni di broker.
3503 Indica che un’interruzione è stata risolta e che le operazioni normali sono riprese.
3504 Indica il broker LHC eletto e gli altri broker LHC coinvolti nell’elezione.
3507 Indica che la modalità LHC è attiva sul broker LHC eletto. Contiene un riepilogo dell’interruzione, inclusa la durata dell’interruzione, la registrazione VDA e le informazioni sulla sessione.
3508 Indica che LHC non è più attivo sul broker LHC eletto e che le operazioni normali sono state ripristinate. Contiene un riepilogo dell’interruzione, inclusa la durata dell’interruzione, il numero di macchine registrate durante l’evento LHC e il numero di avvii riusciti durante la modalità LHC.
3509 Indica che LHC è attivo sul broker LHC non eletto. Contiene la durata dell’interruzione ogni 2 minuti e indica il broker LHC eletto.
3510 Indica che LHC non è più attivo sul broker LHC non eletto. Contiene la durata dell’interruzione e indica il broker LHC eletto.

Provider di broker remoto

Questo servizio funge da proxy tra Citrix Cloud e i VDA e i Cloud Connector.

|ID evento|Descrizione| |–|–|

-  |3001|La prima rilevazione di un errore che causa l'ingresso del Cloud Connector nello stato \*\*HA in sospeso\*\*. I controlli di integrità iniziano a valutare se l'errore è transitorio o persistente. Dopo il tempo assegnato nello stato \*\*HA in sospeso\*\*, i risultati più recenti dei controlli di integrità indicano se è necessario un ingresso in modalità LHC o se le operazioni normali possono essere riprese.|
-  |3002|Indica che il Cloud Connector non può entrare in modalità LHC. La ragione è inclusa nelle informazioni dell'evento.|
-  |3003|Indica che il Cloud Connector sta passando attraverso gli stati della modalità LHC. L'evento fornisce dettagli sui seguenti elementi|
-  |^^|^^ -  stato da cui il Cloud Connector sta passando|
-  |^^|^^ -  stato a cui sta passando|
  • ^^ ^^ - durata dello stato precedente

Nota:

Gli eventi 3001 sui Cloud Connector che si verificano periodicamente durante il giorno di solito non sono motivo di preoccupazione. Tuttavia, se si verificano più volte all’ora, ciò indica un problema di rete e potrebbe giustificare ulteriori indagini.

Citrix Monitor

Citrix Monitor contiene informazioni centralizzate relative agli ingressi in modalità LHC e alle prestazioni per le diverse Zone nel proprio ambiente.

DaaS Monitor LHC

Per maggiori informazioni, consultare Monitorare le tendenze storiche in un sito.

Forzare la modalità Local Host Cache

Potrebbe essere necessario forzare deliberatamente la modalità Local Host Cache nei seguenti scenari:

  • Se la rete si disconnette e riconnette ripetutamente: Forzare LHC fino a quando i problemi di rete non sono risolti previene la transizione continua tra le modalità normale e LHC (e le conseguenti frequenti tempeste di registrazione VDA).
  • Per testare un piano di ripristino di emergenza.
  • Per contribuire a garantire che Local Host Cache funzioni correttamente.

Per forzare la modalità LHC:

  1. Modificare il registro di ogni server Cloud Connector in HKLM\Software\Citrix\DesktopServer\LHC: Creare e impostare OutageModeForced come REG_DWORD su 1.

    • L’impostazione del valore su 1 indica al broker LHC di entrare in modalità LHC, indipendentemente dallo stato della connessione a Citrix Cloud.
    • L’impostazione del valore su 0 indica al broker LHC di uscire dalla modalità LHC e riprendere le operazioni normali.

Per verificare gli eventi:

  1. Monitorare il file di log Current_HighAvailabilityService in C:\ProgramData\Citrix\workspaceCloud\Logs\Plugins\HighAvailabilityService.

Risolvere i problemi di errore di importazione della sincronizzazione

Quando un’importazione di sincronizzazione nel database LHC fallisce e viene registrato un evento 505, è possibile utilizzare i seguenti strumenti di risoluzione dei problemi:

  • Traccia CDF:
    • Abilitare la traccia per i moduli ConfigSyncServer e BrokerLHC.
    • Utilizzare con altri moduli broker per identificare il problema.
  • Report di traccia CSS:

    • Genera un report dettagliato che individua l’oggetto che causa l’errore di sincronizzazione.

      Nota:

      L’abilitazione di questo report può influire sulla velocità di sincronizzazione. Disabilitarlo quando non si sta attivamente risolvendo i problemi.

    Per abilitare e generare un report di traccia CSS:

    1. Abilitare la creazione di report: Eseguire il comando seguente:

      
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -PropertyType DWORD -Value 1

<!--NeedCopy-->

    2. Individuare il report: Il report HTML viene generato in C:\Windows\ServiceProfiles\NetworkService\AppData\Local\Temp\CitrixBrokerConfigSyncReport.html.

    3. Disabilitare la creazione di report: Dopo la generazione del report, eseguire il comando seguente per disabilitare la funzionalità di creazione di report:

      
Set-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -Value 0

<!--NeedCopy-->

Comandi PowerShell per la cache host locale

È possibile gestire la cache host locale sui Cloud Connector utilizzando i comandi PowerShell.

Il modulo PowerShell si trova nella posizione seguente sui Cloud Connector:

C:\Program Files\Citrix\Broker\Service\ControlScripts

Importante:

Eseguire questo modulo solo sui Cloud Connector.

Importare il modulo PowerShell

Per importare il modulo, eseguire quanto segue sul Cloud Connector:


Import-Module "C:\Program Files\Citrix\Broker\Service\ControlScripts\HighAvailabilityServiceControl.psm1

<!--NeedCopy-->

Comandi PowerShell per gestire LHC

I cmdlet seguenti consentono di attivare e gestire la modalità LHC sui Cloud Connector.

Cmdlet Funzione
Enable-LhcForcedOutageMode Posiziona il Broker in modalità LHC. I file del database della cache host locale devono essere stati creati correttamente dal CSS affinché Enable-LhcForcedOutageMode funzioni correttamente. Questo cmdlet forza LHC solo sul Cloud Connector su cui è stato eseguito. Affinché LHC diventi attivo, questo cmdlet deve essere eseguito su tutti i Cloud Connector all’interno della zona.
Disable-LhcForcedOutageMode Disattiva la modalità LHC del Broker. Questo cmdlet disabilita la modalità LHC solo sul Cloud Connector su cui è stato eseguito. Disable-LhcForcedOutageMode deve essere eseguito su tutti i Cloud Connector all’interno della zona.
Set-LhcConfigSyncIntervalOverride Imposta l’intervallo con cui il CSS verifica le modifiche di configurazione all’interno del sito Citrix DaaS™. L’intervallo di tempo può variare da 60 secondi (un minuto) a 3600 secondi (un’ora). Questa impostazione si applica solo al Cloud Connector su cui è stata eseguita. Per coerenza tra i Cloud Connector, considerare l’esecuzione di questo cmdlet su ciascun Cloud Connector. Ad esempio: Set-LhcConfigSyncIntervalOverride -Seconds 1200
Clear-LhcConfigSyncIntervalOverride Imposta l’intervallo con cui il CSS verifica le modifiche di configurazione all’interno del sito Citrix DaaS sul valore predefinito di 300 secondi (cinque minuti). Questa impostazione si applica solo al Cloud Connector su cui è stata eseguita. Per coerenza tra i Cloud Connector, considerare l’esecuzione di questo cmdlet su ciascun Cloud Connector.
Enable-LhcHighAvailabilitySDK Abilita l’accesso a tutti i cmdlet Get-Broker* all’interno del Cloud Connector su cui è stato eseguito.
Disable-LhcHighAvailabilitySDK Disabilita l’accesso ai comandi PowerShell del Broker all’interno del Cloud Connector su cui è stato eseguito.

Nota:

  • Utilizzare la porta 89 quando si eseguono i cmdlet Get-Broker* sul Cloud Connector. Ad esempio:
    • Get-BrokerMachine -AdminAddress localhost:89
  • Quando non è in modalità LHC, il Broker LHC sul Cloud Connector contiene solo informazioni di configurazione.
  • Durante la modalità LHC, il Broker LHC contiene le seguenti informazioni:
    • Stati delle risorse
    • Dettagli della sessione
    • Registrazioni VDA
    • Informazioni di configurazione

Ulteriori informazioni

Cache host locale
May 4, 2026
Grazie al contributo di: 
C C
May 4, 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.