Cache host locale
Per garantire che il database del sito Citrix Virtual Apps and Desktops sia sempre disponibile, Citrix consiglia di iniziare con una distribuzione di SQL Server a tolleranza di errore, seguendo le best practice di alta disponibilità di Microsoft. (Per le funzionalità di alta disponibilità di SQL Server supportate, vedere Databases.) Tuttavia, problemi e interruzioni di rete possono impedire agli utenti di connettersi alle proprie applicazioni o desktop.
La funzionalità Cache host locale consente alle operazioni di brokering delle connessioni in un sito di continuare quando si verifica un’interruzione. Un’interruzione si verifica quando la connessione tra un Delivery Controller™ e il database del sito fallisce in un ambiente Citrix® on-premise. La Cache host locale si attiva quando il database del sito è inaccessibile per 90 secondi.
A partire da XenApp e XenDesktop 7.16, la funzionalità di leasing delle connessioni (una precedente funzionalità di alta disponibilità nelle versioni precedenti) è stata rimossa dal prodotto e non è più disponibile.
Contenuto dei dati
La Cache host locale include le seguenti informazioni, che sono un sottoinsieme delle informazioni presenti nel database principale:
- Identità di utenti e gruppi a cui sono stati assegnati i diritti alle risorse pubblicate dal sito.
- Identità di 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 Citrix Receiver™ utilizzate attivamente per connettersi alle risorse pubblicate.
Contiene anche informazioni per le connessioni attualmente attive che sono state stabilite mentre il database principale non era disponibile:
- Risultati di qualsiasi analisi degli endpoint delle macchine client eseguita da Citrix Receiver.
- Identità delle macchine dell’infrastruttura (come i server NetScaler Gateway e StoreFront™) coinvolte nel sito.
- Date, orari e tipi di attività recenti degli utenti.
Come funziona
Il seguente grafico illustra i componenti della Cache host locale e i percorsi di comunicazione durante le operazioni normali.
Durante le operazioni normali
- Il broker principale (Citrix Broker Service) su un Controller accetta le richieste di connessione da StoreFront. Il broker comunica con il database del sito per connettere gli utenti ai VDA registrati con il Controller.
- Il Citrix Config Synchronizer Service (CSS) verifica con il broker circa ogni 5 minuti se sono state apportate modifiche. Tali modifiche possono essere avviate dall’amministratore (ad esempio, la modifica di una proprietà di un gruppo di consegna) o azioni di sistema (ad esempio, le assegnazioni di macchine).
-
Se si è verificata una modifica della configurazione dall’ultima verifica, il CSS sincronizza (copia) le informazioni a un broker secondario sul Controller. (Il broker secondario è anche noto come High Availability Service.)
Tutti i dati di configurazione vengono copiati, non solo gli elementi modificati dall’ultima verifica. Il CSS importa i dati di configurazione in un database Microsoft SQL Server Express LocalDB sul Controller. Questo database è denominato database della Cache host locale. Il CSS garantisce che le informazioni nel database della Cache host locale corrispondano alle informazioni nel database del sito. Il database della Cache host locale viene ricreato ogni volta che si verifica una sincronizzazione.
Microsoft SQL Server Express LocalDB (utilizzato dal database della Cache host locale) viene installato automaticamente quando si installa un Controller. (È possibile impedire questa installazione quando si installa un Controller dalla riga di comando.) Il database della Cache host locale non può essere condiviso tra i Controller. Non è necessario eseguire il backup del database della Cache host locale. Viene ricreato ogni volta che viene rilevata una modifica della configurazione.
- Se non si sono verificate modifiche dall’ultima verifica, nessun dato viene copiato.
Il seguente grafico illustra le modifiche nei percorsi di comunicazione se il broker principale perde il contatto con il database del sito (inizia un’interruzione).
Durante un’interruzione
Quando inizia un’interruzione:
- Il broker secondario inizia ad ascoltare ed elaborare le richieste di connessione.
- Quando inizia l’interruzione, il broker secondario 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 secondario ottiene anche le informazioni sulla sessione corrente relative a quel VDA.
- Mentre il broker secondario gestisce le connessioni, il Brokering Principal continua a monitorare la connessione. Quando la connessione viene ripristinata, il Brokering Principal istruisce il broker secondario a smettere di ascoltare le informazioni di connessione e il Brokering Principal riprende le operazioni di brokering. La prossima volta che un VDA comunica con il Brokering Principal, viene attivato un processo di registrazione. Il broker secondario rimuove tutte le registrazioni VDA rimanenti dalla precedente interruzione. Il CSS riprende la sincronizzazione delle informazioni quando apprende che si sono verificate modifiche alla configurazione nella distribuzione.
Nell’improbabile eventualità che un’interruzione inizi durante una sincronizzazione, l’importazione corrente viene scartata e viene utilizzata l’ultima configurazione nota.
Il registro eventi fornisce informazioni su sincronizzazioni e interruzioni.
Non è imposto alcun limite di tempo per il funzionamento in modalità interruzione.
La transizione tra la modalità normale e la modalità interruzione non influisce sulle sessioni esistenti. Influisce solo sull’avvio di nuove sessioni.
È anche possibile attivare intenzionalmente un’interruzione. Vedere Forzare un’interruzione per i dettagli sul perché e come farlo.
Siti con più Controller
Tra gli altri suoi compiti, il CSS fornisce regolarmente al broker secondario informazioni su tutti i Controller nella zona. (Se la distribuzione non contiene più zone, questa azione influisce su tutti i Controller nel sito.) Avendo tali informazioni, ogni broker secondario conosce tutti i broker secondari peer in esecuzione su altri Controller nella zona.
I broker secondari 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 secondario gestirà le operazioni di brokeraggio nella zona in caso di interruzione. Durante l’interruzione, tutti i VDA si registrano con il broker secondario eletto. I broker secondari non eletti nella zona rifiutano attivamente le richieste di connessione in ingresso e di registrazione VDA.
Se un broker secondario eletto fallisce durante un’interruzione, un altro broker secondario viene eletto per subentrare e i VDA si registrano con il broker secondario appena eletto.
Durante un’interruzione, se un Controller viene riavviato:
- Se quel Controller non è il broker eletto, il riavvio non ha alcun impatto.
- Se quel Controller è il broker eletto, viene eletto un Controller diverso, causando la registrazione dei VDA. Dopo l’accensione del Controller riavviato, esso assume automaticamente il brokeraggio, il che causa la nuova registrazione dei VDA. In questo scenario, le prestazioni possono essere influenzate durante le registrazioni.
Se si spegne un Controller durante le operazioni normali e poi lo si accende durante un’interruzione, la Cache host locale non può essere utilizzata su quel Controller se è eletto come broker.
I registri eventi forniscono informazioni sulle elezioni.
Cosa non è disponibile durante un’interruzione e altre differenze
Non è imposto alcun limite di tempo per il funzionamento in modalità interruzione. Tuttavia, Citrix raccomanda di ripristinare la connettività il più rapidamente possibile.
Durante un’interruzione:
- Non è possibile utilizzare Studio.
-
Si ha accesso limitato all’SDK PowerShell.
- È necessario prima:
- Aggiungere una chiave di registro
EnableCssTestModecon un valore di 1:New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTestMode -PropertyType DWORD -Value 1 - Utilizzare la porta 89:
Get-BrokerMachine -AdminAddress localhost:89 | Select MachineName, ControllerDNSName, DesktopGroupName, RegistrationState
- Aggiungere una chiave di registro
- Dopo aver eseguito questi comandi, è possibile accedere a:
- Tutti i cmdlet
Get-Broker*.
- Tutti i cmdlet
- È necessario prima:
- Le credenziali dell’hypervisor non possono essere ottenute dal servizio Host. Tutte le macchine sono in stato di alimentazione sconosciuto e non è possibile emettere operazioni di alimentazione. Tuttavia, le VM sull’host che sono accese possono essere utilizzate per le richieste di connessione.
- Una macchina assegnata può essere utilizzata solo se l’assegnazione è avvenuta durante le operazioni normali. Nuove assegnazioni non possono essere effettuate durante un’interruzione.
- L’iscrizione e la configurazione automatica delle macchine Remote PC Access non sono possibili. Tuttavia, le macchine che sono state iscritte e configurate durante il normale funzionamento sono utilizzabili.
- Gli utenti di applicazioni e desktop ospitati su server potrebbero utilizzare più sessioni rispetto ai limiti di sessione configurati, se le risorse si trovano in zone diverse.
- Gli utenti possono avviare applicazioni e desktop solo da VDA registrati nella zona contenente il broker secondario attualmente attivo/eletto. Gli avvii tra zone (da un broker secondario in una zona a un VDA in una zona diversa) non sono supportati durante un’interruzione.
- Se si verifica un’interruzione del database del sito prima che inizi un riavvio pianificato per i VDA in un gruppo di consegna, i riavvii iniziano al termine dell’interruzione. Ciò può avere risultati imprevisti. Per ulteriori informazioni, vedere Riavvii pianificati ritardati a causa di un’interruzione del database.
- La preferenza di zona non può essere configurata. Se configurate, le preferenze non vengono considerate per l’avvio della sessione.
- Le restrizioni dei tag in cui i tag vengono utilizzati per designare le zone non sono supportate per gli avvii di sessione. Quando tali restrizioni dei tag sono configurate e l’opzione controllo avanzato dello stato di un archivio StoreFront è abilitata, le sessioni potrebbero non riuscire ad avviarsi in modo intermittente.
Supporto per applicazioni e desktop
La Cache host locale supporta applicazioni e desktop ospitati su server e desktop statici (assegnati).
La Cache host locale supporta i VDA desktop nei gruppi di consegna in pool, come segue:
-
Per impostazione predefinita, i VDA desktop con gestione dell’alimentazione in gruppi di consegna in pool (creati da MCS o Citrix Provisioning™) che hanno la proprietà
ShutdownDesktopsAfterUseabilitata non sono disponibili per nuove connessioni durante un evento di Cache host locale. È possibile modificare questa impostazione predefinita per consentire l’utilizzo di tali desktop durante la Cache host locale.Tuttavia, non è possibile fare affidamento sulla gestione dell’alimentazione durante l’interruzione. (La gestione dell’alimentazione riprende dopo il ripristino delle operazioni normali.) Inoltre, tali desktop potrebbero contenere dati dell’utente precedente, poiché non sono stati riavviati.
-
Per ignorare il comportamento predefinito, deve essere abilitato a livello di sito e per ogni gruppo di consegna interessato. Eseguire i seguenti cmdlet PowerShell.
A livello di sito:
Set-BrokerSite -ReuseMachinesWithoutShutdownInOutageAllowed $truePer ogni gruppo di consegna interessato, eseguire il seguente comando PowerShell:
Set-BrokerDesktopGroup -Name "nome" -ReuseMachinesWithoutShutdownInOutage $true
Per abilitare l’impostazione del gruppo di consegna per impostazione predefinita, eseguire il seguente comando PowerShell:
Set-BrokerSite -DefaultReuseMachinesWithoutShutdownInOutage $true
Questa impostazione si applica a tutti i nuovi gruppi di consegna creati dopo l’abilitazione di questa impostazione.
Per abilitare questa impostazione per i gruppi di consegna esistenti, eseguire il seguente comando PowerShell:
Set-BrokerDesktopGroup -Name "nome" -ReuseMachinesWithoutShutdownInOutage $true
L’abilitazione di questa funzionalità nel sito e nei gruppi di consegna non influisce sul funzionamento della proprietà ShutdownDesktopsAfterUse configurata durante le operazioni normali. Quando questa funzionalità è abilitata, i VDA non si riavviano automaticamente al termine dell’evento LHC. I VDA desktop con gestione dell’alimentazione nei gruppi di consegna in pool possono conservare i dati delle sessioni precedenti fino al riavvio del VDA. Ciò può verificarsi quando un utente si disconnette dal VDA durante operazioni non LHC o il riavvio può essere attivato manualmente.
Importante:
Senza abilitare
ReuseMachinesWithoutShutdownInOutageAlloweda livello di sito eReuseMachinesWithoutShutdownInOutagea livello di gruppo di consegna, tutti i tentativi di avvio di sessione per i VDA desktop con gestione dell’alimentazione nei gruppi di consegna in pool falliranno durante un evento di Cache host locale.
Considerazioni sulle dimensioni della RAM
Il servizio LocalDB può utilizzare circa 1,2 GB di RAM (fino a 1 GB per la cache del database, più 200 MB per l’esecuzione di SQL Server Express LocalDB). Il broker secondario può utilizzare fino a 1 GB di RAM se un’interruzione dura per un intervallo prolungato con molti accessi (ad esempio, 12 ore con 10.000 utenti). Questi requisiti di memoria si aggiungono ai normali requisiti di RAM per il Controller, quindi potrebbe essere necessario aumentare la capacità totale di RAM.
Se si utilizza un’installazione di SQL Server Express per il database del sito, il server avrà due processi sqlserver.exe.
Considerazioni sulla configurazione di core e socket della CPU
La configurazione della CPU di un Controller, in particolare il numero di core disponibili per SQL Server Express LocalDB, influisce direttamente sulle prestazioni della Cache host locale, anche più dell’allocazione della memoria. Questo overhead della CPU viene osservato solo durante il periodo di interruzione, quando il database è irraggiungibile e il broker secondario è attivo.
Sebbene LocalDB possa utilizzare più core (fino a 4), è limitato a un solo socket. L’aggiunta di più socket non migliorerà le prestazioni (ad esempio, avere 4 socket con 1 core ciascuno). Invece, Citrix raccomanda di utilizzare più socket con più core. Nei test Citrix, una configurazione 2x3 (2 socket, 3 core) ha fornito prestazioni migliori rispetto alle configurazioni 4x1 e 6x1.
Considerazioni sullo storage
Man mano che gli utenti accedono alle risorse durante un’interruzione, il LocalDB cresce. Ad esempio, durante un test di accesso/disconnessione eseguito a 10 accessi al secondo, il database è cresciuto di 1 MB ogni 2-3 minuti. Quando l’operazione normale riprende, il database locale viene ricreato e lo spazio viene restituito. Tuttavia, deve essere disponibile spazio sufficiente sull’unità in cui è installato il LocalDB per consentire la crescita del database durante un’interruzione. La Cache host locale comporta anche più I/O durante un’interruzione: circa 3 MB di scritture al secondo, con diverse centinaia di migliaia di letture.
Considerazioni sulle prestazioni
Durante un’interruzione, un broker secondario gestisce tutte le connessioni, quindi nei siti (o zone) che bilanciano il carico tra più Controller durante le operazioni normali, il broker secondario eletto potrebbe dover gestire molte più richieste del normale durante un’interruzione. Pertanto, le richieste di CPU saranno più elevate. Ogni broker secondario nel sito (zona) deve essere in grado di gestire il carico aggiuntivo imposto dal database della Cache host locale e da tutti i VDA interessati, perché il broker secondario eletto durante un’interruzione può cambiare.
Limiti VDI:
- In una distribuzione VDI a zona singola, è possibile gestire efficacemente fino a 10.000 VDA durante un’interruzione.
- In una distribuzione VDI multi-zona, è possibile gestire efficacemente fino a 10.000 VDA in ogni zona durante un’interruzione, fino a un massimo di 40.000 VDA nel sito. Ad esempio, ciascuno dei seguenti siti può essere gestito efficacemente durante un’interruzione:
- Un sito con quattro zone, ciascuna contenente 10.000 VDA.
- Un sito con sette zone, una contenente 10.000 VDA e sei contenenti 5.000 VDA ciascuna.
Durante un’interruzione, la gestione del carico all’interno del sito può essere influenzata. I valutatori di carico (e in particolare le regole di conteggio delle sessioni) possono essere superati.
Durante il tempo necessario a tutti i VDA per registrarsi con un broker secondario, tale servizio potrebbe non disporre di informazioni complete sulle sessioni correnti. Pertanto, una richiesta di connessione utente durante tale intervallo può comportare l’avvio di una nuova sessione, anche se era possibile la riconnessione a una sessione esistente. Questo intervallo (mentre il “nuovo” broker secondario acquisisce le informazioni sulla sessione da tutti i VDA durante la nuova registrazione) è inevitabile. Le sessioni connesse all’inizio di un’interruzione non sono influenzate durante l’intervallo di transizione, ma le nuove sessioni e le riconnessioni di sessione potrebbero esserlo.
Questo intervallo si verifica ogni volta che i VDA devono registrarsi:
- Inizia un’interruzione: quando si migra da un broker principale a un broker secondario.
- Guasto del broker secondario durante un’interruzione: quando si migra da un broker secondario che ha fallito a un broker secondario appena eletto.
- Ripristino da un’interruzione: quando le operazioni normali riprendono e il broker principale riprende il controllo.
È possibile ridurre l’intervallo abbassando il valore di registro HeartbeatPeriodMs del protocollo Citrix Broker (predefinito = 600000 ms, ovvero 10 minuti). Questo valore di heartbeat è il doppio dell’intervallo che il VDA utilizza per i ping, quindi il valore predefinito si traduce in un ping ogni 5 minuti.
Ad esempio, il seguente comando modifica l’heartbeat a cinque minuti (300000 millisecondi), il che si traduce in un ping ogni 2,5 minuti:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer -Name HeartbeatPeriodMs -PropertyType DWORD –Value 300000
Prestare attenzione quando si modifica il valore di heartbeat. L’aumento della frequenza comporta un maggiore carico sui Controller sia in modalità normale che in modalità interruzione.
L’intervallo non può essere eliminato del tutto, indipendentemente dalla velocità con cui i VDA si registrano.
Il tempo necessario per la sincronizzazione tra i broker secondari aumenta con il numero di oggetti (come VDA, applicazioni, gruppi). Ad esempio, la sincronizzazione di 5000 VDA potrebbe richiedere 10 minuti o più per essere completata.
Differenze dalle versioni XenApp 6.x
Sebbene questa implementazione della Cache host locale condivida il nome della funzionalità Cache host locale in XenApp 6.x e nelle versioni precedenti di XenApp, ci sono miglioramenti significativi. Questa implementazione è più robusta e immune alla corruzione. I requisiti di manutenzione sono minimizzati, come l’eliminazione della necessità di comandi dsmaint periodici. Questa Cache host locale è un’implementazione tecnicamente completamente diversa.
Gestire la Cache host locale
Affinché la Cache host locale funzioni correttamente, la policy di esecuzione di PowerShell su ogni Controller deve essere impostata su RemoteSigned, Unrestricted o Bypass.
SQL Server Express LocalDB
Il software Microsoft SQL Server Express LocalDB utilizzato dalla Cache host locale viene installato automaticamente quando si installa un Controller o si aggiorna un Controller da una versione precedente alla 7.9. Solo il broker secondario comunica con questo database. Non è possibile utilizzare i cmdlet PowerShell per modificare alcunché di questo database. Il LocalDB non può essere condiviso tra i Controller.
Il software del database SQL Server Express LocalDB viene installato indipendentemente dal fatto che la Cache host locale sia abilitata.
Per impedirne l’installazione, installare o aggiornare il Controller utilizzando il comando XenDesktopServerSetup.exe e includere l’opzione /exclude "Local Host Cache Storage (LocalDB)". Tuttavia, tenere presente che la funzionalità Cache host locale non funzionerà senza il database e non è possibile utilizzare un database diverso con il broker secondario.
L’installazione di questo database LocalDB non ha alcun effetto sull’installazione di SQL Server Express da utilizzare come database del sito.
Per informazioni sulla sostituzione di una versione precedente di SQL Server Express LocalDB con una versione più recente, vedere Sostituire SQL Server Express LocalDB.
Impostazioni predefinite dopo l’installazione e l’aggiornamento del prodotto
Durante una nuova installazione di Citrix Virtual Apps and Desktops (versione minima 7.16), la Cache host locale è abilitata.
Dopo un aggiornamento (alla versione 7.16 o successiva), la Cache host locale è abilitata se ci sono meno di 10.000 VDA nell’intera distribuzione.
Abilitare e disabilitare la Cache host locale
-
Per abilitare la Cache host locale, immettere:
Set-BrokerSite -LocalHostCacheEnabled $truePer determinare se la Cache host locale è abilitata, immettere
Get-BrokerSite. Verificare che la proprietàLocalHostCacheEnabledsiaTrue. -
Per disabilitare la Cache host locale, immettere:
Set-BrokerSite -LocalHostCacheEnabled $false
Ricordi: A partire da XenApp e XenDesktop 7.16, il leasing delle connessioni (la funzionalità che ha preceduto la Cache host locale a partire dalla versione 7.6) è stato rimosso dal prodotto e non è più disponibile.
Verificare che la Cache host locale funzioni
Per verificare che la Cache host locale sia configurata e funzioni correttamente:
- Assicurarsi che le importazioni di sincronizzazione siano completate con successo. Controllare i registri eventi.
- Assicurarsi che il database SQL Server Express LocalDB sia stato creato su ogni Delivery Controller. Ciò conferma che il broker secondario può subentrare, se necessario.
- Sul server Delivery Controller, navigare a
C:\Windows\ServiceProfiles\NetworkService. - Verificare che
HaDatabaseName.mdfeHaDatabaseName_log.ldfsiano stati creati.
- Sul server Delivery Controller, navigare a
- Forzare un’interruzione sui Delivery Controller. Dopo aver verificato che la Cache host locale funziona, ricordarsi di riportare tutti i Controller in modalità normale. Ciò può richiedere circa 15 minuti.
Registri eventi
I registri eventi indicano quando si verificano sincronizzazioni e interruzioni. Nei registri del visualizzatore eventi, la modalità di interruzione è indicata come modalità HA.*
Servizio di sincronizzazione della configurazione (Config Synchronizer Service):
Durante le operazioni normali, i seguenti eventi possono verificarsi quando il CSS importa i dati di configurazione nel database della Cache host locale utilizzando il broker della Cache host locale.
- 503: Il servizio Citrix Config Sync ha ricevuto una configurazione aggiornata. Questo evento indica l’inizio del processo di sincronizzazione.
- 504: Il servizio Citrix Config Sync ha importato una configurazione aggiornata. L’importazione della configurazione è stata completata con successo.
- 505: Il servizio Citrix Config Sync ha fallito un’importazione. L’importazione della configurazione non è stata completata con successo. Se è disponibile una configurazione precedente riuscita, viene utilizzata in caso di interruzione. Tuttavia, sarà obsoleta rispetto alla configurazione corrente. Se non è disponibile alcuna configurazione precedente, il servizio non può partecipare al brokering delle sessioni durante un’interruzione. In questo caso, consultare la sezione Risoluzione dei problemi e contattare il supporto Citrix.
- 507: Il servizio Citrix Config Sync ha abbandonato un’importazione perché il sistema è in modalità interruzione e il broker della Cache host locale viene utilizzato per il brokering. Il servizio ha ricevuto una nuova configurazione, ma l’importazione è stata abbandonata a causa di un’interruzione. Questo è il comportamento previsto.
- 510: Nessun dato di configurazione del servizio di configurazione ricevuto dal servizio di configurazione primario.
- 517: Si è verificato un problema di comunicazione con il Broker primario.
- 518: Script di sincronizzazione della configurazione interrotto perché il Broker secondario (High Availability Service) non è in esecuzione.
Servizio di alta disponibilità (High Availability Service):
Questo servizio è anche noto come broker della Cache host locale.
- 3502: Si è verificato un’interruzione e il broker della Cache host locale sta eseguendo operazioni di brokering.
- 3503: Un’interruzione è stata risolta e le operazioni normali sono riprese.
- 3504: Indica quale broker della Cache host locale è eletto, più altri broker della Cache host locale coinvolti nell’elezione.
- 3507: Fornisce un aggiornamento dello stato della Cache host locale ogni 2 minuti che indica che la modalità Cache host locale è attiva sul broker eletto. Contiene un riepilogo dell’interruzione, inclusa la durata dell’interruzione, la registrazione VDA e le informazioni sulla sessione.
- 3508: Annuncia che la Cache host locale non è più attiva sul broker 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 della Cache host locale e il numero di avvii riusciti durante l’evento LHC.
- 3509: Notifica che la Cache host locale è attiva sui broker non eletti. Contiene una durata dell’interruzione ogni 2 minuti e indica il broker eletto.
- 3510: Annuncia che la Cache host locale non è più attiva sui broker non eletti. Contiene la durata dell’interruzione e indica il broker eletto.
Forzare un’interruzione
Potrebbe essere necessario forzare deliberatamente un’interruzione.
- Se la rete si attiva e disattiva ripetutamente. Forzare un’interruzione fino a quando i problemi di rete non vengono risolti impedisce la transizione continua tra le modalità normale e di interruzione (e le conseguenti frequenti tempeste di registrazione VDA).
- Per testare un piano di ripristino di emergenza.
- Per contribuire a garantire che la Cache host locale funzioni correttamente.
- Durante la sostituzione o la manutenzione del server del database del sito.
Per forzare un’interruzione, modificare il registro di ogni server contenente un Delivery Controller. In HKLM\Software\Citrix\DesktopServer\LHC, creare e impostare OutageModeForced come REG_DWORD su 1. Questa impostazione istruisce il broker della Cache host locale a entrare in modalità interruzione, indipendentemente dallo stato del database. L’impostazione del valore su 0 fa uscire il broker della Cache host locale dalla modalità interruzione.
Per verificare gli eventi, monitorare il file di registro Current_HighAvailabilityService in C:\ProgramData\Citrix\WorkspaceCloud\Logs\Plugins\HighAvailabilityService.
Risoluzione dei problemi
Sono disponibili diversi strumenti di risoluzione dei problemi quando un’importazione di sincronizzazione nel database della Cache host locale fallisce e viene registrato un evento 505.
Traccia CDF: Contiene opzioni per i moduli ConfigSyncServer e BrokerLHC. Tali opzioni, insieme ad altri moduli broker, probabilmente identificheranno il problema.
Report: Se un’importazione di sincronizzazione fallisce, è possibile generare un report. Questo report si ferma all’oggetto che causa l’errore. Questa funzionalità di report influisce sulla velocità di sincronizzazione, quindi Citrix raccomanda di disabilitarla quando non in uso.
Per abilitare e produrre un report di traccia CSS, immettere il seguente comando:
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -PropertyType DWORD -Value 1
Il report HTML viene pubblicato in C:\Windows\ServiceProfiles\NetworkService\AppData\Local\Temp\CitrixBrokerConfigSyncReport.html.
Dopo la generazione del report, immettere il seguente comando per disabilitare la funzionalità di reporting:
Set-ItemProperty -Path HKLM:\SOFTWARE\Citrix\DesktopServer\LHC -Name EnableCssTraceMode -Value 0
Esportare la configurazione del broker: Fornisce la configurazione esatta per scopi di debug.
Export-BrokerConfiguration | Out-File <percorso-file>
Ad esempio, Export-BrokerConfiguration | Out-File C:\\BrokerConfig.xml.
Comandi PowerShell della Cache host locale
È possibile gestire la Cache host locale (LHC) sui Delivery Controller utilizzando i comandi PowerShell.
Il modulo PowerShell si trova nella seguente posizione sui Delivery Controller:
C:\Program Files\Citrix\Broker\Service\ControlScripts
Importante:
Eseguire questo modulo solo sui Delivery Controller.
Importare il modulo PowerShell
Per importare il modulo, eseguire quanto segue sul Delivery Controller.
cd C:\Program Files\Citrix\Broker\Service\ControlScripts
Import-Module .\HighAvailabilityServiceControl.psm1
Comandi PowerShell per gestire LHC
I seguenti comandi consentono di attivare e gestire la modalità LHC sui Delivery Controller.
| Cmdlet | Funzione |
|---|---|
Enable-LhcForcedOutageMode |
Posiziona il Broker in modalità LHC. I file del database LHC devono essere stati creati con successo dal servizio ConfigSync affinché Enable-LhcForcedOutageMode funzioni correttamente. Questo cmdlet forza l’LHC solo sul Delivery Controller su cui è stato eseguito. Affinché l’LHC diventi attivo, questo comando deve essere eseguito su tutti i Delivery Controller all’interno della zona. |
Disable-LhcForcedOutageMode |
Fa uscire il Broker dalla modalità LHC. Questo cmdlet disabilita la modalità LHC solo sul Delivery Controller su cui è stato eseguito. Disable-LhcForcedOutageMode deve essere eseguito su tutti i Delivery Controller all’interno della zona. |
Set-LhcConfigSyncIntervalOverride |
Imposta l’intervallo con cui il servizio Citrix Config Synchronizer (CSS) verifica le modifiche alla configurazione all’interno del sito. L’intervallo di tempo può variare da 60 secondi (un minuto) a 3600 secondi (un’ora). Questa impostazione si applica solo al Delivery Controller su cui è stata eseguita. Per coerenza tra i Delivery Controller, considerare di eseguire questo cmdlet su ogni Delivery Controller. Ad esempio: Set-LhcConfigSyncIntervalOverride -Seconds 1200
|
Clear-LhcConfigSyncIntervalOverride |
Imposta l’intervallo con cui il servizio Citrix Config Synchronizer (CSS) verifica le modifiche alla configurazione all’interno del sito sul valore predefinito di 300 secondi (cinque minuti). Questa impostazione si applica solo al Delivery Controller su cui è stata eseguita. Per coerenza tra i Delivery Controller, considerare di eseguire questo cmdlet su ogni Delivery Controller. |
Enable-LhcHighAvailabilitySDK |
Abilita l’accesso a tutti i cmdlet Get-Broker* all’interno del Delivery Controller su cui è stato eseguito. |
Disable-LhcHighAvailabilitySDK |
Disabilita l’accesso ai cmdlet del Broker all’interno del Delivery Controller su cui è stato eseguito. |
Nota:
- Utilizzare la porta 89 quando si eseguono i cmdlet
Get-Broker*sul Delivery Controller. Ad esempio:
Get-BrokerMachine -AdminAddress localhost:89- Quando non è in modalità LHC, il Broker LHC sul Delivery Controller contiene solo informazioni di configurazione.
- Durante la modalità LHC, il Broker LHC sul Delivery Controller eletto contiene le seguenti informazioni:
- Stati delle risorse
- Dettagli della sessione
- Registrazioni VDA
- Informazioni di configurazione