Konfiguration zu Citrix Cloud™ migrieren
Das Automated Configuration Tool (ACT) ermöglicht die Migration der Konfiguration von Citrix Virtual Apps and Desktops™ (Richtlinien, Anwendungen, Katalogen, Administratorrollen, Scopes und anderen) von einem oder mehreren lokalen Standorten zu Citrix DaaS, das in Citrix Cloud gehostet wird. Es kann auch verwendet werden, um Informationen zwischen verschiedenen Cloud-Regionen oder Mandanten zu migrieren.
Dieses Tool erkennt und exportiert einen oder mehrere lokale Standorte als Sammlung von Konfigurationsdateien, die Sie optional bearbeiten können. Die Konfiguration dieser Dateien kann dann in Citrix DaaS importiert werden. Die Migration erfolgt in Phasen, indem das Tool mehrmals ausgeführt wird, sodass Sie den gewünschten Konfigurationszustand leicht erreichen können.
ACT ist nicht nur ein einmaliges Migrationstool. Sie können es verwenden, um Ihre täglichen Cloud-Operationen zu verwalten, wie zum Beispiel:
- Automatisierung der Übertragung von Test- oder Staging-Cloud-Konten zu Produktions-Cloud-Konten
- Sichern und Wiederherstellen Ihrer Konfiguration
- Aufteilen einer Cloud-Umgebung in mehrere Clouds
Das folgende 2-minütige Video bietet einen kurzen Überblick über Automated Configuration.
Weitere Informationen zu Automated Configuration finden Sie unter Proof of Concept: Automated Configuration Tool in der Tech Zone.
Für einen tiefergehenden Einblick in die Verlagerung Ihrer Bereitstellung und die Vorbereitung Ihrer lokalen Konfiguration für die Migration, siehe Bereitstellungshandbuch: Migrieren von Citrix Virtual Apps and Desktops von On-Premises zu Citrix Cloud in der Tech Zone.
Bekannte Einschränkungen
- Maschinenkataloge, die über Machine Creation Services™ bereitgestellt werden, haben besondere Überlegungen. Weitere Informationen zu MCS finden Sie unter Verstehen der Migration von über Machine Creation Services bereitgestellten Katalogen.
Voraussetzungen für die Migration Ihrer Konfiguration
Für den Export Ihrer Konfiguration aus Citrix Virtual Apps and Desktops benötigen Sie:
- Citrix Virtual Apps and Desktops: aktuelle Version und deren direkter Vorgänger oder Citrix Virtual Apps and Desktops, XenApp und XenDesktop® LTSRs: alle Versionen
- Eine in die Domäne eingebundene Maschine mit .NET Framework 4.7.2 oder höher und dem Citrix PowerShell SDK. Dies wird automatisch auf dem Delivery Controller installiert. (Um auf einer anderen Maschine als dem lokalen Delivery Controller ausgeführt zu werden, muss Citrix Studio installiert sein, da Studio die korrekten PowerShell-Snap-Ins installiert. Das Studio-Installationsprogramm finden Sie auf den Installationsmedien von Citrix Virtual Apps and Desktops.)
Für den Import Ihrer Konfiguration in Citrix DaaS benötigen Sie:
- Eine Maschine mit Zugriff auf Citrix Cloud. Dies muss kein Delivery Controller™ oder eine in die Domäne eingebundene Maschine sein.
- Citrix DaaS bereitgestellt.
- Ein aktiver Ressourcenstandort mit installiertem Connector und in derselben Domäne wie das lokale Setup eingebunden.
- Die Konnektivität zu Standorten, die auf Citrix Cloud zugreifen, muss zugelassen und verfügbar sein. Weitere Informationen finden Sie unter System- und Konnektivitätsanforderungen.
Hinweis:
Automated Configuration kann nicht auf einem Cloud Connector-System installiert werden.
Wichtige Schritte
- Laden Sie das Automated Configuration Tool herunter und überprüfen Sie die Systemanforderungen. Siehe Automated Configuration herunterladen.
- Füllen Sie die Datei
CustomerInfo.ymlmit Ihren Werten fürCustomerName,CustomerIDundSecretKeyaus, die Sie im Citrix Cloud-Portal generiert haben. Siehe Kunden-ID, Client-ID und geheimen Schlüssel generieren und Kundeninformationsdatei füllen. - Wenn der lokale Standort mehrere Zonen enthält, aktualisieren Sie die Datei
ZoneMapping.yml, um Zonen Citrix DaaS-Ressourcenstandorten zuzuordnen. Siehe Zonen-Mapping-Datei füllen. - Wenn der Standort mehrere Hosting-Verbindungen enthält, aktualisieren Sie die Datei
CvadAcSecurity.ymlmit den Verbindungsinformationen für jeden Host-Typ, der zu Citrix DaaS migriert wird. Wenn nur eine einzige Host-Verbindung vorhanden ist, aktualisieren Sie die DateiCvadACSecurity.ymlmit den Verbindungsinformationen für diese Host-Verbindung. Siehe Sicherheitsdatei für Host-Verbindungen aktualisieren. - Öffnen Sie ACT und exportieren Sie Ihren lokalen Standort mit dem Befehl
Export-CvadAcToFile. Eine Liste der für die Migration unterstützten Komponenten finden Sie unter Unterstützte Migrationsobjekte. Informationen zu den Exportschritten finden Sie unter Lokale Konfiguration exportieren. - Importieren Sie Komponenten in Phasen mit dem Befehl
Merge-CvadAcToSite. Alternativ können Sie den gesamten Standort auf einmal migrieren. Stellen Sie sicher, dass Sie Komponenten in der unter Reihenfolge der Komponentenmigration aufgeführten Reihenfolge migrieren. Informationen zu den Importschritten finden Sie unter Einen Import ausführen. - Aktivieren Sie den Cloud-Standort. Siehe Standorte aktivieren.
Automated Configuration herunterladen
Laden Sie das Automated Configuration Tool von Citrix Downloads herunter und installieren Sie es.
Automated Configuration aktualisieren
Um Funktionsfehler zu vermeiden, verwenden Sie immer die neueste verfügbare Version von ACT.
Um Ihre Tool-Version zu erfahren, gehen Sie wie folgt vor:
- Doppelklicken Sie auf das Symbol Auto Config. Ein PowerShell-Fenster wird angezeigt.
- Führen Sie den folgenden Befehl aus, um Ihre Versionsnummer zu überprüfen.
Kunden-ID, Client-ID und geheimen Schlüssel generieren
Um die lokale Site zu Citrix DaaS zu migrieren, füllen Sie die Datei CustomerInfo.yml mit der Kunden-ID, Client-ID und dem geheimen Schlüssel aus dem Citrix Cloud-Portal.
So rufen Sie die Kunden-ID ab:
- Melden Sie sich bei Ihrem Citrix Cloud-Konto an und wählen Sie den Kunden aus.
- Klicken Sie auf das Rastersymbol und wählen Sie Identitäts- und Zugriffsverwaltung.
- Navigieren Sie zu API-Zugriff > Sichere Clients. Die Kunden-ID wird auf der Seite angezeigt.
So rufen Sie die Client-ID und den geheimen Schlüssel ab:
- Geben Sie auf der Seite Sichere Clients einen Namen in das Feld ein. Dieser Name wird verwendet, um zwischen mehreren Client-IDs und geheimen Schlüsseln zu unterscheiden.
- Klicken Sie auf Client erstellen, um die Client-ID und den geheimen Schlüssel zu erstellen.
- Kopieren Sie die Client-ID und den geheimen Schlüssel an einen sicheren Ort und laden Sie die
.csv-Datei mit diesen Informationen herunter. Verwenden Sie die.csv-Datei, um die DateiCustomerInfo.ymlzu füllen.
Hinweis:
- Die Client-ID und der geheime Schlüssel laufen nicht ab. Wenn sie kompromittiert werden, entfernen Sie sie sofort über das Papierkorb-Symbol und erstellen Sie neue.
- Der geheime Schlüssel kann nicht wiederhergestellt werden, wenn er verloren geht oder vergessen wird; eine neue Client-ID und ein neuer geheimer Schlüssel müssen erstellt werden.
Kundendaten-Datei füllen
Die Datei CustomerInfo.yml macht es überflüssig, bei jeder Ausführung des Cmdlets Kundeninformationsparameter anzugeben. Alle Kundeninformationen können durch die Verwendung von Cmdlet-Parametern überschrieben werden.
Verwenden Sie das Cmdlet New-CvadAcCustomerInfoFile, um die Datei CustomerInfo.yml zu erstellen.
Wichtig:
Bearbeiten Sie die Datei
CustomerInfo.ymlnicht manuell. Dies kann zu unbeabsichtigten Formatierungsfehlern führen.
Das Cmdlet New-CvadAcCustomerInfoFile hat die folgenden erforderlichen Parameter.
- CustomerId – Kunden-ID.
- ClientId – Kunden-Client-ID, die in Citrix Cloud erstellt wurde.
- Secret – Kunden-Geheimnis, das in Citrix Cloud erstellt wurde.
Beispiel:
Hinweis:
Fügen Sie ein Leerzeichen zwischen dem Doppelpunkt und dem Namen des Ressourcenstandorts ein. Wenn Leerzeichen im Zonen- oder Ressourcenstandortnamen verwendet werden, setzen Sie den Namen in Anführungszeichen.
Aktualisieren der Sicherheitsdatei für Hostverbindungen
Hostverbindungen und die zugehörigen Hypervisoren können mit ACT exportiert und importiert werden.
Das Hinzufügen eines Hypervisors zu einer Hostverbindung erfordert sicherheitsrelevante Informationen, die spezifisch für den Hypervisor-Typ sind. Diese Informationen können aus Sicherheitsgründen nicht vom lokalen Standort exportiert werden. Sie müssen die Informationen manuell bereitstellen, damit die automatisierte Konfiguration Hostverbindungen und Hypervisoren erfolgreich in die Cloud-Site importieren kann.
Der Exportprozess erstellt die Datei CvadAcSecurity.yml unter %HOMEPATH%\Documents\Citrix\AutoConfig, die Platzhalter für jedes Sicherheitselement enthält, das für den spezifischen Hypervisor-Typ benötigt wird. Sie müssen die Datei CvadAcSecurity.yml aktualisieren, bevor Sie sie in die Cloud-Site importieren. Administratoraktualisierungen bleiben über mehrere Exporte hinweg erhalten, wobei bei Bedarf neue Sicherheitsplatzhalter hinzugefügt werden. Sicherheitselemente werden niemals entfernt. Weitere Informationen finden Sie unter Manuelles Aktualisieren der Datei CvadAcSecurity.yml
Migrieren von mit Machine Creation Services bereitgestellten Katalogen verstehen
Hinweis:
Diese Funktion ist nur in Versionen 3.0 und höher verfügbar. Überprüfen Sie Ihre Version, indem Sie
Get-CvadAcStatusin Automated Configuration verwenden.
Machine Creation Services (MCS)-Kataloge erstellen zwei verschiedene Arten von Katalogen:
- Wenn an einer Maschine vorgenommene Änderungen verloren gehen oder rückgängig gemacht werden (üblicherweise Server-Betriebssysteme, auf denen Anwendungen veröffentlicht werden) – dies ist ein Anwendungsfall für gepoolte VDI / Multi-Session
- Wenn an einer Maschine vorgenommene Änderungen über einen Neustart hinweg erhalten bleiben (üblicherweise Client-Betriebssysteme mit einem dedizierten Benutzer) – dies ist ein Anwendungsfall für statische VDI
Der Katalogtyp kann im Katalogknoten in Citrix Studio überprüft werden, indem der Wert “Benutzerdaten:” des Katalogs betrachtet wird.
Hinweis:
MCS kann nicht über die Cloud mit Automated Configuration gesichert werden.
Gepoolte VDI- / Multi-Session-Kataloge
Kataloge mit “Benutzerdaten: Verwerfen” sind gepoolte VDI-Kataloge und können nur das Hauptimage und die Konfiguration migrieren. Virtuelle Maschinen in diesen Katalogen werden nicht migriert. Dies liegt daran, dass der Lebenszyklus der virtuellen Maschine von der Site verwaltet wird, von der Sie importieren, was bedeutet, dass sich der Zustand der Maschinen bei jedem Einschalten ändern kann. Dies macht den Import unmöglich, da die Importdaten für die virtuellen Maschinen schnell nicht mehr synchron sind.
Wenn Sie diese Kataloge mit dem Tool migrieren, erstellt es Katalogmetadaten und initiiert die Erstellung des Hauptimages, es werden jedoch keine Maschinen importiert.
Da dieser Prozess je nach Größe des Hauptimages einige Zeit in Anspruch nehmen kann, startet der Importbefehl innerhalb des Tools nur die MCS-Katalogerstellung und wartet nicht auf deren Abschluss. Nachdem der Import abgeschlossen ist, überwachen Sie den Fortschritt der Katalogerstellung mit Studio in der Cloud-Bereitstellung.
Sobald das Hauptimage erstellt ist, können Sie Maschinen bereitstellen. Berücksichtigen Sie die Kapazitätsaspekte, da Sie Kapazität von Ihrer lokalen Nutzung verbrauchen würden.
Alle anderen Objekte (Bereitstellungsgruppen, Anwendungen, Richtlinien usw.), die diesen Katalog verwenden, können importiert werden und müssen nicht auf die Erstellung des Hauptimages warten. Wenn der Katalog fertig erstellt ist, können Maschinen zum importierten Katalog hinzugefügt werden, und Benutzer können dann ihre Ressourcen starten.
Hinweis:
Verwenden Sie dieselben Befehle, die im Tool verfügbar sind, um Kataloge und alle anderen Objekte zu migrieren.
Statische VDI-Kataloge
Hinweis:
Da dieser Vorgang Low-Level-Details importiert, die in der Datenbank gespeichert sind, muss dieser Prozess von einer Maschine mit Datenbankzugriff ausgeführt werden.
Die statischen VDI-Kataloge migrieren das Hauptimage, Konfigurationen und alle virtuellen Maschinen. Im Gegensatz zum Anwendungsfall gepoolter VDI müssen keine Images erstellt werden.
Die VDAs müssen auf den Connector zeigen, damit sie sich bei der Cloud registrieren können.
Lesen Sie den Abschnitt Sites aktivieren, um die Cloud-Site aktiv zu schalten, sodass der Neustartzeitplan, die Energieverwaltung und andere Elemente von der Cloud gesteuert werden.
Sobald die Migration abgeschlossen ist, müssen Sie, wenn Sie diesen Katalog von Ihrer lokalen Site löschen möchten, VM und AD-Konto beibehalten auswählen. Andernfalls werden sie gelöscht, und die Cloud-Site würde auf die gelöschte VM zeigen.
MCS-Tags aktualisieren, um verwaiste Ressourcen nach der Migration zu erkennen
Nachdem Sie von einer lokalen Konfiguration zu einer Cloud-Site oder von Ihrer Cloud-Konfiguration zu einer anderen Cloud-Site migriert haben, müssen Sie die MCS-Site-ID-Tags im Falle persistenter VMs aktualisieren, damit verwaiste Ressourcen korrekt erkannt werden können. Verwenden Sie dazu den PowerShell-Befehl Set-ProvResourceTags. Derzeit ist diese Funktion für Azure anwendbar.
Die detaillierten Schritte sind wie folgt:
- Aktualisieren Sie die MCS-Site-ID-Tags von der neuen Citrix-Site mithilfe des PowerShell-Befehls
Set-ProvResourceTags. Zum Beispiel:
In diesem Artikel
- Bekannte Einschränkungen
- Voraussetzungen für die Migration Ihrer Konfiguration
- Wichtige Schritte
- Automated Configuration herunterladen
- Automated Configuration aktualisieren
- Kunden-ID, Client-ID und geheimen Schlüssel generieren
- Aktualisieren der Sicherheitsdatei für Hostverbindungen
- Migrieren von mit Machine Creation Services bereitgestellten Katalogen verstehen
- MCS-Tags aktualisieren, um verwaiste Ressourcen nach der Migration zu erkennen