Risoluzione dei problemi relativi ad Automated configuration (Configurazione automatica) e informazioni aggiuntive
Importante:
Per i messaggi di errore che si verificano comunemente nella Configurazione automatica e le soluzioni corrispondenti, vedere le domande frequenti sulla risoluzione dei problemi nell’articolo del Knowledge Center CTX277730.
Errori dello strumento di configurazione automatica
Le operazioni dello strumento di configurazione automatica possono talvolta produrre errori. Quando ciò accade, possono verificarsi errori durante l’elaborazione di componenti come cataloghi di macchine, gruppi di consegna o criteri di gruppo, ad esempio. L’uso di OnErrorAction e dei parametri di continuazione consente di rilevare gli errori durante l’elaborazione, risolverli e riprendere da dove si era interrotto.
Il valore predefinito di OnErrorAction è StopCompEnd. Quando si verifica un errore, lo strumento termina l’elaborazione del componente corrente. Non vengono elaborati componenti aggiuntivi e gli errori non si ripercuotono sui componenti dipendenti a valle. Dopo aver risolto gli errori, è possibile eseguire nuovamente i cmdlet con qualsiasi parametro di continuazione applicato.
Parametro OnErrorAction
È possibile definire i valori del parametro OnErrorAction nei cmdlet di migrazione per controllare come lo strumento risponde agli errori rilevati durante l’elaborazione dei componenti.
Questa tabella mostra i valori dei parametri e le relative descrizioni:
| Valore | Descrizione |
|---|---|
Continue |
Tenta di elaborare il maggior numero possibile di componenti. |
Pause |
Si interrompe al termine dell’elaborazione e richiede di continuare o interrompere. |
StopCompEnd |
Tenta di elaborare quanto più possibile il componente. Si arresta dopo che il componente è finito. (Impostazione predefinita) |
StopImmediately |
L’elaborazione si interrompe quando viene rilevato un errore. |
Cmdlet di migrazione
È possibile applicare il parametro OnErrorAction ai seguenti cmdlet di migrazione:
Compare-CvadAcToSiteImport-CvadAcToSiteMerge-CvadAcToSiteNew-CvadAcToSiteRestore-CvadAcToSite
Esempio: Merge-CvadAcToSite -OnErrorAction StopImmediately
Parametri di ripresa
Questi parametri definiscono il modo in cui lo strumento riprende a funzionare dopo la pausa o l’interruzione di un’operazione a causa di un errore.
È possibile applicare ai cmdlet di migrazione parametri di ripresa che includono uno dei seguenti valori del parametro OnErrorAction:
PauseStopCompEndStopImmediately
Questa tabella mostra i valori dei parametri e le relative descrizioni:
| Valore | Descrizione |
|---|---|
-AllRemaining |
Richiede un componente iniziale. L’elaborazione inizia dal componente iniziale ed elabora tutti i componenti rimanenti. Vengono elaborati più componenti. |
-Resume |
Utilizza il componente di CurrentComponent.txt come punto di partenza. Tutto il resto è impostato su true. Vengono elaborati più componenti. |
-Repeat |
Utilizza il componente di CurrentComponent.txt come punto di partenza. Tutto il resto è impostato su false. Viene elaborato un solo componente. |
L’ultimo componente elaborato viene archiviato nel file CurrentComponent.txt nella cartella AutoConfig. La modifica di questo file non è consigliata.
Se si specifica -Resume o -Repeat e CurrentComponent.txt è mancante o non valido, l’elaborazione si interrompe e viene richiesto di selezionare un componente.
Impostare OnErrorAction nel file CustomerInfo.yml
È inoltre possibile impostare i valori OnErrorAction nel file CustomerInfo.yml. Impostare i valori utilizzando i seguenti cmdlet:
- Per un nuovo file:
New-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately - Per un file esistente:
Set-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately
Log
L’esecuzione di qualsiasi cmdlet genera un file di log creato e una voce nel file di log principale della cronologia. Tutti i file di log delle operazioni vengono inseriti in una cartella di backup. Tutti i nomi dei file di log iniziano con CitrixLog, quindi mostrano l’operazione di configurazione automatica e la data e l’ora dell’esecuzione del cmdlet. I log non vengono eliminati automaticamente.
Il log principale della cronologia si trova in %HOMEPATH%\Documents\Citrix\AutoConfig, nel file chiamato History.Log. Ogni esecuzione di cmdlet produce una voce di log principale contenente la data, l’operazione, il risultato, il backup e le posizioni dei file di log dell’esecuzione.
È inoltre possibile utilizzare il cmdlet New-CvadAcZipInfoForSupport per raccogliere i log da inviare a Citrix per assistenza. Questo cmdlet comprime tutti i file di log e i file .yml in un unico file zip. Le informazioni sensibili dei clienti (CustomerInfo.yml e CvadAcSecurity.yml) non sono incluse nel file zip. Anche il file Icon.yml è escluso a causa delle sue dimensioni. Il file zip viene inserito in %HOMEPATH%\Documents\Citrix\AutoConfig e denominato CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip, in base alla data e all’ora. Questo file zip può anche fungere da backup.
Ogni file di log include quanto segue:
- Il nome dell’operazione e se la modalità di controllo è abilitata
- La data e l’ora di inizio e fine
- Voci multiple per le azioni di ciascun componente e le notifiche di successo/errore
- Riepilogo delle azioni intraprese, inclusi vari conteggi di oggetti creati
- Correzioni consigliate ove applicabile
- Posizione della cartella di backup, ove applicabile
- Posizione del log principale
- Durata
File diagnostici
I file diagnostici aiutano a individuare e risolvere i problemi. I seguenti file vengono creati quando viene eseguita la relativa operazione. Si trovano nella sottocartella specifica dell’azione in %HOMEPATH%\Documents\Citrix\AutoConfig. Includere questi file quando si forniscono informazioni per il supporto alla risoluzione dei problemi.
Esportazione
PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1
Questo file conta tutte le chiamate dell’SDK Broker PowerShell effettuate per esportare la configurazione del sito nei file.
Import (Importa), Merge (Unisci), Restore (Ripristina), Sync (Sincronizza), Backup (Esegui il backup), Compare (Confronta)
Transaction_yyyy_mm_dd_hh_mm_ss.txt
Questo file documenta ogni chiamata API Rest e le informazioni correlate.
RestApiContent_yyyy_mm_dd_hh_mm_ss.txt
In questo file è presente tutto il contenuto dell’API Rest Add, Update e Delete.
Problemi derivanti dalle dipendenze
Le importazioni e le unioni potrebbero non riuscire a causa di dipendenze mancanti. Alcuni problemi comuni sono:
- In Criteri di gruppo mancano dei filtri del gruppo di consegna. Le cause comuni sono gruppi di consegna che non sono stati importati.
- Le applicazioni non riescono a essere importate o unite. La causa comune è la mancanza di gruppi di consegna o gruppi di applicazioni che non sono stati importati.
- Nei gruppi di applicazioni manca un RestrictToTag. Le cause comuni sono i tag che non sono stati importati.
- Le connessioni host non vanno a buon fine. La causa abituale è la mancanza di informazioni di sicurezza nel file CvadAcSecurity.yml.
- I cataloghi delle macchine non funzionano. La causa abituale sono le connessioni host che non sono state importate.
- Macchine mancanti nei cataloghi delle macchine e nei gruppi di consegna. La causa abituale sono le macchine che non sono state trovate in Active Directory.
- Utenti mancanti nei gruppi di consegna. La causa abituale sono gli utenti che non sono stati trovati in Active Directory.
Consigli
- Non eseguire più di un’istanza di Automated configuration (Configurazione automatica) alla volta. L’esecuzione di più istanze simultanee produce risultati imprevedibili nel sito cloud. Se questo si verifica, eseguire nuovamente un’istanza di Automated configuration (Configurazione automatica) per portare il sito allo stato previsto.
- Non elaborare o modificare i dati nella scheda Manage (Gestisci) in Full Configuration (Configurazione completa) durante l’esecuzione di Automated configuration (Configurazione automatica).
- Verificare sempre visivamente i risultati di Merge (unisci)/Import (importa)/Restore (ripristina) in Full Configuration (Configurazione completa) per garantire che il sito cloud soddisfi le aspettative.
Cartelle
Posizione predefinita della cartella principale
Tutte le operazioni dello strumento Automated configuration (Configurazione automatica) avvengono nella cartella principale o nelle sottocartelle al suo interno. La cartella principale si trova in %HOMEPATH%\Documents\Citrix\AutoConfig.
Esportazione
Tutti i file esportati vengono collocati in due cartelle, offrendo facilità d’uso e una cronologia delle esportazioni. Le esportazioni vengono sempre inserite nella cartella principale. Le copie vengono inserite in una sottocartella denominata Export (Esporta) con la data e l’ora dell’esportazione.
La cartella principale contiene sempre la configurazione del sito on-premise esportata più recente. Ogni sottocartella Export (Esporta) contiene l’esportazione effettuata nella data e ora indicate, che mantiene una cronologia delle esportazioni. È possibile utilizzare qualsiasi sottocartella Export (Esporta) per configurare il sito cloud. Automated configuration (Configurazione automatica) non elimina o modifica le sottocartelle di esportazione esistenti.
Import (Importa)/Merge (Unisci)/Sync (Sincronizza)/Compare (Confronta)
Le operazioni Import, Merge e Compare provenienti sempre da file che si trovano nella cartella principale. Ogni operazione comporta la creazione di una sottocartella in cui vengono copiati i file nella cartella principale, fornendo una cronologia dei file sorgente modificati del sito cloud.
Restore (Ripristina)
L’ operazione Restore utilizza una sottocartella esistente per configurare il sito cloud. La cartella di origine è specificata nel parametro -RestoreFolder richiesto. A differenza di altri comandi, non viene creata nessuna nuova sottocartella perché l’operazione Restore utilizza una sottocartella esistente. La cartella di ripristino può essere la cartella principale ma deve comunque essere specificata nel parametro -RestoreFolder.
Backup
Automated Configuration (Configurazione automatica) inizializza, aggiorna ed esegue il backup di una configurazione del sito cloud. Se vengono utilizzate per un certo tempo, molte configurazioni diverse possono cambiare sul sito cloud. Per facilitare l’uso a lungo termine e preservare le modifiche alla cronologia, Automated Configuration (Configurazione automatica) utilizza uno schema di conservazione per salvare la cronologia delle modifiche e fornire un metodo per ripristinare gli stati precedenti.
I backup della configurazione del sito cloud vengono sempre eseguiti in una sottocartella denominata Backup con i dati e l’ora del backup. Automated Configuration (Configurazione automatica) non elimina o modifica le sottocartelle di esportazione esistenti.
È possibile utilizzare i backup per ripristinare componenti specifici o l’intera configurazione. Per ripristinare l’intero gruppo di consegna e i componenti del catalogo delle macchine, utilizzare il cmdlet:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs
Nota:
Le informazioni sul file di backup nel cmdlet precedente si basano sui backup dell’utente.
Per ripristinare l’intera configurazione del sito cloud, utilizzare il cmdlet:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
Nota:
Le informazioni sul file di backup nel cmdlet precedente si basano sui backup dell’utente.
Modifica della cartella principale predefinita
Le operazioni Export, Import, Merge, Sync e Compare possono modificare la cartella principale predefinita utilizzando il parametro –AlternateFolder. La creazione e la gestione delle sottocartelle per ciascuna operazione rimangono le stesse descritte in precedenza.
File copiati nelle sottocartelle
Tutti i file con estensione “.yml” vengono copiati nelle sottocartelle delle operazioni, ad eccezione dei seguenti:
- CustomerInfo.yml
- ZoneMapping.yml
- CvadAcSecurity.yml
Backup automatizzati di siti cloud in modalità provvisoria
Viene eseguito un backup della configurazione corrente del sito cloud prima di eseguire operazioni che modificano la configurazione. Questo include i parametri Import, Merge, Sync e Restore. Il backup si trova sempre in una sottocartella sotto la sottocartella operativa.
Nel caso di Restore, la cartella di backup è una sottocartella della cartella specificata nel parametro -RestoreFolder.
Automazione
I cmdlet dello strumento Automated configuration (Configurazione automatica) possono essere eseguiti negli script di automazione senza l’intervento dell’amministratore eliminando i prompt e la visualizzazione dei risultati dei log al completamento del cmdlet. È inoltre possibile impostare i parametri in modo che facciano lo stesso utilizzando il file CustomerInfo.yml.
Aggiungere il seguente parametro ai cmdlet che modificano il cloud per impedire la visualizzazione dei prompt.
-Confirm $false
Aggiungere il seguente parametro ai cmdlet per impedire la visualizzazione del log al completamento del cmdlet.
-DisplayLog $false
Aggiungere il seguente parametro ai cmdlet per impedire la registrazione nella finestra di comando PowerShell.
-Quiet
Come metodo alternativo, i seguenti parametri possono essere inseriti nel file CustomerInfo.yml.
Confirm: False
DisplayLog: False
Esportazione da PC diversi dal Delivery Controller
Lo strumento Automated configuration (Configurazione automatica) utilizza più SDK Citrix PowerShell per esportare la configurazione del sito on-premise in file. Questi SDK vengono installati automaticamente sul Delivery Controller, consentendo allo strumento di funzionare sul Delivery Controller senza azioni aggiuntive. Quando viene eseguito su macchine diverse dai Delivery Controller, è necessario installare il set di SDK Citrix PowerShell richiesto dallo strumento. Questo set di SDK fa parte di Citrix Studio, che può essere installato dal supporto di installazione Citrix Virtual Apps and Desktops.
Nota:
Automated configuration (Configurazione automatica) non può essere eseguito su Cloud Connector.
Passaggio a Citrix Cloud Government e Japan Control Plane
Gli ambienti Citrix Cloud Government e Japan Control Plane utilizzano punti di accesso diversi per autenticare e allocare i token di accesso. Questo requisito unico si applica a qualsiasi strumento di Automated configuration (Configurazione automatica) che accede al cloud. Effettuare i seguenti passaggi per utilizzare Automated configuration (Configurazione automatica) in questi ambienti.
- Nella cartella %HOMEPATH%\Documents\Citrix\AutoConfig, modificare CustomerInfo.yml.
-
Aggiungere una delle seguenti righe, a seconda dell’ambiente a cui si desidera connettersi, a CustomerInfo.yml (o modificarla, se già presente).
Environment: 'ProductionGov'o
Environment: 'ProductionJP'
Automated Configuration (Configurazione automatica) può ora essere utilizzata in questi ambienti.
Raccolta dati Citrix Cloud
Per informazioni sulle informazioni raccolte da Citrix Cloud, vedere Gestione dei log e dei contenuti dei clienti di Citrix Cloud Services.
Risorse aggiuntive
Forum di discussione
Visitare il forum di discussione Citrix per Automated Configuration (Configurazione automatica).
Video
Guardare Under the Hood of the Automated Configuration Tool for Citrix Virtual Apps and Desktops su YouTube.
Formazione
Il Cloud Learning Center contiene guide video dettagliate per la creazione di una distribuzione di servizi, incluse le attività descritte in questo articolo. Vedere Migrazione di Citrix Virtual Apps and Desktops a Citrix Cloud Learning Path.
In questo articolo
- Errori dello strumento di configurazione automatica
- Log
- File diagnostici
- Problemi derivanti dalle dipendenze
- Consigli
- Cartelle
- Backup
- Automazione
- Esportazione da PC diversi dal Delivery Controller
- Passaggio a Citrix Cloud Government e Japan Control Plane
- Raccolta dati Citrix Cloud
- Risorse aggiuntive