Cloud-Konfigurationen zu lokalen Umgebungen migrieren

Dieser Artikel beschreibt das Sichern und Migrieren Ihrer Cloud-Konfigurationen zu lokalen Sites.

Voraussetzungen für die Migration Ihrer Konfiguration

  • Citrix Virtual Apps and Desktops™ On-Premises-Umgebung mit mindestens einem registrierten VDA.
  • Citrix Virtual Apps and Desktops On-Premises-Umgebung, die auf einer der folgenden Versionen ausgeführt wird:
    • Die aktuellste Long-Term Service Release (LTSR)-Version – 2402.
    • Beliebige Current Releases (CR)-Versionen – 2308, 2311.
  • Führen Sie die Befehle des Automated Configuration Tool (ACT) auf einem in die Domäne eingebundenen Computer mit .Net 4.7.2 oder höher aus.
  • Ein Computer mit dem Citrix PowerShell SDK. Das PowerShell SDK ist im Installationspaket des Citrix Delivery Controller™ enthalten.

Hinweis:

  • Wenn Sie das ACT auf einem anderen Computer ausführen, muss dieser in die Domäne eingebunden sein und Studio muss die korrekten PowerShell-Snap-Ins installiert haben. Den Installer erhalten Sie auf der Citrix Virtual Apps and Desktops-Download-Website.
  • Auf der lokalen Site empfehlen wir, ACT auf dem Delivery Controller zu installieren. ACT kann über das Desktopsymbol gestartet werden.
  • Wenn ACT über das Standard-Powershell-Fenster verwendet werden soll, muss der folgende Befehl ausgeführt werden: Import-Module Citrix.AutoConfig.Commands

ACT ist nicht Teil des System-PowerShell-Pfads und muss daher explizit importiert werden.

Wichtige Schritte

Befolgen Sie die Anweisungen, um die Migration Ihrer Cloud-Konfigurationen in die lokale Umgebung abzuschließen:

  1. Cloud-Konfiguration sichern
  2. YML-Dateien ändern
  3. Konfigurationen in die lokale Umgebung importieren

Cloud-Konfiguration sichern

  1. Installieren Sie die Automatisierte Konfiguration.
  2. Doppelklicken Sie auf das Symbol Auto Config. Ein PowerShell-Fenster wird angezeigt.
  3. Führen Sie New-CvadAcCustomerInfoFile aus, um eine Datei namens CustomerInfo.yml zu erstellen. Weitere Informationen finden Sie unter Kundeninformationsdatei füllen.
  4. Führen Sie den Befehl Backup-CvadAcToFile aus, um eine Sicherung Ihrer Cloud-Konfigurationen zu erstellen.

    Hinweis:

    • Nachdem Sie ein Cmdlet zum ersten Mal ausgeführt haben, wird ein Exportordner mit den .yml-Konfigurationsdateien und Protokollen erstellt. Der Ordner befindet sich unter %HOMEPATH%\Documents\Citrix\AutoConfig.
    • Wenn Fehler oder Ausnahmen auftreten, lesen Sie den Abschnitt Fixups in der Protokolldatei.
    • Backup-CvadToFile unterstützt die Parameter IncludeByName oder ExcludeByName nicht.

Wichtig:

Citrix empfiehlt, alle Komponenten zusammen zu sichern.

YML-Dateien ändern

Ändern Sie die .yml Dateien, die sich unter %HOMEPATH%\Documents\Citrix\AutoConfig befinden, um die lokalen Details aufzunehmen, wie in der folgenden Tabelle beschrieben:

YML-Datei Parameter Beschreibung Beispiele
CustomerInfo.yml Umgebung Ändern Sie die Umgebung in OnPrem. Der Wert des Umgebungsparameters ist Groß-/Kleinschreibung-sensitiv.  
ZoneMapping.yml DaaS:CVAD Ordnen Sie Ihre Cloud-Ressourcenstandorte Ihren lokalen Zonen zu. Es muss alte:neue Zonen sein
CvadAcSecurity.yml Hypervisor: Verbindungstyp: ‘ ‘ Benutzername: ‘ ’ Passwort: ‘ ‘ Fügen Sie den Hypervisor-Benutzernamen und die Kennwörter hinzu. Wenn der Hypervisor XenServer ist,XenServer: ConnectionType: ‘XenServer’ Username: ‘root’ Password: ‘ ‘

Konfigurationen in die lokale Umgebung importieren

  1. Führen Sie je nach Ihren Anforderungen einen der folgenden Befehle an Ihrem lokalen Standort aus:
    1. Merge-CvadAcToSite - wenn ein lokaler Standort ausgeführt wird und Sie die Cloud-Konfigurationen damit zusammenführen möchten.
    2. Import-CvadAcToSite -Environment OnPrem - Wenn keine lokalen Konfigurationen verfügbar sind und Sie die Cloud-Konfigurationen importieren, um eine zu erstellen.

Wichtig:

Citrix empfiehlt, jeweils eine Komponente zu importieren, um Konflikte zu vermeiden.

Cloud-Konfigurationen zu lokalen Umgebungen migrieren