Problembehandlung bei automatischer Konfiguration und zusätzliche Informationen
Wichtig:
Häufig auftretende Fehlermeldungen für die automatische Konfiguration und entsprechende Lösungen finden Sie in den FAQ zur Problembehandlung im Knowledge Center-Artikel CTX277730.
Fehler bei Verwendung des automatisierten Konfigurationstools
Mit dem automatisierten Konfigurationstool können gelegentlich Fehler auftreten. Komponenten wie Maschinenkataloge, Bereitstellungsgruppen oder Gruppenrichtlinien können dann nicht korrekt verarbeitet werden. Mit OnErrorAction und Fortsetzungsparametern können Sie Fehler, die während der Verarbeitung auftreten, erfassen, beheben und den Prozess fortsetzen.
Der OnErrorAction-Standardwert ist StopCompEnd. Bei einem Fehler beendet das Tool dann die Verarbeitung der aktuellen Komponente. Es werden keine zusätzlichen Komponenten verarbeitet, und Fehler werden nicht an nachgelagerte, abhängige Komponenten übertragen. Nachdem Sie alle Fehler behoben haben, können Sie Ihre Cmdlets mit angewendetem Fortsetzungsparameter erneut ausführen.
Parameter “OnErrorAction”
Sie können Parameterwerte für OnErrorAction in Migrationsbefehlen definieren, um festzulegen, wie das Tool auf Fehler reagiert, die beim Verarbeiten von Komponenten erfasst werden.
Diese Tabelle enthält Parameterwerte und ihre Beschreibung:
| Wert | Beschreibung |
|---|---|
Continue |
Versucht, möglichst viele Komponenten zu verarbeiten. |
Pause |
Hält nach der Verarbeitung an und fordert Sie auf, fortzufahren oder den Vorgang zu beenden. |
StopCompEnd |
Versucht, möglichst viel von der Komponente zu verarbeiten. Stoppt nach Abschluss der Komponente. (Standard) |
StopImmediately |
Die Verarbeitung wird gestoppt, wenn ein Fehler gefunden wird. |
Migrations-Cmdlets
Sie können den Parameter OnErrorAction auf die folgenden Migrationsbefehle anwenden:
Compare-CvadAcToSiteImport-CvadAcToSiteMerge-CvadAcToSiteNew-CvadAcToSiteRestore-CvadAcToSite
Beispiel:Merge-CvadAcToSite -OnErrorAction StopImmediately
Wiederaufnahmeparameter
Diese Parameter definieren, wie das Tool einen Vorgang fortsetzt, der aufgrund eines Fehlers angehalten oder beendet wurde.
Sie können Wiederaufnahmeparameter auf Migrations-Cmdlets anwenden, die einen der folgenden Parameterwerte für OnErrorAction enthalten:
PauseStopCompEndStopImmediately
Diese Tabelle enthält Parameterwerte und ihre Beschreibung:
| Wert | Beschreibung |
|---|---|
-AllRemaining |
Erfordert eine Startkomponente. Die Verarbeitung beginnt bei der Startkomponente und verarbeitet alle verbleibenden Komponenten. Es werden mehrere Komponenten verarbeitet. |
-Resume |
Verwendet die Komponente von CurrentComponent.txt als Ausgangspunkt. “All Remaining” ist auf “true” festgelegt. Es werden mehrere Komponenten verarbeitet. |
-Repeat |
Verwendet die Komponente von CurrentComponent.txt als Ausgangspunkt. “All Remaining” ist auf “false” festgelegt. Es wird nur eine Komponente verarbeitet. |
Die zuletzt verarbeitete Komponente wird in der Datei CurrentComponent.txt im Ordner “AutoConfig” gespeichert. Das Bearbeiten dieser Datei wird nicht empfohlen.
Wenn Sie -Resume oder -Repeat festlegen und CurrentComponent.txt fehlt oder ungültig ist, wird die Verarbeitung beendet und Sie werden aufgefordert, eine Komponente auszuwählen.
Einstellen von OnErrorAction in der Datei CustomerInfo.yml
Sie können auch OnErrorAction-Werte in der Datei CustomerInfo.yml festlegen. Legen Sie die Werte mit den folgenden Cmdlets fest:
- Für eine neue Datei:
New-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately - Für eine vorhandene Datei:
Set-CvadAcCustomerInfoFile -OnErrorAction Continue | Pause | StopCompEnd | StopImmediately
Protokolle
Beim Ausführen eines Cmdlets wird immer eine Protokolldatei erstellt und der Hauptverlaufsprotokolldatei ein Eintrag hinzugefügt. Alle Vorgangsprotokolldateien werden in einem Backupordner gespeichert. Alle Protokolldateinamen beginnen mit CitrixLog, gefolgt von dem Vorgang der automatischen Konfiguration und dem Datum und der Uhrzeit der Cmdlet-Ausführung. Protokolle werden nicht automatisch gelöscht.
Das Hauptverlaufsprotokoll mit dem Namen History.Log bedindet sich im Ordner *%HOMEPATH%\Documents\Citrix\AutoConfig*. Jede Cmdlet-Ausführung wird im Hauptverlaufsprotokoll mit Datum, Vorgang, Ergebnis, Backup und Protokolldatei-Speicherorten eingetragen.
Sie können das Cmdlet New-CvadAcZipInfoForSupport auch verwenden, um Protokolle zu sammeln, die zwecks Support an Citrix gesendet werden sollen. Dieses Cmdlet komprimiert alle Protokoll- und YML-Dateien in einer einzigen ZIP-Datei. Vertrauliche Kundendaten (CustomerInfo.yml und CvadAcSecurity.yml) sind nicht in der ZIP-Datei enthalten. Die Datei Icon.yml ist aufgrund ihrer Größe ebenfalls ausgeschlossen. Die ZIP-Datei wird in %HOMEPATH%\Documents\Citrix\AutoConfig gespeichert und erhält den Namen CvadAcSupport_yyyy_mm_dd_hh_mm_ss.zip (mit Datums- und Zeitstempel). Diese ZIP-Datei kann auch als Backup dienen.
Jede Protokolldatei enthält Folgendes:
- Name des Vorgangs und ob der Prüfmodus aktiviert ist
- Datum und Uhrzeit des Starts und Endes
- Einträge für die Aktionen an jeder Komponente und Erfolgs-/Fehlermeldung
- Zusammenfassung der durchgeführten Aktionen, einschließlich Anzahl erstellter Objekte
- Gegebenenfalls Empfehlungen für Fixes
- Gegebenenfalls Speicherort des Backupordners
- Speicherort des Hauptprotokolls
- Dauer
Diagnosedateien
Diagnosedateien helfen bei der Ermittlung und Behebung von Problemen. Die folgenden Dateien werden erstellt, wenn der betreffende Vorgang ausgeführt wird. Sie sind in dem aktionsspezifischen Unterordner in %HOMEPATH%\Documents\Citrix\AutoConfig. Fügen Sie diese Dateien bei, wenn Sie Informationen für den Support zur Problembehebung bereitstellen.
Exportieren
PoshSdk_yyyy_mm_dd_hh_mm_ss.ps1
Diese Datei zählt alle Broker PowerShell SDK-Anrufe, die zum Exportieren der Sitekonfiguration ausgeführt wurden.
Import, Merge, Restore, Sync, Backup, Compare
Transaction_yyyy_mm_dd_hh_mm_ss.txt
Diese Datei dokumentiert jeden Rest API-Aufruf und zugehörige Informationen.
RestApiContent_yyyy_mm_dd_hh_mm_ss.txt
Diese Datei enthält den Inhalt für alle Add-, Update- und Delete-Rest APIs.
Durch Voraussetzungen verursachte Probleme
Import und Zusammenführung können aufgrund fehlender Voraussetzungen fehlschlagen. Einige häufig auftretende Probleme:
- In Gruppenrichtlinien fehlen Bereitstellungsgruppenfilter. Die übliche Ursache sind nicht importierte Bereitstellungsgruppen.
- Anwendungen können nicht importiert oder zusammengeführt werden. Die übliche Ursache sind nicht importierte Bereitstellungsgruppen oder Anwendungsgruppen.
- In Anwendungsgruppen fehlt ein RestrictToTag. Die übliche Ursache sind nicht importierte Tags.
- Hostverbindungen schlagen fehl. Die übliche Ursache sind fehlende Sicherheitsinformationen in der Datei CvadAcSecurity.yml.
- Maschinenkataloge schlagen fehl. Die übliche Ursache sind nicht importierte Hostverbindungen.
- In Maschinenkatalogen und Bereitstellungsgruppen fehlen Maschinen. Die übliche Ursache sind Maschine, die nicht in Active Directory gefunden wurden.
- In Bereitstellungsgruppen fehlen Benutzer. Die übliche Ursache sind Benutzer, die nicht in Active Directory gefunden wurden.
Empfehlungen
- Führen Sie nicht mehrere Instanzen der automatischen Konfiguration gleichzeitig aus. Das Ausführen mehrerer Instanzen führt zu unvorhersehbaren Ergebnissen in der Cloudsite. Führen Sie in diesem Fall eine Instanz der automatischen Konfiguration erneut aus, um die Site in den erwarteten Zustand zu versetzen.
- Arbeiten oder ändern Sie keine Daten in Studio, während Sie die automatische Konfiguration ausführen.
- Stellen Sie über eine visuelle Kontrolle der Ergebnisse des Zuammenführens, Importierens oder Wiederherstellens in Studio stets sicher, dass die Cloudsite den Erwartungen entspricht.
Ordner
Standard-Stammordner
Alle Vorgänge des automatisierten Konfigurationstools werden im Stammordner oder einem seiner Unterordner ausgeführt. Der Stammordner ist in %HOMEPATH%\Documents\Citrix\AutoConfig.
Exportieren
Alle exportierten Dateien werden zur Gewährleistung der Benutzerfreundlichkeit und zur Bewahrung eines Exportverlaufs in zwei Ordnern gespeichert. Exporte werden immer im Stammordner gespeichert. Kopien werden in dem Unterordner Export mit dem Datum und der Uhrzeit des Exports gespeichert.
Der Stammordner enthält immer die zuletzt exportierte On-Premises-Sitekonfiguration. Jeder Export-Unterordner enthält den zu dem angegebenen Datum und der angegebenen Uhrzeit erfolgten Export, wodurch ein Exportverlauf bereitgestellt wird. Sie können die Cloudsite unter Verwendung eines beliebigen Export-Unterordners konfigurieren. Vorhandene Exportunterordner werden bei der automatischen Konfiguration weder gelöscht noch geändert.
Importieren, Zusammenführen, Synchronisieren, Vergleichen
Die Vorgänge Import, Merge und Compare erfolgen immer mit Quelldateien im Stammordner. Jeder Vorgang führt zur Erstellung eines Unterordners, in den Dateien aus dem Stammordner kopiert werden, sodass ein Verlauf der Quelldateien der Cloudsite-Änderungen entsteht.
Wiederherstellen
Der Restore-Vorgang verwendet einen bestehenden Unterordner zum Konfigurieren der Cloudsite. Der Quellordner wird mit dem erforderlichen Parameter -RestoreFolder angegeben. Im Gegensatz zu anderen Befehlen wird kein Unterordner erstellt, da der Restore-Vorgang einen bestehenden Unterordner verwendet. Als Wiederherstellungsordner kann der Stammordner verwendet werden, doch auch er muss im -RestoreFolder-Parameter angegeben werden.
Backups
Die automatische Konfiguration initialisiert, aktualisiert und sichert die Cloudsite-Konfiguration. Die Verwendung im Laufe der Zeit kann zu vielen Konfigurationsänderungen bei der Cloudsite führen. Zur Vereinfachung der langfristigen Verwendung speichert die automatische Konfiguration den Änderungsverlauf und bietet eine Methode zum Wiederherstellen früherer Zustände.
Backups der Cloudsite-Konfiguration werden immer in einem Unterordner namens Backup mit Datum und Zeitpunkt des Backups gespeichert. Vorhandene Exportunterordner werden bei der automatischen Konfiguration weder gelöscht noch geändert.
Sie können mit den Backups einzelne Komponenten oder die gesamte Konfiguration wiederherstellen. Verwenden Sie zum Wiederherstellen der gesamten Bereitstellungsgruppen- und Maschinenkatalogkomponenten folgendes Cmdlet:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss -DeliveryGroups -MachineCatalogs
Hinweis:
Die Informationen zur Backupdatei im obigen Cmdlet basieren auf Ihren eigenen Backups.
Verwenden Sie zum Wiederherstellen der gesamten Cloudsite-Konfiguration folgendes Cmdlet:
Restore-CvadAcToSite -RestoreFolder %HOMEPATH%\Documents\Citrix\AutoConfig/Backup_yyyy_mm_dd_hh_mm_ss
Hinweis:
Die Informationen zur Backupdatei im obigen Cmdlet basieren auf Ihren eigenen Backups.
Ändern des Standardstammordners
Die Vorgänge Export, Import, Merge, Sync und Compare können bei Verwendung des Parameters –AlternateFolder den Stammordner ändern. Die Erstellung und Verwaltung vorgangsbezogener Unterordner ist weiterhin wie oben beschrieben.
In Unterordner kopierte Dateien
Mit Ausnahme der Folgenden werden alle Dateien mit der Erweiterung “.yml” in Vorgangsunterordner kopiert:
- CustomerInfo.yml
- ZoneMapping.yml
- CvadAcSecurity.yml
Automatisierte, ausfallsichere Cloudsite-Backups
Vor dem Ausführen von Vorgängen, die die Konfiguration ändern, wird ein Backup der Cloudsite-Konfiguration vorgenommen. Dies betrifft die Parameter Import, Merge, Sync und Restore. Das Backup ist immer in einem Unterordner des zum Vorgang gehörenden Unterordners.
Bei Restore ist der Backupordner ein Unterordner des im Parameter -RestoreFolder angegebenen Ordners.
Automatisierung
Die Cmdlets des automatisierten Konfigurationstools können ohne Administratoreingriff in Skripts ausgeführt werden. Eingabeaufforderungen und die Anzeige der Protokollergebnisse bei Abschluss des Cmdlets werden dann unterdrückt. Sie können für dieselbe Funktion auch Parameter über die Datei CustomerInfo.yml festlegen.
Fügen Sie den folgenden Parameter zu Cmdlets zur Cloudmodifizierung hinzu, um die Anzeige von Eingabeaufforderungen zu unterdrücken.
-Confirm $false
Fügen Sie den folgenden Parameter zu Cmdlets hinzu, um die Anzeige des Protokolls nach Abschluss des Cmdlets zu unterdrücken.
-DisplayLog $false
Fügen Sie Cmdlets den folgenden Parameter hinzu, um die Protokollierung im PowerShell-Befehlsfenster zu unterdrücken.
-Quiet
Alternativ können die folgenden Parameter in die Datei CustomerInfo.yml geschrieben werden.
Confirm: False
DisplayLog: False
Exportieren von anderen PCs als dem Delivery Controller
Das automatisierte Konfigurationstool verwendet mehrere Citrix PowerShell-SDKs, um die Konfiguration der On-Premises-Site zu exportieren. Die SDKs werden automatisch auf dem Delivery Controller installiert, sodass das Tool darauf ohne zusätzliche Aktionen ausgeführt werden kann. Zur Ausführung des Tools auf Maschinen, die kein Delivery Controller sind, müssen Sie die benötigten Citrix PowerShell-SDKs installieren. Die SDKs ist gehören zu Citrix Studio, das vom Citrix Virtual Apps and Desktops-Installationsmedium installiert werden kann.
Hinweis:
Die automatische Konfiguration kann nicht auf dem Cloud Connector ausgeführt werden.
Umstellung auf Citrix Cloud Government und Japan Control Plane
Die Citrix Cloud Government- und Japan Control Plane-Umgebung verwenden verschiedene Zugriffspunkte zum Authentifizieren und Zuweisen von Zugriffstoken. Diese einmalige Anforderung gilt für jedes automatisierte Konfigurationstool, das auf die Cloud zugreift. Führen Sie die folgenden Schritte aus, um die automatische Konfiguration in diesen Umgebungen zu verwenden.
- Bearbeiten Sie die Datei CustomerInfo.yml im Ordner %HOMEPATH%\Documents\Citrix\AutoConfig.
-
Fügen Sie je nach der Umgebung, mit der Sie eine Verbindung herstellen möchten, eine der folgenden Zeilen zu CustomerInfo.yml hinzu (oder ändern Sie sie, falls bereits vorhanden).
Environment: 'ProductionGov'oder
Environment: 'ProductionJP'
Die automatische Konfiguration kann jetzt in diesen Umgebungen verwendet werden.
Citrix Cloud-Datenerfassung
Informationen zu den von Citrix Cloud erfassten Informationen finden Sie unter Erfassen von Kundendaten und Protokollen in Citrix Cloud Services.
Weitere Ressourcen
Diskussionsforum
Besuchen Sie das Citrix Diskussionsforum zur automatisierten Konfiguration.
Video
Schauen Sie sich das Video Under the Hood of the Automated Configuration Tool for Citrix Virtual Apps and Desktops auf YouTube an.
Schulung
Das Cloud Learning Center enthält Videos mit schrittweisen Anleitungen zum Aufbau einer Service-Bereitstellung, einschließlich der in diesem Artikel beschriebenen Aufgaben. Siehe Migrating Citrix Virtual Apps and Desktops to Citrix Cloud Learning Path.
In diesem Artikel
- Fehler bei Verwendung des automatisierten Konfigurationstools
- Protokolle
- Diagnosedateien
- Durch Voraussetzungen verursachte Probleme
- Empfehlungen
- Ordner
- Backups
- Automatisierung
- Exportieren von anderen PCs als dem Delivery Controller
- Umstellung auf Citrix Cloud Government und Japan Control Plane
- Citrix Cloud-Datenerfassung
- Weitere Ressourcen