Configurer une appliance avec un script

  • Article

Suivez cet article pour le déploiement d’une appliance Azure Migrate à l’aide d’un script PowerShell pour :

  • la détection, l’évaluation et la réplication sans agent des serveurs exécutés dans un environnement VMware
  • la détection et l’évaluation des serveurs exécutés dans un environnement Hyper-V.

Vous pouvez déployer l’appliance pour des serveurs sur VMware et Hyper-V à l’aide d’un script ou d'un modèle (OVA/VHD) en téléchargement sur le portail Azure. Un script s'avère utile si vous ne parvenez pas à créer une appliance à l’aide du modèle téléchargé.

  • Pour utiliser un modèle, suivez les tutoriels pour VMware ou Hyper-V.
  • Pour configurer une appliance pour les serveurs physiques, seul un script peut être utilisé. Suivez cet article.
  • Pour configurer une appliance dans un Cloud Azure Government, vous ne pouvez utiliser qu’un script. Suivez cet article.

Prérequis

Vous pouvez utiliser le script pour déployer l’appliance Azure Migrate sur un serveur existant dans votre environnement VMware ou Hyper-V.

  • Le serveur hébergeant l’appliance doit remplir les conditions suivantes en matière de matériel et de système d’exploitation :
Scénario Spécifications
VMware Windows Server 2019 ou Windows Server 2022, avec 32 Go de mémoire, huit processeurs virtuels, environ 80 Go de stockage sur disque.
Hyper-V Windows Server 2019 ou Windows Server 2022, avec 16 Go de mémoire, huit processeurs virtuels, environ 80 Go de stockage sur disque.

  • Le serveur a également besoin d’un commutateur virtuel externe. Il nécessite une adresse IP statique ou dynamique.

  • Avant de déployer l’appliance, examinez en détail la configuration requise pour VMware et les Hyper-V.

  • Si vous exécutez le script sur un serveur sur lequel l’appliance Azure Migrate est déjà configurée, vous pouvez choisir de nettoyer la configuration existante et de configurer une nouvelle appliance de la configuration souhaitée. Lorsque vous exécutez le script, vous recevrez une notification comme indiqué ci-dessous :

    Configuration de l’appliance avec la configuration souhaitée

Configurer l'appliance pour VMware

  1. Pour configurer l’appliance, téléchargez le fichier compressé dénommé AzureMigrateInstaller.zip à partir du portail ou de cette page.
  2. Extrayez le contenu sur le serveur sur lequel vous souhaitez déployer l’appliance.
  3. Exécuter le script PowerShell pour lancer le gestionnaire de configuration de l’appliance.
  4. Installez l'appliance et configurez-la pour la première fois.

Vérifier la sécurité

Vérifiez que le fichier compressé est sécurisé avant de le déployer.

  1. Sur le serveur où vous avez téléchargé le fichier, ouvrez une fenêtre de commande d’administrateur.
  2. Exécutez la commande suivante pour générer le code de hachage du fichier compressé :
    • C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]
    • Exemple d’utilisation : C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256
  3. Vérifiez la dernière version de l’appliance et la valeur de hachage :
Télécharger Valeur de hachage
Version la plus récente a551f3552fee62ca5c7ea11648960a09a89d226659febd26314e222a37c7d857

Remarque

Le même script peut être utilisé pour configurer une appliance VMware pour un cloud public Azure ou un cloud Azure Government.

Exécuter le script

  1. Extrayez le fichier compressé dans un dossier sur le serveur qui hébergera l’appliance.

Remarque

Veillez à ne pas exécuter le script sur un serveur disposant d’une appliance Azure Migrate. L’exécution du script sur l’appliance Azure Migrate supprimera la configuration de travail et la remplacera par une configuration nouvellement définie.

  1. Lancez PowerShell sur le serveur ci-dessus avec un privilège administratif (élevé).

  2. Remplacez le répertoire PowerShell par le dossier dans lequel le contenu a été extrait du fichier compressé téléchargé.

  3. Exécutez le script nommé AzureMigrateInstaller.ps1 via la commande suivante :

    PS C:\Users\administrator\Desktop\AzureMigrateInstaller> .\AzureMigrateInstaller.ps1

  4. Sélectionnez parmi les options de scénario, de cloud et de connectivité pour déployer une appliance avec la configuration souhaitée. Par exemple, la sélection présentée ci-dessous configure une appliance pour la détection, l’évaluation et la migration de serveurs exécutés sur votre environnement VMware dans un projet Azure Migrate doté d’une connectivité (point de terminaison public) par défaut sur lecloud public Azure.

    Capture d’écran montrant comment configurer l’appliance VMware avec la configuration souhaitée.

  5. Le script du programme d’installation effectue les opérations suivantes :

  • Installe les agents et une application web.
  • Installe des rôles Windows, notamment le service d’activation Windows, IIS et PowerShell ISE.
  • Télécharge et installe un module réinscriptible IIS.
  • Met à jour une clé de Registre (HKLM) avec les détails de paramètres persistants pour Azure Migrate.
  • Crée les fichiers suivants sous le chemin :
    • Fichiers de configuration : %ProgramData%\Microsoft Azure\Config
    • Fichiers journaux : %ProgramData%\Microsoft Azure\Logs

Une fois que le script a été exécuté avec succès, le gestionnaire de configuration de l’appliance est lancé automatiquement.

Notes

Si vous rencontrez des problèmes, vous pouvez accéder aux journaux de script dans C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_horodatage.log pour les résoudre.

Vérifier l’accès

Vérifiez que l’appliance peut se connecter aux URL Azure pour le cloud public.

Configurer l'appliance pour Hyper-V

  1. Pour configurer l’appliance, téléchargez le fichier compressé dénommé AzureMigrateInstaller.zip à partir du portail ou de cette page.
  2. Extrayez le contenu sur le serveur sur lequel vous souhaitez déployer l’appliance.
  3. Exécuter le script PowerShell pour lancer le gestionnaire de configuration de l’appliance.
  4. Installez l'appliance et configurez-la pour la première fois.

Vérifier la sécurité

Vérifiez que le fichier compressé est sécurisé avant de le déployer.

  1. Sur le serveur où vous avez téléchargé le fichier, ouvrez une fenêtre de commande d’administrateur.
  2. Exécutez la commande suivante pour générer le code de hachage du fichier compressé :
    • C:\>CertUtil -HashFile <file_location> [Hashing Algorithm]
    • Exemple d’utilisation : C:\>CertUtil -HashFile C:\Users\administrator\Desktop\AzureMigrateInstaller.zip SHA256
  3. Vérifiez la dernière version de l’appliance et la valeur de hachage :
Télécharger Valeur de hachage
Version la plus récente a551f3552fee62ca5c7ea11648960a09a89d226659febd26314e222a37c7d857

Remarque

Le même script peut être utilisé pour configurer une appliance Hyper-V pour un cloud public Azure ou un cloud Azure Government.

Exécuter le script

  1. Extrayez le fichier compressé dans un dossier sur le serveur qui hébergera l’appliance.

Remarque

Veillez à ne pas exécuter le script sur une appliance Azure Migrate existante. L’exécution du script sur l’appliance Azure Migrate supprimera la configuration de travail et la remplacera par une configuration nouvellement définie.

  1. Lancez PowerShell sur le serveur ci-dessus avec un privilège administratif (élevé).

  2. Remplacez le répertoire PowerShell par le dossier dans lequel le contenu a été extrait du fichier compressé téléchargé.

  3. Exécutez le script AzureMigrateInstaller.ps1 à l’aide de la commande suivante :

    PS C:\Users\administrator\Desktop\AzureMigrateInstaller> .\AzureMigrateInstaller.ps1

  4. Sélectionnez parmi les options de scénario, de cloud et de connectivité pour déployer une appliance avec la configuration souhaitée. Par exemple, la sélection présentée ci-dessous configure une appliance pour la détection et l’évaluation de serveurs exécutés sur votre environnement Hyper-V dans un projet Azure Migrate doté d’une connectivité (point de terminaison public) par défaut sur lecloud public Azure.

    Capture d’écran montrant comment configurer l’appliance Hyper-V avec la configuration souhaitée.

  5. Le script du programme d’installation effectue les opérations suivantes :

    • Installe les agents et une application web.
    • Installe des rôles Windows, notamment le service d’activation Windows, IIS et PowerShell ISE.
    • Télécharge et installe un module réinscriptible IIS.
    • Met à jour une clé de Registre (HKLM) avec les détails de paramètres persistants pour Azure Migrate.
    • Crée les fichiers suivants sous le chemin :
      • Fichiers de configuration : %Programdata%\Microsoft Azure\Config
      • Fichiers journaux : %Programdata%\Microsoft Azure\Logs

Une fois que le script a été exécuté avec succès, le gestionnaire de configuration de l’appliance est lancé automatiquement.

Notes

Si vous rencontrez des problèmes, vous pouvez accéder aux journaux de script dans C:\ProgramData\Microsoft Azure\Logs\AzureMigrateScenarioInstaller_horodatage.log pour les résoudre.

Vérifier l’accès

Vérifiez que l’appliance peut se connecter aux URL Azure pour le cloud public.

Étapes suivantes

Après avoir déployé l'appliance, vous devez la configurer pour la première fois et l'inscrire auprès du projet.

  • Configurez l’appliance pour VMware.
  • Configurez l’appliance pour Hyper-V.