Citrix Scout

Introduzione

Citrix Scout raccoglie diagnostica ed esegue controlli di integrità. È possibile utilizzare i risultati per mantenere la distribuzione di Citrix Virtual Apps and Desktops™. Citrix offre un’analisi completa e automatizzata delle raccolte diagnostiche tramite Citrix Insight Services. È inoltre possibile utilizzare Scout per risolvere i problemi, autonomamente o con la guida del supporto Citrix.

È possibile caricare i file di raccolta su Citrix per l’analisi e la guida del supporto Citrix. In alternativa, è possibile salvare una raccolta localmente per la propria revisione e quindi caricare in seguito il file di raccolta su Citrix per l’analisi.

Scout offre le seguenti procedure:

• Raccogli: Esegue una raccolta diagnostica una tantum sulle macchine selezionate in un sito. È quindi possibile caricare il file su Citrix o salvarlo localmente.
• Traccia e Riproduci: Avvia una traccia manuale sulle macchine selezionate. Quindi si ricreano i problemi su tali macchine. Dopo aver ricreato il problema, la traccia viene interrotta. Scout raccoglie quindi altre diagnostiche e carica il file su Citrix, oppure salva il file localmente.
• Pianifica: Pianifica le raccolte diagnostiche in modo che si verifichino quotidianamente o settimanalmente a un’ora specificata sulle macchine selezionate. Il file viene caricato automaticamente su Citrix.
• Controllo integrità: Esegue controlli che misurano l’integrità e la disponibilità del sito e dei suoi componenti. È possibile eseguire controlli di integrità per Delivery Controller, Virtual Delivery Agents (VDA), server StoreFront™ e Citrix License Servers. Se vengono rilevati problemi durante i controlli, Scout fornisce un rapporto dettagliato. Ogni volta che Scout si avvia, verifica la presenza di script di controllo integrità aggiornati. Se sono disponibili nuove versioni, Scout le scarica automaticamente, per utilizzarle la prossima volta che vengono eseguiti i controlli di integrità.

Nota:

Le procedure Traccia e Riproduci, Pianifica e Controllo integrità non sono attualmente disponibili per Linux VDA.

L’interfaccia grafica descritta in questo articolo è il modo principale per utilizzare Scout. In alternativa, è possibile utilizzare PowerShell per configurare raccolte e caricamenti diagnostici una tantum o pianificati. Vedere Call Home.

Dove eseguire Scout:

• In una distribuzione on-premise, eseguire Scout da un Delivery Controller™ per acquisire diagnostica o eseguire controlli su uno o più Virtual Delivery Agents (VDA), Delivery Controller, server StoreFront e License Servers. È anche possibile eseguire Scout da un VDA per raccogliere diagnostica locale.
• In un ambiente Citrix Cloud che utilizza Citrix DaaS (precedentemente servizio Citrix Virtual Apps and Desktops), eseguire Scout da un VDA per raccogliere diagnostica locale.

Il log dell’applicazione Scout è memorizzato in C:\ProgramData\Citrix\TelemetryService\ScoutUI.log. Questo file può essere utilizzato per la risoluzione dei problemi.

Cosa viene raccolto

Le diagnostiche raccolte da Scout includono i file di log di traccia di Citrix Diagnostic Facility (CDF). È incluso anche un sottoinsieme di tracce CDF chiamato Always-on Tracing (AOT). Le informazioni AOT possono essere utili per la risoluzione dei problemi comuni come le registrazioni VDA e gli avvii di applicazioni/desktop. Non vengono raccolte altre informazioni di Event Tracing for Windows (ETW).

La raccolta include:

• Voci di registro create da Citrix Virtual Apps and Desktops in HKEY_LOCAL_MACHINE\SOFTWARE\Citrix.
• Informazioni di Windows Management Instrumentation (WMI) sotto il Citrix namespace.
• Processi in esecuzione.
• Dump di arresto anomalo dei processi Citrix memorizzati in %PROGRAMDATA%\Citrix\CDF.
• Informazioni sulla policy Citrix, in formato CSV.
• Informazioni sull’installazione e l’aggiornamento. La raccolta può includere il log completo del metainstaller del prodotto, i log MSI non riusciti, l’output dell’analizzatore di log MSI, i log di StoreFront, i log di controllo della compatibilità delle licenze e i risultati dei test preliminari di aggiornamento del sito.

Informazioni sulla traccia:

• Le informazioni di traccia vengono compresse al momento della raccolta, mantenendo un ingombro ridotto sulla macchina.
• Su ogni macchina, il Citrix Telemetry Service conserva le informazioni di traccia recenti compresse per un massimo di otto giorni.
• A partire da Citrix Virtual Apps and Desktops 7 1808, le tracce AOT vengono salvate sul disco locale per impostazione predefinita. (Nelle versioni precedenti, le tracce erano mantenute in memoria.) Percorso predefinito = C:\Users\CitrixTelemetryService\AppData\Local\CitrixAOT.
• A partire da Citrix Virtual Apps and Desktops 7 1811, le tracce AOT salvate su condivisioni di rete vengono raccolte con altre diagnostiche.
• È possibile modificare la dimensione massima (predefinita = 10 MB) e la durata della sezione, utilizzando il cmdlet Enable-CitrixTrace o la stringa di registro HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Telemetry DefaultListen.
• Le tracce vengono aggiunte al file finché il file non raggiunge il 10% di MaxSize.

Per un elenco dei punti dati raccolti da Scout, vedere Punti dati chiave di Call Home.

Configurazione di Scout

Scout può essere configurato per funzionare su VDA Linux. Per ulteriori informazioni su VDA Linux e la telemetria, vedere Integrare con il servizio di telemetria Citrix

Il VDA Linux potrebbe modificare automaticamente la porta socket ctxtelemetry o la porta per il servizio di telemetria. In tal caso, è necessario configurare la porta manualmente.

1. Accedere a C:\Program Files\Citrix\Telemetry Service
2. Aprire il file ScoutUI.exe.config.
3. Modificare il valore di LinuxVDATelemetryServicePort o LinuxVDATelemetryWakeupPort in base a quanto configurato sul VDA Linux:

• <add key="LinuxVDATelemetryServicePort" value="7502"/>
• <add key="LinuxVDATelemetryWakeupPort" value="7503"/>

1. Salvare le modifiche e chiudere il file.
2. Aprire nuovamente Scout per assicurarsi che carichi la configurazione più recente.

Informazioni sui controlli di integrità

I dati dei controlli di integrità sono archiviati in cartelle sotto C:\ProgramData\Citrix\TelemetryService\.

Controlli di integrità del sito

I controlli di integrità del sito sono inclusi nel Servizio di test dell’ambiente, che fornisce una valutazione completa dei servizi FlexCast Management Architecture (FMA). Oltre a verificare la disponibilità del servizio, questi controlli cercano altri indicatori di integrità come le connessioni al database.

I controlli di integrità del sito vengono eseguiti sui Delivery Controller. A seconda delle dimensioni del sito, questi controlli possono richiedere fino a un’ora per essere completati.

Controlli di configurazione del Delivery Controller

Come parte dei controlli di integrità del sito, i controlli di configurazione del Delivery Controller verificano l’esistenza dei seguenti problemi, in base alle raccomandazioni Citrix per i siti Virtual Apps and Desktops:

• Uno o più Delivery Controller si trovano in uno stato di errore.
• È presente un solo Delivery Controller nel sito.
• I Delivery Controller sono di versioni diverse.

Oltre a soddisfare le autorizzazioni e i requisiti per i controlli di integrità, i controlli di configurazione del Delivery Controller richiedono:

• Almeno un Controller acceso.
• Il Broker Service in esecuzione su un Controller.
• Una connessione funzionante dal Controller al database del sito.

Controlli di integrità VDA

I controlli di integrità VDA identificano le possibili cause di problemi comuni di registrazione VDA, avvio sessione e reindirizzamento del fuso orario.

Per la registrazione sul VDA, Scout verifica:

• Installazione del software VDA
• Appartenenza al dominio della macchina VDA
• Disponibilità della porta di comunicazione VDA
• Stato del servizio VDA
• Configurazione del firewall di Windows
• Comunicazione con il Controller
• Sincronizzazione oraria con il Controller
• Stato di registrazione del VDA

Per gli avvii di sessione sui VDA, Scout verifica:

• Disponibilità della porta di comunicazione per l’avvio della sessione
• Stato dei servizi di avvio della sessione
• Configurazione del firewall di Windows per l’avvio della sessione
• Licenze di accesso client dei servizi desktop remoto VDA
• Percorso di avvio dell’applicazione VDA
• Impostazioni del registro per l’avvio della sessione

Per il reindirizzamento del fuso orario sui VDA, Scout verifica:

• Installazione di hotfix di Windows
• Installazione di hotfix di Citrix
• Impostazioni dei criteri di gruppo Microsoft
• Impostazioni dei criteri di gruppo Citrix

Per Profile Management sui VDA, Scout verifica:

• Rilevamento hypervisor
• Rilevamento provisioning
• Citrix App virtuali e Desktop
• Configurazione di Personal vDisk
• Archivio utente
• Rilevamento dello stato del servizio Profile Management
• Test di hooking di Winlogon.exe

Per eseguire i controlli su Profile Management, è necessario installare e abilitare Profile Management sul VDA. Per ulteriori informazioni sui controlli di configurazione di Profile Management, consultare l’articolo del Knowledge Center CTX132805.

Controlli di integrità di StoreFront

I controlli di StoreFront verificano:

• Il servizio Citrix Default Domain è in esecuzione
• Il servizio Citrix Credential Wallet è in esecuzione
• Connessione dal server StoreFront alla porta 88 di Active Directory
• Connessione dal server StoreFront alla porta 389 di Active Directory
• L’URL di base ha un FQDN valido
• È possibile recuperare l’indirizzo IP corretto dall’URL di base
• Il pool di applicazioni IIS utilizza .NET 4.0
• Se il certificato è associato alla porta SSL per l’URL host
• Se la catena di certificati è completa
• Se i certificati sono scaduti
• Se un certificato sta per scadere (entro 30 giorni)

Controlli del server licenze

I controlli del server licenze verificano:

• Connessione al server licenze dal Delivery Controller
• Stato dell’accesso remoto del firewall del server licenze
• Stato del servizio di licenze Citrix
• Stato della modalità di caching delle licenze del server licenze
• Connessione delle porte del server licenze
• Se il daemon del fornitore Citrix (CITRIX) è in esecuzione
• Se gli orologi di sistema sono sincronizzati
• Se il servizio di licenze Citrix è in esecuzione con l’account Servizio locale
• Presenza del file CITRIX.opt
• Data di idoneità ai servizi Customer Success
• Aggiornamento del server licenze Citrix
• Se il certificato del server licenze si trova nell’archivio radice attendibile del Delivery Controller

Oltre a soddisfare le autorizzazioni e i requisiti per i controlli di integrità, il server licenze deve essere aggiunto a un dominio. In caso contrario, il server licenze non viene rilevato.

Eseguire i controlli di integrità

La procedura di controllo di integrità comprende la selezione delle macchine, l’avvio del controllo e la revisione del rapporto sui risultati.

1. Avviare Scout. Dal menu Start della macchina, selezionare Citrix > Citrix Scout. Nella pagina iniziale, fare clic su Health Check.

2. Selezionare le macchine. Fare clic su Trova macchina per rilevare le macchine. La pagina Seleziona macchine elenca tutti i VDA, i Delivery Controller e i License Server rilevati nel sito. È possibile filtrare la visualizzazione per nome macchina. Selezionare la casella di controllo accanto a ciascuna macchina da cui si desidera raccogliere i dati diagnostici, quindi fare clic su Continua.

   Per aggiungere altri tipi di componenti (come i server StoreFront e le macchine VDA), vedere Aggiungere macchine manualmente e Importare macchine VDA. Non è possibile aggiungere manualmente server Citrix Provisioning™ o License Server.

   Scout avvia automaticamente i test di verifica su ogni macchina selezionata, assicurandosi che soddisfi i criteri elencati in Test di verifica. Se la verifica fallisce, viene visualizzato un messaggio nella colonna Stato e la casella di controllo di quella macchina viene deselezionata. È possibile:

   • Risolvere il problema e quindi selezionare nuovamente la casella di controllo della macchina. Ciò attiva un nuovo tentativo dei test di verifica.
   • Saltare quella macchina (lasciare deselezionata la sua casella di controllo). I controlli di integrità non vengono eseguiti per quella macchina.

   Al termine dei test di verifica, fare clic su Continua.

3. Eseguire i controlli di integrità sulle macchine selezionate. Il riepilogo elenca le macchine su cui vengono eseguiti i test (le macchine selezionate che hanno superato i test di verifica). Fare clic su Avvia controllo.

   Durante e dopo il controllo:

   • La colonna Stato indica lo stato di controllo corrente per una macchina.
   • Per interrompere tutti i controlli in corso, fare clic su Interrompi controllo nell’angolo in basso a destra della pagina. (Non è possibile annullare il controllo di integrità di una singola macchina, ma solo di tutte le macchine selezionate. Le informazioni delle macchine che hanno completato i controlli vengono mantenute.
   • Quando i controlli sono completati per tutte le macchine selezionate, il pulsante Interrompi controllo nell’angolo in basso a destra cambia in Fatto.
   • Se un controllo fallisce, è possibile fare clic su Riprova nella colonna Azione.
   • Se un controllo viene completato senza problemi, la colonna Azione è vuota.
   • Se un controllo rileva problemi, fare clic su Visualizza dettagli per mostrare i risultati.
   • Dopo che il controllo è completato per tutte le macchine selezionate, non fare clic su Indietro. (In caso contrario, i risultati del controllo andranno persi.)
4. Quando i controlli sono completati, fare clic su Fatto per tornare alla pagina iniziale di Scout.

Risultati del controllo di integrità

Per i controlli Citrix che generano report, i report contengono:

• Ora e data di generazione del report dei risultati
• Macchine controllate
• Condizioni che il controllo ha cercato sulle macchine di destinazione

Autorizzazioni e requisiti

Autorizzazioni:

• Per raccogliere i dati diagnostici:

  • È necessario essere un amministratore locale e un utente di dominio per ogni macchina da cui si raccolgono i dati diagnostici.
  • È necessario disporre dell’autorizzazione di scrittura nella directory LocalAppData su ogni macchina.

• Per eseguire i controlli di integrità:

  • È necessario essere un membro del gruppo utenti di dominio.
  • È necessario essere un amministratore completo o avere un ruolo personalizzato con autorizzazioni di sola lettura e Esegui test ambiente per il sito.
  • Impostare i criteri di esecuzione degli script su almeno RemoteSigned per consentire l’esecuzione degli script. Ad esempio: Set-ExecutionPolicy RemoteSigned. Nota: anche altri privilegi di esecuzione degli script possono funzionare.

• Utilizzare Esegui come amministratore all’avvio di Scout.

Per ogni macchina da cui si raccolgono diagnostici o si eseguono controlli di integrità:

• Scout deve essere in grado di comunicare con la macchina.
• La condivisione di file e stampanti deve essere attivata.
• PSRemoting e WinRM devono essere abilitati. La macchina deve inoltre eseguire PowerShell 3.0 o versioni successive.
• Il servizio Citrix Telemetry deve essere in esecuzione sulla macchina.
• L’accesso a Windows Management Infrastructure (WMI) deve essere abilitato sulla macchina.
• Per impostare una pianificazione per la raccolta diagnostica, la macchina deve eseguire una versione di Scout compatibile.

Non utilizzare il segno di dollaro ($) nei nomi utente specificati nei percorsi. Impedisce la raccolta di informazioni diagnostiche.

Scout esegue test di verifica sulle macchine selezionate per assicurarsi che questi requisiti siano soddisfatti.

Il servizio Telemetry per Windows viene eseguito su Network Service.

Utilizzo dei dati di Scout 1(/it-it/citrix-virtual-apps-desktops/2311/media/scout-data1.png)

La cartella AOT Trace viene salvata in C:\ProgramData\Citrix\TelemetryService\CitrixAOT.

Solo gli utenti del gruppo Administrator, System e Telemetry Service SID hanno l’autorizzazione ad accedere al registro HKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetry.

Utilizzo dei dati di Scout 2(/it-it/citrix-virtual-apps-desktops/2311/media/scout-data2.png)

Il SID del servizio di telemetria rimane nel gruppo Utenti del registro prestazioni dopo la disinstallazione del servizio di telemetria, ma è possibile rimuoverlo manualmente.

Test di verifica

Prima dell’avvio di una raccolta diagnostica o di un controllo dello stato di integrità, i test di verifica vengono eseguiti automaticamente per ogni macchina selezionata. Questi test assicurano che i requisiti siano soddisfatti. Se un test fallisce per una macchina, Scout visualizza un messaggio con le azioni correttive suggerite.

• Scout non riesce a raggiungere questa macchina - Assicurarsi che:

  • La macchina sia accesa.
  • La connessione di rete funzioni correttamente. (Ciò può includere la verifica che il firewall sia configurato correttamente.)
  • La condivisione di file e stampanti sia attivata. Per istruzioni, consultare la documentazione Microsoft.
• Abilitare PSRemoting e WinRM - È possibile abilitare PowerShell remoting e WinRM contemporaneamente. Utilizzando Esegui come amministratore, eseguire il cmdlet Enable-PSRemoting. Per i dettagli, consultare la guida Microsoft per il cmdlet.
• Scout richiede PowerShell 3.0 (minimo) - Installare PowerShell 3.0 (o versione successiva) sulla macchina, quindi abilitare PowerShell remoting.
• Impossibile accedere alla directory LocalAppData su questa macchina - Assicurarsi che l’account disponga dell’autorizzazione di scrittura nella directory LocalAppData sulla macchina.
• Impossibile individuare il servizio di telemetria Citrix - Assicurarsi che il servizio di telemetria Citrix sia installato e avviato sulla macchina.
• Impossibile ottenere la pianificazione - Aggiornare la macchina a (minimo) XenApp e XenDesktop 7.14.
• WMI non è in esecuzione sulla macchina - Assicurarsi che l’accesso a Windows Management Instrumentation (WMI) sia abilitato.
• Connessioni WMI bloccate - Abilitare WMI nel servizio Windows Firewall.
• Versione più recente del servizio Citrix Telemetry richiesta - (La versione viene controllata solo per Raccogli e Traccia e Riproduci.) Aggiornare la versione del servizio Telemetry sulla macchina (vedere Installa e aggiorna). Se non si aggiorna il servizio, la macchina non viene inclusa nelle azioni Raccogli o Traccia e Riproduci.

• Scout non riesce a connettersi al socket systemd su questa macchina - Assicurarsi che:

  • La porta 7503 sia aperta. Verificare che il socket systemd ctxtelemetry.socket sia in ascolto sulla porta 7503 sulla macchina. La porta potrebbe essere diversa se la porta del socket ctxtelemetry.socket è stata modificata. Vedere Configurazione di Scout per regolare le porte.
  • La connessione di rete funzioni correttamente. (Ciò potrebbe includere la verifica che il firewall sia configurato correttamente.)

• Il servizio Telemetry di Linux VDA non è avviato su questa macchina - Assicurarsi che:

  • La porta 7502 sia aperta. Verificare che il servizio Telemetry di Linux VDA sia installato e avviato sulla macchina. La porta potrebbe essere diversa se la porta del servizio Telemetry è stata modificata. Vedere Configurazione di Scout per regolare le porte.
  • La connessione di rete funzioni correttamente. (Ciò potrebbe includere la verifica che il firewall sia configurato correttamente.)

Compatibilità delle versioni

Questa versione di Scout (3.x) è destinata all’esecuzione su Controller e VDA di Citrix Virtual Apps and Desktops (o minimo XenApp e XenDesktop 7.14).

Una versione precedente di Scout è fornita con le versioni di XenApp e XenDesktop precedenti alla 7.14. Per informazioni su tale versione precedente, vedere CTX130147.

Se si aggiorna un Controller o un VDA precedente alla versione 7.14 alla versione 7.14 (o a una versione successiva supportata), la versione precedente di Scout viene sostituita con la versione corrente.

Installazione e aggiornamento

Per impostazione predefinita, Scout viene installato o aggiornato automaticamente come parte del servizio Citrix Telemetry quando si installa o si aggiorna un VDA o un Controller.

Se si omette il servizio Citrix Telemetry durante l’installazione di un VDA, o si rimuove il servizio in seguito, eseguire TelemetryServiceInstaller_xx.msi dalla cartella x64\Virtual Desktop Components o x86\Virtual Desktop Components sul supporto di installazione di Citrix Virtual Apps and Desktops.

Quando si seleziona l’azione Raccogli o Traccia e riproduci, si viene avvisati se una macchina esegue una versione precedente del servizio Citrix Telemetry. Citrix consiglia di utilizzare la versione più recente supportata. Se non si aggiorna il servizio Telemetry su tale macchina, non verrà incluso nelle azioni Raccogli o Traccia e riproduci. Per aggiornare il servizio Telemetry, utilizzare la stessa procedura di installazione.

Autorizzazione al caricamento

Se si prevede di caricare raccolte diagnostiche su Citrix, è necessario disporre di un account Citrix o Citrix Cloud. (Queste sono le credenziali utilizzate per accedere ai download Citrix o al Citrix Cloud Control Center.) Dopo la convalida delle credenziali dell’account, viene emesso un token.

Se ci si autentica con un account Citrix o un account Citrix Cloud, fare clic su un collegamento per accedere a Citrix Cloud tramite HTTPS con il browser predefinito. Dopo aver inserito le credenziali di Citrix Cloud, viene visualizzato il token. Copiare il token e incollarlo in Scout. È quindi possibile continuare con la procedura guidata di Scout.

Il token viene archiviato localmente sulla macchina in cui si esegue Scout. Per abilitare l’uso di tale token la prossima volta che si esegue Raccogli o Traccia e riproduci, selezionare la casella di controllo Memorizza token e salta questo passaggio in futuro.

È necessario riautorizzare ogni volta che si seleziona Pianifica nella pagina iniziale di Scout. Non è possibile utilizzare un token memorizzato durante la creazione o la modifica di una pianificazione.

Utilizzare un proxy per i caricamenti

Se si desidera utilizzare un server proxy per caricare le raccolte su Citrix, è possibile indicare a Scout di utilizzare le impostazioni proxy configurate per le proprietà Internet del browser. In alternativa, è possibile specificare l’indirizzo IP e il numero di porta del server proxy.

Trova macchina

Per le procedure Raccogli, Traccia e riproduci e Pianifica, Scout elenca automaticamente i Controller e i VDA che rileva.

Quando si esegue Controllo integrità Scout da Delivery Controller, fare clic su Trova macchina per rilevare le macchine, inclusi i controller di consegna, i VDA, i server licenze e i server StoreFront.

Quando si esegue Controllo integrità Scout da una macchina aggiunta a un dominio che non è un Delivery Controller, Scout non può rilevare automaticamente le macchine. È necessario aggiungere macchine manualmente o importare macchine VDA.

Aggiungere macchine manualmente

Dopo che Scout elenca i Controller e i VDA che rileva, è possibile aggiungere manualmente altre macchine nella distribuzione, come i server StoreFront, i server licenze e i server Citrix Provisioning.

Quando si eseguono controlli di integrità:

• I Citrix License Server nel dominio vengono rilevati automaticamente. Non è possibile aggiungere License Server manualmente.
• I controlli di integrità attualmente non supportano i server Citrix Provisioning.

In qualsiasi pagina di Scout che elenca le macchine rilevate, fare clic su + Aggiungi macchina. Digitare il FQDN della macchina che si desidera aggiungere, quindi fare clic su Continua. Ripetere per aggiungere altre macchine, se necessario. (Sebbene l’inserimento di un alias DNS anziché un FQDN possa sembrare valido, i controlli di integrità potrebbero fallire.)

Le macchine aggiunte manualmente appaiono sempre nella parte superiore dell’elenco delle macchine, sopra le macchine rilevate.

Un modo semplice per identificare una macchina aggiunta manualmente è il pulsante di eliminazione rosso all’estremità destra della riga. Solo le macchine aggiunte manualmente hanno quel pulsante. Le macchine rilevate no.

Per rimuovere una macchina aggiunta manualmente, fare clic sul pulsante rosso all’estremità destra della riga. Confermare l’eliminazione. Ripetere per eliminare altre macchine aggiunte manualmente.

Scout ricorda le macchine aggiunte manualmente finché non le si rimuove. Quando si chiude e poi si riapre Scout, le macchine aggiunte manualmente sono ancora elencate nella parte superiore dell’elenco.

Le tracce CDF non vengono raccolte quando si utilizza Traccia e riproduci sui server StoreFront. Tuttavia, tutte le altre informazioni di traccia vengono raccolte.

Importare macchine VDA

È possibile importare macchine VDA nella distribuzione quando si eseguono controlli di integrità.

1. Su Delivery Controller o Connector, generare il file dell’elenco delle macchine con il comando PowerShell. Su Connector, è necessario inserire le credenziali Citrix e selezionare il cliente nella finestra di dialogo a comparsa.

   Get-BrokerMachine| foreach { $_.DnsName } | out-file C:\machineList.txt

2. Copiare il file machineList.txt nella macchina aggiunta al dominio in cui si desidera avviare Scout Health Check.
3. Nella pagina Scout Health Check, fare clic su Aggiungi macchina.
4. Selezionare il tipo di macchina Windows VDA.
5. Fare clic su Importa macchine VDA.
6. Selezionare il file machineList.txt.
7. Fare clic su Apri.

Le macchine VDA importate sono elencate nella pagina Controllo integrità di Scout.

Raccogli diagnostica

La procedura Raccogli comprende la selezione delle macchine, l’avvio della raccolta della diagnostica e quindi il caricamento del file contenente la raccolta su Citrix o il salvataggio in locale.

1. Avviare Scout. Dal menu Start della macchina, selezionare Citrix > Citrix Scout. Nella pagina iniziale, fare clic su Raccogli.

2. Selezionare le macchine.

   • Su un Controller, la pagina Seleziona macchine elenca tutti i VDA e i Controller nel sito. È possibile filtrare la visualizzazione per nome della macchina. Per aggiungere altre macchine manualmente (ad esempio server StoreFront o Citrix Provisioning), vedere Aggiungere macchine manualmente.
   • Su altri componenti (ad esempio server VDA), la pagina Seleziona macchine elenca solo la macchina locale. L’aggiunta manuale di macchine non è supportata.

   Selezionare la casella di controllo accanto a ogni macchina da cui si desidera raccogliere la diagnostica, quindi fare clic su Continua.

   Scout avvia automaticamente i test di verifica su ogni macchina selezionata, assicurandosi che soddisfi i criteri elencati in Test di verifica. Se la verifica fallisce, viene visualizzato un messaggio nella colonna Stato e la casella di controllo di quella macchina viene deselezionata. È possibile:

   • Risolvere il problema e quindi selezionare di nuovo la casella di controllo della macchina. Ciò attiva un nuovo tentativo dei test di verifica.
   • Ignorare quella macchina (lasciare deselezionata la sua casella di controllo). La diagnostica non verrà raccolta da quella macchina.

   Quando i test di verifica sono completi, fare clic su Continua.

3. Raccogliere i dati diagnostici. Il riepilogo elenca tutte le macchine da cui vengono raccolti i dati diagnostici (le macchine selezionate che hanno superato i test di verifica). Fare clic su Avvia raccolta.

   Durante la raccolta:

   • La colonna Stato indica lo stato di raccolta corrente per una macchina.
   • Per interrompere una raccolta in corso su una singola macchina, fare clic su Annulla nella colonna Azione per quella macchina.
   • Per interrompere tutte le raccolte in corso, fare clic su Interrompi raccolta nell’angolo in basso a destra della pagina. I dati diagnostici delle macchine che hanno completato la raccolta vengono mantenuti. Per riprendere la raccolta, fare clic su Riprova nella colonna Azione per ciascuna macchina.
   • Quando la raccolta è completata per tutte le macchine selezionate, il pulsante Interrompi raccolta nell’angolo in basso a destra cambia in Continua.
   • Per raccogliere nuovamente i dati diagnostici, fare clic su Raccogli di nuovo nella colonna Azione di quella macchina. La raccolta più recente sovrascrive quella precedente.
   • Se una raccolta fallisce, è possibile fare clic su Riprova nella colonna Azione. Vengono caricate o salvate solo le raccolte riuscite.
   • Dopo che la raccolta è completata per tutte le macchine selezionate, non fare clic su Indietro. (Se si fa clic, la raccolta viene persa.)

   Quando la raccolta è completata, fare clic su Continua.

4. Salvare o caricare la raccolta. Scegliere se caricare il file su Citrix o salvarlo sulla macchina locale.

   Se si sceglie di caricare il file ora, continuare con il passaggio 5.

   Se si sceglie di salvare il file localmente:

   • Viene visualizzata una finestra di dialogo Salva di Windows. Passare alla posizione desiderata.
   • Al completamento del salvataggio locale, viene visualizzato e collegato il percorso del file. È possibile visualizzare il file. È possibile caricare il file in seguito su Citrix. Vedere CTX136396.

   Fare clic su Done per tornare alla pagina iniziale di Scout. Non è necessario completare ulteriori passaggi in questa procedura.

5. Autenticarsi per i caricamenti e, facoltativamente, specificare un proxy. Per i dettagli, vedere Autorizzazione al caricamento.

   • Se non ci si è autenticati tramite Scout, continuare con questo passaggio.
   • Se ci si è autenticati tramite Scout, il token di autorizzazione memorizzato viene utilizzato per impostazione predefinita. Se è questo che si desidera fare, selezionare questa opzione e fare clic su Continue. Non verranno richieste le credenziali per questa raccolta. Continuare con il passaggio 6.
   • Se ci si è autenticati in precedenza, ma si desidera riautorizzare e ottenere un nuovo token, fare clic su Change/Reauthorize e continuare con questo passaggio.

   Scegliere se si desidera utilizzare le credenziali Citrix o le credenziali Citrix Cloud per autenticare il caricamento. Fare clic su Continue. La pagina delle credenziali viene visualizzata solo se non si utilizza un token memorizzato.

   Nella pagina delle credenziali:

   • Se si desidera utilizzare un server proxy per il caricamento del file, fare clic su Configure proxy. È possibile indicare a Scout di utilizzare le impostazioni proxy configurate per le proprietà Internet del browser. Oppure, è possibile immettere l’indirizzo IP e il numero di porta del server proxy. Chiudere la finestra di dialogo del proxy.
   • Per un account Citrix Cloud, fare clic su Generate token. Il browser predefinito si avvia su una pagina Citrix Cloud dove viene visualizzato un token. Copiare il token, quindi incollarlo nella pagina Scout.
   • Per un account Citrix, inserire le proprie credenziali.

   Al termine, fare clic su Continue.

6. Inserire le informazioni sul caricamento.

   • Il campo del nome contiene il nome predefinito per il file per le diagnostiche raccolte. Questo è sufficiente per la maggior parte delle raccolte, anche se è possibile modificare il nome. (Se si elimina il nome predefinito e si lascia vuoto il campo del nome, viene utilizzato il nome predefinito.)
   • Facoltativamente, specificare un numero di caso di supporto Citrix di 8 cifre.
   • Nel campo facoltativo Descrizione, descrivere il problema e indicare quando si è verificato, se applicabile.

   Al termine, fare clic su Avvia caricamento.

   Durante il caricamento, la parte inferiore sinistra della pagina approssima la percentuale di caricamento completata. Per annullare un caricamento in corso, fare clic su Interrompi caricamento.

   Al completamento del caricamento, viene visualizzato e collegato l’URL della sua posizione. È possibile seguire il collegamento alla posizione Citrix per visualizzare l’analisi del caricamento, oppure copiare il collegamento.

   Fare clic su Fatto per tornare alla pagina iniziale di Scout.

Traccia e riproduci

La procedura Traccia e riproduci comprende la selezione delle macchine, l’avvio di una traccia, la riproduzione dei problemi, il completamento della raccolta diagnostica e quindi il caricamento del file su Citrix o il salvataggio in locale.

Questa procedura è simile alla procedura standard di Raccolta. Tuttavia, consente di avviare una traccia sulle macchine e quindi di ricreare i problemi su tali macchine. Tutte le raccolte diagnostiche includono informazioni di traccia AOT. Questa procedura aggiunge tracce CDF per facilitare la risoluzione dei problemi.

1. Avviare Scout. Dal menu Start della macchina, selezionare Citrix > Citrix Scout. Nella pagina iniziale, fare clic su Traccia e riproduci.

2. Selezionare le macchine. La pagina Seleziona macchine elenca tutti i VDA e i Controller nel sito. È possibile filtrare la visualizzazione per nome macchina. Selezionare la casella di controllo accanto a ciascuna macchina da cui si desidera raccogliere tracce e diagnostica. Quindi fare clic su Continua.

   Per aggiungere manualmente altre macchine (come i server StoreFront o Citrix Provisioning), vedere Aggiungere macchine manualmente.

   Scout avvia automaticamente test di verifica su ogni macchina selezionata, assicurandosi che soddisfi i criteri elencati in Test di verifica. Se la verifica fallisce per una macchina, viene visualizzato un messaggio nella colonna Stato e la casella di controllo di quella macchina viene deselezionata. È possibile:

   • Risolvere il problema e quindi selezionare nuovamente la casella di controllo della macchina. Questo attiva un nuovo tentativo dei test di verifica.
   • Saltare quella macchina (lasciare deselezionata la sua casella di controllo). La diagnostica e le tracce non vengono raccolte da quella macchina.

   Al completamento dei test di verifica, fare clic su Continua.

3. Avvia la traccia. Il riepilogo elenca tutte le macchine da cui vengono raccolte le tracce. Fare clic su Avvia traccia.

   Su una o più delle macchine selezionate, riprodurre i problemi riscontrati. La raccolta delle tracce continua mentre si esegue questa operazione. Al termine della riproduzione del problema, fare clic su Continua in Scout. Ciò interrompe la traccia.

   Dopo aver interrotto la traccia, indicare se il problema è stato riprodotto durante la traccia.

4. Raccogliere i dati diagnostici dalle macchine. Fare clic su Avvia raccolta. Durante la raccolta:

   • La colonna Stato indica lo stato di raccolta corrente per una macchina.
   • Per interrompere una raccolta in corso su una singola macchina, fare clic su Annulla nella colonna Azione per quella macchina.
   • Per interrompere tutte le raccolte in corso, fare clic su Interrompi raccolta nell’angolo in basso a destra della pagina. I dati diagnostici delle macchine che hanno completato la raccolta vengono mantenuti. Per riprendere la raccolta, fare clic su Riprova nella colonna Azione per ogni macchina.
   • Quando la raccolta è completata per tutte le macchine selezionate, il pulsante Interrompi raccolta nell’angolo in basso a destra cambia in Continua.
   • Per raccogliere nuovamente i dati diagnostici da una macchina, fare clic su Raccogli di nuovo nella colonna Azione di quella macchina. La raccolta più recente sovrascrive quella precedente.
   • Se una raccolta non riesce, è possibile fare clic su Riprova nella colonna Azione. Solo le raccolte riuscite vengono caricate o salvate.
   • Dopo che la raccolta è completata per tutte le macchine selezionate, non fare clic su Indietro. (In caso contrario, la raccolta andrà persa.)

   Quando la raccolta è completata, fare clic su Continua.

5. Salvare o caricare la raccolta. Scegliere se caricare il file su Citrix o salvarlo localmente.

   Se si sceglie di caricare il file ora, continuare con il passaggio 6.

   Se si sceglie di salvare il file localmente:

   • Viene visualizzata una finestra di dialogo Salva di Windows. Selezionare la posizione desiderata.
   • Al completamento del salvataggio locale, il percorso del file viene visualizzato e collegato. È possibile visualizzare il file. Ricorda: è possibile caricare il file in seguito da Citrix; vedere CTX136396 per i servizi Citrix Insight.

   Fare clic su Fatto per tornare alla pagina iniziale di Scout. Non è necessario completare ulteriori passaggi in questa procedura.

6. Autenticarsi per i caricamenti e, facoltativamente, specificare il proxy. Consultare Autorizzazione al caricamento per i dettagli di questo processo.

   • Se non ci si è autenticati tramite Scout, continuare con questo passaggio.
   • Se ci si è autenticati tramite Scout, il token di autorizzazione memorizzato viene utilizzato per impostazione predefinita. Se è questo che si desidera fare, scegliere questa opzione e fare clic su Continua. Non verranno richieste le credenziali per questa raccolta. Continuare con il passaggio 7.
   • Se ci si è autenticati in precedenza, ma si desidera riautorizzare e ottenere un nuovo token, fare clic su Cambia/Riautorizza e continuare con questo passaggio.

   Scegliere se si desidera utilizzare le credenziali Citrix o le credenziali Citrix Cloud per autenticare il caricamento. Fare clic su Continua. La pagina delle credenziali viene visualizzata solo se non si utilizza un token memorizzato.

   Nella pagina delle credenziali:

   • Se si desidera utilizzare un server proxy per il caricamento del file, fare clic su Configura proxy. È possibile indicare a Scout di utilizzare le impostazioni proxy configurate per le proprietà Internet del browser. Oppure, è possibile immettere l’indirizzo IP e il numero di porta del server proxy. Chiudere la finestra di dialogo del proxy.
   • Per un account Citrix Cloud, fare clic su Genera token. Il browser predefinito si aprirà su una pagina Citrix Cloud in cui viene visualizzato un token. Copiare il token e incollarlo nella pagina Scout.
   • Per un account Citrix, immettere le credenziali.

   Al termine, fare clic su Continua.

7. Fornire informazioni sul caricamento.

   Immettere i dettagli del caricamento:

   • Il campo nome contiene il nome predefinito per il file per le diagnostiche raccolte. Questo è sufficiente per la maggior parte delle raccolte, anche se è possibile modificare il nome. (Se si elimina il nome predefinito e si lascia vuoto il campo nome, viene utilizzato il nome predefinito.)
   • Facoltativamente, specificare un numero di caso di supporto Citrix di 8 cifre.
   • Nel campo facoltativo Descrizione, descrivere il problema e indicare quando si è verificato, se applicabile.

   Al termine, fare clic su Avvia caricamento.

   Durante il caricamento, la parte inferiore sinistra della pagina indica approssimativamente la percentuale di caricamento completata. Per annullare un caricamento in corso, fare clic su Interrompi caricamento.

   Al completamento del caricamento, l’URL della sua posizione viene visualizzato e collegato. È possibile seguire il collegamento alla posizione Citrix per visualizzare l’analisi del caricamento, oppure è possibile copiare il collegamento.

   Fare clic su Fine per tornare alla pagina iniziale di Scout.

Abilita la raccolta di log aggiuntivi

La funzione Abilita la raccolta di log aggiuntivi consente di utilizzare la funzione di traccia e riproduzione con più strumenti, come perfmon, Netsh, DebugView e Wireshark.

Nota:

Questo si applica solo alle macchine locali.

Per configurare la raccolta di log aggiuntivi:

1. Avviare Citrix Scout.
2. Fare clic sull’icona a forma di ingranaggio Impostazioni.
3. Fare clic su Abilita la raccolta di log aggiuntivi con più strumenti.
4. Fare clic su Salva.

Per raccogliere log aggiuntivi:

1. Nella home page di Scout, fare clic su Trace & Reproduce.
2. Nella pagina Select machines, fare clic sull’ingranaggio sul lato destro della macchina locale.
3. Nella pagina Select the tools require for logging:, fare clic su Download Tools.
4. Nella pagina Download Tools, selezionare gli strumenti che si desidera utilizzare e fare clic su Download. Gli strumenti vengono quindi scaricati, ad eccezione di Wireshark. Wireshark può essere scaricato e installato solo manualmente. Nota: se si sceglie di scaricare altri strumenti manualmente, è necessario estrarre il contenuto del file .zip scaricato in C:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\<toolname>. Ad esempio, se si scarica il file DebugView.zip, si decomprimerebbe il contenuto del file in C:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\DebugView\.
5. Nella pagina Select the tools require for logging:, fare clic su Refresh Status. Tutti gli strumenti selezionati appaiono come Present nella colonna Stato.
6. Selezionare gli strumenti per la registrazione, quindi fare clic su Next.
7. Seguire le istruzioni Trace and Reproduce.
8. Al termine, controllare i log nel file zip. I log sono compressi nella cartella CDCLogs.

Nota:

Se lo strumento Procmon è selezionato per la traccia, i log di Process Monitor possono diventare rapidamente di grandi dimensioni. Assicurarsi di selezionare solo gli strumenti necessari. È anche possibile monitorare le dimensioni dei log in %temp%\Scout-CDC-Log.

Pianificare le raccolte

Nota:

Attualmente è possibile pianificare le raccolte, ma non i controlli di integrità.

La procedura di pianificazione prevede la selezione delle macchine e quindi l’impostazione o l’annullamento della pianificazione. Le raccolte pianificate vengono caricate automaticamente su Citrix. (È possibile salvare le raccolte pianificate localmente utilizzando l’interfaccia PowerShell. Vedere Citrix Call Home.)

1. Avviare Scout. Dal menu Start della macchina, selezionare Citrix > Citrix Scout. Nella pagina iniziale, fare clic su Pianifica.

2. Selezionare le macchine. Vengono elencati tutti i VDA e i Controller nel sito. È possibile filtrare la visualizzazione in base al nome della macchina.

   Quando sono stati installati VDA e Controller utilizzando l’interfaccia grafica, se è stata impostata una pianificazione Call Home (vedere Citrix Call Home), Scout visualizza tali impostazioni per impostazione predefinita. È possibile utilizzare questa versione di Scout per avviare le raccolte pianificate per la prima volta o per modificare una pianificazione configurata in precedenza.

   Sebbene sia stato abilitato/disabilitato Call Home per singola macchina durante l’installazione del componente, una pianificazione configurata in Scout influisce su tutte le macchine selezionate.

   Selezionare la casella di controllo accanto a ciascuna macchina da cui si desidera raccogliere i dati diagnostici, quindi fare clic su Continua.

   Per aggiungere altre macchine manualmente (ad esempio server StoreFront o Citrix Provisioning), vedere Aggiungere macchine manualmente.

   Scout avvia automaticamente i test di verifica su ciascuna delle macchine selezionate, assicurandosi che soddisfi i criteri in Test di verifica. Se la verifica fallisce per una macchina, viene visualizzato un messaggio nella colonna Stato e la casella di controllo di quella macchina viene deselezionata. È possibile:

   • Risolvere il problema e quindi selezionare nuovamente la casella di controllo della macchina. Ciò attiva un nuovo tentativo dei test di verifica.
   • Ignorare quella macchina (lasciare deselezionata la sua casella di controllo). I dati diagnostici (o le tracce) non vengono raccolti da quella macchina.

   Al termine dei test di verifica, fare clic su Continua.

   La pagina di riepilogo elenca le macchine a cui vengono applicate le pianificazioni. Fare clic su Continua.

3. Impostare la pianificazione. Indicare quando si desidera che vengano raccolti i dati diagnostici. Ricorda: la pianificazione influisce su tutte le macchine selezionate.

   • Per configurare una pianificazione settimanale per le macchine selezionate, fare clic su Settimanale. Scegliere il giorno della settimana. Immettere l’ora del giorno (formato 24 ore) in cui deve iniziare la raccolta.
   • Per configurare una pianificazione giornaliera per le macchine selezionate, fare clic su Giornaliera. Immettere l’ora del giorno (formato 24 ore) in cui deve iniziare la raccolta.
   • Per annullare una pianificazione esistente per le macchine selezionate (e non sostituirla con un’altra), fare clic su Off. Questo annulla qualsiasi pianificazione configurata in precedenza per tali macchine.

   Fare clic su Continua.

4. Autenticarsi per i caricamenti e, facoltativamente, specificare un proxy. Per i dettagli di questo processo, consultare Autorizzazione al caricamento. Ricorda: non è possibile utilizzare un token memorizzato per l’autenticazione quando si lavora con una pianificazione Scout.

   Scegliere se si desidera utilizzare le credenziali Citrix o le credenziali Citrix Cloud per autenticare il caricamento. Fare clic su Continua.

   Nella pagina delle credenziali:

   • Se si desidera utilizzare un server proxy per il caricamento del file, fare clic su Configura proxy. È possibile indicare a Scout di utilizzare le impostazioni proxy configurate per le proprietà Internet del browser. Oppure, è possibile inserire l’indirizzo IP e il numero di porta del server proxy. Chiudere la finestra di dialogo del proxy.
   • Per un account Citrix Cloud, fare clic su Genera token. Il browser predefinito si aprirà su una pagina Citrix Cloud dove verrà visualizzato un token. Copiare il token e incollarlo nella pagina Scout.
   • Per un account Citrix, inserire le proprie credenziali.

   Al termine, fare clic su Continua.

   Rivedere la pianificazione configurata. Fare clic su Fatto per tornare alla pagina iniziale di Scout.

   Durante una raccolta, il registro applicazioni di Windows di ogni macchina selezionata contiene voci relative alla raccolta e al caricamento.

Mascheramento dei dati

Le informazioni diagnostiche raccolte utilizzando Citrix Scout potrebbero contenere informazioni sensibili alla sicurezza. La funzione di mascheramento dei dati di Citrix Scout consente di mascherare i dati sensibili nei file diagnostici prima di caricarli su Citrix.

Il mascheramento dei dati di Scout è configurato per mascherare l’indirizzo IP, i nomi delle macchine, i nomi di dominio, i nomi utente, i nomi degli hypervisor, i nomi dei Delivery Group, i nomi dei cataloghi, i nomi delle applicazioni e i SID.

Nota:

Le tracce CDF sono crittografate e non possono essere mascherate.

I log di Linux VDA sono compressi nel formato .tar.gz2 e non possono essere mascherati.

Raccogliere nuove diagnostiche ed eseguire il mascheramento dei dati

Per utilizzare la funzionalità di mascheramento dei dati di Citrix Scout, avviare Scout dalla riga di comando.

1. In Windows, aprire il prompt dei comandi come amministratore.
2. Andare alla directory in cui è installato Scout: cd C:\Program Files\Citrix\Telemetry Service.
3. Avviare Scout: ScoutUI.exe datamasking.
4. Fare clic su Collect o Trace & Reproduce per raccogliere le diagnostiche.
5. Al termine della raccolta, selezionare Enable data masking. Questa opzione è abilitata per impostazione predefinita.
6. Configurare la maschera dei dati. È possibile utilizzare le regole predefinite o personalizzare le regole.
7. Selezionare se caricare o salvare la raccolta di diagnostiche.
   • Se si seleziona Upload the diagnostics collection to Citrix, i file di diagnostica mascherati vengono caricati su Citrix.
   • Se si seleziona Save the diagnostics collection on your local machine, sia le diagnostiche originali che quelle mascherate vengono salvate nella posizione specificata.

Eseguire il mascheramento dei dati su diagnostiche esistenti

1. In Windows, aprire il prompt dei comandi come amministratore.
2. Vai alla directory in cui è installato Scout: cd C:\Program Files\Citrix\Telemetry Service.
3. Avvia Scout direttamente in modalità mascheramento dati: ScoutUI.exe datamasking filePath.
4. Selezionare “Abilita mascheramento dati” per continuare. Questa opzione è abilitata per impostazione predefinita.
5. Configurare la maschera dati. È possibile eseguire il mascheramento dei dati con le regole predefinite o personalizzare le regole.
6. Selezionare se caricare o salvare la raccolta di diagnostica.
   • Se si seleziona Carica la raccolta di diagnostica su Citrix, i file di diagnostica mascherati vengono caricati su Citrix.
   • Se si seleziona Salva la raccolta di diagnostica sul computer locale, sia la diagnostica originale che quella mascherata vengono salvate nella posizione specificata.

Posizioni dei file di dati mascherati e dei file di mappatura

Dopo aver caricato o salvato la raccolta di diagnostica, fare clic sul collegamento per aprire la diagnostica originale e mascherata e aprire il file delle informazioni di mappatura.

Raccolta dati di utilizzo

Quando si utilizza Scout, Citrix utilizza Google Analytics per raccogliere dati di utilizzo anonimi da utilizzare per future funzionalità e miglioramenti del prodotto. La raccolta dati è abilitata per impostazione predefinita.

Per modificare la raccolta e il caricamento dei dati di utilizzo, fare clic sull’icona a forma di ingranaggio Impostazioni nell’interfaccia utente di Scout. È quindi possibile scegliere se inviare le informazioni selezionando Sì o No e quindi facendo clic su Salva.