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 successivamente 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, o 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 Agent (VDA), server StoreFront™ e Citrix License Server. Se vengono rilevati problemi durante i controlli, Scout fornisce un rapporto dettagliato. Ogni volta che Scout si avvia, controlla la presenza di script di controllo di integrità aggiornati. Se sono disponibili nuove versioni, Scout le scarica automaticamente, per l’utilizzo 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 Agent (VDA), Delivery Controller, server StoreFront e License Server. È 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 per l’applicazione Scout è memorizzato in C:\ProgramData\Citrix\TelemetryService\ScoutUI.log. Questo file può essere utilizzato per la risoluzione dei problemi.
Cosa viene raccolto
La diagnostica raccolta da Scout include 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 namespace Citrix.
- Processi in esecuzione.
- Dump di crash 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 falliti, 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 Citrix Telemetry Service 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 su 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-CitrixTraceo la stringa di registroHKEY_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 Linux VDA e telemetria, vedere Integrare con il Citrix Telemetry Service
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.
- Passare a C:\Program Files\Citrix\Telemetry Service
- Aprire il file ScoutUI.exe.config.
-
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"/>
- Salvare le modifiche e chiudere il file.
- Aprire nuovamente Scout per assicurarsi che carichi la configurazione più recente.
Informazioni sui controlli di integrità
I dati dei controlli di integrità sono memorizzati in cartelle sotto C:\ProgramData\Citrix\TelemetryService\.
Controlli di integrità del sito
I controlli di integrità del sito sono inclusi nel servizio Environment Test, 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, basati sulle raccomandazioni Citrix per i siti Virtual Apps and Desktops:
- Uno o più Delivery Controller sono in stato di errore.
- C’è solo un 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 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 Citrix
- Impostazioni di Criteri di gruppo Microsoft
- Impostazioni di Criteri di gruppo Citrix
Per Profile Management sui VDA, Scout controlla:
- Rilevamento hypervisor
- Rilevamento provisioning
- Citrix Virtual Apps and Desktops
- Configurazione Personal vDisk
- Archivio utente
- Rilevamento dello stato del servizio Profile Management
- Test di hooking 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 License Server
I controlli del License Server verificano:
- Connessione del License Server dal Delivery Controller
- Stato dell’accesso remoto del firewall del License Server
- Stato del servizio Citrix Licensing
- Stato del periodo di grazia del License Server
- Connessione delle porte del License Server
- Se il daemon del fornitore Citrix (CITRIX) è in esecuzione
- Se gli orologi di sistema sono sincronizzati
- Se il servizio Citrix Licensing è in esecuzione con l’account Servizio locale
- Presenza del file
CITRIX.opt - Data di idoneità ai Customer Success Services
- Aggiornamento del Citrix License Server
- Se il certificato del License Server si trova nell’archivio radice attendibile del Delivery Controller
Oltre a soddisfare le autorizzazioni e i requisiti per i controlli di integrità, il License Server deve essere aggiunto a un dominio. Altrimenti, il License Server non viene rilevato.
Eseguire i controlli di integrità
La procedura di Controllo integrità comprende la selezione delle macchine, l’avvio del controllo e quindi la revisione del rapporto sui risultati.
- Avviare Scout. Dal menu Start della macchina, selezionare Citrix > Citrix Scout. Nella pagina iniziale, fare clic su Controllo integrità.
-
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 ogni 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 Citrix Provisioning™ Server 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 la sua casella di controllo deselezionata). I controlli di integrità non vengono eseguiti per quella macchina.
Quando i test di verifica sono completati, fare clic su Continua.
-
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 si completa senza problemi rilevati, 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.)
- 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 rapporto sui risultati
- Macchine controllate
- Condizioni che il controllo ha cercato sulle macchine di destinazione
Autorizzazioni e requisiti
Autorizzazioni:
-
Per raccogliere diagnostica:
- È necessario essere un amministratore locale e un utente di dominio per ogni macchina da cui si raccoglie 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 utenti del dominio.
- È necessario essere un amministratore completo o avere un ruolo personalizzato con autorizzazioni di sola lettura e Esegui test ambiente per il sito.
- Impostare la policy di esecuzione degli script su almeno
RemoteSignedper 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 raccoglie la diagnostica o si eseguono i 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 Citrix Telemetry Service 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. Ciò impedisce la raccolta di informazioni diagnostiche.
Scout esegue test di verifica sulle macchine selezionate, per assicurarsi che questi requisiti siano soddisfatti.
Il Telemetry Service per Windows viene eseguito su Network Service.
La cartella di traccia AOT è salvata in C:\ProgramData\Citrix\TelemetryService\CitrixAOT.
Solo gli utenti nel gruppo Administrator, System e Telemetry Service SID hanno l’autorizzazione per accedere al registro HKEYLOCALMACHINE:SOFTWARE\Citrix\Telemetry.
Il SID del Telemetry Service rimane nel gruppo Performance Log Users dopo la disinstallazione del Telemetry Service, 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 può 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 PowerShell remoting 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 PowerShell remoting.
- 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 Citrix Telemetry Service - Assicurarsi che il Citrix Telemetry Service 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.
- Richiesta una versione più recente del Citrix Telemetry Service - (La versione viene controllata solo per Raccogli e Traccia e riproduci.) Aggiornare la versione del Telemetry Service sulla macchina (vedere Installazione e aggiornamento). Se non si aggiorna il servizio, quella macchina non sarà inclusa nelle azioni Raccogli o Traccia e riproduci.
-
Scout non può 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 Linux VDA Telemetry Service non è avviato su questa macchina - Assicurarsi che:
- La porta 7502 sia aperta. Verificare che il Linux VDA Telemetry Service 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 Citrix Virtual Apps and Desktops (o minimo XenApp e XenDesktop 7.14) Controller e VDA.
| Funzionalità | Scout 2.23 | Scout 3.0 |
|---|---|---|
| Supporto Citrix Virtual Apps and Desktops (più XenApp e XenDesktop da 7.14 a 7.18) | Sì | Sì |
| Supporto XenDesktop 5.x, 7.1–7.13 | Sì | No |
| Supporto XenApp 6.x, 7.5 a 7.13 | Sì | No |
| Fornito con il prodotto | 7.1–7.13 | A partire da 7.14 |
| Scaricabile dall’articolo CTX | Sì | No |
| Acquisizione tracce CDF | Sì | Sì |
| Acquisizione tracce Always-on (AOT) | No | Sì |
| Consente la raccolta di dati diagnostici | Fino a 10 macchine contemporaneamente (per impostazione predefinita) | Illimitato (soggetto alla disponibilità di risorse) |
| Consente l’invio di dati diagnostici a Citrix | Sì | Sì |
| Consente il salvataggio locale dei dati diagnostici | Sì | Sì |
| Supporto credenziali Citrix Cloud™ | No | Sì |
| Supporto credenziali Citrix | Sì | Sì |
| Supporto server proxy per i caricamenti | Sì | Sì |
| Regola pianificazioni | N/D | Sì |
| Supporto script | Riga di comando (solo Controller locale) | PowerShell utilizzando i cmdlet Call Home (qualsiasi macchina con il Telemetry Service installato) |
| Controlli di integrità | No | Sì |
| Mascheramento dati | No | A partire da 3.17 |
Installazione e aggiornamento
Per impostazione predefinita, Scout viene installato o aggiornato automaticamente come parte del Citrix Telemetry Service quando si installa o si aggiorna un VDA o un Controller.
Se si omette il Citrix Telemetry Service 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 Citrix Telemetry Service. Citrix raccomanda di utilizzare la versione più recente supportata. Se non si aggiorna il Telemetry Service su quella macchina, non sarà incluso nelle azioni Raccogli o Traccia e riproduci. Per aggiornare il Telemetry Service, 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 link 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 nella procedura guidata di Scout.
Il token viene memorizzato localmente sulla macchina in cui si esegue Scout. Per abilitare l’utilizzo 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 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 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 delivery controller, VDA, license server e 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 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 server StoreFront, License Server e server Citrix Provisioning.
Quando si eseguono i controlli di integrità:
- I Citrix License Server nel dominio vengono rilevati automaticamente. Non è possibile aggiungere License Server 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 i controlli di integrità.
-
Su Delivery Controller o Connector, generare il file dell’elenco 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 - Copiare il file machineList.txt sulla macchina aggiunta al dominio da cui si desidera avviare Controllo integrità di Scout.
- Nella pagina Controllo integrità di Scout, fare clic su Aggiungi macchina.
- Selezionare il tipo di macchina Windows VDA.
- Fare clic su Importa macchine VDA.
- Selezionare il file machineList.txt.
- Fare clic su Apri.
Le macchine VDA importate sono elencate nella pagina Controllo integrità di Scout.
Raccogliere 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.
- Avviare Scout. Dal menu Start della macchina, selezionare Citrix > Citrix Scout. Nella pagina iniziale, fare clic su Raccogli.
-
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 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 nuovamente la casella di controllo della macchina. Ciò attiva un nuovo tentativo dei test di verifica.
- Saltare quella macchina (lasciare la sua casella di controllo deselezionata). La diagnostica non verrà raccolta da quella macchina.
Quando i test di verifica sono completati, fare clic su Continua.
-
Raccogliere 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 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 la diagnostica, fare clic su Raccogli di nuovo nella colonna Azione di quella macchina. La raccolta più recente sovrascrive la 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.)
Quando la raccolta è completata, fare clic su Continua.
-
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.
- Quando il salvataggio locale è completato, il 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.
-
Autenticarsi per i caricamenti e specificare facoltativamente 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 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 di Citrix Cloud dove 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.
-
Inserire le informazioni sul caricamento.
- Il campo nome contiene il nome predefinito per il file della diagnostica raccolta. Questo è sufficiente per la maggior parte delle raccolte, sebbene sia possibile modificare il nome. (Se si elimina il nome predefinito e si lascia il campo 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.
Quando il caricamento è completato, l’URL della sua posizione viene visualizzato e collegato. È possibile seguire il link alla posizione Citrix per visualizzare l’analisi del caricamento, oppure è possibile copiare il link.
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.
- Avviare Scout. Dal menu Start della macchina, selezionare Citrix > Citrix Scout. Nella pagina iniziale, fare clic su Traccia e riproduci.
-
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 ogni 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 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. Ciò attiva un nuovo tentativo dei test di verifica.
- Saltare quella macchina (lasciare la sua casella di controllo deselezionata). La diagnostica e le tracce non vengono raccolte da quella macchina.
Quando i test di verifica sono completati, fare clic su Continua.
-
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.
-
Raccogliere 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 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 la diagnostica da una macchina, fare clic su Raccogli di nuovo nella colonna Azione di quella macchina. La raccolta più recente sovrascrive la 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.)
Quando la raccolta è completata, fare clic su Continua.
-
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.
- Quando il salvataggio locale è completato, il percorso del file viene visualizzato e collegato. È possibile visualizzare il file. Ricorda: è 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.
-
Autenticarsi per i caricamenti e specificare facoltativamente un proxy. Rivedere 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 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 di Citrix Cloud dove 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.
-
Fornire informazioni sul caricamento.
Inserire i dettagli del caricamento:
- Il campo nome contiene il nome predefinito per il file della diagnostica raccolta. Questo è sufficiente per la maggior parte delle raccolte, sebbene sia possibile modificare il nome. (Se si elimina il nome predefinito e si lascia il campo 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.
Quando il caricamento è completato, l’URL della sua posizione viene visualizzato e collegato. È possibile seguire il link alla posizione Citrix per visualizzare l’analisi del caricamento, oppure è possibile copiare il link.
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:
- Avviare Citrix Scout.
- Fare clic sull’icona a forma di ingranaggio Impostazioni.
- Fare clic su Abilita raccolta log aggiuntivi con più strumenti.
- Fare clic su Salva.
Per raccogliere log aggiuntivi:
- Nella pagina iniziale di Scout, fare clic su Traccia e riproduci.
- Nella pagina Seleziona macchine, fare clic sull’ingranaggio sul lato destro della macchina locale.
- Nella pagina Seleziona gli strumenti richiesti per la registrazione:, fare clic su Scarica strumenti.
- 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\<toolname>. Ad esempio, se si scarica il file DebugView.zip, si decomprimerebbe il contenuto del file inC:\ProgramData\Citrix\TelemetryService\CDC\Lib\Resources\Tools\DebugView\. - Nella pagina Seleziona gli strumenti richiesti per la registrazione:, fare clic su Aggiorna stato. Tutti gli strumenti selezionati appaiono come Presente nella colonna Stato.
- Selezionare gli strumenti per la registrazione, quindi fare clic su Avanti.
- Seguire le istruzioni Traccia e riproduci.
- 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 crescere rapidamente di dimensioni. Assicurarsi di selezionare solo gli strumenti necessari. È inoltre possibile monitorare la dimensione dei log in %temp%\Scout-CDC-Log.
Pianificare le raccolte
Nota:
Attualmente è possibile pianificare le raccolte, ma non i controlli di integrità.
La procedura Pianifica 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.)
- Avviare Scout. Dal menu Start della macchina, selezionare Citrix > Citrix Scout. Nella pagina iniziale, fare clic su Pianifica.
-
Selezionare le macchine. Tutti i VDA e i Controller nel sito sono elencati. È 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 ogni 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 la sua casella di controllo deselezionata). La diagnostica (o le tracce) non vengono raccolte da quella macchina.
Quando i test di verifica sono completati, fare clic su Continua.
La pagina di riepilogo elenca le macchine a cui vengono applicate le pianificazioni. Fare clic su Continua.
-
Impostare la pianificazione. Indicare quando si desidera che la diagnostica venga raccolta. 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. 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 Disattiva. Ciò annulla qualsiasi pianificazione configurata in precedenza per tali macchine.
Fare clic su Continua.
-
Autenticarsi per i caricamenti e specificare facoltativamente un proxy. Rivedere Autorizzazione al caricamento per i dettagli di questo processo. Ricorda: 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 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 di Citrix Cloud dove 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 dati
Le informazioni diagnostiche raccolte utilizzando Citrix Scout potrebbero contenere informazioni sensibili alla sicurezza. La funzione di mascheramento dati di Citrix Scout consente di mascherare i dati sensibili nei file diagnostici prima di caricarli su Citrix.
Il mascheramento 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 in formato
.tar.gz2e non possono essere mascherati.
Raccogliere nuova diagnostica ed eseguire il mascheramento dei dati
Per utilizzare la funzione di mascheramento dati di Citrix Scout, avviare Scout dalla riga di comando.
- In Windows, aprire il prompt dei comandi come amministratore.
- Passare alla directory in cui è installato Scout:
cd C:\Program Files\Citrix\Telemetry Service. - Avviare Scout:
ScoutUI.exe datamasking. - Fare clic su Raccogli o Traccia e riproduci per raccogliere la diagnostica.
- Dopo il completamento della raccolta, selezionare Abilita mascheramento dati. Questa opzione è abilitata per impostazione predefinita.
- Configurare la maschera dati. È possibile utilizzare le regole predefinite o personalizzare le regole.
-
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
- In Windows, aprire il prompt dei comandi come amministratore.
- Passare alla directory in cui è installato Scout:
cd C:\Program Files\Citrix\Telemetry Service. - Avviare Scout direttamente in modalità mascheramento dati:
ScoutUI.exe datamasking filePath. - Selezionare “Abilita mascheramento dati” per continuare. Questa opzione è abilitata per impostazione predefinita.
- Configurare la maschera dati. È possibile eseguire il mascheramento dei dati con le regole predefinite o personalizzare le regole.
-
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 link 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.
In questo articolo
- Introduzione
- Cosa viene raccolto
- Configurazione di Scout
- Informazioni sui controlli di integrità
- Eseguire i controlli di integrità
- Autorizzazioni e requisiti
- Test di verifica
- Compatibilità delle versioni
- Installazione e aggiornamento
- Autorizzazione al caricamento
- Trova macchina
- Aggiungere macchine manualmente
- Importare macchine VDA
- Raccogliere diagnostica
- Traccia e riproduci
- Abilitare la raccolta di log aggiuntivi
- Pianificare le raccolte
- Mascheramento dati
- Raccolta dati di utilizzo