Migrer

Important :

  • Si vous avez l’intention de migrer votre base de données WEM locale existante vers le service WEM, assurez-vous d’utiliser la dernière version de l’outil de migration.
  • Pour vous assurer que l’outil de migration fonctionne comme prévu, vous devrez peut-être mettre à niveau .NET Framework. Si vous utilisez WEM 1909 ou une version antérieure, mettez à niveau vers .NET Framework 4.7.1 ou version ultérieure sur la machine sur laquelle vous exécutez l’outil.
  • Nous vous recommandons d’exécuter l’outil de migration sur la machine sur laquelle le service d’infrastructure est installé. Cela garantit que le service d’infrastructure peut se connecter à la base de données WEM et que la machine sur laquelle le service d’infrastructure s’exécute dispose des composants nécessaires.

Nous vous fournissons une boîte à outils pour migrer votre base de données WEM (Workspace Environment Management) locale existante vers le service WEM. La boîte à outils comprend un assistant pour générer un fichier SQL contenant le contenu de votre base de données WEM et un moyen simple de télécharger le fichier SQL dans la base de données Azure du service WEM. Cet article décrit comment effectuer votre migration de base de données locale. Passez en revue la séquence complète avant de commencer le processus de migration afin de savoir à quoi vous attendre.

Avant de migrer votre base de données WEM, gardez à l’esprit les éléments suivants :

  • Une fois votre migration terminée, toutes les données associées à votre base de données de service WEM actuelle seront perdues.
  • Vous ne pouvez migrer votre base de données WEM qu’une fois que votre service WEM a été correctement configuré.
  • Avant de démarrer le processus de migration, Citrix vous recommande de sauvegarder votre base de données WEM locale.
  • Avant de démarrer le processus de migration, Citrix vous recommande de configurer la maintenance de votre base de données sous l’onglet Maintenancede base de données. Cela réduit la taille de votre base de données WEM afin que vous puissiez bénéficier d’une meilleure expérience de migration. Pour plus d’informations sur la maintenance de base de données, voir Configurer le service d’infrastructure.
  • Si vous tentez de migrer votre base de données WEM pendant la mise à niveau du service WEM, le message d’erreur suivant apparaît dans la zone de notifications dans le coin supérieur droit de l’interface utilisateur Citrix Cloud : « La migration de la base de données Workspace Environment Management a échoué car Workspace Environment Management est en cours de mise à niveau. Veuillez réessayer plus tard. » Lorsque cela se produit, essayez de télécharger le fichier SQL après la mise à niveau de votre service WEM. Les mises à niveau de service sont également notifiées dans le coin supérieur droit de l’interface utilisateur Citrix Cloud.

Configuration système requise

La boîte à outils prend en charge la migration depuis WEM 4.7 et versions ultérieures. Pour migrer à partir d’une version antérieure, mettez à niveau WEM 4.x vers WEM 4.7 ou version ultérieure, puis migrez la base de données vers le service WEM. Pour plus d’informations sur la mise à niveau, voir Mettre à niveau un déploiement.

Mise en route

Connectez-vous à votre compte Citrix Cloud. Pour plus d’informations, voir Qu’est-ce qu’un compte Citrix Cloud.

Migrer votre base de données locale

Étape 1 : Télécharger l’outil de migration

Téléchargez l’outil de migration (WEM-Migration-Tool.zip) à partir de l’ongletTéléchargements du service WEM. Extrayez le fichier zip dans un dossier pratique.

Remarque :

Citrix vous recommande d’exécuter l’outil de migration sur la machine sur laquelle le service d’infrastructure est installé. Cela garantit que le service d’infrastructure peut se connecter à la base de données WEM et que la machine sur laquelle le service d’infrastructure s’exécute dispose des composants nécessaires.

Étape 2 : Exporter les données de base de données dans un fichier SQL

Exécutez l’outil de migration Citrix WEM .EXE contenu dans le fichier zip.

Outil de migration Citrix WEM

Entrez les données suivantes dans l’assistant :

Nom du serveur et de l’instance. Adresse de l’instance de serveur SQL qui héberge la base de données. Il doit être accessible à partir du serveur d’infrastructure exactement comme indiqué ici.

Utiliser une connexion intégrée (informations d’identification Windows). Si cette option est sélectionnée, permetà l’Assistant Migration debase de données d’utiliser le compte Windows de l’identité sous laquelle il s’exécute pour se connecter au serveur SQL, puis de générer le fichier SQL contenant le contenu de votre base de données WEM locale. Si ce compte Windows ne dispose pas d’autorisations suffisantes, exécutez Citrix WEM Migration Tool.exe à l’aide d’un compte Windows disposant de privilèges suffisants, ou désactivez cette option et fournissez un compte SQL avec des privilèges suffisants à la place.

Nom de la base de données. Nom de la base de données à migrer.

Cible. Dossier souhaité pour enregistrer le fichier SQL contenant le contenu de votre base de données WEM locale. Utilisez leboutonParcourir pour accéder au dossier dans lequel vous souhaitez enregistrer le fichier SQL.

Exporter les journaux. Contrôle s’il faut exporter les journaux. Les journaux contiennent les modifications apportées à vos agents WEM. Si cette option est activée, le fichier de base de données à exporter contient les journaux. Pour accélérer votre migration, nous vous recommandons de ne pas activer cette option.

Remarque :

Lors de l’enregistrement en tant que fichier, votre fichier de base de données WEM est automatiquement renommé « Votre base de données name_upload.7z ».

Cliquez sur Exporter pour démarrer le processus d’exportation de base de données ou cliquez sur Annuler pour quitter l’Assistant Migration de base de données.

Au cours du processus d’exportation, lafenêtre Statut de la migrationde base de données s’affiche.

Une fois le processus d’exportation terminé, cliquez sur ** Terminer pour fermer la fenêtre et revenir à l’Assistant Migration **de base de données.

Remarque :

  • Selon la taille de votre base de données, le processus d’exportation peut prendre de quelques secondes à quelques minutes, voire quelques heures.

  • Si vous fermez lafenêtre Statut de la migration debase de données lorsque l’exportation de base de données est en cours, vous revenez à l’Assistant Migration de base de données, mais leboutonExporter est désactivé car le processus d’exportation de base de données se poursuit en arrière-plan. Pour arrêter complètement le processus d’exportation, cliquez sur Annuler.

En cas d’erreurs lors de l’exportation, vérifiez lefichier journal de débogage de l’outil de migrationCitrix WEM dans le dossier de l’outil de migration qui contient l’outil de migration Citrix WEM Migration Tool.exe.

Étape 3 : Télécharger le fichier SQL dans votre base de données de service WEM

Important :

Ne fermez pas la page de Workspace Environment Management Service avant la fin du téléchargement. Sinon, votre fichier SQL ne peut pas être téléchargé avec succès.

  1. Sous l’ongletTéléchargements du service WEM, cliquez sur Charger pour démarrer le processus de téléchargement.
  2. Cliquez sur Choisir un fichier dans la page Charger un fichier SQL, puis sélectionnez le fichier SQL à charger.
  3. Cliquez sur OK pour démarrer le téléchargement et revenir à l’ongletTéléchargements du service WEM.

Une fois que vous revenez à l’ongletTéléchargements du service WEM, le message de progression apparaît sous Charger, qui se met à jour à mesure que le téléchargement progresse. Une fois votre fichier SQL téléchargé avec succès, le processus de migration démarre automatiquement.

Remarque :

Une fois votre fichier SQL téléchargé avec succès, vous devez attendre 10 minutes avant de pouvoir le charger à nouveau.

Après la migration

Vous recevez un message de notification quelques heures plus tard, vous communiquant le résultat de la migration. Consultez les notifications dans le coin supérieur droit de l’interface utilisateur Citrix Cloud. Une fois la migration terminée, effectuez les opérations suivantes sous l’ongletGérer pour afficher les données migrées à partir de votre base de données WEM locale.

Étape 1 : Charger les données migrées dans la console de service WEM

  1. Placez la souris sur le menu déroulant de l’ongletGérer du service WEM.
  2. Cliquez sur l’icône Citrix Workspace.
  3. Cliquez sur l’icône représentant des points de suspension pour développer d’autres options.
  4. Cliquez sur Fermer la session pour vous déconnecter du service WEM.
  5. Actualisez la fenêtre de votre navigateur pour vous reconnecter au service WEM et afficher les données migrées à partir de votre base de données WEM locale.

Étape 2 : Passer en mode agent de service

Utilisez la fonction de commutateur d’agent pour passer du mode agent local au mode agent de service. Pour plus d’informations sur le commutateur d’agent, voir Commutateur d’ agent.

Important :

La fonctionnalité de commutateur d’agent est disponible dans Workspace Environment Management 1909 et versions ultérieures. Pour les versions antérieures, vous devez réinstaller l’agent ou le mettre à niveau vers la version 1909 ou ultérieure avant d’utiliser le commutateur d’agent.

Vous pouvez également télécharger l’agent à partir de l’ongletTéléchargements du service, puis réinstaller manuellement l’agent.

Migrer