Skip To Content

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. Die ArcGIS for Server-Web-GIS-Vorlagen erstellen außerdem Protokolle, die in eine CloudWatch-Protokollgruppe kopiert werden, um Ihnen bei der Problembehandlung zu helfen.

Registerkarte "Ereignisse" der CloudFormation-Konsole

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 Ereignisse normalerweise einen Ansatz, um festzustellen, worin das Problem bestehen könnte.

CloudWatch-Protokollgruppe

Die CloudFormation-Beispielvorlagen von Esri erstellen eine CloudWatch-Protokollgruppe, in die die folgenden Protokolldateien aus der EC2-Instanz kopiert werden:

EC2-Instanztyp Protokolldatei und Speicherort auf der EC2-InstanzBeschreibung 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:

Einige AWS-Regionen, wie GovCloud und China, verfügen nicht über Protokollierungsfunktionen. Für diese Regionen werden keine Protokollmeldungen in der AWS Management Console angezeigt, Sie können jedoch trotzdem die Protokolldateien auf der Instanz überprüfen.

Die CloudWatch-Protokollgruppe enthält Protokolldatenströme, die die ID der Instanz mit dem Namen der Protokolldatei enthalten. So können Sie feststellen, auf welcher EC2-Instanz sich die Protokolldatei befindet. So handelt es sich beispielsweise bei einem Protokolldatenstrom von i-c8244b6f/chef-run.log um die Protokolldatei des Chef-Konfigurations-Management-Werkzeugs für die EC2-Instanz "i-c8244b6f".

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.

In der Standardeinstellung löscht AWS die CloudWatch-Protokollgruppen bei einer fehlerhaften Stack-Erstellung. Um dies zu vermeiden und somit Protokolldateien zu erhalten, die Sie zum Beheben von Problemen bei der Stack-Erstellung benötigen, ändern die CloudFormation-Beispielvorlagen von Esri diese Einstellung, sodass CloudWatch-Protokollgruppen nicht gelöscht werden. Dies bedeutet jedoch, dass Sie die CloudWatch-Protokollgruppen bereinigen müssen, wenn Sie sie nicht mehr benötigen.

Fehlermeldungen

Im Folgenden finden Sie Tipps zur Problembehandlung bei Fehlern der Stack-Erstellung anhand einiger Fehlermeldungen, die möglicherweise in den Protokolldateien zu finden sind:

  • Wenn eine 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 angezeigt wird, stellen Sie sicher, dass der Bereitstellungs-S3-Bucket-Name richtig ist und dass die S3-Objektschlüsselnamen der Autorisierungsdateien sowie der SSL-Zertifikate korrekt sind.
  • Wenn 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 catalina.out-Protokolldatei unter Ubuntu angezeigt wird, stellen Sie sicher, dass das SSL-Zertifikat im Bereitstellungs-S3-Bucket gültig ist und über das PKCS 12-Format verfügt. Vergewissern Sie sich weiterhin, dass das Kennwort des SSL-Zertifikats richtig ist.
  • Wenn die Meldung OpenSSL::PKCS12::PKCS12Error: PKCS12_parse: mac verify failure (OpenSSL::PKCS12::PKCS12Error: PKCS12_parse: Fehler bei MAC-Überprüfung) in chef-run.log unter Windows angezeigt wird, stellen Sie sicher, dass das SSL-Zertifikat im Bereitstellungs-3-Bucket gültig ist und über das PKCS 12-Format verfügt. Vergewissern Sie sich weiterhin, dass das Kennwort des SSL-Zertifikats richtig ist.