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 di diagnostica 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 successivamente caricare il file di raccolta su Citrix per l’analisi.

Scout offre le seguenti procedure:

• Raccogli: Esegue una raccolta di 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 o lo salva localmente.
• Pianifica: Pianifica le raccolte di diagnostica in modo che avvengano quotidianamente o settimanalamente 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 Agent (VDA), server StoreFront™ e server licenze Citrix. Se vengono riscontrati 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 VDA Linux.

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 Agent (VDA), Delivery Controller, server StoreFront e server licenze. È inoltre 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 è archiviato in C:\ProgramData\Citrix\TelemetryService\ScoutUI.log. Questo file può essere utilizzato per la risoluzione dei problemi.

Guardare una dimostrazione di Citrix Scout.

Cosa viene raccolto

La diagnostica raccolta da Scout include i file di log di traccia Citrix Diagnostic Facility (CDF). È incluso anche un sottoinsieme di tracce CDF chiamato Traccia sempre attiva (AOT). Le informazioni AOT possono essere utili per la risoluzione di 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) nello spazio dei nomi Citrix.
• Processi in esecuzione.
• Dump di arresto anomalo dei processi Citrix archiviati in %PROGRAMDATA%\Citrix\CDF.
• Informazioni sui criteri 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 durante la raccolta, mantenendo un ingombro ridotto sulla macchina.
• Su ogni macchina, il servizio di telemetria Citrix mantiene 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 dello slice, 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 che Scout raccoglie, vedere Punti dati chiave di Call Home.

Configurazione di Scout

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

Il VDA Linux potrebbe modificare automaticamente la porta del 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 per 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 in 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 se esistono i seguenti problemi, basati sulle raccomandazioni Citrix per i siti Virtual Apps and Desktops:

• Uno o più Delivery Controller sono in stato di errore.
• Nel sito è presente un solo Delivery Controller.
• 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 servizio Broker 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 controlla:

• 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 VDA

Per gli avvii di sessione sui VDA, Scout controlla:

• 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 controlla:

• 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 controlla:

• Rilevamento dell’hypervisor
• Rilevamento del provisioning
• Citrix Virtual Apps and Desktops
• Configurazione di vDisk personale
• Archivio utente
• Rilevamento dello stato del servizio Profile Management
• Test di hooking di Winlogon.exe

Per eseguire controlli su Profile Management, è necessario installare e abilitare Profile Management sul VDA. Per maggiori informazioni sui controlli di configurazione di Profile Management, vedere 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 del server licenze dal Delivery Controller
• Stato dell’accesso remoto del firewall del server licenze
• Stato del servizio di licenze Citrix
• Stato del periodo di tolleranza 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 di 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 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 Controllo integrità.

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 server licenze rilevati nel sito. È possibile filtrare la visualizzazione per nome macchina. Selezionare la casella di controllo accanto a ciascuna macchina da cui si desidera raccogliere la diagnostica, quindi fare clic su Continua.

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

   Scout avvia automaticamente i test di verifica su ciascuna 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 completamento 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. Al completamento dei controlli, fare clic su Fatto per tornare alla pagina iniziale di Scout.

Risultati del controllo integrità

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

• Ora e data di generazione del rapporto sui risultati
• Macchine controllate
• Condizioni ricercate dal controllo sulle macchine target

Autorizzazioni e requisiti

Autorizzazioni:

• Per raccogliere la diagnostica:

  • È necessario essere un amministratore locale e un utente di dominio per ogni macchina da cui si sta raccogliendo la diagnostica.
  • È necessario disporre dell’autorizzazione di scrittura nella directory LocalAppData su ogni macchina.

• Per eseguire i controlli di integrità:

  • È necessario essere un membro del gruppo di 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 il criterio 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 quando si avvia Scout.

Per ogni macchina da cui si raccolgono diagnostiche 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 di telemetria Citrix 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 di telemetria per Windows viene eseguito su Servizio di rete.

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

Solo gli utenti del gruppo Administrator, System e il SID del servizio di telemetria hanno l’autorizzazione per accedere al registro HKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetry.

Il SID del servizio di telemetria rimane nel gruppo Utenti log 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 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. Vedere la documentazione Microsoft per le istruzioni.
• Abilitare PSRemoting e WinRM - È possibile abilitare il remoting PowerShell e WinRM contemporaneamente. Utilizzando Esegui come amministratore, eseguire il cmdlet Enable-PSRemoting. Per i dettagli, vedere la guida Microsoft per il cmdlet.
• Scout richiede PowerShell 3.0 (minimo) - Installare PowerShell 3.0 (o versioni successive) sulla macchina, quindi abilitare il remoting PowerShell.
• Impossibile accedere alla directory LocalAppData su questa macchina - Assicurarsi che l’account abbia l’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 Firewall di Windows.
• Richiesta una versione più recente del servizio di telemetria Citrix - (La versione viene controllata solo per Raccogli e Traccia e riproduci.) Aggiornare la versione del servizio di telemetria sulla macchina (vedere Installazione e aggiornamento). Se non si aggiorna il servizio, quella macchina non viene inclusa nelle azioni Raccogli o Traccia e riproduci. Per aggiornare il servizio di telemetria, utilizzare la stessa procedura di installazione.

• 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 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 di telemetria VDA Linux non è avviato su questa macchina - Assicurarsi che:

  • La porta 7502 sia aperta. Verificare che il servizio di telemetria VDA Linux sia installato e avviato sulla macchina. La porta potrebbe essere diversa se la porta del servizio di telemetria è 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).

Installazione e aggiornamento

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

Se si omette il servizio di telemetria Citrix 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 di telemetria Citrix. Citrix consiglia di utilizzare la versione più recente supportata. Se non si aggiorna il servizio di telemetria su quella macchina, essa non viene inclusa nelle azioni Raccogli o Traccia e riproduci. Per aggiornare il servizio di telemetria, 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, il processo di emissione del token non è visibile. È sufficiente inserire le credenziali dell’account. Dopo che Citrix convalida le credenziali, è possibile continuare con la procedura guidata di Scout.
• Se ci si autentica con un account Citrix Cloud, si fa clic su un collegamento per accedere a Citrix Cloud utilizzando 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 quel 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 quando si crea o si modifica una pianificazione.

Utilizzare un proxy per i caricamenti

Se si desidera utilizzare un server proxy per caricare le raccolte su Citrix, è possibile istruire Scout a 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 i Controller e i VDA che rileva automaticamente.

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

Quando si esegue Controllo integrità di Scout da una macchina aggiunta a un dominio che non è un Delivery Controller, Scout non può rilevare le macchine automaticamente. È 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 server StoreFront, server licenze e server Citrix Provisioning.

Quando si eseguono controlli di integrità:

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

In qualsiasi pagina di Scout che elenca le macchine rilevate, fare clic su + Aggiungi macchina. Digitare l’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 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 sulla macchina aggiunta al dominio da cui si desidera avviare il Controllo integrità di Scout.
3. Nella pagina Controllo integrità di Scout, 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.

Raccogliere la diagnostica

La procedura Raccogli comprende la selezione delle macchine, l’avvio della raccolta diagnostica e quindi il caricamento del file contenente la raccolta su Citrix o il salvataggio 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 macchina. Per aggiungere altre macchine manualmente (come server StoreFront o Citrix Provisioning), vedere Aggiungere macchine manualmente.
   • Su altri componenti (come i 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 ciascuna macchina da cui si desidera raccogliere la diagnostica, quindi fare clic su Continua.

   Scout avvia automaticamente i test di verifica su ciascuna 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). La diagnostica non verrà raccolta da quella macchina.

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

3. Raccogliere la diagnostica. Il riepilogo elenca tutte le macchine da cui viene raccolta la diagnostica (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. La diagnostica delle macchine che hanno completato la raccolta viene mantenuta. 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 la diagnostica, 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. 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.)

   Al completamento della raccolta, 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. Navigare fino alla posizione desiderata.
   • Al completamento del salvataggio locale, il nome percorso del file viene visualizzato e collegato. È possibile visualizzare il file. È possibile caricare il file in seguito su Citrix. Vedere CTX136396.

   Fare clic su Fatto 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 Continua. 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 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 appare 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 istruire Scout a 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 avvia su una pagina Citrix Cloud in cui viene visualizzato un token. Copiare il token e incollarlo nella pagina di Scout.
   • Per un account Citrix, inserire le credenziali.

   Al termine, fare clic su Continua.

6. Inserire le informazioni sul caricamento.

   • Il campo del nome contiene il nome predefinito per il file per la diagnostica raccolta. Questo è sufficiente per la maggior parte delle raccolte, anche se è possibile modificare il nome. (Se si elimina il nome predefinito e si lascia il campo del nome vuoto, viene utilizzato il nome predefinito.)
   • Facoltativamente, specificare un numero di caso del Supporto Citrix di 8 cifre.
   • Nel campo Descrizione facoltativo, 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, 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 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 locale.

Questa procedura è simile alla procedura Raccogli standard. 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 aiutare 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 altre macchine manualmente (come server StoreFront o Citrix Provisioning), vedere Aggiungere macchine manualmente.

   Scout avvia automaticamente i test di verifica su ciascuna 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. Ciò 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. Avviare 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 si è riprodotto il problema durante la traccia.

4. Raccogliere la diagnostica 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. La diagnostica delle macchine che hanno completato la raccolta viene mantenuta. 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 la diagnostica 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 fallisce, è 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.)

   Al completamento della raccolta, 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 nome percorso del file viene visualizzato e collegato. È possibile visualizzare il file. Ricordare: è possibile caricare il file in seguito da Citrix; vedere CTX136396 per Citrix Insight Services.

   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 un proxy. Vedere 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 appare 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 istruire Scout a 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 avvia su una pagina Citrix Cloud in cui viene visualizzato un token. Copiare il token e incollarlo nella pagina di Scout.
   • Per un account Citrix, inserire le credenziali.

   Al termine, fare clic su Continua.

7. Fornire informazioni sul caricamento.

   Inserire i dettagli del caricamento:

   • Il campo del nome contiene il nome predefinito per il file per la diagnostica raccolta. Questo è sufficiente per la maggior parte delle raccolte, anche se è possibile modificare il nome. (Se si elimina il nome predefinito e si lascia il campo del nome vuoto, viene utilizzato il nome predefinito.)
   • Facoltativamente, specificare un numero di caso del Supporto Citrix di 8 cifre.
   • Nel campo Descrizione facoltativo, 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, 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 Fatto per tornare alla pagina iniziale di Scout.

Abilitare la raccolta di log aggiuntivi

La funzione Abilita raccolta 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 raccolta log aggiuntivi con più strumenti.
4. Fare clic su Salva.

Per raccogliere log aggiuntivi:

1. Nella home page di Scout, fare clic su Traccia e riproduci.
2. Nella pagina Seleziona macchine, fare clic sull’ingranaggio sul lato destro della macchina locale.
3. Nella pagina Seleziona gli strumenti necessari per la registrazione:, fare clic su Scarica strumenti.
4. Nella pagina Scarica strumenti, selezionare gli strumenti che si desidera utilizzare e fare clic su Scarica. 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\<nome_strumento>. 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 Seleziona gli strumenti necessari per la registrazione:, fare clic su Aggiorna stato. Tutti gli strumenti selezionati appaiono come Presente nella colonna Stato.
6. Selezionare gli strumenti per la registrazione, quindi fare clic su Avanti.
7. Seguire le istruzioni Traccia e riproduci.
8. Al completamento, 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 Monitoraggio processi 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 comprende 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 per nome macchina.

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

   Sebbene si sia abilitato/disabilitato Call Home su base per macchina durante l’installazione dei componenti, 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 la diagnostica, quindi fare clic su Continua.

   Per aggiungere altre macchine manualmente (come 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.
   • Saltare quella macchina (lasciare deselezionata la sua casella di controllo). La diagnostica (o le tracce) non vengono raccolte da quella macchina.

   Al completamento 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 la diagnostica venga raccolta. Ricordare: 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. Inserire l’ora del giorno (formato 24 ore) per l’inizio della raccolta.
   • Per configurare una pianificazione giornaliera per le macchine selezionate, fare clic su Giornaliera. Inserire l’ora del giorno (formato 24 ore) per l’inizio della raccolta.
   • Per annullare una pianificazione esistente per le macchine selezionate (e non sostituirla con un’altra), fare clic su Disattivato. Ciò annulla qualsiasi pianificazione configurata in precedenza per quelle macchine.

   Fare clic su Continua.

4. Autenticarsi per i caricamenti e, facoltativamente, specificare un proxy. Vedere Autorizzazione al caricamento per i dettagli di questo processo. Ricordare: non è possibile utilizzare un token memorizzato per autenticarsi quando si lavora con una pianificazione di 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 istruire Scout a 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 avvia su una pagina Citrix Cloud in cui viene visualizzato un token. Copiare il token e incollarlo nella pagina di Scout.
   • Per un account Citrix, inserire le 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 log delle 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 gruppi di consegna, i nomi dei cataloghi, i nomi delle applicazioni e i SID.

Nota:

Le tracce CDF sono crittografate e non possono essere mascherate.

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

Raccogliere nuova diagnostica ed eseguire il mascheramento dei dati

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

1. In Windows, aprire il prompt dei comandi come amministratore.
2. Accedere alla directory in cui è installato Scout: cd C:\Program Files\Citrix\Telemetry Service.
3. Avviare Scout: ScoutUI.exe datamasking.
4. Fare clic su Raccogli o Traccia e riproduci per raccogliere la diagnostica.
5. Al completamento della raccolta, selezionare Abilita mascheramento dei dati. 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 diagnostica.
   • Se si seleziona Carica la raccolta diagnostica su Citrix, i file diagnostici mascherati vengono caricati su Citrix.
   • Se si seleziona Salva la raccolta diagnostica sulla macchina locale, sia la diagnostica originale che quella mascherata vengono salvate nella posizione specificata.

Eseguire il mascheramento dei dati sulla diagnostica esistente

1. In Windows, aprire il prompt dei comandi come amministratore.
2. Accedere alla directory in cui è installato Scout: cd C:\Program Files\Citrix\Telemetry Service.
3. Avviare Scout direttamente in modalità di mascheramento dei dati: ScoutUI.exe datamasking filePath.
4. Selezionare “Abilita mascheramento dei dati” per continuare. Questa opzione è abilitata per impostazione predefinita.
5. Configurare la maschera dei dati. È possibile eseguire il mascheramento dei dati con le regole predefinite o personalizzare le regole.
6. Selezionare se caricare o salvare la raccolta diagnostica.
   • Se si seleziona Carica la raccolta diagnostica su Citrix, i file diagnostici mascherati vengono caricati su Citrix.
   • Se si seleziona Salva la raccolta diagnostica sulla macchina 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 diagnostica, fare clic sul collegamento per aprire la diagnostica originale e mascherata e aprire il file di 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.