Wie behebe ich den Installationsfehler des AWS Replication Agents auf meiner EC2-Windows-Instance?

Kurzbeschreibung

Der AWS Replication Agent muss auf jedem Quellserver sowohl für den Application Migration Service als auch die Elastic-Notfallwiederherstellung installiert werden. Möglicherweise treten die folgenden Fehler bei der Installation auf:

• „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“

Lösung

Ergreife je nach Fehler, den du erhältst, die folgenden Maßnahmen zur Problembehandlung.

„CERTIFICATE_VERIFY_FAILED“

Dieser Fehler tritt auf, wenn die Installation von AWS Replication Agent fehlschlägt, weil keine Amazon-Zertifikate der Root Certificate Authority (CA) vorhanden sind. Du benötigst Amazon-Root-CA-Zertifikate, um dich bei der AWS-Managementkonsole zu authentifizieren.

Führe die folgenden Schritte aus, um diesen Fehler zu beheben:

1. Lade die Amazon-Root-CA-Zertifikate herunter.
2. Importiere die Amazon-Root-CA-Zertifikate in den Ordner Trusted Root Certification Authorities. Anweisungen findest du unter Installation des vertrauenswürdigen Stammzertifikats auf der Microsoft-Website.


„Downloading of path/AwsReplicationInstaller.exe failed“

Dieser Fehler bedeutet, dass Netzwerkfehler von der Quell-Instance auftraten, als sie eine Verbindung zu den folgenden erforderlichen Service-Endpunkten herstellte:

• Amazon Simple Storage Service (Amazon S3)-Endpunkte
• Endpunkte des Dienstes für die Anwendungsmigration
• Elastic Notfallwiederherstellungs-Endpunkte

Um Verbindungsfehler zu beheben, öffne PowerShell und führe dann die folgenden Befehle aus, um die Verbindung über Port 443 zu jedem Endpunkt zu testen.

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

Hinweis: Ersetze us-east-1 durch die AWS-Region, die du für Application Migration Service oder Elastic Disaster Recovery verwendest.

Du musst auch alle Proxys zwischen der lokalen Umgebung und den erforderlichen Endpunkten für den Dienst für die Anwendungsmigration oder die Elastic-Notfallwiederherstellung konfigurieren.

Wenn dein lokales Netzwerk nicht für die erforderlichen Service-Endpunkte geöffnet ist, verwend AWS PrivateLink, um den Agenten für den Dienst für die Anwendungsmigration oder die Elastic-Notfallwiederherstellung zu installieren.

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

Diese Fehler treten auf, wenn der Client keinen Handshake mit dem Service-Endpunkt des Diensts für die Anwendungsmigration oder der Elastic-Notfallwiederherstellung durchführen kann. Dieses Problem tritt auf, wenn der Client versucht, eine Verbindung mit TLS 1.0 oder TLS 1.1 herzustellen. Die meisten AWS-Endpunkte funktionieren nur mit dem TLS 1.2-Protokoll.

Gehe wie folgt vor, um dieses Problem zu beheben:

• Aktiviere TLS 1.2 für den Server- und Client-Unterschlüssel.
• Deaktiviere TLS 1.0, TLS 1.1 und andere SSL-Versionen über die Registrierung.

Anweisungen findest du unter Konfiguration der Registrierungseinstellungen für TLS 1.2 auf der Oracle-Website.

Nachdem du deine TLS-Einstellungen geändert hast, starte den Server neu und versuche dann erneut, die Installation durchzuführen.

Wenn du Invoke-WebRequest verwendest, um das Agent-Installationsprogramm herunterzuladen, treten Fehler auf, wenn du veraltete Sicherheitsprotokolle verwendest. Dieses Problem tritt auf, wenn der Zielendpunkt TLS 1.2 benötigt, das Skript oder die Sitzung des Clients dieses Protokoll jedoch nicht erzwingt.

Führe den folgenden Befehl aus, um TLS 1.2 durchzusetzen:

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

Versuche dann erneut, die Installation durchzuführen.

„No permission to install“

Dieser Fehler tritt auf, wenn der Benutzer, der den AWS Replication Agent installiert, keine Administrator-Domain-Berechtigungen hat. Dieser Fehler tritt auch auf, wenn eine Antiviren-Software die Installation blockiert.

Gehe wie folgt vor, um diesen Fehler zu beheben:

• Öffne den Prompt oder PowerShell als Administrator.
• Füge C:\Program Files (x86)\AWS Replication Agent\ zum Verzeichnis der Zulassungsliste in deiner Antivirensoftware hinzu.
  Hinweis: Um zu überprüfen, ob die Antiviren-Software die Installation blockiert, deaktiviere sie vorübergehend, wenn du AWS Replication Agent installierst.

„This agent installer is not suitable for the current operating system“

Dieser Fehler tritt auf, wenn du die falsche AWS Replication Agent-Version für das Betriebssystem (OS) der aktuellen Quellmaschine installierst. Die Windows-Server-Versionen 2003, 2003 R2, 2008, 2008 R2, 2012 und 2012 R2 verwenden eine eigene Agentenversion, die nur für ältere Windows-Betriebssysteme gültig ist.

Verwende für 2003, 2003 R2, 2008, 2008 R2 das Installationsprogramm AwsReplicationWindowsLegacyInstaller.exe.

Verwende für 2012 und 2012 R2 das Installationsprogramm AwsReplicationWindows2012LegacyInstaller.exe.

Weitere Informationen findest du unter Installation des AWS Replication Agent auf Windows-Servern.

„Agent installation failed with "Unexpected Error"“

Dieser Fehler tritt auf, wenn du ungültige Anmeldeinformationen verwendest oder wenn die Anmeldeinformationen des Benutzers nicht über die erforderlichen Berechtigungen verfügen.

Um diesen Fehler zu beheben, stelle sicher, dass die von dir verwendete AWS Identity and Access Management (IAM)-Rolle in deinem AWS-Konto vorhanden ist. Stelle außerdem sicher, dass die Rolle über die erforderlichen Richtlinien für den Dienst für die Anwendungsmigration oder die Elastic-Notfallwiederherstellung verfügt.

Wenn die Berechtigungen korrekt sind und der Fehler weiterhin angezeigt wird, überprüfe die Installationsprotokolle, um mit der Problembehebung fortzufahren. Du findest die Installationsprotokolle im Dateipfad install_path\aws_replication_agent_installer.log.

„The service cannot be started... Failed to execute script install_agent_windows“

Um den AWS Replication Agent verwenden zu können, musst du den Windows Management Instrumentation (WMI)-Service aktivieren. Wenn das WMI nicht wie erwartet funktioniert, erhältst du in deinen Protokollen eine Fehlermeldung ähnlich dem folgenden Beispiel:

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"

Um dieses Problem zu beheben, aktiviere den WMI-Dienst auf dem Quellcomputer. Anweisungen findest du unter Einrichtung einer WMI-Remote-Verbindung auf der Microsoft-Website. Weitere Informationen zur WMI findest du unter Windows Management Instrumentation auf der Microsoft-Website.

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

Dieser Fehler tritt auf, wenn du Festplatten nicht in der richtigen Reihenfolge beschreibst. Wenn du das Flag --force-volumes verwendest, musst du zuerst die Root-Festplatte auflisten. Im folgenden Beispielbefehl ist PhysicalDisk1 die Root-Festplatte:

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

Hinweis: Ersetze destination-region durch die Zielregion. Ersetze außerdem your-access-key durch den Zugriffsschlüssel, den du für die Installation des Agenten verwendet hast, und your-secret-access-key durch den geheimen Zugriffsschlüssel, den du für die Installation des Agenten verwendet hast. Informationen zum Erstellen des Zugriffsschlüssels und des geheimen Zugriffsschlüssels findest du unter Generierung der erforderlichen AWS-Anmeldeinformationen (Dienst für die Anwendungsmigration) oder Generierung der erforderlichen AWS-Anmeldeinformationen (Elastic-Notfallwiederherstellung).

Führe den folgenden Befehl aus, um deine Festplattennamen zu überprüfen:

wmic diskdrive list brief

„[WinError 740] The requested operation requires elevation“

Dieser Fehler tritt auf, wenn ein Benutzer ohne Adminrechte versucht, die Software zu installieren. Du benötigst Adminrechte, um AWS Replication Agent zu installieren und zu verwenden.

Um die Agenteninstallationsdatei mit Adminrechten auszuführen, öffne das Kontextmenü AWSReplicationWindowsInstaller.exe (Rechtsklick) und wähle dann Als Administrator ausführen aus.

„MissingDotNetVersionException“

Wenn du die „MissingDotNetVersionException“ in den Protokollen des Agenteninstallationsprogramms siehst, fehlt dem Server das erforderliche .Net-Framework.

Gehe wie folgt vor, um dieses Problem zu beheben:

• Wenn du Windows Server 2008 R2 oder höher verwendest, stelle sicher, dass du .NET Framework Version 4.5 oder höher auf dem Server installiert hast. Anweisungen findest du unter Vorgehensweise: Ermitteln, welche .NET Framework-Versionen installiert sind auf der Microsoft-Website.

• Um die Version von .NET Framework zu überprüfen, führe die folgenden Befehle aus, um die erforderlichen Registrierungsschlüssel zu überprüfen:

  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"

• Vergewissere dich, dass deine Gruppenrichtlinie die .NET-Installation oder Abfragen der erforderlichen Registrierungsschlüssel nicht blockiert.

„UninitializedAccountException“

Dieser Fehler tritt auf, wenn du das Konto nicht mit dem Dienst für die Anwendungsmigration oder der Elastic-Notfallwiederherstellung initialisiert hast. Der Fehler tritt auch auf, wenn das Konto nicht die Standardreplikationsvorlage verwendet.

Die Replikationseinstellungen bestimmen, wie die Services die Daten von den Quellservern auf AWS replizieren. Du musst diese Einstellungen für den Dienst für die Anwendungsmigration oder die Elastic-Notfallwiederherstellung konfigurieren, bevor du den Agenten installierst.

„AccessDeniedException“

Dieses Problem tritt aufgrund fehlender Berechtigungen auf. Vergewissere dich, dass du eine IAM-Richtlinie mit den erforderlichen Berechtigungen an die IAM-Rolle oder den IAM-Benutzer angehängt hast, den du für die Installation des Agenten verwendest.

Hänge für den Dienst für die Anwendungsmigration AWSApplicationMigrationAgentInstallationPolicy an. Wenn es sich bei deinem Quellserver um eine Amazon Elastic Compute Cloud (Amazon EC2)-Instance handelt, hänge AWSApplicationMigrationServiceEc2InstancePolicy an.

Weitere Informationen zu Berechtigungen für den Dienst für die Anwendungsmigration findest du unter Generierung der erforderlichen AWS-Anmeldeinformationen.

Hänge für die Elastic-Notfallwiederherstellung AWSApplicationMigrationServiceEc2InstancePolicy an. Wenn deine Quelle eine Amazon EC2-Instance ist, füge AWSElasticDisasterRecoveryEc2InstancePolicy an.

Weitere Informationen zu Berechtigungen für die Elastic-Notfallwiederherstellung findest du unter Generierung der erforderlichen AWS-Anmeldeinformationen.

Stelle außerdem sicher, dass eine Service Control Policy (SCP) keine erforderlichen API-Aktionen für den Dienst für die Anwendungsmigration oder die Elastic-Notfallwiederherstellung blockiert oder ablehnt.

Ähnliche Informationen

Beheben von Problemen mit dem Agent