Es gibt viele Methoden zur Bereitstellung von ArcGIS Enterprise und ArcGIS Server unter Amazon Web Services (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 for Amazon Web Services
In dem Verzeichnis, in dem Sie ArcGIS Enterprise Cloud Builder for Amazon Web Services und die verknüpften Dateien extrahiert haben, finden Sie 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 CloudFormation-Ereignisprotokolle für jeden Stack, den Sie im Rahmen der Bereitstellung immer dann erstellen, wenn Sie den Befehl CREATE mit dem Dienstprogramm ArcGIS Enterprise Cloud Builder CLI for AWS ausführen oder eine Bereitstellung in der ArcGIS Enterprise Cloud Builder for Amazon Web Services-App hinzufügen.
- ErrorLog: Dieser Ordner enthält Protokolldateien zum Aufzeichnen von Fehlern, die beim Ausführen des Dienstprogramms ArcGIS Enterprise Cloud Builder CLI for AWS oder der ArcGIS Enterprise Cloud Builder for Amazon Web Services-App auftreten. Um Probleme effizient zu behandeln, lesen Sie diese Fehlerprotokolle.
In den folgenden beiden Abschnitten finden Sie Informationen zu bestimmten Fehlern, die bei der Ausführung der Cloud Builder-App oder des Dienstprogramms ArcGIS Enterprise Cloud Builder CLI for AWS auftreten können. Sowohl von der App als auch dem Dienstprogramm werden CloudFormation-Stacks gestartet. Aus diesem Grund sollten Sie sich ebenfalls mit dem Abschnitt über die Problembehandlung bei der Erstellung von CloudFormation-Stacks vertraut machen, um Bereitstellungsprobleme erkennen und beheben zu können.
Beim Ausführen der App ArcGIS Enterprise Cloud Builder for Amazon Web Services auftretende Fehler
Die App ArcGIS Enterprise Cloud Builder for Amazon Web Services überprüft viele der Werte, die Sie bei der Nutzung der App angeben. Weitere Informationen finden Sie in den Speicherorten der Protokolldateien aus dem vorherigen Abschnitt.
Mir wird mit einer Meldung mitgeteilt, dass der Domänenname ungültig ist.
Es gibt mehrere Gründe, warum Cloud Builder den Domänennamen nicht überprüfen kann. Der wahrscheinlichste ist eine fehlende oder falsche Zuordnung des Domänennamens in Ihrem Domänennamensserver (DNS). Der Domänenname kann in Ihrem DNS beispielsweise nicht oder falsch zugeordnet sein.
Stellen Sie sicher, dass der von Ihnen angegebene Domänenname in Ihrem DNS in einen CNAME- oder A-Eintrag aufgelöst wird. Um zu überprüfen, ob der in Cloud Builder angegebene Domänenname richtig zugeordnet wurde, verwenden Sie den Befehl nslookup an einer Microsoft Windows-Eingabeaufforderung auf dem Computer, auf dem Sie die App Cloud Builder ausführen.
Wenn Sie die Domänennamenzuordnung für richtig halten, löschen Sie den lokalen DNS-Cache auf dem Computer, auf dem Sie Cloud Builder ausführen. Überprüfen Sie den Domänennamen dann erneut in der Cloud Builder-App.
Wenn der Domänenname weiterhin nicht überprüft wird, bitten Sie Ihren IT-Administrator um Unterstützung.
Meine Bereitstellung wurde nicht erstellt.
Wenn die App Cloud Builder Ihre Bereitstellung nicht erstellen kann, werden auf der Cloud Builder-Seite für den Auftragsabschluss Fehlermeldungen angezeigt. Sie erhalten weitere Details zu den Fehlern, indem Sie auf der Seite für den Auftragsabschluss auf View Process Log und View Error Log klicken.
Wenn ein allgemeiner Fehler wie Wait condition received failed message: 'Chef run failed. See 'c:\\chef\chef-run.log' for details' angezeigt wird, prüfen Sie die Amazon CloudWatch-Protokolle, indem Sie im Abschnitt View AWS CloudWatch Logs der Cloud Builder-Zusammenfassungsseite auf die Protokoll-URLs klicken. Damit wird das entsprechende CloudWatch-Protokoll in Ihrem standardmäßigen Webbrowser geöffnet, sodass Sie die Protokolle für jede Instanz von Amazon Elastic Compute Cloud (EC2) in Ihrer Bereitstellung anzeigen und die Fehlerursache ermitteln können.
Sobald Sie die Fehlerursache gefunden haben, klicken Sie in der App Cloud Builder auf Back, um den erforderlichen Parameter zu korrigieren und die Bereitstellung zu wiederholen. Alternativ können Sie die fehlgeschlagene Bereitstellung löschen und eine neue erstellen.
Die App ArcGIS Enterprise Cloud Builder for Amazon Web Services stürzt ständig ab und gibt einen Fehler zurück, der darauf hinweist, dass ArcGIS Enterprise Cloud Builder for AWS nicht mehr funktioniert
Wenn die App ArcGIS Enterprise Cloud Builder for Amazon Web Services abstürzt und die Fehlermeldung ArcGIS Enterprise Cloud Builder for AWS has stopped working. A problem caused the program to stop working correctly. Windows will close the program and notify you if a solution is available. zurückgibt, fehlt auf Ihrem Computer wahrscheinlich das erforderliche Microsoft Visual C++ Redistributable-Paket. Weitere Informationen und einen Link zum Herunterladen des Pakets finden Sie in den Voraussetzungen für Cloud Builder.
Wo finde ich die CloudWatch-Protokolle für Bereitstellungen, die ich mit der App ArcGIS Enterprise Cloud Builder for Amazon Web Services erstellt habe?
Wenn die App Cloud Builder Ihre Bereitstellung nicht erstellen kann, werden auf der Seite für den Auftragsabschluss Fehlermeldungen zurückgegeben. Weitere Details zu den Fehlern erhalten Sie, indem Sie auf der Seite für den Auftragsabschluss auf die Links View Process Log und View Error Log klicken.
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 Cannot find file <file_name>.
Ab Version 10.8.1 müssen Sie die JSON-Konfigurationsdateien im Arbeitsverzeichnis im Ordner Configuration bzw. in einem der Unterordner ablegen. Speichern Sie die JSON-Konfigurationsdateien nicht im Ordner Configuration des Installationsverzeichnisses. Wenn sich die Konfigurationsdateien nicht im Ordner Configuration des Arbeitsverzeichnisses befinden, müssen Sie die Dateien dorthin verschieben und das Dienstprogramm erneut ausführen.
Bei Version 10.8 und früher müssen Sie die JSON-Konfigurationsdateien im Installationsverzeichnis im Ordner Configuration oder in einem der Unterordner ablegen. Wenn sich die Konfigurationsdateien nicht in diesem Verzeichnis befinden, verschieben Sie sie in den Ordner Configuration, und führen Sie das Dienstprogramm erneut aus.
Ich erhalte die Meldung Invalid deployment configuration file extension. It must be '.json'.
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 Invalid JSON format for file <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 Failed to access AWS account with provided credentials.
Ü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 Amazon Simple Storage Service (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 dem "Default"-Knoten 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
Von den Bereitstellungswerkzeugen von ArcGIS Enterprise on Amazon Web Services werden AWS CloudFormation-Stacks erstellt. Verwenden Sie die AWS CloudFormation-Konsole, um den Status des AWS CloudFormation-Stacks 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 Events, 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.
Durch die Bereitstellungswerkzeuge von ArcGIS Enterprise on Amazon Web Services werden ebenfalls Protokolldateien auf den virtuellen Maschinen erstellt, 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 die Option Rollback bei Fehler deaktivieren.
Wenn die Bereitstellung nicht über ein ArcGIS Enterprise on Amazon Web Services-Bereitstellungswerkzeug gestartet werden kann, stellen Sie eine Remote-Desktop-Verbindung oder SSH mit der Amazon Elastic Compute Cloud (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 der 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.
Wo finde ich die CloudWatch-Protokolle für Bereitstellungen, die ich mit den Bereitstellungswerkzeugen von ArcGIS Enterprise on Amazon Web Services erstellt habe?
Für den Zugriff auf CloudWatch-Protokolle für Bereitstellungen, die Sie mit den Bereitstellungswerkzeugen von ArcGIS Enterprise on Amazon Web Services erstellt haben, müssen Sie sich bei der CloudFormation-Konsole anmelden, die Teil der AWS Management Console ist. Weitere Informationen finden Sie auf der AWS-Website unter View CloudFormation Logs in the Console.
Warum finde ich nicht die CloudWatch-Protokolle für Bereitstellungen, die ich mit den Bereitstellungswerkzeugen von ArcGIS Enterprise on Amazon Web Services erstellt habe?
Ab Version 10.8.1 wird von ArcGIS Enterprise Cloud Builder for AWS bei der Erstellung von Bereitstellungen Version 2 (V2) des Amazon-Instance-Metadaten-Service (IMDS) verwendet. Ab Version 10.8.1 wird in den CloudFormation-Vorlagen von Esri ebenfalls standardmäßig IMDS V2 verwendet. Derzeit ist der CloudWatch-Protokollagent, der von AWS auf EC2-Instanzen installiert wird, nicht mit IMDS V2 kompatibel. Dies ist eine bekannte Einschränkung.
Bis diese Einschränkung von AWS korrigiert wird, müssen Sie bei einem Startfehler des Stack folgendermaßen vorgehen, um die Protokolle für die Problembehandlung anzuzeigen:
- Melden Sie sich bei der CloudFormation-Konsole in der AWS Management Console an.
- Greifen Sie auf den fehlgeschlagenen CloudFormation-Stack zu, und überprüfen Sie die Registerkarte Events auf die Fehlerursache.
- Wird die Meldung Received FAILURE signal with UniqueId <Instanz-ID> oder eine ähnliche Meldung angezeigt, können Sie über Remotedesktop oder SSH anhand der Instanz-ID aus der Meldung auf die betroffene EC2-Instanz zugreifen.
- Überprüfen Sie die Chef-Protokolle, um den Grund zu bestimmen, aus dem der Stack nicht gestartet wurde. Die Chef-Protokolle finden Sie in Abhängigkeit vom Betriebssystem der EC2-Instanz an einem der folgenden Speicherorte:
- Microsoft Windows: C:\chef\chef-run.log
- Ubuntu: /var/log/chef-run.log
Tipp:
Wenn Sie die Esri CloudFormation-Vorlagen verwenden, wird in der neuen Bereitstellung Version 1 (V1) des IMDS verwendet, wodurch die für den CloudWatch-Protokollagenten bestehende Einschränkung umgangen werden kann. Allerdings empfiehlt sich dieser Workaround nicht, da IMDS V1 weniger Sicherheit als IMDS V2 bietet.
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 Elastic Compute Cloud 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 erlauben, dass EC2 die Verfügbarkeitszone für Sie auswählt. 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/ 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 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 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 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 No password was found, 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.
Nach dem Neustart der Site sollte die Meldung nicht mehr angezeigt werden.