Migration

Wichtig:

  • Wenn Sie Ihre vorhandene lokale WEM-Datenbank in den WEM-Dienst migrieren möchten, stellen Sie sicher, dass Sie die neueste Version des Migrationstools verwenden.
  • Um sicherzustellen, dass das Migrationstool erwartungsgemäß funktioniert, müssen Sie möglicherweise .NET Framework aktualisieren. Wenn Sie WEM 1909 oder früher verwenden, aktualisieren Sie auf dem Computer, auf dem Sie das Tool ausführen, auf .NET Framework 4.7.1 oder höher.
  • Es wird empfohlen, das Migrationstool auf dem Computer auszuführen, auf dem der Infrastrukturdienst installiert ist. Dadurch wird sichergestellt, dass der Infrastrukturdienst eine Verbindung zur WEM-Datenbank herstellen kann und dass der Computer, auf dem der Infrastrukturdienst ausgeführt wird, über die erforderlichen Komponenten verfügt.

Wir stellen Ihnen ein Toolkit zur Verfügung, mit dem Sie Ihre vorhandene lokale WEM-Datenbank (Workspace Environment Management) in den WEM-Service migrieren können. Das Toolkit enthält einen Assistenten zum Generieren einer SQL-Datei, die den Inhalt Ihrer WEM-Datenbank enthält, und eine einfache Möglichkeit, die SQL-Datei in die Azure-Datenbank des WEM-Dienstes hochzuladen. Dieser Artikel beschreibt, wie Sie die lokale Datenbankmigration abschließen. Überprüfen Sie die gesamte Sequenz, bevor Sie den Migrationsprozess starten, damit Sie wissen, was Sie erwarten.

Bevor Sie Ihre WEM-Datenbank migrieren, beachten Sie Folgendes:

  • Nach erfolgreicher Migration gehen alle Daten verloren, die mit der aktuellen WEM-Dienstdatenbank verknüpft sind.
  • Sie können Ihre WEM-Datenbank erst migrieren, nachdem der WEM-Dienst erfolgreich bereitgestellt wurde.
  • Bevor Sie den Migrationsprozess starten, empfiehlt Citrix, die lokale WEM-Datenbank zu sichern.
  • Bevor Sie den Migrationsprozess starten, empfiehlt Citrix, dass Sie die Datenbankwartung auf derRegisterkarteDatenbankwartung konfigurieren. Dadurch wird die Größe Ihrer WEM-Datenbank reduziert, sodass Sie eine bessere Migrationserfahrung haben. Weitere Informationen zur Datenbankwartung finden Sie unter Konfigurieren des Infrastrukturdienstes.
  • Wenn Sie versuchen, Ihre WEM-Datenbank zu migrieren, während der WEM-Dienst aktualisiert wird, wird im Benachrichtigungsbereich in der oberen rechten Ecke der Citrix Cloud-Benutzeroberfläche die folgende Fehlermeldung angezeigt: “The Workspace Environment Management database migration has failed because the Workspace Environment Management service is upgrading. Please try again later.” Wenn dies geschieht, versuchen Sie, die SQL-Datei hochzuladen, nachdem Ihr WEM-Dienst erfolgreich aktualisiert wurde. Service-Upgrades werden ebenfalls in der oberen rechten Ecke der Citrix Cloud-Benutzeroberfläche benachrichtigt.

Systemanforderungen

Das Toolkit unterstützt die Migration von WEM 4.7 und höher. Um von einer früheren Version zu migrieren, aktualisieren Sie WEM 4.x auf WEM 4.7 oder höher, und migrieren Sie die Datenbank dann in den WEM-Dienst. Weitere Informationen zum Upgrade finden Sie unter Aktualisieren einer Bereitstellung.

Erste Schritte

Melden Sie sich bei Ihrem Citrix Cloud-Konto an. Weitere Informationen finden Sie unter Was ist ein Citrix Cloud-Konto.

Migrieren der lokalen Datenbank

Schritt 1: Laden Sie das Migrationstool herunter

Laden Sie das Migrationstool (WEM-Migration-Tool.zip) von derRegisterkarteDownloads des WEM-Dienstes herunter. Extrahieren Sie die ZIP-Datei in einen praktischen Ordner.

Hinweis:

Citrix empfiehlt, das Migrationstool auf dem Computer auszuführen, auf dem der Infrastrukturdienst installiert ist. Dadurch wird sichergestellt, dass der Infrastrukturdienst eine Verbindung zur WEM-Datenbank herstellen kann und der Computer, auf dem der Infrastrukturdienst ausgeführt wird, über die erforderlichen Komponenten verfügt.

Schritt 2: Exportieren der Datenbankdaten in eine SQL-Datei

Führen Sie das in der ZIP-DateienthalteneCitrix WEM Migration Tool.exe aus.

Citrix WEM-Migrationstool

Geben Sie die folgenden Daten in den Assistenten ein:

Server- und Instanzname. Adresse der SQL Server-Instanz, die die Datenbank hostet. Es muss vom Infrastrukturserver genau so erreicht werden, wie es hier angegeben ist.

Integrierte Verbindung verwenden (Windows-Anmeldeinformationen). Wenn diese Option aktiviert ist, kann der Datenbankmigrations-Assistent das Windows-Konto der Identität verwenden, unter der er ausgeführt wird, um eine Verbindung mit dem SQL-Server herzustellen, und dann die SQL-Datei mit dem Inhalt der lokalen WEM-Datenbank zu generieren. Wenn dieses Windows-Konto nicht über ausreichende Berechtigungen verfügt, führen Sie Citrix WEM Migration Tool.exe mit einem Windows-Konto mit ausreichenden Berechtigungen aus, oder deaktivieren Sie diese Option, und stellen Sie stattdessen ein SQL-Konto mit ausreichenden Berechtigungen bereit.

Name der Datenbank. Name der zu migrierenden Datenbank.

Ziel. Der gewünschte Ordner zum Speichern der SQL-Datei, die den Inhalt der lokalen WEM-Datenbank enthält. Verwenden Sie die Schaltfläche Durchsuchen, um zu dem Ordner zu navigieren, in dem Sie die SQL-Datei speichern möchten.

Protokolle exportieren. Steuert, ob Protokolle exportiert werden sollen. Die Protokolle enthalten Änderungen, die an Ihren WEM-Agenten vorgenommen wurden. Wenn diese Option aktiviert ist, enthält die zu exportierende Datenbankdatei die Protokolle. Um die Migration zu beschleunigen, empfehlen wir, diese Option nicht zu aktivieren.

Hinweis:

Beim Speichern als Datei wird Ihre WEM-Datenbankdatei automatisch in „Ihre Datenbank name_upload.7z“ umbenannt.

Klicken Sie auf Exportieren, um den Datenbankexport zu starten, oder klicken Sie auf Abbrechen, um den Datenbankmigrations-Assistenten zu beenden.

Während des Exportvorgangs wird dasFensterDatenbankmigrationsstatus angezeigt.

Klicken Sie nach Abschluss des Exportvorgangs auf Fertig stellen, um das Fenster zu schließen und zum Assistenten für die Datenbankmigration zurückzukehren.

Hinweis:

  • Je nach Datenbankgröße kann der Exportprozess von einigen Sekunden bis zu einigen Minuten oder sogar ein paar Stunden dauern.

  • Wenn Sie dasFensterDatenbankmigrationsstatus schließen, während der Datenbankexport ausgeführt wird, kehren Sie zum Assistenten für die Datenbankmigration zurück. Die Schaltfläche Exportieren ist jedoch deaktiviert, da der Datenbankexport im Hintergrund fortgesetzt wird. Um den Exportvorgang vollständig zu beenden, klicken Sie auf Abbrechen.

Wenn beim Exportieren Fehler auftreten, überprüfen Sie dieDebug-Protokolldatei desCitrix WEM Migrationstools im Ordner des Migrationstools, der das Citrix WEM Migration Tool.exe enthält.

Schritt 3: Laden Sie die SQL-Datei in Ihre WEM-Dienstdatenbank hoch

Wichtig:

Do not close the Workspace Environment Management service page before the upload finishes. Andernfalls kann Ihre SQL-Datei nicht erfolgreich hochgeladen werden.

  1. Klicken Sie auf derRegisterkarteDownloads des WEM-Dienstes auf Hochladen, um den Uploadvorgang zu starten.
  2. Klicken Sie auf der Seite SQL-Datei hochladen auf Datei auswählen, und wählen Sie dann die SQL-Datei aus, die hochgeladen werden soll.
  3. Klicken Sie auf OK, um den Upload zu starten und zurRegisterkarteDownloads des WEM-Dienstes zurückzukehren.

Nachdem Sie zurRegisterkarteDownloads des WEM-Dienstes zurückgekehrt sind, wird unter Hochladen die Fortschrittsmeldung angezeigt, die während des Uploads aktualisiert wird. Nachdem die SQL-Datei erfolgreich hochgeladen wurde, wird der Migrationsprozess automatisch gestartet.

Hinweis:

Nachdem die SQL-Datei erfolgreich hochgeladen wurde, müssen Sie 10 Minuten warten, bevor Sie erneut hochladen können.

Nach der Migration

Einige Stunden später erhalten Sie eine Benachrichtigung, die Ihnen das Ergebnis der Migration mitteilt. Siehe Benachrichtigungen in der oberen rechten Ecke der Citrix Cloud-Benutzeroberfläche. Führen Sie nach erfolgreichem Abschluss der Migration die folgenden Schritte auf derRegisterkarteVerwalten aus, um die Daten anzuzeigen, die aus Ihrer lokalen WEM-Datenbank migriert wurden.

Schritt 1: Laden der migrierten Daten in die WEM-Servicekonsole

  1. Bewegen Sie den Mauszeiger über das Dropdown-Menü auf derRegisterkarte „Verwalten“ des WEM-Dienstes.
  2. Klicken Sie auf das Citrix Workspace-Symbol.
  3. Klicken Sie auf das Ellipsensymbol, um zusätzliche Optionen zu erweitern.
  4. Klicken Sie auf Abmelden, um die Verbindung zum WEM-Dienst zu trennen.
  5. Aktualisieren Sie das Browserfenster, um die Verbindung zum WEM-Dienst wiederherzustellen und die Daten anzuzeigen, die von der lokalen WEM-Datenbank migriert wurden.

Schritt 2: Wechseln in den Service-Agent-Modus

Verwenden Sie die Agenten-Switch-Funktion, um vom lokalen in den Service-Agent-Modus zu wechseln. Weitere Informationen zum Agent-Switch finden Sie unter Agent-Switch.

Wichtig:

Die Agent-Switch-Funktion ist in Workspace Environment Management 1909 und höher verfügbar. Bei früheren Versionen müssen Sie den Agent neu installieren oder auf Version 1909 oder höher aktualisieren, bevor Sie den Agent-Switch verwenden.

Alternativ können Sie den Agenten von derRegisterkarteDownloads des Dienstes herunterladen und dann den Agenten manuell neu installieren.

Migration