Es gibt viele Methoden zur Bereitstellung von ArcGIS Enterprise und ArcGIS Server unter AWS. In diesem Thema werden die Möglichkeiten der Behandlung von Problemen beschrieben, die bei den einzelnen Bereitstellungsoptionen auftreten können.
Problembehandlung ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services
In dem Verzeichnis, in dem Sie das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS und die entsprechenden Dateien extrahiert haben, gibt es im Ordner Logs zwei Ordner.
Der Ordner Logs enthält die folgenden beiden Unterordner:
- Log: Dieser Ordner enthält Konsolenprotokolle, die bei jeder Ausführung des Dienstprogramms erstellt werden. Der Ordner Log enthält zudem für jeden Stack, den Sie bei jeder Ausführung des Befehls CREATE im Rahmen der Bereitstellung erstellen, CloudFormation-Ereignisprotokolle.
- ErrorLog: Dieser Ordner enthält Protokolldateien zum Aufzeichnen von Fehlern, die beim Ausführen des Dienstprogramms ArcGIS Enterprise Cloud Builder CLI for AWS auftreten. Um Probleme effizient zu behandeln, lesen Sie diese Fehlerprotokolle.
Fehler, die bei Verwendung des Dienstprogramms ArcGIS Enterprise Cloud Builder CLI for AWS auftreten
Im Folgenden werden Meldungen bzw. Probleme beschrieben, die bei Verwendung des Dienstprogramms ArcGIS Enterprise Cloud Builder CLI for AWS auftreten können. Zudem werden Vorschläge zum Beheben der Probleme aufgeführt.
Ich erhalte einen Fehler zu Berechtigungen.
Der Benutzer, der das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS ausführt, muss über rekursiven Schreibzugriff für die Ordner Logs und Output verfügen. Vergewissern Sie sich, dass diese Berechtigungen erteilt wurden.
Ich erhalte die Meldung Die Datei <file_name> wurde nicht gefunden.
Sie müssen die JSON-Konfigurationsdateien im Ordner Configuration oder in einem der Unterordner ablegen. Wenn sich die Konfigurationsdatei nicht in diesem Verzeichnis befindet, verschieben Sie sie in den Ordner Configuration, und führen Sie das Dienstprogramm erneut aus.
Ich erhalte die Meldung Ungültige Erweiterung der Konfigurationsdatei für die Bereitstellung. Die Erweiterung muss "json" lauten.
Die Konfigurationsdatei muss die Erweiterung .json aufweisen. Ist dies nicht der Fall, benennen Sie sie entsprechend um, und führen Sie das Dienstprogramm erneut aus.
Ich erhalte die Meldung Ungültiges JSON-Format für Datei <file_name>.
Stellen Sie sicher, dass die Konfigurationsdatei ein gültiges JSON enthält.
Tipp:
Das Format können Sie mit einem JSON-Validator wie JSONLint prüfen.
Ich erhalte die Meldung Fehler beim Zugriff auf das AWS-Konto mit den angegebenen Anmeldeinformationen.
Überprüfen Sie, ob Sie in der JSON-Konfigurationsdatei gültige AWS-Anmeldeinformationen angegeben haben, sodass das Dienstprogramm eine Verbindung zu AWS herstellen kann. Wenn die Anmeldeinformationen gültig sind, prüfen Sie, ob Sie von dem Computer aus, auf dem Sie das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS ausführen, auf Ihr Konto zugreifen können.
Beim Ausführen des Dienstprogramms ArcGIS Enterprise Cloud Builder CLI for AWS mit dem Befehl PREP erhalte ich die Fehlermeldung, dass der Zugriff verweigert wird.
Wenn Sie für Ihre Bereitstellungsdateien einen vorhandenen S3-Bucket verwenden, müssen Sie über die entsprechenden Berechtigungen für den Zugriff auf den Bucket sowie zum Schreiben im Bucket verfügen.
Wenn ich nach dem Ausführen des Dienstprogramms ArcGIS Enterprise Cloud Builder CLI for AWS mit dem Befehl CREATE die Ausgabedatei öffne, werden nicht alle erwarteten Komponenten angezeigt.
Die Ausgabedatei, die erstellt wird, wenn Sie den Befehl CREATE verwenden, enthält für jede vom Dienstprogramm unter AWS erstellte Komponente eine Überschrift. Diese Überschriften entsprechen den Knoten, die Sie in die JSON-Konfigurationsdatei einbezogen haben. Anhand der Knoten in der Konfigurationsdatei kann das Dienstprogramm erkennen, welche Komponenten erstellt werden sollen. Wenn in der Konfigurationsdatei ein Knoten fehlt, wird die entsprechende Komponente vom Dienstprogramm nicht erstellt.
Jeder Knoten, den Sie in die Konfigurationsdatei einbeziehen, muss mindestens einen Parameter enthalten. Auch dann, wenn Sie alle Parameter unter dem Knoten "Default" festlegen, müssen Sie für jeden Teil der Bereitstellung, der erstellt werden soll, einen Knoten einbeziehen, und dieser Knoten muss mindestens einen Parameter und einen Wert enthalten. Wenn ein Knoten in der Konfigurationsdatei vorhanden ist, aber keinen Parameter enthält, wird dieser Knoten vom Dienstprogramm übersprungen. So ist es beispielsweise nicht möglich, Parameter für eine ArcGIS GIS Server-Site in "Default" festzulegen und einen leeren "Server"-Knoten in die Konfigurationsdatei einzubeziehen. Wenn Sie dies versuchen, wird die ArcGIS GIS Server-Site vom Dienstprogramm nicht erstellt.
Prüfen Sie die Konfigurationsdatei, um sicherzustellen, dass Sie alle erforderlichen Knoten und mindestens einen Parameter für jede Komponente der Bereitstellung hinzugefügt haben. Eine Liste mit den für alle Knoten in der Konfigurationsdatei erforderlichen Parameter finden Sie unter ArcGIS Enterprise Cloud Builder CLI for AWS-Parameter.
Wenn ich das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS ausführe, scheint die Eingabeaufforderung nicht mehr zu funktionieren.
Wenn das Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS oder ein anderes Dienstprogramm in einem Microsoft Windows-Befehlsfenster scheinbar nicht mehr ausgeführt wird, deaktivieren Sie den QuickEdit-Modus für das Befehlsfenster.
Problembehandlung für die Stack-Erstellung mit AWS CloudFormation
Verwenden Sie die AWS CloudFormation-Konsole, um den Status des AWS CloudFormation-Stapels zu überwachen und festzustellen, ob die Stack-Erstellung fehlschlägt. Melden Sie sich bei der AWS CloudFormation-Konsole an (Teil der AWS Management Console), und öffnen Sie die Registerkarte Ereignisse, um Informationen zur Stack-Erstellung, zu Aktualisierungen und zu Löschungen zu erhalten. Wenn bei der Stack-Erstellung ein Fehler auftritt, bieten Ihnen die Informationen auf der Registerkarte Events normalerweise einen Ansatz, um festzustellen, worin das Problem bestehen könnte.
Die CloudFormation-Vorlagen von Esri erstellen außerdem Protokolldateien auf den virtuellen Computern, um Sie bei der Problembehandlung zu unterstützen. Um sicherzustellen, dass die Dateien auch dann beibehalten werden, wenn die Bereitstellung nicht gestartet werden konnte, müssen Sie sich bei der AWS CloudFormation-Konsole anmelden und disable Rollback on failure.
Wenn die Bereitstellung nicht über eine Esri Vorlage gestartet werden kann, stellen Sie eine Remote-Desktop-Verbindung oder SSH mit der EC2-Instanz her, um die Protokolle anzuzeigen. In der folgenden Tabelle sind Protokolltypen und Positionen Tabelle aufgeführt:
| EC2-Instanztyp | Protokolldatei und Speicherort auf der EC2-Instanz | Beschreibung der Protokolldatei |
|---|---|---|
Ubuntu | /var/log/cfn-init.log | Protokolldatei für das CloudFormation-Hilfsskript, das zum Abrufen und Analysieren der Ressourcenmetadaten, für Paketinstallationen, die Erstellung von Dateien und zum Starten von Services verwendet wird |
/var/log/chef-run.log | Protokolldatei des Chef-Konfigurations-Management-Werkzeugs | |
/var/lib/tomcat7/logs/catalina.out | Protokolldatei des Apache Tomcat-Anwendungsservers | |
Windows | C:\cfn\log\cfn-init.log | Protokolldatei für das CloudFormation-Hilfsskript, das zum Abrufen und Analysieren der Ressourcenmetadaten, für Paketinstallationen, die Erstellung von Dateien und zum Starten von Services verwendet wird |
C:\chef\chef-run.log | Protokolldatei des Chef-Konfigurations-Management-Werkzeugs |
Hinweis:
Wenn der CloudFormation-Stack erfolgreich erstellt werden konnte, enthalten die Stack-Ausgabeparameter einen Link zu Protokollgruppe in der AWS Management Console. Wenn die Erstellung des Stacks fehlschlägt, wechseln Sie zur Liste Ressourcen von CloudFormation in der AWS Management Console, um nach der Protokollgruppe zu suchen. Beachten Sie, dass bei einem Fehler bei der Stack-Erstellung vor dem Start einer beliebigen Instanz möglicherweise keine Protokollgruppe erstellt wird.
Fehler beim Starten eines AWS CloudFormation-Stacks
Im Folgenden werden Meldungen bzw. Probleme beschrieben, die bei der Bereitstellung mithilfe einer AWS CloudFormation-Vorlage auftreten können. Zudem werden Vorschläge zum Beheben der Probleme aufgeführt.
Warum erhalte ich eine Fehlermeldung, die darauf hinweist, dass nicht genügend Speicherkapazität verfügbar ist, wenn ich auf Start klicke, um eine Instanz zu starten?
Diese Fehlermeldung wird von Amazon EC2 ausgegeben und bedeutet, dass für die Anforderung einer neuen Instanz nicht genügend Speicherkapazität verfügbar ist. Wenn es die Architektur der Bereitstellung zulässt, können Sie diesen Fehler möglicherweise umgehen, indem Sie eine Instanz in einer anderen Verfügbarkeitszone anfordern oder EC2 die Verfügbarkeitszone für Sie auswählen lassen. Sie haben auch die Möglichkeit, eine andere Instanzgröße zu starten oder die Instanz zu einem späteren Zeitpunkt zu starten.
Was bedeutet die Meldung Error encountered during build of config: Failed to retrieve https:// .s3.amazonaws.com/ (Fehler beim Erstellen der Konfiguration: Abrufen von https://.s3.amazonaws.com/ fehlgeschlagen) in cfn-init.log?
Wenn diese Meldung in der Datei cfn-init.log angezeigt wird, stellen Sie sicher, dass der S3-Bucket-Name der Bereitstellung richtig ist und dass die S3-Objektschlüsselnamen der Autorisierungsdateien sowie der SSL-Zertifikate korrekt sind.
Was bedeutet die Meldung Unable to connect to WebAdaptor URL : https://agsportalssl.esri.com/server/webadaptor (Fehler bei der Verbindung mit WebAdaptor URL: https://agsportalssl.esri.com/server/webadaptor) in der Protokolldatei catalina.out?
Wenn diese Meldung in der Protokolldatei catalina.out unter Ubuntu angezeigt wird, stellen Sie sicher, dass das SSL-Zertifikat im S3-Bucket der Bereitstellung gültig ist und im PKCS 12-Format vorliegt. Vergewissern Sie sich weiterhin, dass das Kennwort des SSL-Zertifikats richtig ist.
Was bedeutet die Meldung OpenSSL::PKCS12::PKCS12Error: PKCS12_parse: mac verify failure (OpenSSL::PKCS12::PKCS12Error: PKCS12_parse: Fehler bei MAC-Überprüfung) in der Datei chef-run.log?
Wenn diese Meldung in der Datei chef-run.log auf einer Windows-Instanz angezeigt wird, stellen Sie sicher, dass das SSL-Zertifikat im S3-Bucket der Bereitstellung gültig ist und im PKCS 12-Format vorliegt. Vergewissern Sie sich weiterhin, dass das Kennwort des SSL-Zertifikats richtig ist.
Problembehandlung bei AWS Management Console
Bei Verwendung der AWS Management Console und Esri Amazon Machine Images zum manuellen Erstellen der Site werden möglicherweise folgende Fehlermeldungen angezeigt:
Warum erhalte ich die Meldung Es wurde kein Kennwort angegeben, wenn ich versuche, das Administratorkennwort für meine EC2-Instanz unter Windows abzurufen?
Diese Meldung kann angezeigt werden, wenn Sie versuchen, Get Windows Password zu verwenden, nachdem Sie eine EC2-Instanz beendet und wieder gestartet haben. Um diesen Fehler zu vermeiden, sollten Sie das Administratorkennwort bei der ersten Anmeldung in einen Wert ändern, den Sie sich gut merken können.
In der AWS Management Console wird eine Meldung angezeigt, dass meine Instanz in Kürze auslaufen soll. Was bedeutet das?
Diese Meldung kann angezeigt werden, wenn die Instanz zufällig auf beeinträchtigter Hardware ausgeführt wird, die von Amazon ersetzt werden muss. Wenn diese Meldung angezeigt wird, sollten Sie die Site beenden und erneut starten.
Hinweis: Wenn Sie ArcGIS Server Cloud Builder on Amazon Web Services verwendet haben, um die Site zu erstellen, verwenden Sie Cloud Builder, um die Site zu beenden und anschließend wieder zu starten.
Nach dem Neustart der Site sollte die Meldung nicht mehr angezeigt werden.
Problembehandlung ArcGIS Server Cloud Builder on Amazon Web Services
Wenn Probleme beim Verwenden von ArcGIS Server Cloud Builder on Amazon Web Services auftreten, können Sie eine Textdatei erstellen, in der Fehlerprotokolle und andere Informationen erfasst werden, um Probleme besser beheben zu können.
Führen Sie die folgenden Schritte aus, um die Protokollierung auf Debug-Ebene für ArcGIS Server Cloud Builder on Amazon Web Services zu aktivieren:
- Wenn ArcGIS Server Cloud Builder on Amazon Web Services ausgeführt wird, schließen Sie es.
- Erstellen Sie eine einfache Textdatei mit dem Namen loglevel im Ordner %USERPROFILE%\documents\ArcGISCloudBuilder auf dem Computer, auf dem ArcGIS Server Cloud Builder on Amazon Web Services installiert ist.
Fügen Sie keine Erweiterung in den Dateinamen ein. Der Name der Datei muss beispielsweise loglevel, nicht etwa loglevel.txt lauten.
- Öffnen Sie die Datei ein einem Texteditor, und geben Sie in der ersten Zeile DEBUG ein.
- Speichern und schließen Sie die Datei.
- Starten Sie ArcGIS Server Cloud Builder on Amazon Web Services, und wiederholen Sie die Schritte, die zu dem Problem geführt haben, das Sie beheben möchten.
In die Protokolldatei werden nun Protokolle auf Debug-Ebene geschrieben. Wenn ArcGIS Server Cloud Builder on Amazon Web Services in die Protokolldatei schreibt, wird das Datum am Ende des Dateinamens im Format JJJJ-MM-TT angefügt.
An jedem Tag, an dem ArcGIS Server Cloud Builder on Amazon Web Services verwendet wird, wird eine Protokolldatei erstellt. Stellen Sie sicher, dass alte Protokolldateien gelöscht werden.
Fehler, die bei Verwendung von ArcGIS Server Cloud Builder on Amazon Web Services auftreten
Im Folgenden werden Meldungen bzw. Probleme beschrieben, die beim Erstellen einer ArcGIS Server-Site mit ArcGIS Server Cloud Builder on Amazon Web Services auftreten können. Zudem werden Vorschläge zum Beheben der Probleme aufgeführt.
Warum kann ich keine Remotedesktopverbindung mit meiner neu erstellten ArcGIS Server-Site unter Windows herstellen?
Geben Sie der Site ein wenig Zeit zum Starten. Wenn Sie die Site mit ArcGIS Server Cloud Builder on Amazon Web Services erstellt haben, warten Sie, bis die Site-Informationen im Fenster My Sites und die Schaltflächen zum Beenden, Aktualisieren, Löschen einer Site angezeigt werden.
Wenn Sie die Site über die AWS Management Console oder eine CloudFormation-Vorlage gestartet haben, klicken Sie in der AWS Management Console mit der rechten Maustaste auf die Instanz, und klicken Sie dann auf Get System Log. Wenn eine Meldung angezeigt wird, die Sie darüber informiert, dass Windows bereit ist, warten Sie noch etwa 5 Minuten, bevor Sie sich anmelden.
Als Nächstes müssen Sie sicherstellen, dass Sie eine Regel zur Sicherheitsgruppe der Site hinzugefügt haben, die Remotedesktopverbindungen über Port 3389 zulässt. Dies wird unter Öffnen einer Amazon EC2-Sicherheitsgruppe für ArcGIS beschrieben.
ArcGIS Server Cloud Builder on Amazon Web Services zeigt die folgende Meldung an, nachdem ich mich angemeldet habe: Fehler beim Abrufen der benutzerdefinierten Konfigurationsvorlagen. Nicht zulässig. Was bedeutet das?
Obwohl diese Meldung mehrere Ursachen haben kann, wird sie möglicherweise angezeigt, wenn Ihre Systemzeit nicht mit der aktuellen Uhrzeit synchron ist. Wenn Sie beispielsweise in einer Region leben, in der die Uhrzeit während der Sommermonate um eine Stunde vorgestellt wird, und die Uhr des Computers nicht mit dieser Änderung synchronisiert wurde, kann ArcGIS Server Cloud Builder on Amazon Web Services bestimmte Aktionen mit Amazon EC2 nicht ausführen.