Comment résoudre les échecs d’installation d’AWS Replication Agent sur mon serveur Windows ?

Brève description

Vous devez installer AWS Replication Agent sur chaque serveur source pour Application Migration Service et Elastic Disaster Recovery. Vous pouvez rencontrer les erreurs d'échec d'installation suivantes :

• « CERTIFICATE_VERIFY_FAILED »
• « Downloading of path/AwsReplicationInstaller.exe failed. »
• « ConnectionResetError: [WinError 10054] An existing connection was forcibly closed by the remote host
{change »
• « invoke-webrequest : The underlying connection was closed: An unexpected error occurred on a send. »
• « No permission to install »
• « This agent installer is not suitable for the current operating system »
• « Agent installation failed with "Unexpected Error »
• « The service cannot be started, either because it is disabled or because it has no enabled devices associated with it.', None, None) Failed to execute script install_agent_windows »
• « Agent installation fails of freezes when using the "--force-volumes" flag to specify disks »
• « [WinError 740] The requested operation requires elevation »
• « MissingDotNetVersionException »
• « UninitializedAccountException »
• « AccessDeniedException »

Résolution

Effectuez les actions de résolution de problèmes suivantes en fonction de l’erreur que vous recevez.

« CERTIFICATE_VERIFY_FAILED »

Cette erreur se produit lorsque l'installation d'AWS Replication Agent échoue car il n'existe aucun certificat d'autorité de certification (CA) racine Amazon. Vous devez disposer de certificats CA racine Amazon pour vous authentifier auprès de la console de gestion AWS.

Pour résoudre cette erreur, procédez comme suit :

1. Téléchargez les certificats CA racine Amazon.
2. Importez les certificats CA racine Amazon dans le dossier Autorités de certification racine approuvées. Pour obtenir des instructions, consultez la page Installation du certificat racine approuvé sur le site Web de Microsoft.


« Downloading of path/AwsReplicationInstaller.exe failed »

Cette erreur signifie que des erreurs réseau sont survenues depuis l'instance source lorsqu'elle s'est connectée aux points de terminaison de service requis suivants :

• Points de terminaison Amazon Simple Storage Service (Amazon S3)
• Point de terminaison d’Application Migration Service
• Points de terminaison Elastic Disaster Recovery

Pour résoudre les erreurs de connexion, ouvrez PowerShell, puis exécutez les commandes suivantes pour tester la connexion du port 443 à chaque point de terminaison.

Amazon S3 :

Test-NetConnection s3.us-east-1.amazonaws.com -Port 443


Application Migration Service :

Test-NetConnection mgn.us-east-1.amazonaws.com -Port 443

Elastic Disaster Recovery :

Test-NetConnection drs.us-east-1.amazonaws.com -Port 443

Remarque : Remplacez us-east-1 par la région AWS que vous utilisez pour Application Migration Service ou Elastic Disaster Recovery.

Vous devez également configurer tous les proxys entre l'environnement sur site et les points de terminaison requis pour Application Migration Service ou Elastic Disaster Recovery.

Si votre réseau sur site n'est pas ouvert aux points de terminaison de service requis, utilisez AWS PrivateLink pour installer l'agent pour Application Migration Service ou Elastic Disaster Recovery.

« ConnectionResetError: [WinError 10054]" or "invoke-webrequest : The underlying connection was closed »

Ces erreurs se produisent lorsque le client ne parvient pas à établir une liaison avec le point de terminaison de service Application Migration Service ou Elastic Disaster Recovery. Ce problème se produit lorsque le client essaie de se connecter à TLS 1.0 ou TLS 1.1. La plupart des points de terminaison AWS fonctionnent avec le protocole TLS 1.2.

Pour résoudre ce problème, procédez comme suit :

• Activez TLS 1.2 pour la sous-clé du serveur et du client.
• Désactivez TLS 1.0, TLS 1.1 et d’autres versions de SSL via le registre.

Pour obtenir des instructions, consultez la page Configuration des paramètres de registre pour TLS 1.2 sur le site Web d'Oracle.

Après avoir modifié vos paramètres TLS, redémarrez le serveur, puis relancez l'installation.

Lorsque vous utilisez Invoke-WebRequest pour télécharger le programme d'installation de l'agent, vous rencontrez des erreurs si vous utilisez des protocoles de sécurité obsolètes. Ce problème se produit lorsque le point de terminaison cible requiert le protocole TLS 1.2, mais que le script ou la session du client n'applique pas ce protocole.

Pour appliquer le protocole TLS 1.2, exécutez la commande suivante :

[System.Net.ServicePointManager]::SecurityProtocol = 'TLS12'

Puis, réessayez l'installation.

« No permission to install »

Cette erreur se produit lorsque l'utilisateur qui installe l'AWS Replication Agent ne dispose pas d'autorisations de domaine d'administrateur. Cette erreur se produit également si un logiciel antivirus bloque l'installation.

Pour résoudre cette erreur, effectuez les actions suivantes :

• Ouvrez l'invite de commande ou PowerShell en tant qu'administrateur.
• Ajoutez C:\Program Files (x86)\AWS Replication Agent\ au répertoire de la liste d’autorisations de votre logiciel antivirus.
  Remarque : Pour vérifier si le logiciel antivirus bloque l'installation, désactivez-le temporairement lorsque vous installez AWS Replication Agent.

« This agent installer is not suitable for the current operating system »

Cette erreur se produit lorsque vous installez la mauvaise version d'AWS Replication Agent pour le système d'exploitation (OS) de la machine source actuelle. Les versions 2003, 2003 R2, 2008, 2008 R2, 2012 et 2012 R2 de Windows Server utilisent une version d'agent unique qui n'est valide que pour les systèmes d'exploitation Windows existants.

Pour 2003, 2003 R2, 2008, 2008 R2, utilisez le programme d'installation AwsReplicationWindowsLegacyInstaller.exe.

Pour 2012 et 2012 R2, utilisez le programme d'installation AwsReplicationWindows2012LegacyInstaller.exe.

Pour plus d'informations, consultez la section Installation d’ AWS Replication Agent sur des serveurs Windows.

« Agent installation failed with "Unexpected Error" »

Cette erreur se produit lorsque vous utilisez des informations d'identification qui ne sont pas valides ou lorsque les informations d'identification de l'utilisateur ne disposent pas des autorisations requises.

Pour résoudre cette erreur, assurez-vous que le rôle Gestion des identités et des accès AWS (AWS IAM) que vous utilisez existe dans votre compte AWS. Assurez-vous également que le rôle dispose des politiques requises pour Application Migration Service ou Elastic Disaster Recovery.

Si les autorisations sont correctes et que le message d'erreur persiste, consultez les journaux d'installation pour résoudre le problème. Les journaux d'installation se trouvent dans le chemin de fichier install_path\aws_replication_agent_installer.log.

« The service cannot be started... Failed to execute script install_agent_windows »

Pour utiliser AWS Replication Agent, vous devez activer le service Windows Management Instrumentation (WMI). Si le WMI ne fonctionne pas comme prévu, vous recevez un message d'erreur similaire à l'exemple suivant dans vos journaux :

File "install_agent_windows.py", line 28, in <module>
  File "c:\python27\Lib\site-packages\PyInstaller\loader\pyimod03_importers.py", line 389, in load_module
  File "installer_utils\init.py", line 5, in <module>
  File "c:\python27\Lib\site-packages\PyInstaller\loader\pyimod03_importers.py", line 389, in load_module
  File "installer_utils\cloud_utils.py", line 34, in <module>
  File "c:\python27\Lib\site-packages\PyInstaller\loader\pyimod03_importers.py", line 389, in load_module
  File "installer_utils\instance_id_utils.py", line 41, in <module>
  File "c:\python27\Lib\site-packages\PyInstaller\loader\pyimod03_importers.py", line 389, in load_module
  File "site-packages\wmi.py ", line 157, in <module>
  File "site-packages\win32com\client\init.py", line 72, in GetObject
  File "site-packages\win32com\client\init.py", line 87, in Moniker
pywintypes.com_error: (-2147023838, 'The service cannot be started, either because it is disabled or because it has no enabled devices associated with it.', None, None)
Failed to execute script install_agent_windows"

Pour résoudre ce problème, activez le service WMI sur la machine source. Pour obtenir des instructions, consultez la page Configuration d'une connexion WMI à distance sur le site Web de Microsoft. Pour plus d'informations sur le WMI, consultez la page Windows Management Instrumentation sur le site Web de Microsoft.

« Agent installation fails or freezes when using the "--force-volumes" flag to specify disks »

Cette erreur se produit lorsque vous ne décrivez pas les disques dans le bon ordre. Lorsque vous utilisez l'indicateur --force-volumes, vous devez d'abord répertorier le disque racine. Dans l'exemple de commande suivant, PhysicalDisk1 est le disque racine :

AwsReplicationWindowsInstaller.exe --region destination-region --aws-access-key-id your-access-key --aws-secret-access-key your-secret-access-key --force-volumes --drives=\\.\PHYSICALDRIVE1,\\.\PHYSICALDRIVE0 --no-prompt

Remarque : Remplacez destination-region par la région de destination. Remplacez également your-access-key par la clé d'accès que vous avez utilisée pour installer l'agent, et your-secret-access-key par la clé d'accès secrète que vous avez utilisée pour installer l'agent. Pour plus d'informations sur la création de la clé d'accès et de la clé d'accès secrète, consultez la section Génération des informations d'identification AWS requises (Application Migration Service) ou Génération des informations d'identification AWS requises (Elastic Disaster Recovery).

Pour vérifier le nom de vos disques, exécutez la commande suivante :

wmic diskdrive list brief

« [WinError 740] The requested operation requires elevation »

Cette erreur se produit lorsqu'un utilisateur sans autorisation administrative tente d'installer le logiciel. Vous devez disposer d'autorisations administratives pour installer et utiliser AWS Replication Agent.

Pour exécuter le fichier d'installation de l'agent avec l'autorisation d'administrateur, ouvrez le menu contextuel (cliquez avec le bouton droit) AWSReplicationWindowsInstaller.exe, puis sélectionnez Exécuter en tant qu'administrateur.

« MissingDotNetVersionException »

Si le message « MissingDotNetVersionException » apparaît dans les journaux du programme d'installation de l'agent, cela signifie que le framework .Net requis est manquant sur le serveur.

Pour résoudre ce problème, procédez comme suit :

• Si vous utilisez Windows Server 2008 R2 ou une version ultérieure, assurez-vous d'avoir installé .NET Framework version 4.5 ou ultérieure sur le serveur. Pour obtenir des instructions, consultez la page Procédure : Déterminer quelles versions de .NET Framework sont installées sur le site Web de Microsoft.

• Pour vérifier la version de .NET Framework, exécutez les commandes suivantes pour vérifier les clés de registre requises :

  reg query "HKEY_LOCAL_MACHINE\Software\Microsoft\NET Framework Setup\NDP\v4\full"  
  
  reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full" /v "Release"

• Vérifiez que votre stratégie de groupe ne bloque pas l'installation de .NET ou ne demande pas les clés de registre requises.

« UninitializedAccountException »

Cette erreur se produit si vous n'avez pas initialisé le compte avec Application Migration Service ou Elastic Disaster Recovery. L'erreur se produit également si le compte n'utilise pas le modèle de réplication par défaut.

Les paramètres de réplication déterminent la manière dont les services répliquent les données des serveurs source vers AWS. Vous devez configurer ces paramètres pour Application Migration Service ou Elastic Disaster Recovery avant d'installer l'agent.

« AccessDeniedException »

Ce problème se produit en raison d'autorisations manquantes. Vérifiez que vous avez associé une politique IAM avec les autorisations requises au rôle ou à l'utilisateur IAM que vous utilisez pour installer l'agent.

Pour Application Migration Service, associez AWSApplicationMigrationAgentInstallationPolicy. Si votre serveur source est une instance Amazon Elastic Compute Cloud (Amazon EC2), associez AWSApplicationMigrationServiceEc2InstancePolicy.

Pour plus d'informations sur les autorisations relatives à Application Migration Service, consultez la section Génération des informations d'identification AWS requises.

Pour Elastic Disaster Recovery, associez AWSElasticDisasterRecoveryAgentInstallationPolicy. Si votre source est une instance Amazon EC2, associez AWSElasticDisasterRecoveryEc2InstancePolicy.

Pour plus d'informations sur les autorisations relatives à Elastic Disaster Recovery, consultez la section Génération des informations d'identification AWS requises.

Assurez-vous également qu'une politique de contrôle des services (SCP) ne bloque ni ne refuse les actions d'API requises pour Application Migration Service ou Elastic Disaster Recovery.

Informations connexes

Résolution des problèmes liés à l'agent