Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Problembehebung AWS IoT Greengrass V2
<a name="troubleshooting"></a>

Verwenden Sie die Informationen und Lösungen zur Fehlerbehebung in diesem Abschnitt, um Probleme mit AWS IoT Greengrass Version 2 zu lösen.

**Topics**
+ [Protokolle der AWS IoT Greengrass Kernsoftware und der Komponenten anzeigen](#troubleshoot-with-logs)
+ [AWS IoT Greengrass Kernprobleme mit der Software](#greengrass-core-issues)
+ [AWS IoT Greengrass Cloud-Probleme](#greengrass-cloud-issues)
+ [Hauptprobleme bei der Gerätebereitstellung](#greengrass-core-deployment-issues)
+ [Probleme mit den wichtigsten Gerätekomponenten](#greengrass-core-component-issues)
+ [Probleme mit den Lambda-Funktionskomponenten des Kerngeräts](#greengrass-core-lambda-function-issues)
+ [Die Version der Komponente wurde eingestellt](#discontinued-component-version)
+ [Probleme mit der Greengrass-Befehlszeilenschnittstelle](#greengrass-cli-issues)
+ [AWS Command Line Interface Probleme](#aws-cli-issues)
+ [Detaillierte Fehlercodes für die Bereitstellung](troubleshooting-deployment.md)
+ [Detaillierte Statuscodes für Komponenten](troubleshooting-component.md)

## Protokolle der AWS IoT Greengrass Kernsoftware und der Komponenten anzeigen
<a name="troubleshoot-with-logs"></a>

Die AWS IoT Greengrass Core-Software schreibt Protokolle in das lokale Dateisystem, mit denen Sie Echtzeitinformationen über das Kerngerät abrufen können. Sie können Core-Geräte auch so konfigurieren, dass sie CloudWatch Protokolle in Logs schreiben, sodass Sie Probleme bei Kerngeräten remote beheben können. Mithilfe dieser Protokolle können Sie Probleme mit Komponenten, Bereitstellungen und Kerngeräten identifizieren. Weitere Informationen finden Sie unter [AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).

## AWS IoT Greengrass Kernprobleme mit der Software
<a name="greengrass-core-issues"></a>

Beheben Sie Probleme mit der AWS IoT Greengrass Kernsoftware. 

**Topics**
+ [ThrottlingException von der ListDeployments API](#ThrottlingException)
+ [Das Kerngerät konnte nicht eingerichtet werden](#unable-to-set-up-core-device)
+ [Die AWS IoT Greengrass Core-Software konnte nicht als Systemdienst gestartet werden](#unable-to-start-system-service)
+ [Nucleus kann nicht als Systemdienst eingerichtet werden](#unable-to-set-up-system-service)
+ [Es konnte keine Verbindung hergestellt werden AWS IoT Core](#core-error-unable-to-connect-to-aws-iot)
+ [Fehler: Nicht genügend Arbeitsspeicher](#java-out-of-memory)
+ [Greengrass CLI kann nicht installiert werden](#unable-to-install-greengrass-cli)
+ [User root is not allowed to execute](#user-not-allowed-to-execute)
+ [com.aws.greengrass.lifecyclemanager.GenericExternalService: Could not determine user/group to run with](#missing-default-run-with-user)
+ [Failed to map segment from shared object: operation not permitted](#tmp-folder-noexec)
+ [Der Windows-Dienst konnte nicht eingerichtet werden](#failed-to-set-up-windows-service)
+ [com.aws.greengrass.util.exceptions.TLSAuthException: Failed to get trust manager](#failed-to-get-trust-manager)
+ [com.aws.greengrass.deployment.IotJobsHelper: No connection available during subscribing to Iot Jobs descriptions topic. Will retry in sometime](#iot-jobs-no-connection-available)
+ [software.amazon.awssdk.services.iam.model.IamException: The security token included in the request is invalid](#error-invalid-security-token)
+ [software.amazon.awssdk.services.iot.model.IotException: User: <user> is not authorized to perform: iot:GetPolicy](#missing-automatic-provisioning-permissions)
+ [Error: com.aws.greengrass.shadowmanager.sync.model.FullShadowSyncRequest: Could not execute cloud shadow get request](#shadow-manager-error-could-not-execute-shadow-get-request)
+ [Operation aws.greengrass\$1<operation> is not supported by Greengrass](#ipc-operation-not-supported)
+ [java.io.FileNotFoundException: <stream-manager-store-root-dir>/stream\$1manager\$1metadata\$1store (Permission denied)](#stream-manager-store-root-folder-not-found)
+ [com.aws.greengrass.security.provider.pkcs11.PKCS11CryptoKeyService: Private key or certificate with label <label> does not exist](#pkcs11-provider-error-private-key-or-certificate-does-not-exist)
+ [software.amazon.awssdk.services.secretsmanager.model.SecretsManagerException: User: <user> is not authorized to perform: secretsmanager:GetSecretValue on resource: <arn>](#secret-manager-error-not-authorized-to-perform-get-secret-value)
+ [software.amazon.awssdk.services.secretsmanager.model.SecretsManagerException: Access to KMS is not allowed](#secret-manager-error-no-kms-access)
+ [java.lang.NoClassDefFoundError: com/aws/greengrass/security/CryptoKeySpi](#hardware-security-incompatible-nucleus-version)
+ [com.aws.greengrass.security.provider.pkcs11.PKCS11CryptoKeyService: CKR\$1OPERATION\$1NOT\$1INITIALIZED](#ckr-operation-not-initialized)
+ [Greengrass core device stuck on nucleus v2.12.3](#v2.12.3-revise-deployment)
+ [Greengrass nucleus v2.14.0 systemd template issue](#v2.14.0-systemd-template)

### ThrottlingException von der ListDeployments API
<a name="ThrottlingException"></a>

`ThrottlingException`von der `ListDeployments` API: Dies wird möglicherweise angezeigt, wenn Sie eine große Anzahl von Bereitstellungen im Konto haben. 

Gehen Sie wie folgt vor, um dieses Problem zu lösen:
+ Wenn Sie SDK verwenden, geben Sie bitte den MaxResult Parameter an. Zum Beispiel für [JavaSDK](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/greengrassv2/model/ListDeploymentsRequest.html#maxResults) mit einem kleinen Wert (z. B. 5).
+ Sie können [AWS Service Quotas](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html) verwenden, um eine Limiterhöhung des Ratenlimits der `DescribeJob` API zu beantragen. Sie können zur Service-Kontingentkonsole gehen, Kontingente von auswählen AWS IoT und das Limit heißt **DescribeJob Throttle Limit**. Sie können es von 10 auf 50 erhöhen.

### Das Kerngerät konnte nicht eingerichtet werden
<a name="unable-to-set-up-core-device"></a>

Wenn das AWS IoT Greengrass Core-Softwareinstallationsprogramm fehlschlägt und Sie kein Kerngerät einrichten können, müssen Sie die Software möglicherweise deinstallieren und es erneut versuchen. Weitere Informationen finden Sie unter [Deinstallieren Sie die AWS IoT Greengrass Core-Software](uninstall-greengrass-core-v2.md).

### Die AWS IoT Greengrass Core-Software konnte nicht als Systemdienst gestartet werden
<a name="unable-to-start-system-service"></a>

Wenn die AWS IoT Greengrass Core-Software nicht gestartet werden kann, [überprüfen Sie die Systemdienstprotokolle](monitor-logs.md#access-system-service-logs), um das Problem zu identifizieren. Ein häufiges Problem besteht darin, dass Java in der Umgebungsvariablen PATH (Linux) oder der Systemvariablen PATH (Windows) nicht verfügbar ist.

### Nucleus kann nicht als Systemdienst eingerichtet werden
<a name="unable-to-set-up-system-service"></a>

Dieser Fehler tritt möglicherweise auf, wenn das Installationsprogramm der AWS IoT Greengrass Core-Software nicht AWS IoT Greengrass als Systemdienst eingerichtet werden kann. Auf Linux-Geräten tritt dieser Fehler normalerweise auf, wenn das Core-Gerät nicht über das [Systemd-Init-System](https://en.wikipedia.org/wiki/Systemd) verfügt. Das Installationsprogramm kann die AWS IoT Greengrass Core-Software erfolgreich einrichten, auch wenn der Systemdienst nicht eingerichtet werden kann.

Führen Sie eine der folgenden Aktionen aus:
+ Konfigurieren Sie die AWS IoT Greengrass Core-Software und führen Sie sie als Systemdienst aus. Sie müssen die Software als Systemdienst konfigurieren, um alle Funktionen von nutzen zu können AWS IoT Greengrass. Sie können [systemd](https://en.wikipedia.org/wiki/Systemd) installieren oder ein anderes Init-System verwenden. Weitere Informationen finden Sie unter [Den Greengrass Nucleus als Systemdienst konfigurieren](configure-greengrass-core-v2.md#configure-system-service).
+ Führen Sie die AWS IoT Greengrass Core-Software ohne einen Systemdienst aus. Sie können die Software mit einem Loader-Skript ausführen, das der Installer im Greengrass-Stammordner einrichtet. Weitere Informationen finden Sie unter [Führen Sie die AWS IoT Greengrass Core-Software ohne Systemdienst aus](run-greengrass-core-v2.md#run-greengrass-core-no-system-service).

### Es konnte keine Verbindung hergestellt werden AWS IoT Core
<a name="core-error-unable-to-connect-to-aws-iot"></a>

Dieser Fehler tritt möglicherweise auf, wenn die AWS IoT Greengrass Core-Software beispielsweise keine Verbindung AWS IoT Core zum Abrufen von Bereitstellungsaufträgen herstellen kann. Gehen Sie wie folgt vor:
+ Vergewissern Sie sich, dass Ihr Core-Gerät eine Verbindung zum Internet herstellen kann und AWS IoT Core. Weitere Informationen zum AWS IoT Core Endpunkt, mit dem Ihr Gerät eine Verbindung herstellt, finden Sie unter[Konfiguration der AWS IoT Greengrass Core-Software](configure-greengrass-core-v2.md).
+ Vergewissern Sie sich, dass AWS IoT das Gerät Ihres Kerngeräts ein Zertifikat verwendet`iot:Connect`, das die`iot:Publish`,`iot:Receive`, und `iot:Subscribe` Berechtigungen zulässt.
+ Wenn Ihr Hauptgerät einen [Netzwerk-Proxy](configure-greengrass-core-v2.md#configure-network-proxy) verwendet, überprüfen Sie, ob Ihr Kerngerät eine [Geräterolle](device-service-role.md) hat und ob seine Rolle die`iot:Connect`, `iot:Publish``iot:Receive`, und `iot:Subscribe` Berechtigungen zulässt.

### Fehler: Nicht genügend Arbeitsspeicher
<a name="java-out-of-memory"></a>

Dieser Fehler tritt normalerweise auf, wenn Ihr Gerät nicht über ausreichend Speicher verfügt, um ein Objekt im Java-Heap zuzuweisen. Auf Geräten mit begrenztem Speicher müssen Sie möglicherweise eine maximale Heap-Größe angeben, um die Speicherzuweisung zu steuern. Weitere Informationen finden Sie unter [Steuern Sie die Speicherzuweisung mit JVM-Optionen](configure-greengrass-core-v2.md#jvm-tuning).

### Greengrass CLI kann nicht installiert werden
<a name="unable-to-install-greengrass-cli"></a>

Möglicherweise wird die folgende Konsolenmeldung angezeigt, wenn Sie das `--deploy-dev-tools` Argument in Ihrem Installationsbefehl für AWS IoT Greengrass Core verwenden.

```
Thing group exists, it could have existing deployment and devices, hence NOT creating deployment for Greengrass first party dev tools, please manually create a deployment if you wish to
```

Dies tritt auf, wenn die Greengrass-CLI-Komponente nicht installiert ist, weil Ihr Kerngerät Mitglied einer Dinggruppe ist, für die bereits eine Bereitstellung vorhanden ist. Wenn Sie diese Meldung sehen, können Sie die Greengrass-CLI-Komponente (`aws.greengrass.Cli`) manuell auf dem Gerät bereitstellen, um die Greengrass-CLI zu installieren. Weitere Informationen finden Sie unter [Installieren Sie die Greengrass-CLI](install-gg-cli.md).

### User root is not allowed to execute
<a name="user-not-allowed-to-execute"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn der Benutzer, der die AWS IoT Greengrass Core-Software ausführt, (normalerweise`root`) nicht berechtigt ist, die Software `sudo` mit einem Benutzer und einer Gruppe zu verwenden. Für den `ggc_user` Standardsystembenutzer sieht dieser Fehler wie folgt aus:

```
Sorry, user root is not allowed to execute <command> as ggc_user:ggc_group.
```

Vergewissern Sie sich, dass Ihre `/etc/sudoers` Datei dem Benutzer die Erlaubnis gibt, `sudo` sie unter anderen Gruppen auszuführen. Die Zugriffsrechte für den Benutzer `/etc/sudoers` sollten wie im folgenden Beispiel aussehen.

```
root    ALL=(ALL:ALL) ALL
```

### com.aws.greengrass.lifecyclemanager.GenericExternalService: Could not determine user/group to run with
<a name="missing-default-run-with-user"></a>

Dieser Fehler tritt möglicherweise auf, wenn das Kerngerät versucht, eine Komponente auszuführen, und der Greengrass-Nucleus keinen Standardsystembenutzer für die Ausführung von Komponenten angibt.

Um dieses Problem zu beheben, konfigurieren Sie den Greengrass-Nucleus so, dass er den Standardsystembenutzer angibt, der die Komponenten ausführt. Weitere Informationen erhalten Sie unter [Konfigurieren Sie den Benutzer, der die Komponenten ausführt](configure-greengrass-core-v2.md#configure-component-user) und [Konfigurieren Sie den Standardkomponentenbenutzer](configure-greengrass-core-v2.md#configure-default-component-user).

### Failed to map segment from shared object: operation not permitted
<a name="tmp-folder-noexec"></a>

Dieser Fehler tritt möglicherweise auf, wenn die AWS IoT Greengrass Core-Software nicht gestartet werden kann, weil der `/tmp` Ordner mit `noexec` entsprechenden Berechtigungen bereitgestellt wurde. Die [AWS Common Runtime (CRT) -Bibliothek](https://github.com/awslabs/aws-crt-java) verwendet den `/tmp` Ordner standardmäßig.

Führen Sie eine der folgenden Aktionen aus:
+ Führen Sie den folgenden Befehl aus, um den `/tmp` Ordner mit den `exec` entsprechenden Berechtigungen erneut bereitzustellen, und versuchen Sie es erneut.

  ```
  sudo mount -o remount,exec /tmp
  ```
+ Wenn Sie Greengrass Nucleus v2.5.0 oder höher ausführen, können Sie eine JVM-Option festlegen, um den Ordner zu ändern, den die CRT-Bibliothek verwendet. AWS Sie können den `jvmOptions` Parameter in der Greengrass Nucleus-Komponentenkonfiguration in einer Bereitstellung oder bei der Installation der AWS IoT Greengrass Core-Software angeben. */path/to/use*Ersetzen Sie ihn durch den Pfad zu einem Ordner, den die AWS CRT-Bibliothek verwenden kann.

  ```
  {
    "jvmOptions": "-Daws.crt.lib.dir=\"/path/to/use\""
  }
  ```

### Der Windows-Dienst konnte nicht eingerichtet werden
<a name="failed-to-set-up-windows-service"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn Sie die AWS IoT Greengrass Core-Software auf einem Microsoft Windows 2016-Gerät installieren. Die AWS IoT Greengrass Core-Software wird unter Windows 2016 nicht unterstützt. Eine Liste der unterstützten Betriebssysteme finden Sie unter[Unterstützte Plattformen](greengrass-nucleus-component.md#greengrass-v2-supported-platforms).

Wenn Sie Windows 2016 verwenden müssen, können Sie Folgendes tun:

1. Entpacken Sie das heruntergeladene AWS IoT Greengrass Core-Installationsarchiv

1. Öffnen Sie im `Greengrass` Verzeichnis die `bin/greengrass.xml.template` Datei.

1. Fügen Sie das `<autoRefresh>` Tag am Ende der Datei direkt vor dem `</service>` Tag hinzu.

   ```
     </log>
     <autoRefresh>false</autoRefresh>
   </service>
   ```

### com.aws.greengrass.util.exceptions.TLSAuthException: Failed to get trust manager
<a name="failed-to-get-trust-manager"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn Sie die AWS IoT Greengrass Core-Software ohne eine Root-Zertifizierungsstellendatei (CA) installieren.

```
2022-06-05T10:00:39.556Z [INFO] (main) com.aws.greengrass.lifecyclemanager.Kernel: service-loaded. {serviceName=DeploymentService}
2022-06-05T10:00:39.943Z [WARN] (main) com.aws.greengrass.componentmanager.ClientConfigurationUtils: configure-greengrass-mutual-auth. Error during configure greengrass client mutual auth. {}
com.aws.greengrass.util.exceptions.TLSAuthException: Failed to get trust manager
```

Vergewissern Sie sich, dass Sie eine gültige Root-CA-Datei mit dem `rootCaPath` Parameter in der Konfigurationsdatei angeben, die Sie dem Installationsprogramm zur Verfügung stellen. Weitere Informationen finden Sie unter [Installieren Sie die AWS IoT Greengrass Core-Software](install-greengrass-core-v2.md).

### com.aws.greengrass.deployment.IotJobsHelper: No connection available during subscribing to Iot Jobs descriptions topic. Will retry in sometime
<a name="iot-jobs-no-connection-available"></a>

Diese Warnmeldung wird möglicherweise angezeigt, wenn das Core-Gerät keine Verbindung herstellen kann, AWS IoT Core um Benachrichtigungen über Bereitstellungsaufträge zu abonnieren. Gehen Sie wie folgt vor:
+ Vergewissern Sie sich, dass das Hauptgerät mit dem Internet verbunden ist und den von Ihnen konfigurierten AWS IoT Datenendpunkt erreichen kann. Weitere Informationen zu Endpunkten, die von Kerngeräten verwendet werden, finden Sie unter[Geräteverkehr über einen Proxy oder eine Firewall zulassen](allow-device-traffic.md).
+ Suchen Sie in den Greengrass-Protokollen nach anderen Fehlern, die andere Ursachen aufdecken.

### software.amazon.awssdk.services.iam.model.IamException: The security token included in the request is invalid
<a name="error-invalid-security-token"></a>

Dieser Fehler tritt möglicherweise auf, wenn Sie [die AWS IoT Greengrass Core-Software mit automatischer Bereitstellung installieren](quick-installation.md) und das Installationsprogramm ein ungültiges AWS Sitzungstoken verwendet. Gehen Sie wie folgt vor:
+ Wenn Sie temporäre Sicherheitsanmeldeinformationen verwenden, überprüfen Sie, ob das Sitzungstoken korrekt ist und ob Sie das vollständige Sitzungstoken kopieren und einfügen.
+ Wenn Sie langfristige Sicherheitsanmeldedaten verwenden, stellen Sie sicher, dass das Gerät nicht über ein Sitzungstoken aus einer Zeit verfügt, in der Sie zuvor temporäre Anmeldeinformationen verwendet haben. Gehen Sie wie folgt vor:

  1. Führen Sie den folgenden Befehl aus, um die Umgebungsvariable für das Sitzungstoken zu deaktivieren.

------
#### [ Linux or Unix ]

     ```
     unset AWS_SESSION_TOKEN
     ```

------
#### [ Windows Command Prompt (CMD) ]

     ```
     set AWS_SESSION_TOKEN=
     ```

------
#### [ PowerShell ]

     ```
     Remove-Item Env:\AWS_SESSION_TOKEN
     ```

------

  1. Überprüfen Sie, ob die AWS Anmeldeinformationsdatei,`~/.aws/credentials`, ein Sitzungstoken, `aws_session_token` enthält. Wenn ja, entfernen Sie diese Zeile aus der Datei.

     ```
     aws_session_token = AQoEXAMPLEH4aoAH0gNCAPyJxz4BlCFFxWNE1OPTgk5TthT+FvwqnKwRcOIfrRh3c/LTo6UDdyJwOOvEVPvLXCrrrUtdnniCEXAMPLE/IvU1dYUg2RVAJBanLiHb4IgRmpRV3zrkuWJOgQs8IZZaIv2BXIa2R4Olgk
     ```

Sie können die AWS IoT Greengrass Core-Software auch ohne Angabe von AWS Anmeldeinformationen installieren. Für weitere Informationen siehe [Installieren Sie die AWS IoT Greengrass Core-Software mit manueller Ressourcenbereitstellung](manual-installation.md) oder [Installieren Sie die AWS IoT Greengrass Core-Software mit AWS IoT Flottenbereitstellung](fleet-provisioning.md).

### software.amazon.awssdk.services.iot.model.IotException: User: <user> is not authorized to perform: iot:GetPolicy
<a name="missing-automatic-provisioning-permissions"></a>

Dieser Fehler tritt möglicherweise auf, wenn Sie [die AWS IoT Greengrass Core-Software mit automatischer Bereitstellung installieren](quick-installation.md) und das Installationsprogramm AWS Anmeldeinformationen verwendet, für die nicht die erforderlichen Berechtigungen erforderlich sind. Weitere Informationen zu den erforderlichen Berechtigungen finden Sie unter[Minimale IAM-Richtlinie für das Installationsprogramm zur Bereitstellung von Ressourcen](provision-minimal-iam-policy.md).

Überprüfen Sie die Berechtigungen für die IAM-Identität der Anmeldeinformationen und gewähren Sie der IAM-Identität alle erforderlichen Berechtigungen, die fehlen.

### Error: com.aws.greengrass.shadowmanager.sync.model.FullShadowSyncRequest: Could not execute cloud shadow get request
<a name="shadow-manager-error-could-not-execute-shadow-get-request"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn Sie die [Shadow-Manager-Komponente verwenden, um Geräteschatten](shadow-manager-component.md) mit zu [synchronisieren](sync-shadows-with-iot-core.md). AWS IoT Core Der HTTP-Statuscode 403 gibt an, dass dieser Fehler aufgetreten ist, weil die AWS IoT Richtlinie des Kerngeräts keine Anrufberechtigung gewährt`GetThingShadow`.

```
com.aws.greengrass.shadowmanager.sync.model.FullShadowSyncRequest: Could not execute cloud shadow get request. {thing name=MyGreengrassCore, shadow name=MyShadow}
2021-07-14T21:09:02.456Z [ERROR] (pool-2-thread-109) com.aws.greengrass.shadowmanager.sync.SyncHandler: sync. Skipping sync request. {thing name=MyGreengrassCore, shadow name=MyShadow}
com.aws.greengrass.shadowmanager.exception.SkipSyncRequestException: software.amazon.awssdk.services.iotdataplane.model.IotDataPlaneException: null (Service: IotDataPlane, Status Code: 403, Request ID: f6e713ba-1b01-414c-7b78-5beb3f3ad8f6, Extended Request ID: null)
```

Um lokale Shadows mit zu synchronisieren AWS IoT Core, muss die AWS IoT Richtlinie des Kerngeräts die folgenden Berechtigungen gewähren:
+ `iot:GetThingShadow`
+ `iot:UpdateThingShadow`
+ `iot:DeleteThingShadow`

Überprüfen Sie die AWS IoT Richtlinien des Core-Geräts und fügen Sie alle erforderlichen Berechtigungen hinzu, die noch fehlen. Weitere Informationen finden Sie hier:
+ [AWS IoT Core Richtlinienaktionen](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html) im *AWS IoT Entwicklerhandbuch*
+ [Aktualisieren Sie die AWS IoT Richtlinie eines Kerngeräts](device-auth.md#update-core-device-iot-policy)

### Operation aws.greengrass\$1<operation> is not supported by Greengrass
<a name="ipc-operation-not-supported"></a>

Dieser Fehler tritt möglicherweise auf, wenn Sie einen [IPC-Vorgang (Interprocess Communication)](interprocess-communication.md) in einer benutzerdefinierten AWS Greengrass-Komponente verwenden und die erforderliche, bereitgestellte Komponente nicht auf dem Kerngerät installiert ist.

Um dieses Problem zu beheben, fügen Sie die erforderliche Komponente als [Abhängigkeit zu Ihrem Komponentenrezept](component-recipe-reference.md#recipe-reference-component-dependencies) hinzu, sodass die AWS IoT Greengrass Core-Software die erforderliche Komponente bei der Bereitstellung Ihrer Komponente installiert hat.
+ [Geheime Werte abrufen](ipc-secret-manager.md) — `aws.greengrass.SecretManager`
+ [Interagiere mit lokalen Schatten](ipc-local-shadows.md) — `aws.greengrass.ShadowManager`
+ [Lokale Bereitstellungen und Komponenten verwalten](ipc-local-deployments-components.md) — `aws.greengrass.Cli` v2.6.0 oder höher
+ [Authentifizieren und autorisieren Sie Client-Geräte](ipc-client-device-auth.md) — v2.2.0 oder höher `aws.greengrass.clientdevices.Auth`

### java.io.FileNotFoundException: <stream-manager-store-root-dir>/stream\$1manager\$1metadata\$1store (Permission denied)
<a name="stream-manager-store-root-folder-not-found"></a>

Dieser Fehler wird möglicherweise in der Stream Manager-Protokolldatei (`aws.greengrass.StreamManager.log`) angezeigt, wenn Sie den [Stream Manager](stream-manager-component.md) so konfigurieren, dass er einen Stammordner verwendet, der nicht existiert oder nicht über die richtigen Berechtigungen verfügt. Weitere Informationen zur Konfiguration dieses Ordners finden Sie unter [Stream Manager-Konfiguration](stream-manager-component.md#stream-manager-component-configuration).

### com.aws.greengrass.security.provider.pkcs11.PKCS11CryptoKeyService: Private key or certificate with label <label> does not exist
<a name="pkcs11-provider-error-private-key-or-certificate-does-not-exist"></a>

Dieser Fehler tritt auf, wenn die [PKCS \$111 -Anbieterkomponente](pkcs11-provider-component.md) den privaten Schlüssel oder das Zertifikat, das Sie bei der Konfiguration der AWS IoT Greengrass Core-Software für die Verwendung eines [Hardware-Sicherheitsmoduls (HSM](hardware-security.md)) angeben, nicht finden oder laden kann. Gehen Sie wie folgt vor:
+ Überprüfen Sie anhand des Steckplatzes, der Benutzer-PIN und der Objektbezeichnung, für die Sie die AWS IoT Greengrass Core-Software konfiguriert haben, ob der private Schlüssel und das Zertifikat im HSM gespeichert sind.
+ Stellen Sie sicher, dass der private Schlüssel und das Zertifikat dieselbe Objektbezeichnung im HSM verwenden.
+ Wenn Ihr HSM Objekte unterstützt IDs, überprüfen Sie, ob der private Schlüssel und das Zertifikat dieselbe Objekt-ID im HSM verwenden.

In der Dokumentation für Ihr HSM erfahren Sie, wie Sie Details zu den Sicherheitstoken im HSM abfragen können. Wenn Sie den Steckplatz, die Objektbezeichnung oder die Objekt-ID für ein Sicherheitstoken ändern müssen, lesen Sie in der Dokumentation zu Ihrem HSM nach, wie Sie das tun können.

### software.amazon.awssdk.services.secretsmanager.model.SecretsManagerException: User: <user> is not authorized to perform: secretsmanager:GetSecretValue on resource: <arn>
<a name="secret-manager-error-not-authorized-to-perform-get-secret-value"></a>

Dieser Fehler kann auftreten, wenn Sie die [Secret Manager-Komponente](secret-manager-component.md) verwenden, um ein AWS Secrets Manager Geheimnis bereitzustellen. Wenn die [Token-Exchange-IAM-Rolle](device-service-role.md) des Kerngeräts keine Erlaubnis zum Abrufen des Geheimnisses erteilt, schlägt die Bereitstellung fehl und die Greengrass-Protokolle enthalten diesen Fehler.

**Um ein Core-Gerät zum Herunterladen eines Secrets zu autorisieren**

1. Fügen Sie die `secretsmanager:GetSecretValue` Berechtigung zur Token-Austauschrolle des Kerngeräts hinzu. Das folgende Beispiel für eine Richtlinienanweisung erteilt die Erlaubnis, den Wert eines Geheimnisses abzurufen.

   ```
   {
       "Effect": "Allow",
       "Action": [
           "secretsmanager:GetSecretValue"
       ],
       "Resource": [
           "arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
       ]
   }
   ```

   Weitere Informationen finden Sie unter [Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS](device-service-role.md).

1. Wenden Sie die Bereitstellung erneut auf das Kerngerät an. Führen Sie eine der folgenden Aktionen aus:
   + Überarbeiten Sie die Bereitstellung ohne Änderungen. Das Kerngerät versucht erneut, den geheimen Schlüssel herunterzuladen, wenn es die überarbeitete Bereitstellung erhält. Weitere Informationen finden Sie unter [Bereitstellungen überarbeiten](revise-deployments.md).
   + Starten Sie die AWS IoT Greengrass Core-Software neu, um die Bereitstellung erneut zu versuchen. Weitere Informationen finden Sie unter [Führen Sie die AWS IoT Greengrass Core-Software aus](run-greengrass-core-v2.md).

   Die Bereitstellung ist erfolgreich, wenn Secret Manager das Secret erfolgreich herunterlädt.

### software.amazon.awssdk.services.secretsmanager.model.SecretsManagerException: Access to KMS is not allowed
<a name="secret-manager-error-no-kms-access"></a>

Dieser Fehler kann auftreten, wenn Sie die [Secret Manager-Komponente](secret-manager-component.md) verwenden, um ein AWS Secrets Manager Geheimnis bereitzustellen, das mit einem AWS Key Management Service Schlüssel verschlüsselt ist. Wenn die [Token-Exchange-IAM-Rolle](device-service-role.md) des Kerngeräts keine Erlaubnis zur Entschlüsselung des Geheimnisses erteilt, schlägt die Bereitstellung fehl und die Greengrass-Protokolle enthalten diesen Fehler.

Um das Problem zu beheben, fügen Sie die `kms:Decrypt` Berechtigung zur Token-Austauschrolle des Kerngeräts hinzu. Weitere Informationen finden Sie hier:
+ [Geheime Verschlüsselung und Entschlüsselung](https://docs.aws.amazon.com/secretsmanager/latest/userguide/security-encryption.html) im *AWS Secrets Manager Benutzerhandbuch*
+ [Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS](device-service-role.md)

### java.lang.NoClassDefFoundError: com/aws/greengrass/security/CryptoKeySpi
<a name="hardware-security-incompatible-nucleus-version"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn Sie versuchen, die AWS IoT Greengrass Core-Software mit [Hardwaresicherheit](hardware-security.md) zu installieren, und Sie eine frühere Greengrass Nucleus-Version verwenden, die die Hardware-Sicherheitsintegration nicht unterstützt. Um die Hardware-Sicherheitsintegration verwenden zu können, müssen Sie Greengrass Nucleus v2.5.3 oder höher verwenden.

### com.aws.greengrass.security.provider.pkcs11.PKCS11CryptoKeyService: CKR\$1OPERATION\$1NOT\$1INITIALIZED
<a name="ckr-operation-not-initialized"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn Sie die TPM2 Bibliothek verwenden, wenn Sie AWS IoT Greengrass Core als Systemdienst ausführen.

Dieser Fehler weist darauf hin, dass Sie eine Umgebungsvariable hinzufügen müssen, die den Speicherort des PKCS \$111 -Speichers in der AWS IoT Greengrass Core-Systemd-Dienstdatei angibt. 

Weitere Informationen finden Sie im Abschnitt „Anforderungen“ der [PKCS \$111 -Anbieter](pkcs11-provider-component.md) Komponentendokumentation.

### Greengrass core device stuck on nucleus v2.12.3
<a name="v2.12.3-revise-deployment"></a>

Wenn Ihr Greengrass Core-Gerät Ihre Bereitstellung von Nucleus Version 2.12.3 nicht überarbeitet, müssen Sie die `Greengrass.jar` Datei möglicherweise herunterladen und durch Greengrass Nucleus Version 2.12.2 ersetzen. Gehen Sie wie folgt vor:

1. Führen Sie auf Ihrem Greengrass Core-Gerät den folgenden Befehl aus, um die Greengrass Core-Software zu beenden.

------
#### [ Linux or Unix ]

   ```
   sudo systemctl stop greengrass
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   sc stop "greengrass"
   ```

------
#### [ PowerShell ]

   ```
   Stop-Service -Name "greengrass"
   ```

------

1. Laden Sie die AWS IoT Greengrass Software auf Ihrem Core-Gerät in eine Datei mit dem Namen herunter. `greengrass-2.12.2.zip`

------
#### [ Linux or Unix ]

   ```
   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-2.12.2.zip > greengrass-2.12.2.zip
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-2.12.2.zip > greengrass-2.12.2.zip
   ```

------
#### [ PowerShell ]

   ```
   iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-2.12.2.zip -OutFile greengrass-2.12.2.zip
   ```

------

1. Entpacken Sie die AWS IoT Greengrass Core-Software in einen Ordner auf Ihrem Gerät. *GreengrassInstaller*Ersetzen Sie es durch den Ordner, den Sie verwenden möchten.

------
#### [ Linux or Unix ]

   ```
   unzip greengrass-2.12.2.zip -d GreengrassInstaller && rm greengrass-2.12.2.zip
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   mkdir GreengrassInstaller && tar -xf greengrass-2.12.2.zip -C GreengrassInstaller && del greengrass-2.12.2.zip
   ```

------
#### [ PowerShell ]

   ```
   Expand-Archive -Path greengrass-2.12.2.zip -DestinationPath .\\GreengrassInstaller
   rm greengrass-2.12.2.zip
   ```

------

1. Führen Sie den folgenden Befehl aus, um die Nucleus Version 2.12.3 Greengrass JAR-Datei mit der Nucleus Version 2.12.2 Greengrass JAR-Datei zu überschreiben.

------
#### [ Linux or Unix ]

   ```
   sudo cp ./GreengrassInstaller/lib/Greengrass.jar /greengrass/v2/packages/artifacts-unarchived/aws.greengrass.Nucleus/2.12.3/aws.greengrass.nucleus/lib
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   robocopy ./GreengrassInstaller/lib/Greengrass.jar /greengrass/v2/packages/artifacts-unarchived/aws.greengrass.Nucleus/2.12.3/aws.greengrass.nucleus/lib /E
   ```

------
#### [ PowerShell ]

   ```
   cp -Path ./GreengrassInstaller/lib/Greengrass.jar -Destination /greengrass/v2/packages/artifacts-unarchived/aws.greengrass.Nucleus/2.12.3/aws.greengrass.nucleus/lib
   ```

------

1. Führen Sie den folgenden Befehl aus, um die Greengrass Core-Software zu starten.

------
#### [ Linux or Unix ]

   ```
   sudo systemctl start greengrass
   ```

------
#### [ Windows Command Prompt (CMD) ]

   ```
   sc start "greengrass"
   ```

------
#### [ PowerShell ]

   ```
   Start-Service -Name "greengrass"
   ```

------

### Greengrass nucleus v2.14.0 systemd template issue
<a name="v2.14.0-systemd-template"></a>

Dieses Problem kann auftreten, wenn Sie Greengrass Nucleus v2.14.0 auf einem Linux-Gerät mit der standardmäßigen Systemd-Dienstvorlage installiert haben. Gehen Sie wie folgt vor:

1. Führen Sie auf Ihrem Greengrass-Core-Gerät den folgenden Befehl aus, um die Systemd-Dienstdatei auf den Stand von Nucleus v2.13.0 und früheren Versionen zurückzusetzen.

------
#### [ Linux or Unix ]

   ```
   sudo sed -i 's|ExecStart=/bin/sh -c "\(.*\) >> .*/logs/loader.log 2>&1"|ExecStart=/bin/sh \1|' /etc/systemd/system/greengrass.service
   ```

------

1. Wenden Sie die Änderungen an.

------
#### [ Linux or Unix ]

   ```
   sudo systemctl daemon-reload
   sudo systemctl restart greengrass
   ```

------

## AWS IoT Greengrass Cloud-Probleme
<a name="greengrass-cloud-issues"></a>

Verwenden Sie die folgenden Informationen, um Probleme mit der AWS IoT Greengrass Konsole und der API zu beheben. Jeder Eintrag entspricht einer Fehlermeldung, die möglicherweise angezeigt wird, wenn Sie eine Aktion ausführen.

### An error occurred (AccessDeniedException) when calling the CreateComponentVersion operation: User: arn:aws:iam::123456789012:user/<username> is not authorized to perform: null
<a name="cloud-error-create-component-version-not-authorized-to-perform-null"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn Sie eine Komponentenversion über die AWS IoT Greengrass Konsole oder während des [CreateComponentVersion](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateComponentVersion.html)Vorgangs erstellen.

Dieser Fehler weist darauf hin, dass Ihr Rezept kein gültiges JSON- oder YAML-Format ist. Überprüfen Sie die Syntax Ihres Rezepts, beheben Sie alle Syntaxprobleme und versuchen Sie es erneut. Sie können einen Online-JSON- oder YAML-Syntaxprüfer verwenden, um Syntaxprobleme in Ihrem Rezept zu identifizieren.

### Invalid Input: Encountered following errors in Artifacts: \$1<s3ArtifactUri> = Specified artifact resource cannot be accessed\$1
<a name="cloud-error-specified-artifact-resource-cannot-be-accessed"></a>

Dieser Fehler tritt möglicherweise auf, wenn Sie eine Komponentenversion über die AWS IoT Greengrass Konsole oder während des Vorgangs erstellen. [CreateComponentVersion](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateComponentVersion.html) Dieser Fehler weist darauf hin, dass ein S3-Artefakt im Komponentenrezept nicht gültig ist.

Gehen Sie wie folgt vor:
+ Vergewissern Sie sich, dass sich der S3-Bucket an derselben AWS-Region Stelle befindet, an der Sie die Komponente erstellt haben. AWS IoT Greengrass unterstützt keine regionsübergreifenden Anfragen nach Komponentenartefakten.
+ Überprüfen Sie, ob es sich bei der Artefakt-URI um eine gültige S3-Objekt-URL handelt, und überprüfen Sie, ob das Artefakt unter dieser S3-Objekt-URL vorhanden ist.
+ Vergewissern Sie sich, dass Sie AWS-Konto über die entsprechende S3-Objekt-URL auf das Artefakt zugreifen dürfen.

### INACTIVE deployment status
<a name="cloud-error-inactive-deployment"></a>

Möglicherweise erhalten Sie einen `INACTIVE` Bereitstellungsstatus, wenn Sie die [ListDeployments](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_ListDeployments.html)API ohne die erforderlichen abhängigen AWS IoT Richtlinien aufrufen. Sie müssen über die erforderlichen Berechtigungen verfügen, um einen genauen Bereitstellungsstatus zu erhalten. Sie können die abhängigen Aktionen finden, indem Sie in den [Aktionen suchen, die von definiert](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotgreengrassv2.html#awsiotgreengrassv2-actions-as-permissions) sind, AWS IoT Greengrass V2 und den erforderlichen Berechtigungen folgen`ListDeployments`. Ohne die erforderlichen abhängigen AWS IoT Berechtigungen wird Ihnen weiterhin der Bereitstellungsstatus angezeigt, möglicherweise wird jedoch ein falscher Bereitstellungsstatus von `INACTIVE` angezeigt.

## Hauptprobleme bei der Gerätebereitstellung
<a name="greengrass-core-deployment-issues"></a>

Beheben Sie Bereitstellungsprobleme auf Greengrass-Core-Geräten. Jeder Eintrag entspricht einer Protokollnachricht, die Sie möglicherweise auf Ihrem Kerngerät sehen.

**Topics**
+ [Error: com.aws.greengrass.componentmanager.exceptions.PackageDownloadException: Failed to download artifact](#core-error-failed-to-download-artifact-package-download-exception)
+ [Error: com.aws.greengrass.componentmanager.exceptions.ArtifactChecksumMismatchException: Integrity check for downloaded artifact failed. Probably due to file corruption.](#core-error-failed-to-download-artifact-checksum-mismatch-exception)
+ [Error: com.aws.greengrass.componentmanager.exceptions.NoAvailableComponentVersionException: Failed to negotiate component <name> version with cloud and no local applicable version satisfying requirement <requirements>](#core-error-no-available-component-version)
+ [software.amazon.awssdk.services.greengrassv2data.model.ResourceNotFoundException: The latest version of Component <componentName> doesn't claim platform <coreDevicePlatform> compatibility](#deployment-error-no-platform-compatibility)
+ [com.aws.greengrass.componentmanager.exceptions.PackagingException: The deployment attempts to update the nucleus from aws.greengrass.Nucleus-<version> to aws.greengrass.Nucleus-<version> but no component of type nucleus was included as target component](#deployment-error-nucleus-minor-version-update)
+ [Error: com.aws.greengrass.deployment.exceptions.DeploymentException: Unable to process deployment. Greengrass launch directory is not set up or Greengrass is not set up as a system service](#deployment-error-unable-to-process-deployment)
+ [Info: com.aws.greengrass.deployment.exceptions.RetryableDeploymentDocumentDownloadException: Greengrass Cloud Service returned an error when getting full deployment configuration](#core-error-getting-full-deployment-configuration)
+ [Warn: com.aws.greengrass.deployment.DeploymentService: Failed to get thing group hierarchy](#core-warning-failed-to-get-thing-group-hierarchy)
+ [Info: com.aws.greengrass.deployment.DeploymentDocumentDownloader: Calling Greengrass cloud to get full deployment configuration](#core-info-repetitive-get-full-deployment-configuration)
+ [Caused by: software.amazon.awssdk.services.greengrassv2data.model.GreengrassV2DataException: null (Service: GreengrassV2Data, Status Code: 403, Request ID: <some\$1request\$1id>, Extended Request ID: null)](#greengrassv2dataexception)

### Error: com.aws.greengrass.componentmanager.exceptions.PackageDownloadException: Failed to download artifact
<a name="core-error-failed-to-download-artifact-package-download-exception"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn die AWS IoT Greengrass Core-Software ein Komponentenartefakt nicht herunterlädt, wenn das Kerngerät eine Bereitstellung anwendet. Die Bereitstellung schlägt aufgrund dieses Fehlers fehl.

Wenn Sie diesen Fehler erhalten, enthält das Protokoll auch einen Stack-Trace, anhand dessen Sie das spezifische Problem identifizieren können. Jeder der folgenden Einträge entspricht einer Meldung, die Sie möglicherweise im Stack-Trace der `Failed to download artifact` Fehlermeldung sehen.

**Topics**
+ [software.amazon.awssdk.services.s3.model.S3Exception: null (Service: S3, Status Code: 403, Request ID: null, ...)](#core-error-failed-to-download-artifact-s3-permissions)
+ [software.amazon.awssdk.services.s3.model.S3Exception: Access Denied (Service: S3, Status Code: 403, Request ID: <requestID>](#core-error-failed-to-download-artifact-get-bucket-location-403)

#### software.amazon.awssdk.services.s3.model.S3Exception: null (Service: S3, Status Code: 403, Request ID: null, ...)
<a name="core-error-failed-to-download-artifact-s3-permissions"></a>

Der [PackageDownloadException Fehler](#core-error-failed-to-download-artifact-package-download-exception) kann diesen Stack-Trace in den folgenden Fällen beinhalten:
+ Das Komponentenartefakt ist nicht unter der S3-Objekt-URL verfügbar, die Sie im Rezept der Komponente angeben. Überprüfen Sie, ob Sie das Artefakt in den S3-Bucket hochgeladen haben und ob der Artefakt-URI mit der S3-Objekt-URL des Artefakts im Bucket übereinstimmt.
+ Die [Token-Austauschrolle](device-service-role.md) des Kerngeräts erlaubt es der AWS IoT Greengrass Core-Software nicht, das Komponentenartefakt von der S3-Objekt-URL herunterzuladen, die Sie im Rezept der Komponente angeben. Stellen Sie sicher, dass die Token-Austauschrolle die URL des S3-Objekts zulässt`s3:GetObject`, unter der das Artefakt verfügbar ist.

#### software.amazon.awssdk.services.s3.model.S3Exception: Access Denied (Service: S3, Status Code: 403, Request ID: <requestID>
<a name="core-error-failed-to-download-artifact-get-bucket-location-403"></a>

Der [PackageDownloadException Fehler](#core-error-failed-to-download-artifact-package-download-exception) kann diesen Stack-Trace beinhalten, wenn das Kerngerät keine `s3:GetBucketLocation` Anrufberechtigung hat. Die Fehlermeldung enthält auch die folgende Meldung.

```
reason: Failed to determine S3 bucket location
```

Vergewissern Sie sich, dass die [Token-Austauschrolle](device-service-role.md) des Kerngeräts den S3-Bucket zulässt`s3:GetBucketLocation`, in dem das Artefakt verfügbar ist.

### Error: com.aws.greengrass.componentmanager.exceptions.ArtifactChecksumMismatchException: Integrity check for downloaded artifact failed. Probably due to file corruption.
<a name="core-error-failed-to-download-artifact-checksum-mismatch-exception"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn die AWS IoT Greengrass Core-Software ein Komponentenartefakt nicht herunterladen kann, wenn das Kerngerät eine Bereitstellung anwendet. Die Bereitstellung schlägt fehl, weil die Prüfsumme der heruntergeladenen Artefaktdatei nicht mit der Prüfsumme übereinstimmt, die bei der Erstellung der AWS IoT Greengrass Komponente berechnet wurde.

Gehen Sie wie folgt vor:
+ Prüfen Sie, ob sich die Artefaktdatei in dem S3-Bucket, in dem Sie sie hosten, geändert hat. Wenn sich die Datei seit der Erstellung der Komponente geändert hat, stellen Sie die vorherige Version wieder her, die das Kerngerät erwartet. Wenn Sie die Datei nicht auf ihre vorherige Version zurücksetzen können oder wenn Sie die neue Version der Datei verwenden möchten, erstellen Sie eine neue Version der Komponente mit der Artefaktdatei.
+ Überprüfen Sie die Internetverbindung Ihres Core-Geräts. Dieser Fehler kann auftreten, wenn die Artefaktdatei beim Herunterladen beschädigt wird. Erstellen Sie eine neue Bereitstellung und versuchen Sie es erneut.

### Error: com.aws.greengrass.componentmanager.exceptions.NoAvailableComponentVersionException: Failed to negotiate component <name> version with cloud and no local applicable version satisfying requirement <requirements>
<a name="core-error-no-available-component-version"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn ein Kerngerät keine Komponentenversion finden kann, die den Anforderungen der Bereitstellungen für dieses Kerngerät entspricht. Das Kerngerät sucht im AWS IoT Greengrass Dienst und auf dem lokalen Gerät nach der Komponente. Die Fehlermeldung enthält das Ziel jeder Bereitstellung und die Versionsanforderungen dieser Bereitstellung für die Komponente. Das Bereitstellungsziel kann ein Ding, eine Dinggruppe oder sein`LOCAL_DEPLOYMENT`, was die lokale Bereitstellung auf dem Kerngerät darstellt.

Dieses Problem kann in den folgenden Fällen auftreten:
+ Das Kerngerät ist das Ziel mehrerer Bereitstellungen mit widersprüchlichen Anforderungen an die Komponentenversion. Beispielsweise kann das Kerngerät das Ziel mehrerer Bereitstellungen sein, die eine `com.example.HelloWorld` Komponente enthalten, wobei für eine Bereitstellung Version 1.0.0 und für die andere Version 1.0.1 erforderlich ist. Es ist unmöglich, eine Komponente zu haben, die beide Anforderungen erfüllt, sodass die Bereitstellung fehlschlägt.
+ Die Komponentenversion ist weder im AWS IoT Greengrass Dienst noch auf dem lokalen Gerät vorhanden. Die Komponente könnte beispielsweise gelöscht worden sein.
+ Es gibt Komponentenversionen, die die Versionsanforderungen erfüllen, aber keine ist mit der Plattform des Kerngeräts kompatibel.
+ Die AWS IoT Richtlinie des Kerngeräts gewährt die `greengrass:ResolveComponentCandidates` Genehmigung nicht. Suchen Sie `Status Code: 403` im Fehlerprotokoll nach, um dieses Problem zu identifizieren. Um dieses Problem zu beheben, fügen Sie die `greengrass:ResolveComponentCandidates` Berechtigung zur AWS IoT Richtlinie des Kerngeräts hinzu. Weitere Informationen finden Sie unter [Minimale AWS IoT Richtlinie für AWS IoT Greengrass V2 Kerngeräte](device-auth.md#greengrass-core-minimal-iot-policy).

Um dieses Problem zu beheben, überarbeiten Sie die Bereitstellungen, sodass sie kompatible Komponentenversionen enthalten oder inkompatible Versionen entfernen. Weitere Informationen zur Überarbeitung von Cloud-Bereitstellungen finden Sie unter. [Bereitstellungen überarbeiten](revise-deployments.md) Weitere Informationen zum Überarbeiten lokaler Bereitstellungen finden Sie im Befehl [AWS IoT Greengrass CLI deployment create](gg-cli-deployment.md#deployment-create).

### software.amazon.awssdk.services.greengrassv2data.model.ResourceNotFoundException: The latest version of Component <componentName> doesn't claim platform <coreDevicePlatform> compatibility
<a name="deployment-error-no-platform-compatibility"></a>

Dieser Fehler tritt möglicherweise auf, wenn Sie eine Komponente auf einem Kerngerät bereitstellen und die Komponente keine Plattform auflistet, die mit der Plattform des Kerngeräts kompatibel ist. Führen Sie eine der folgenden Aktionen aus:
+ Wenn es sich bei der Komponente um eine benutzerdefinierte Greengrass-Komponente handelt, können Sie die Komponente so aktualisieren, dass sie mit dem Kerngerät kompatibel ist. Fügen Sie ein neues Manifest hinzu, das der Plattform des Kerngeräts entspricht, oder aktualisieren Sie ein vorhandenes Manifest, sodass es mit der Plattform des Kerngeräts übereinstimmt. Weitere Informationen finden Sie unter [AWS IoT Greengrass Referenz zum Komponenten-Rezept](component-recipe-reference.md).
+ Wenn die Komponente von bereitgestellt wird AWS, überprüfen Sie, ob eine andere Version der Komponente mit dem Kerngerät kompatibel ist. Wenn keine Version kompatibel ist, kontaktieren Sie uns unter [AWS re:Post](https://repost.aws/)Verwendung des [AWS IoT Greengrass Tags](https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass) oder kontaktieren Sie uns [Support](https://aws.amazon.com/contact-us/).

### com.aws.greengrass.componentmanager.exceptions.PackagingException: The deployment attempts to update the nucleus from aws.greengrass.Nucleus-<version> to aws.greengrass.Nucleus-<version> but no component of type nucleus was included as target component
<a name="deployment-error-nucleus-minor-version-update"></a>

Dieser Fehler tritt möglicherweise auf, wenn Sie eine Komponente bereitstellen, die vom [Greengrass Nucleus](greengrass-nucleus-component.md) abhängt und auf dem Kerngerät eine frühere Greengrass Nucleus-Version als die neueste verfügbare Nebenversion ausgeführt wird. Dieser Fehler tritt auf, weil die AWS IoT Greengrass Core-Software versucht, Komponenten automatisch auf die neueste kompatible Version zu aktualisieren. Die AWS IoT Greengrass Core-Software verhindert jedoch, dass der Greengrass-Kern auf eine neue Nebenversion aktualisiert wird, da mehrere AWS bereitgestellte Komponenten von bestimmten Nebenversionen des Greengrass-Nukleus abhängen. Weitere Informationen finden Sie unter [Aktualisierungsverhalten von Greengrass Nucleus](update-greengrass-core-v2.md#ota-update-behavior-nucleus).

Sie müssen [die Bereitstellung überarbeiten, um die](revise-deployments.md) Greengrass Nucleus-Version anzugeben, die Sie verwenden möchten. Führen Sie eine der folgenden Aktionen aus:
+ Überarbeiten Sie die Bereitstellung, um die Greengrass Nucleus-Version anzugeben, die derzeit auf dem Kerngerät ausgeführt wird.
+ Überarbeiten Sie die Bereitstellung, um eine spätere Nebenversion des Greengrass-Nukleus zu spezifizieren. Wenn Sie diese Option wählen, müssen Sie auch die Versionen aller AWS bereitgestellten Komponenten aktualisieren, die von bestimmten Nebenversionen von Greengrass Nucleus abhängen. Weitere Informationen finden Sie unter [AWS-mitgelieferte Komponenten](public-components.md).

### Error: com.aws.greengrass.deployment.exceptions.DeploymentException: Unable to process deployment. Greengrass launch directory is not set up or Greengrass is not set up as a system service
<a name="deployment-error-unable-to-process-deployment"></a>

Dieser Fehler tritt möglicherweise auf, wenn Sie ein Greengrass-Gerät von einer Dinggruppe in eine andere verschieben und dann zurück zur ursprünglichen Gruppe mit Bereitstellungen, für die Greengrass neu gestartet werden muss. 

Um dieses Problem zu beheben, erstellen Sie das Startverzeichnis für das Gerät neu. Wir empfehlen außerdem dringend, auf Version 2.9.6 oder höher von Greengrass Nucleus zu aktualisieren.

Im Folgenden finden Sie ein Linux-Skript zum Neuerstellen des Startverzeichnisses. Speichern Sie das Skript in einer Datei namens`fix_directory.sh`.

```
#!/bin/bash

set -e

GG_ROOT=$1
GG_VERSION=$2

CURRENT="$GG_ROOT/alts/current"

if [ ! -L "$CURRENT" ]; then
  mkdir -p $GG_ROOT/alts/directory_fix
  echo "Relinking $GG_ROOT/alts/directory_fix to $CURRENT"
  ln -sf $GG_ROOT/alts/directory_fix $CURRENT
fi

TARGET=$(readlink $CURRENT)

if [[ ! -d "$TARGET" ]]; then
  echo "Creating directory: $TARGET"
  mkdir -p "$TARGET"
fi

DISTRO_LINK="$TARGET/distro"
DISTRO="$GG_ROOT/packages/artifacts-unarchived/aws.greengrass.Nucleus/$GG_VERSION/aws.greengrass.nucleus/"
echo "Relinking Nucleus artifacts to $DISTRO_LINK"
ln -sf $DISTRO $DISTRO_LINK
```

Um das Skript auszuführen, führen Sie den folgenden Befehl aus:

```
[root@ip-172-31-27-165 ~]# ./fix_directory.sh /greengrass/v2 2.9.5
Relinking /greengrass/v2/alts/directory_fix to /greengrass/v2/alts/current
Relinking Nucleus artifacts to /greengrass/v2/alts/directory_fix/distro
```

### Info: com.aws.greengrass.deployment.exceptions.RetryableDeploymentDocumentDownloadException: Greengrass Cloud Service returned an error when getting full deployment configuration
<a name="core-error-getting-full-deployment-configuration"></a>

Dieser Fehler tritt möglicherweise auf, wenn das Core-Gerät ein umfangreiches Bereitstellungsdokument erhält, bei dem es sich um ein Bereitstellungsdokument mit mehr als 7 KB (für Bereitstellungen, die auf Dinge abzielen) oder 31 KB (für Bereitstellungen, die auf Dinggruppen abzielen) handelt. Um ein umfangreiches Bereitstellungsdokument abzurufen, muss die AWS IoT Richtlinie eines Kerngeräts die `greengrass:GetDeploymentConfiguration` Genehmigung zulassen. Dieser Fehler kann auftreten, wenn das Kerngerät nicht über diese Berechtigung verfügt. Wenn dieser Fehler auftritt, wird die Bereitstellung auf unbestimmte Zeit wiederholt und ihr Status lautet **In Bearbeitung** ()`IN_PROGRESS`.

Um dieses Problem zu beheben, fügen Sie die `greengrass:GetDeploymentConfiguration` Berechtigung zur Richtlinie des Kerngeräts hinzu. AWS IoT Weitere Informationen finden Sie unter [Aktualisieren Sie die AWS IoT Richtlinie eines Kerngeräts](device-auth.md#update-core-device-iot-policy).

### Warn: com.aws.greengrass.deployment.DeploymentService: Failed to get thing group hierarchy
<a name="core-warning-failed-to-get-thing-group-hierarchy"></a>

Diese Warnung wird möglicherweise angezeigt, wenn das Kerngerät eine Bereitstellung erhält und die AWS IoT Richtlinie des Kerngeräts die `greengrass:ListThingGroupsForCoreDevice` Genehmigung nicht zulässt. Wenn Sie eine Bereitstellung erstellen, verwendet das Kerngerät diese Berechtigung, um seine Dinggruppen zu identifizieren und Komponenten für alle Dinggruppen zu entfernen, aus denen Sie das Kerngerät entfernt haben. Wenn auf dem Kerngerät [Greengrass Nucleus](greengrass-nucleus-component.md) v2.5.0 ausgeführt wird, schlägt die Bereitstellung fehl. Wenn auf dem Kerngerät Greengrass Nucleus v2.5.1 oder höher ausgeführt wird, wird die Bereitstellung fortgesetzt, ohne dass Komponenten entfernt werden. Weitere Informationen zum Verhalten beim Entfernen von Dinggruppen finden Sie unter. [AWS IoT Greengrass Komponenten auf Geräten bereitstellen](manage-deployments.md)

Um das Verhalten des Kerngeräts zu aktualisieren und Komponenten für Dinggruppen zu entfernen, aus denen Sie das Kerngerät entfernen, fügen Sie die `greengrass:ListThingGroupsForCoreDevice` entsprechende Berechtigung zur AWS IoT Richtlinie des Kerngeräts hinzu. Weitere Informationen finden Sie unter [Aktualisieren Sie die AWS IoT Richtlinie eines Kerngeräts](device-auth.md#update-core-device-iot-policy).

### Info: com.aws.greengrass.deployment.DeploymentDocumentDownloader: Calling Greengrass cloud to get full deployment configuration
<a name="core-info-repetitive-get-full-deployment-configuration"></a>

Diese Informationsmeldung wird möglicherweise mehrmals ohne Fehler gedruckt, da das Kerngerät den Fehler auf Protokollebene `DEBUG` protokolliert. Dieses Problem kann auftreten, wenn das Kerngerät ein umfangreiches Bereitstellungsdokument erhält. Wenn dieses Problem auftritt, wird die Bereitstellung auf unbestimmte Zeit wiederholt und ihr Status lautet **In Bearbeitung** ()`IN_PROGRESS`. Weitere Informationen zur Behebung dieses Problems finden Sie in diesem Eintrag [zur Problembehandlung](#core-error-getting-full-deployment-configuration).

### Caused by: software.amazon.awssdk.services.greengrassv2data.model.GreengrassV2DataException: null (Service: GreengrassV2Data, Status Code: 403, Request ID: <some\$1request\$1id>, Extended Request ID: null)
<a name="greengrassv2dataexception"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn eine Datenebenen-API nicht über `iot:Connect` die entsprechenden Berechtigungen verfügt. Wenn Sie nicht über die richtige Richtlinie verfügen, erhalten Sie eine. `GreengrassV2DataException: 403` Folgen Sie diesen Anweisungen, um eine Berechtigungsrichtlinie zu erstellen:[Erstellen Sie eine AWS IoT Richtlinie](fleet-provisioning-setup.md#create-iot-policy).

## Probleme mit den wichtigsten Gerätekomponenten
<a name="greengrass-core-component-issues"></a>

Beheben Sie Probleme mit Greengrass-Komponenten auf Kerngeräten.

**Topics**
+ [Warn: '<command>' is not recognized as an internal or external command](#component-warn-command-not-recognized)
+ [Python-Skript protokolliert keine Nachrichten](#python-component-no-log-output)
+ [Die Komponentenkonfiguration wird nicht aktualisiert, wenn die Standardkonfiguration geändert wird](#update-component-configuration-to-default-configuration)
+ [awsiot.greengrasscoreipc.model.UnauthorizedError](#ipc-unauthorized-error)
+ [com.aws.greengrass.authorization.exceptions.AuthorizationException: Duplicate policy ID "<id>" for principal "<componentList>"](#ipc-duplicate-authorization-policy-ids)
+ [com.aws.greengrass.tes.CredentialRequestHandler: Error in retrieving AwsCredentials from TES (HTTP 400)](#token-exchange-service-credentials-http-400)
+ [com.aws.greengrass.tes.CredentialRequestHandler: Error in retrieving AwsCredentials from TES (HTTP 403)](#token-exchange-service-credentials-http-403)
+ [com.aws.greengrass.tes.CredentialsProviderError: Could not load credentials from any providers](#token-exchange-service-credentials-provider-error)
+ [Received error when attempting to retrieve ECS metadata: Could not connect to the endpoint URL: "<tokenExchangeServiceEndpoint>"](#token-exchange-service-not-running)
+ [copyFrom: <configurationPath> is already a container, not a leaf](#configuration-key-is-container-cannot-become-leaf)
+ [com.aws.greengrass.componentmanager.plugins.docker.exceptions.DockerLoginException: Error logging into the registry using credentials - 'The stub received bad data.'](#docker-login-stub-received-bad-data)
+ [java.io.IOException: Cannot run program "cmd" ...: [LogonUser] The password for this account has expired.](#windows-account-password-expired)
+ [aws.greengrass.StreamManager: Instant exceeds minimum or maximum instant](#stream-manager-instant-exceeds-maximun-minimum)

### Warn: '<command>' is not recognized as an internal or external command
<a name="component-warn-command-not-recognized"></a>

Möglicherweise wird dieser Fehler in den Protokollen einer Greengrass-Komponente angezeigt, wenn die AWS IoT Greengrass Core-Software einen Befehl im Lifecycle-Skript der Komponente nicht ausführen kann. Der Status der Komponente ergibt `BROKEN` sich aus diesem Fehler. Dieser Fehler kann auftreten, wenn der Systembenutzer, der die Komponente ausführt, z. B. `ggc_user` die ausführbare Datei des Befehls in den Ordnern im [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) nicht finden kann.

Überprüfen Sie auf Windows-Geräten, ob sich der Ordner, der die ausführbare Datei enthält, im Ordner `PATH` für den Systembenutzer befindet, der die Komponente ausführt. Wenn es in der fehlt`PATH`, führen Sie einen der folgenden Schritte aus:
+ Fügen Sie den Ordner der ausführbaren Datei zur `PATH` Systemvariablen hinzu, die für alle Benutzer verfügbar ist. Starten Sie dann die Komponente neu.

  Wenn Sie Greengrass Nucleus 2.5.0 ausführen, müssen Sie nach dem Update der `PATH` Systemvariablen die AWS IoT Greengrass Core-Software neu starten, um Komponenten mit der aktualisierten Version auszuführen. `PATH` Wenn die AWS IoT Greengrass Core-Software das Update `PATH` nach dem Neustart der Software nicht verwendet, starten Sie das Gerät neu und versuchen Sie es erneut. Weitere Informationen finden Sie unter [Führen Sie die AWS IoT Greengrass Core-Software aus](run-greengrass-core-v2.md).
+ Fügen Sie den Ordner der ausführbaren Datei zur `PATH` Benutzervariablen für den Systembenutzer hinzu, der die Komponente ausführt.

### Python-Skript protokolliert keine Nachrichten
<a name="python-component-no-log-output"></a>

Greengrass-Core-Geräte sammeln Protokolle, anhand derer Sie Probleme mit Komponenten identifizieren können. Wenn Ihre Python-Skripte `stdout` und `stderr` -Meldungen nicht in Ihren Komponentenprotokollen erscheinen, müssen Sie möglicherweise den Puffer leeren oder die Pufferung für diese Standardausgabestreams in Python deaktivieren. Führen Sie eine der folgenden Aktionen aus:
+ Führen Sie Python mit dem Argument [-u](https://docs.python.org/3/using/cmdline.html#cmdoption-u) aus, um die Pufferung auf `stdout` und zu deaktivieren. `stderr`

------
#### [ Linux or Unix ]

  ```
  python3 -u hello_world.py
  ```

------
#### [ Windows ]

  ```
  py -3 -u hello_world.py
  ```

------
+ Verwenden Sie [Setenv](component-recipe-reference.md#lifecycle-setenv-definition) im Rezept Ihrer Komponente, um die Umgebungsvariable [PYTHONUNBUFFERED](https://docs.python.org/3/using/cmdline.html#envvar-PYTHONUNBUFFERED) auf eine nicht leere Zeichenfolge zu setzen. Diese Umgebungsvariable deaktiviert die Pufferung bei und. `stdout` `stderr`
+ Leert den Puffer für die `stdout` OR-Streams. `stderr` Führen Sie eine der folgenden Aktionen aus:
  + Leert eine Nachricht beim Drucken.

    ```
    import sys
    
    print('Hello, error!', file=sys.stderr, flush=True)
    ```
  + Löscht eine Nachricht nach dem Drucken. Sie können mehrere Nachrichten senden, bevor Sie den Stream leeren.

    ```
    import sys
    
    print('Hello, error!', file=sys.stderr)
    sys.stderr.flush()
    ```

Weitere Hinweise dazu, wie Sie überprüfen können, ob Ihr Python-Skript Logmeldungen ausgibt, finden Sie unter[AWS IoT Greengrass Protokolle überwachen](monitor-logs.md).

### Die Komponentenkonfiguration wird nicht aktualisiert, wenn die Standardkonfiguration geändert wird
<a name="update-component-configuration-to-default-configuration"></a>

Wenn Sie die `DefaultConfiguration` Rezeptur einer Komponente ändern, ersetzt die neue Standardkonfiguration während einer Bereitstellung nicht die bestehende Konfiguration der Komponente. Um die neue Standardkonfiguration anzuwenden, müssen Sie die Konfiguration der Komponente auf die Standardeinstellungen zurücksetzen. Wenn Sie die Komponente bereitstellen, geben Sie eine einzelne leere Zeichenfolge als [Reset-Update](update-component-configurations.md#reset-configuration-update) an.

------
#### [ Console ]

**Pfade zurücksetzen**  

```
[""]
```

------
#### [ AWS CLI ]

Mit dem folgenden Befehl wird eine Bereitstellung auf einem Core-Gerät erstellt.

```
aws greengrassv2 create-deployment --cli-input-json file://reset-configuration-deployment.json
```

Die `reset-configuration-deployment.json` Datei enthält das folgende JSON-Dokument.

```
{
  "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
  "deploymentName": "Deployment for MyGreengrassCore",
  "components": {
    "com.example.HelloWorld": {
      "componentVersion": "1.0.0",
      "configurationUpdate": {,
        "reset": [""]
      }
    }
  }
}
```

------
#### [ Greengrass CLI ]

Der folgende [Greengrass-CLI-Befehl](greengrass-cli-component.md) erstellt eine lokale Bereitstellung auf einem Core-Gerät.

```
sudo greengrass-cli deployment create \
  --recipeDir recipes \
  --artifactDir artifacts \
  --merge "com.example.HelloWorld=1.0.0" \
  --update-config reset-configuration-deployment.json
```

Die `reset-configuration-deployment.json` Datei enthält das folgende JSON-Dokument.

```
{
  "com.example.HelloWorld": {
    "RESET": [""]
  }
}
```

------

### awsiot.greengrasscoreipc.model.UnauthorizedError
<a name="ipc-unauthorized-error"></a>

Möglicherweise wird dieser Fehler in den Protokollen einer Greengrass-Komponente angezeigt, wenn die Komponente nicht berechtigt ist, einen IPC-Vorgang für eine Ressource auszuführen. Um einer Komponente die Berechtigung zum Aufrufen einer IPC-Operation zu erteilen, definieren Sie in der Konfiguration der Komponente eine IPC-Autorisierungsrichtlinie. Weitere Informationen finden Sie unter [Autorisieren Sie Komponenten zur Ausführung von IPC-Vorgängen](interprocess-communication.md#ipc-authorization-policies).

**Tipp**  <a name="tip-reset-configuration-to-apply-new-default-configuration"></a>
Wenn Sie die Rezeptur `DefaultConfiguration` einer Komponente ändern, müssen Sie die Konfiguration der Komponente auf die neue Standardkonfiguration zurücksetzen. Wenn Sie die Komponente bereitstellen, geben Sie eine einzelne leere Zeichenfolge als [Reset-Update](update-component-configurations.md#reset-configuration-update) an. Weitere Informationen finden Sie unter [Die Komponentenkonfiguration wird nicht aktualisiert, wenn die Standardkonfiguration geändert wird](#update-component-configuration-to-default-configuration).

### com.aws.greengrass.authorization.exceptions.AuthorizationException: Duplicate policy ID "<id>" for principal "<componentList>"
<a name="ipc-duplicate-authorization-policy-ids"></a>

Dieser Fehler tritt möglicherweise auf, wenn mehrere IPC-Autorisierungsrichtlinien, auch für alle Komponenten auf dem Kerngerät, dieselbe Richtlinien-ID verwenden.

Überprüfen Sie die IPC-Autorisierungsrichtlinien Ihrer Komponenten, korrigieren Sie alle Duplikate und versuchen Sie es erneut. Um eine eindeutige Richtlinie zu erstellen IDs, empfehlen wir, den Komponentennamen, den IPC-Dienstnamen und einen Zähler zu kombinieren. Weitere Informationen finden Sie unter [Autorisieren Sie Komponenten zur Ausführung von IPC-Vorgängen](interprocess-communication.md#ipc-authorization-policies).

**Tipp**  <a name="tip-reset-configuration-to-apply-new-default-configuration"></a>
Wenn Sie das `DefaultConfiguration` in der Rezeptur einer Komponente ändern, müssen Sie die Konfiguration der Komponente auf die neue Standardkonfiguration zurücksetzen. Wenn Sie die Komponente bereitstellen, geben Sie eine einzelne leere Zeichenfolge als [Reset-Update](update-component-configurations.md#reset-configuration-update) an. Weitere Informationen finden Sie unter [Die Komponentenkonfiguration wird nicht aktualisiert, wenn die Standardkonfiguration geändert wird](#update-component-configuration-to-default-configuration).

### com.aws.greengrass.tes.CredentialRequestHandler: Error in retrieving AwsCredentials from TES (HTTP 400)
<a name="token-exchange-service-credentials-http-400"></a>

Dieser Fehler tritt möglicherweise auf, wenn ein Core-Gerät keine AWS Anmeldeinformationen vom [Token-Austauschdienst](interact-with-aws-services.md) abrufen kann. Der HTTP 400-Statuscode gibt an, dass dieser Fehler aufgetreten ist, weil die [Token-Exchange-IAM-Rolle](device-service-role.md) des Kerngeräts nicht existiert oder keine Vertrauensbeziehung besteht, die es dem Anbieter der AWS IoT Anmeldeinformationen ermöglicht, sie anzunehmen.

Gehen Sie wie folgt vor:

1. Identifizieren Sie die Token-Austauschrolle, die das Kerngerät verwendet. Die Fehlermeldung enthält den AWS IoT Rollenalias des Kerngeräts, der auf die Token-Austauschrolle verweist. Führen Sie den folgenden Befehl auf Ihrem Entwicklungscomputer aus und *MyGreengrassCoreTokenExchangeRoleAlias* ersetzen Sie ihn durch den Namen des AWS IoT Rollenalias aus der Fehlermeldung.

   ```
   aws iot describe-role-alias --role-alias MyGreengrassCoreTokenExchangeRoleAlias
   ```

   Die Antwort enthält den Amazon-Ressourcennamen (ARN) der Token-Exchange-IAM-Rolle.

   ```
   {
     "roleAliasDescription": {
       "roleAlias": "MyGreengrassCoreTokenExchangeRoleAlias",
       "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/MyGreengrassCoreTokenExchangeRoleAlias",
       "roleArn": "arn:aws:iam::123456789012:role/MyGreengrassV2TokenExchangeRole",
       "owner": "123456789012",
       "credentialDurationSeconds": 3600,
       "creationDate": "2021-02-05T16:46:18.042000-08:00",
       "lastModifiedDate": "2021-02-05T16:46:18.042000-08:00"
     }
   }
   ```

1. Überprüfen Sie, ob die Rolle existiert. Führen Sie den folgenden Befehl aus und *MyGreengrassV2TokenExchangeRole* ersetzen Sie ihn durch den Namen der Token-Austauschrolle.

   ```
   aws iam get-role --role-name MyGreengrassV2TokenExchangeRole
   ```

   Wenn der Befehl einen `NoSuchEntity` Fehler zurückgibt, ist die Rolle nicht vorhanden und Sie müssen sie erstellen. Weitere Informationen zum Erstellen und Konfigurieren dieser Rolle finden Sie unter[Autorisieren Sie Kerngeräte für die Interaktion mit Diensten AWS](device-service-role.md).

1. Vergewissern Sie sich, dass die Rolle über eine Vertrauensstellung verfügt, die es dem Anbieter der AWS IoT Anmeldeinformationen ermöglicht, diese zu übernehmen. Die Antwort aus dem vorherigen Schritt enthält eine`AssumeRolePolicyDocument`, die die Vertrauensbeziehungen der Rolle definiert. Die Rolle muss eine Vertrauensbeziehung definieren, die es erlaubt`credentials.iot.amazonaws.com`, sie anzunehmen. Dieses Dokument sollte dem folgenden Beispiel ähneln.

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "credentials.iot.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

------

   Wenn die Vertrauensbeziehungen der Rolle es nicht zulassen, dies `credentials.iot.amazonaws.com` anzunehmen, müssen Sie diese Vertrauensbeziehung der Rolle hinzufügen. Weitere Informationen finden Sie unter [Ändern einer Rolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) im *AWS Identity and Access Management IAM-Benutzerhandbuch*.

### com.aws.greengrass.tes.CredentialRequestHandler: Error in retrieving AwsCredentials from TES (HTTP 403)
<a name="token-exchange-service-credentials-http-403"></a>

Dieser Fehler tritt möglicherweise auf, wenn ein Kerngerät keine AWS Anmeldeinformationen vom [Token-Austauschdienst](interact-with-aws-services.md) abrufen kann. Der HTTP-Statuscode 403 gibt an, dass dieser Fehler aufgetreten ist, weil die AWS IoT Richtlinien des Kerngeräts die `iot:AssumeRoleWithCertificate` Berechtigung für den AWS IoT Rollenalias des Kerngeräts nicht gewähren.

Überprüfen Sie die AWS IoT Richtlinien des Kerngeräts und fügen Sie die `iot:AssumeRoleWithCertificate` Berechtigung für den AWS IoT Rollenalias des Kerngeräts hinzu. Die Fehlermeldung enthält den aktuellen AWS IoT Rollenalias des Kerngeräts. Weitere Informationen zu dieser Berechtigung und zur Aktualisierung der AWS IoT Richtlinien des Kerngeräts finden Sie unter [Minimale AWS IoT Richtlinie für AWS IoT Greengrass V2 Kerngeräte](device-auth.md#greengrass-core-minimal-iot-policy) und[Aktualisieren Sie die AWS IoT Richtlinie eines Kerngeräts](device-auth.md#update-core-device-iot-policy).

### com.aws.greengrass.tes.CredentialsProviderError: Could not load credentials from any providers
<a name="token-exchange-service-credentials-provider-error"></a>

Dieser Fehler tritt möglicherweise auf, wenn die Komponente versucht, AWS Anmeldeinformationen anzufordern und keine Verbindung zum [Token-Austauschdienst](interact-with-aws-services.md) herstellen kann.

Gehen Sie wie folgt vor:
+ Überprüfen Sie, ob die Komponente eine Abhängigkeit von der Token-Exchange-Dienstkomponente deklariert,`aws.greengrass.TokenExchangeService`. Ist dies nicht der Fall, fügen Sie die Abhängigkeit hinzu und stellen Sie die Komponente erneut bereit.
+ Wenn die Komponente im Docker ausgeführt wird, stellen Sie sicher, dass Sie entsprechend die richtigen Netzwerkeinstellungen und Umgebungsvariablen anwenden. [Verwenden Sie AWS Anmeldeinformationen in Docker-Container-Komponenten (Linux)](run-docker-container.md#docker-container-token-exchange-service)
+ [Wenn die Komponente in NodeJS geschrieben ist, legen Sie dns fest. setDefaultResultBestellung zu.](https://nodejs.org/docs/latest/api/dns.html#dnssetdefaultresultorderorder) **ipv4first**
+ `/etc/hosts`Suchen Sie nach einem Eintrag, der mit beginnt `::1` und enthält`localhost`. Entfernen Sie den Eintrag, um festzustellen, ob die Komponente dadurch eine Verbindung mit dem Token-Austauschdienst unter der falschen Adresse hergestellt hat.

### Received error when attempting to retrieve ECS metadata: Could not connect to the endpoint URL: "<tokenExchangeServiceEndpoint>"
<a name="token-exchange-service-not-running"></a>

Dieser Fehler tritt möglicherweise auf, wenn die Komponente den [Token-Austauschdienst](interact-with-aws-services.md) nicht ausführt und eine Komponente versucht, AWS Anmeldeinformationen anzufordern.

Gehen Sie wie folgt vor:
+ Überprüfen Sie, ob die Komponente eine Abhängigkeit von der Token-Exchange-Dienstkomponente deklariert,`aws.greengrass.TokenExchangeService`. Ist dies nicht der Fall, fügen Sie die Abhängigkeit hinzu und stellen Sie die Komponente erneut bereit.
+ Prüfen Sie, ob die Komponente `install` während ihres Lebenszyklus AWS Anmeldeinformationen verwendet. AWS IoT Greengrass garantiert nicht die Verfügbarkeit des Token-Austauschdienstes während des `install` Lebenszyklus. Aktualisieren Sie die Komponente, um den Code, der AWS Anmeldeinformationen verwendet, in den `startup` `run` OR-Lebenszyklus zu verschieben, und stellen Sie die Komponente dann erneut bereit.

### copyFrom: <configurationPath> is already a container, not a leaf
<a name="configuration-key-is-container-cannot-become-leaf"></a>

Dieser Fehler tritt möglicherweise auf, wenn Sie einen Konfigurationswert von einem Containertyp (eine Liste oder ein Objekt) in einen Nicht-Containertyp (eine Zeichenfolge, Zahl oder Boolean) ändern. Gehen Sie wie folgt vor:

1. Prüfen Sie anhand der Rezeptur der Komponente, ob die Standardkonfiguration diesen Konfigurationswert auf eine Liste oder ein Objekt festlegt. Wenn ja, entfernen oder ändern Sie diesen Konfigurationswert.

1. Erstellen Sie eine Bereitstellung, um diesen Konfigurationswert auf seinen Standardwert zurückzusetzen. Weitere Informationen erhalten Sie unter [Erstellen von Bereitstellungen](create-deployments.md) und [Komponentenkonfigurationen aktualisieren](update-component-configurations.md).

Anschließend können Sie diesen Konfigurationswert auf eine Zeichenfolge, eine Zahl oder einen booleschen Wert festlegen.

### com.aws.greengrass.componentmanager.plugins.docker.exceptions.DockerLoginException: Error logging into the registry using credentials - 'The stub received bad data.'
<a name="docker-login-stub-received-bad-data"></a>

Möglicherweise wird dieser Fehler in den Greengrass-Nukleus-Protokollen angezeigt, wenn die [Docker Application Manager-Komponente](docker-application-manager-component.md) versucht, ein Docker-Image aus einem privaten Repository in Amazon Elastic Container Registry (Amazon ECR) herunterzuladen. Dieser Fehler tritt auf, wenn Sie den `wincred` [Docker](https://github.com/docker/docker-credential-helpers) Credential Helper () verwenden. `docker-credential-wincred` Aus diesem Grund kann Amazon ECR die Anmeldeinformationen nicht speichern.

Ergreifen Sie eine der folgenden Aktionen:
+ Wenn Sie den `wincred` Docker Credential Helper nicht verwenden, entfernen Sie das `docker-credential-wincred` Programm vom Kerngerät.
+ Wenn Sie den `wincred` Docker Credential Helper verwenden, gehen Sie wie folgt vor:

  1. Benennen Sie das `docker-credential-wincred` Programm auf dem Core-Gerät um. `wincred`Ersetzen Sie es durch einen neuen Namen für den Windows Docker Credential Helper. Sie können ihn beispielsweise umbenennen in. `docker-credential-wincredreal`

  1. Aktualisieren Sie die `credsStore` Option in der Docker-Konfigurationsdatei (`.docker/config.json`), sodass sie den neuen Namen für den Windows Docker Credential Helper verwendet. Wenn Sie das Programm beispielsweise in umbenannt haben`docker-credential-wincredreal`, aktualisieren Sie die `credsStore` Option auf. `wincredreal`

     ```
     {
       "credsStore": "wincredreal"
     }
     ```

### java.io.IOException: Cannot run program "cmd" ...: [LogonUser] The password for this account has expired.
<a name="windows-account-password-expired"></a>

Dieser Fehler tritt möglicherweise auf einem Windows-Core-Gerät auf, wenn der Systembenutzer, der die Prozesse der Komponente ausführt, z. B. `ggc_user` ein abgelaufenes Passwort hat. Daher kann die AWS IoT Greengrass Core-Software die Komponentenprozesse nicht als dieser Systembenutzer ausführen.

**Um das Passwort eines Greengrass-Systembenutzers zu aktualisieren**

1. Führen Sie den folgenden Befehl als Administrator aus, um das Passwort des Benutzers festzulegen. *ggc\$1user*Ersetzen Sie es durch den Systembenutzer und *password* ersetzen Sie es durch das festzulegende Passwort.

   ```
   net user ggc_user password
   ```

1. Verwenden Sie das [PsExec Hilfsprogramm](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec), um das neue Passwort des Benutzers in der Credential Manager-Instanz für das LocalSystem Konto zu speichern. *password*Ersetzen Sie es durch das von Ihnen festgelegte Benutzerkennwort.

   ```
   psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password
   ```

**Tipp**  <a name="windows-password-expiration-tip"></a>
Abhängig von Ihrer Windows-Konfiguration ist das Benutzerkennwort möglicherweise so eingestellt, dass es an einem Datum in der future abläuft. Um sicherzustellen, dass Ihre Greengrass-Anwendungen weiterhin funktionieren, verfolgen Sie, wann das Passwort abläuft, und aktualisieren Sie es, bevor es abläuft. Sie können das Benutzerkennwort auch so einrichten, dass es niemals abläuft.  
Führen Sie den folgenden Befehl aus, um zu überprüfen, wann ein Benutzer und sein Passwort ablaufen.  

  ```
  net user ggc_user | findstr /C:expires
  ```
Führen Sie den folgenden Befehl aus, um das Passwort eines Benutzers so einzustellen, dass es nie abläuft.  

  ```
  wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False
  ```
Wenn Sie Windows 10 oder höher verwenden und der [`wmic`Befehl veraltet ist](https://learn.microsoft.com/en-us/windows/win32/wmisdk/wmic), führen Sie den folgenden PowerShell Befehl aus.  

  ```
  Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}
  ```

### aws.greengrass.StreamManager: Instant exceeds minimum or maximum instant
<a name="stream-manager-instant-exceeds-maximun-minimum"></a>

Wenn Sie Stream Manager v2.0.7 auf eine Version zwischen v2.0.8 und v2.0.11 aktualisieren, wird möglicherweise der folgende Fehler in den Protokollen der Stream Manager-Komponente angezeigt, wenn die Komponente nicht gestartet werden kann. 

```
2021-07-16T00:54:58.568Z [INFO] (Copier) aws.greengrass.StreamManager: stdout. Caused by: com.fasterxml.jackson.databind.JsonMappingException: Instant exceeds minimum or maximum instant (through reference chain: com.amazonaws.iot.greengrass.streammanager.export.PersistedSuccessExportStatesV1["lastExportTime"]). {scriptName=services.aws.greengrass.StreamManager.lifecycle.startup.script, serviceName=aws.greengrass.StreamManager, currentState=STARTING}
2021-07-16T00:54:58.579Z [INFO] (Copier) aws.greengrass.StreamManager: stdout. Caused by: java.time.DateTimeException: Instant exceeds minimum or maximum instant. {scriptName=services.aws.greengrass.StreamManager.lifecycle.startup.script, serviceName=aws.greengrass.StreamManager, currentState=STARTING}
```

Wenn Sie Stream Manager v2.0.7 bereitgestellt haben und auf eine neuere Version aktualisieren möchten, müssen Sie direkt auf Stream Manager v2.0.12 aktualisieren. Weitere Hinweise zur Stream Manager-Komponente finden Sie unter. [Stream-Manager](stream-manager-component.md)

## Probleme mit den Lambda-Funktionskomponenten des Kerngeräts
<a name="greengrass-core-lambda-function-issues"></a>

Beheben Sie Probleme mit Lambda-Funktionskomponenten auf Kerngeräten.

**Topics**
+ [The following cgroup subsystems are not mounted: devices, memory](#lambda-cgroups-not-mounted)
+ [ipc\$1client.py:64,HTTP Error 400:Bad Request, b'No subscription exists for the source <label-or-lambda-arn> and subject <label-or-lambda-arn>](#v1-lambda-no-subscription-exists)

### The following cgroup subsystems are not mounted: devices, memory
<a name="lambda-cgroups-not-mounted"></a>

In den folgenden Fällen wird dieser Fehler möglicherweise angezeigt, wenn Sie eine containerisierte Lambda-Funktion ausführen:
+ Auf dem Core-Gerät ist cgroup v1 für die Speicher- oder Geräte-Cgroups nicht aktiviert.
+ Auf dem Core-Gerät ist cgroups v2 aktiviert. Greengrass Lambda-Funktionen erfordern cgroups v1, und cgroups v1 und v2 schließen sich gegenseitig aus.

Um cgroups v1 zu aktivieren, starten Sie das Gerät mit den folgenden Linux-Kernelparametern.

```
cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0
```

**Tipp**  
Bearbeiten Sie auf einem Raspberry Pi die `/boot/cmdline.txt` Datei, um die Kernel-Parameter des Geräts festzulegen.

### ipc\$1client.py:64,HTTP Error 400:Bad Request, b'No subscription exists for the source <label-or-lambda-arn> and subject <label-or-lambda-arn>
<a name="v1-lambda-no-subscription-exists"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn Sie eine V1-Lambda-Funktion, die das AWS IoT Greengrass Core-SDK verwendet, auf einem V2-Core-Gerät ausführen, ohne ein Abonnement in der [älteren Abonnement-Router-Komponente](legacy-subscription-router-component.md) anzugeben. Um dieses Problem zu beheben, stellen Sie den älteren Abonnement-Router bereit und konfigurieren Sie ihn, um die erforderlichen Abonnements anzugeben. Weitere Informationen finden Sie unter [V1-Lambda-Funktionen importieren](set-up-v2-test-device.md#run-v1-lambda-functions).

## Die Version der Komponente wurde eingestellt
<a name="discontinued-component-version"></a>

Möglicherweise wird auf Ihrem Personal Health Dashboard (PHD) eine Benachrichtigung angezeigt, wenn eine Komponentenversion auf Ihrem Kerngerät eingestellt wird. Die Komponentenversion sendet diese Benachrichtigung innerhalb von 60 Minuten nach der Einstellung an Ihren PHD.

Gehen Sie wie folgt vor, um zu sehen, welche Bereitstellungen Sie überarbeiten müssen, indem Sie: AWS Command Line Interface

1. Führen Sie den folgenden Befehl aus, um eine Liste Ihrer Kerngeräte abzurufen.

   ```
   aws greengrassv2 list-core-devices
   ```

1. Führen Sie den folgenden Befehl aus, um den Status der Komponenten auf jedem Kerngerät aus Schritt 1 abzurufen. `coreDeviceName`Ersetzen Sie ihn durch den Namen jedes abzufragenden Kerngeräts.

   ```
   aws greengrassv2 list-installed-components --core-device-thing-name coreDeviceName
   ```

1. Stellen Sie die Kerngeräte zusammen, auf denen die nicht mehr verfügbare Komponentenversion aus den vorherigen Schritten installiert wurde.

1. Führen Sie den folgenden Befehl aus, um den Status aller Bereitstellungsaufträge für jedes Kerngerät aus Schritt 3 abzurufen. `coreDeviceName`Ersetzen Sie ihn durch den Namen des abzufragenden Kerngeräts.

   ```
   aws greengrassv2 list-effective-deployments --core-device-thing-name coreDeviceName
   ```

   Die Antwort enthält die Liste der Bereitstellungsaufträge für das Kerngerät. Sie können die Bereitstellung überarbeiten, um eine andere Komponentenversion auszuwählen. Weitere Informationen zur Überarbeitung einer Bereitstellung finden Sie unter Bereitstellungen [überarbeiten](https://docs.aws.amazon.com/greengrass/v2/developerguide/revise-deployments.html).

## Probleme mit der Greengrass-Befehlszeilenschnittstelle
<a name="greengrass-cli-issues"></a>

Beheben Sie Probleme mit der [Greengrass-CLI](gg-cli.md).

**Topics**
+ [java.lang.RuntimeException: Unable to create ipc client](#greengrass-cli-unable-to-create-ipc-client)

### java.lang.RuntimeException: Unable to create ipc client
<a name="greengrass-cli-unable-to-create-ipc-client"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn Sie einen Greengrass-CLI-Befehl ausführen und einen anderen Stammordner angeben als den, in dem die AWS IoT Greengrass Core-Software installiert ist.

Gehen Sie wie folgt vor, um den Stammpfad festzulegen, und `/greengrass/v2` ersetzen Sie ihn durch den Pfad zu Ihrer AWS IoT Greengrass Core-Softwareinstallation:<a name="greengrass-cli-set-root-path"></a>
+ Legen Sie die Umgebungsvariable `GGC_ROOT_PATH` auf `/greengrass/v2` fest.
+ Fügen Sie das `--ggcRootPath /greengrass/v2` Argument zu Ihrem Befehl hinzu, wie im folgenden Beispiel gezeigt.

  ```
  greengrass-cli --ggcRootPath /greengrass/v2 <command> <subcommand> [arguments]
  ```

## AWS Command Line Interface Probleme
<a name="aws-cli-issues"></a>

 AWS CLI Probleme beheben für AWS IoT Greengrass V2.

**Topics**
+ [Error: Invalid choice: 'greengrassv2'](#aws-cli-invalid-choice-greengrassv2)

### Error: Invalid choice: 'greengrassv2'
<a name="aws-cli-invalid-choice-greengrassv2"></a>

Dieser Fehler wird möglicherweise angezeigt, wenn Sie einen AWS IoT Greengrass V2 Befehl mit AWS CLI (z. B.`aws greengrassv2 list-core-devices`) ausführen.

Dieser Fehler weist darauf hin, dass Sie eine Version von haben AWS CLI , die nicht unterstützt wird AWS IoT Greengrass V2. Um es AWS IoT Greengrass V2 mit dem verwenden zu können AWS CLI, benötigen Sie eine der folgenden Versionen oder höher:<a name="minimum-aws-cli-versions"></a>
+ Mindestversion AWS CLI V1: v1.18.197
+ Minimale AWS CLI V2-Version: v2.1.11

**Tipp**  <a name="tip-check-aws-cli-version"></a>
Sie können den folgenden Befehl ausführen, um die Version von zu überprüfen AWS CLI , die Sie haben.  

```
aws --version
```

Um dieses Problem zu beheben, aktualisieren Sie die AWS CLI auf eine neuere Version, die unterstützt AWS IoT Greengrass V2. Weitere Informationen finden Sie unter [Installation, Aktualisierung und Deinstallation von AWS CLI im AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) *Benutzerhandbuch*.

# Detaillierte Fehlercodes für die Bereitstellung
<a name="troubleshooting-deployment"></a>

Verwenden Sie die Fehlercodes und Lösungen in diesen Abschnitten, um Probleme mit der Komponentenbereitstellung zu lösen, wenn Sie Greengrass Nucleus Version 2.8.0 oder höher verwenden.

Der Greengrass-Kern meldet Bereitstellungsfehler in einer Hierarchie vom unspezifischsten bis zum spezifischsten verfügbaren Code. Sie können diese Hierarchie verwenden, um den Grund für einen Bereitstellungsfehler zu ermitteln. Im Folgenden ist beispielsweise eine mögliche Fehlerhierarchie aufgeführt:
+ DEPLOYMENT\$1FAILURE
  + ARTIFACT\$1DOWNLOAD\$1ERROR
    + IO\$1ERROR
      + DISK\$1SPACE\$1CRITICAL

Die Fehlercodes sind in Typen unterteilt. Jeder Typ steht für eine Klasse von Fehlern, die auftreten können. AWS IoT Greengrass meldet diese Fehlertypen in der Konsole, der API und AWS CLI. Abhängig von den in der Fehlerhierarchie gemeldeten Fehlern kann es mehr als einen Fehlertyp geben. Für das vorherige Beispiel lautet der zurückgegebene Fehlertyp`DEVICE_ERROR`.

Die Typen sind:
+ **PERMISSION\$1ERROR — Der** Zugriff auf einen Vorgang, für den eine Genehmigung erforderlich ist, wurde verweigert.
+ **REQUEST\$1ERROR** — Aufgrund eines Problems im Bereitstellungsdokument ist ein Fehler aufgetreten.
+ **COMPONENT\$1RECIPE\$1ERROR — Aufgrund eines Fehlers** in einem Komponentenrezept ist ein Fehler aufgetreten.
+ **AWS\$1COMPONENT\$1ERROR — Beim** Starten oder Entfernen einer bereitgestellten Komponente ist ein Fehler aufgetreten. AWS 
+ **USER\$1COMPONENT\$1ERROR** — Beim Starten oder Entfernen einer Benutzerkomponente ist ein Fehler aufgetreten.
+ **COMPONENT\$1ERROR** — Beim Starten oder Entfernen einer Komponente ist ein Fehler aufgetreten, aber der Greengrass-Kern konnte nicht feststellen, ob es sich bei der Komponente um eine AWS bereitgestellte Komponente oder eine Benutzerkomponente handelt.
+ **DEVICE\$1ERROR** — Ein lokaler Fehler ist aufgetreten I/O oder es ist ein anderer Gerätefehler aufgetreten.
+ **DEPENDENCY\$1ERROR** — Bei einer Bereitstellung konnte kein Artefakt von Amazon S3 heruntergeladen oder ein Bild aus einer ECR-Registrierung abgerufen werden.
+ **HTTP\$1ERROR — Bei einer HTTP-Anfrage ist ein Fehler aufgetreten**.
+ **NETWORK\$1ERROR** — Im Gerätenetzwerk ist ein Fehler aufgetreten.
+ **NUCLEUS\$1ERROR** — Der Greengrass-Kern konnte eine Komponente nicht lokalisieren oder die aktive Nukleus-Version nicht finden.
+ **SERVER\$1ERROR** — Ein Server hat als Antwort auf eine Anfrage einen Fehler vom Typ 500 zurückgegeben.
+ **CLOUD\$1SERVICE\$1ERROR — Beim** Cloud-Dienst ist ein Fehler aufgetreten. AWS IoT Greengrass 
+ **UNKNOWN\$1ERROR** — Eine ungeprüfte Ausnahme wurde von der Komponente ausgelöst.

Viele der Fehler in diesem Abschnitt führen zu zusätzlichen Informationen in den Core-Protokollen. AWS IoT Greengrass Diese Protokolle werden im lokalen Dateisystem des Kerngeräts gespeichert. Es gibt Protokolle für die AWS IoT Greengrass Core-Kernsoftware und für jede einzelne Komponente. Informationen zum Zugriff auf die Protokolle finden Sie unter[Greifen Sie auf Dateisystemprotokolle zu](monitor-logs.md#access-local-logs).

## Berechtigungsfehler
<a name="permission-error"></a>

ACCESS\$1DENIED  
Dieser Fehler tritt möglicherweise auf, wenn ein AWS Dienstvorgang einen 403-Fehler zurückgibt, weil die Berechtigungen nicht korrekt eingerichtet sind. Einzelheiten finden Sie im spezifischeren Fehlercode.

GET\$1DEPLOYMENT\$1CONFIGURATION\$1ACCESS\$1DENIED  
Dieser Fehler wird möglicherweise angezeigt, wenn die Richtlinie die Erlaubnis zum Aufrufen des AWS IoT Vorgangs nicht zulässt. `GetDeploymentConfiguration` Fügen Sie die `greengrass::GetDeploymentConfiguration` Berechtigung zur Richtlinie des Kerngeräts hinzu.

GET\$1COMPONENT\$1VERSION\$1ARTIFACT\$1ACCESS\$1DENIED  
Möglicherweise wird dieser Fehler angezeigt, wenn die Kerngeräterichtlinie die Genehmigung nicht zulässt. AWS IoT `greengrass:GetComponentVersionArtifact` Fügen Sie die Berechtigung zur Richtlinie des Kerngeräts hinzu.

RESOLVE\$1COMPONENT\$1CANDIDATES\$1ACCESS\$1DENIED  
Möglicherweise wird dieser Fehler angezeigt, wenn die Kerngeräterichtlinie die Genehmigung nicht zulässt. AWS IoT `greengrass:ResolveComponentCandidates` Fügen Sie die Berechtigung zur Richtlinie des Kerngeräts hinzu.

GET\$1ECR\$1CREDENTIALS AL\$1ERROR  
Dieser Fehler tritt möglicherweise auf, wenn die Bereitstellung nicht mit einer privaten Registrierung in ECR authentifiziert werden konnte. Überprüfen Sie das Protokoll auf einen bestimmten Fehler und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

USER\$1NOT\$1AUTHORIZED\$1FOR\$1DOCKER  
Dieser Fehler kann auftreten, wenn der Greengrass-Benutzer nicht berechtigt ist, Docker zu verwenden. Stellen Sie sicher, dass Sie Greengrass als Root ausführen oder dass der Benutzer der `docker` Gruppe hinzugefügt wurde. Versuchen Sie dann erneut, das Deployment durchzuführen.

S3\$1ACCESS\$1DENIED  
Dieser Fehler kann auftreten, wenn ein Amazon S3 S3-Vorgang einen 403-Fehler zurückgibt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

S3\$1HEAD\$1OBJECT\$1ACCESS\$1DENIED  
Dieser Fehler kann entweder auftreten, wenn die Token-Austauschrolle des Geräts es der AWS IoT Greengrass Core-Software nicht erlaubt, das Komponentenartefakt von der S3-Objekt-URL herunterzuladen, die Sie in der Rezeptur der Komponente angegeben haben, oder wenn das Komponentenartefakt nicht verfügbar ist. Vergewissern Sie sich, dass die Token-Austauschrolle `s3:GetObject` die URL des S3-Objekts berücksichtigt, unter der das Artefakt verfügbar ist, und ob das Artefakt vorhanden ist.

S3\$1GET\$1BUCKET\$1LOCATION\$1ACCESS\$1DENIED  
Möglicherweise wird dieser Fehler angezeigt, wenn die Token-Austauschrolle des Geräts die `s3:GetBucketLocation` Genehmigung für den Amazon S3 S3-Bucket, in dem das Artefakt verfügbar ist, nicht zulässt. Vergewissern Sie sich, dass das Gerät die Erlaubnis erteilt, und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

S3\$1GET\$1OBJECT\$1ACCESS\$1DENIED  
Dieser Fehler kann entweder auftreten, wenn die Token-Austauschrolle des Geräts es der AWS IoT Greengrass Core-Software nicht erlaubt, das Komponentenartefakt von der S3-Objekt-URL herunterzuladen, die Sie im Rezept der Komponente angeben, oder wenn das Komponentenartefakt nicht verfügbar ist. Vergewissern Sie sich, dass die Token-Austauschrolle `s3:GetObject` die URL des S3-Objekts berücksichtigt, unter der das Artefakt verfügbar ist, und ob das Artefakt vorhanden ist.

## Fehler bei der Anfrage
<a name="request-error"></a>

NUCLEUS\$1MISSING\$1REQUIRED\$1CAPABILITIES  
Dieser Fehler tritt möglicherweise auf, wenn die Nucleus-Version in der Bereitstellung einen angeforderten Vorgang nicht ausführen kann, z. B. das Herunterladen einer großen Konfiguration oder das Festlegen von Linux-Ressourcenlimits. Versuchen Sie erneut, die Bereitstellung mit einer Nucleus-Version durchzuführen, die den Vorgang unterstützt.

MULTIPLE\$1NUCLEUS\$1RESOLVED\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn bei einer Bereitstellung versucht wird, mehrere Nucleus-Komponenten bereitzustellen. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

COMPONENT\$1CIRCULAR\$1DEPENDENCY\$1ERROR  
Dieser Fehler kann auftreten, wenn zwei Komponenten in Ihrer Bereitstellung voneinander abhängen. Überarbeiten Sie das Komponenten-Setup, sodass die Komponenten in Ihrer Bereitstellung nicht aufeinander angewiesen sind. 

UNAUTHORIZED\$1NUCLEUS\$1MINOR\$1VERSION\$1UPDATE  
Dieser Fehler tritt möglicherweise auf, wenn für eine Komponente in Ihrer Bereitstellung ein Nucleus Minor-Versionsupdate erforderlich ist, diese Version jedoch nicht in der Bereitstellung angegeben ist. Dies trägt dazu bei, versehentliche Updates für Nebenversionen von Komponenten, die von einer anderen Version abhängen, zu reduzieren. Nehmen Sie die neue Nucleus-Niederversion in die Bereitstellung auf.

MISSING\$1DOCKER\$1APPLICATION\$1MANAGER  
Dieser Fehler wird möglicherweise angezeigt, wenn Sie eine Docker-Komponente bereitstellen, ohne den Docker-Anwendungsmanager bereitzustellen. Stellen Sie sicher, dass Ihre Bereitstellung den Docker-Anwendungsmanager enthält.

MISSING\$1TOKEN\$1EXCHANGE\$1SERVICE  
Dieser Fehler wird möglicherweise angezeigt, wenn die Bereitstellung ein Docker-Image-Artefakt aus einer privaten ECR-Registrierung herunterladen möchte, ohne den Token-Exchange-Dienst bereitzustellen. Stellen Sie sicher, dass Ihre Bereitstellung den Token-Austauschdienst umfasst.

COMPONENT\$1VERSION\$1REQUIREMENTS\$1NOT\$1MET  
Dieser Fehler kann auftreten, wenn ein Versionsbeschränkungskonflikt vorliegt oder eine Komponentenversion nicht existiert. Weitere Informationen finden Sie unter [Error: com.aws.greengrass.componentmanager.exceptions.NoAvailableComponentVersionException: Failed to negotiate component <name> version with cloud and no local applicable version satisfying requirement <requirements>](troubleshooting.md#core-error-no-available-component-version).

THROTTLING\$1ERROR  
Dieser Fehler tritt möglicherweise auf, wenn ein AWS Servicevorgang ein Ratenkontingent überschritten hat. Wiederholen Sie die Bereitstellung.

CONFLICTED\$1REQUEST  
Dieser Fehler tritt möglicherweise auf, wenn ein AWS Dienstvorgang einen 409-Fehler zurückgibt, weil Ihre Bereitstellung versucht, mehr als einen Vorgang gleichzeitig auszuführen. Wiederholen Sie die Bereitstellung.

RESOURCE\$1NOT\$1FOUND  
Dieser Fehler kann auftreten, wenn ein AWS Servicevorgang einen 404-Fehler zurückgibt, weil eine Ressource nicht gefunden werden konnte. Suchen Sie im Protokoll nach der fehlenden Ressource.

RUN\$1WITH\$1CONFIG\$1NOT\$1VALID  
Dieser Fehler wird möglicherweise angezeigt, wenn die für die Ausführung der Komponente angegebenen `windowsUser` Informationen `posixUser``posixGroup`, oder nicht gültig sind. Überprüfen Sie, ob der Benutzer gültig ist, und wiederholen Sie dann die Bereitstellung.

UNSUPPORTED\$1REGION  
Dieser Fehler wird möglicherweise angezeigt, wenn die für die Bereitstellung angegebene Region von nicht unterstützt wird. AWS IoT GreengrassÜberprüfen Sie die Region und versuchen Sie es erneut mit der Bereitstellung.

IOT\$1CRED\$1ENDPOINT\$1NOT\$1VALID  
Dieser Fehler wird möglicherweise angezeigt, wenn der in der Konfiguration angegebene Endpunkt für Anmeldeinformationen nicht gültig ist AWS IoT . Überprüfen Sie den Endpunkt und versuchen Sie es erneut mit Ihrer Anfrage.

IOT\$1DATA\$1ENDPOINT\$1NOT\$1VALID  
Möglicherweise wird dieser Fehler angezeigt, wenn der in der Konfiguration angegebene Datenendpunkt nicht gültig ist AWS IoT . Überprüfen Sie den Endpunkt und versuchen Sie es erneut mit Ihrer Anfrage.

S3\$1HEAD\$1OBJECT\$1RESOURCE\$1NOT\$1FOUND  
Dieser Fehler wird möglicherweise angezeigt, wenn das Komponentenartefakt nicht unter der S3-Objekt-URL verfügbar ist, die Sie im Rezept der Komponente angeben. Überprüfen Sie, ob Sie das Artefakt in den S3-Bucket hochgeladen haben und ob der Artefakt-URI mit der S3-Objekt-URL des Artefakts im Bucket übereinstimmt.

S3\$1GET\$1BUCKET\$1LOCATION\$1RESOURCE\$1NOT\$1FOUND  
Möglicherweise wird dieser Fehler angezeigt, wenn der Amazon S3 S3-Bucket nicht gefunden wird. Überprüfen Sie, ob der Bucket vorhanden ist, und versuchen Sie es erneut mit der Bereitstellung.

S3\$1GET\$1OBJECT\$1RESOURCE\$1NOT\$1FOUND  
Dieser Fehler wird möglicherweise angezeigt, wenn das Komponentenartefakt nicht unter der S3-Objekt-URL verfügbar ist, die Sie im Rezept der Komponente angeben. Überprüfen Sie, ob Sie das Artefakt in den S3-Bucket hochgeladen haben und ob der Artefakt-URI mit der S3-Objekt-URL des Artefakts im Bucket übereinstimmt.

IO\$1MAPPING\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn beim Analysieren des Bereitstellungsdokuments oder I/O -rezepts ein Fehler auftritt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

## Fehler bei der Rezeptur der Komponente
<a name="component-recipe-error"></a>

RECIPE\$1PARSE\$1ERROR  
Dieser Fehler tritt möglicherweise auf, wenn das Bereitstellungsrezept nicht analysiert werden konnte, da ein Fehler in der Struktur des Rezepts vorliegt. Vergewissern Sie sich, dass das Rezept korrekt formatiert ist, und versuchen Sie es erneut mit der Bereitstellung.

RECIPE\$1METADATA\$1PARSE\$1ERROR  
Dieser Fehler tritt möglicherweise auf, wenn die aus der Cloud heruntergeladenen Metadaten des Bereitstellungsrezepts nicht analysiert werden konnten. Kontakt Support.

ARTIFACT\$1URI\$1NOT\$1VALID  
Dieser Fehler kann auftreten, wenn eine Artefakt-URI in einem Rezept nicht richtig formatiert ist. Suchen Sie im Protokoll nach dem ungültigen URI, aktualisieren Sie den URI im Rezept und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

S3\$1ARTIFACT\$1URI\$1NOT\$1VALID  
Dieser Fehler kann auftreten, wenn die Amazon S3 S3-URI eines Artefakts in einem Rezept nicht gültig ist. Suchen Sie im Protokoll nach dem ungültigen URI, aktualisieren Sie den URI im Rezept und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

DOCKER\$1ARTIFACT\$1URI\$1NOT\$1VALID  
Möglicherweise wird dieser Fehler angezeigt, wenn die Docker-URI eines Artefakts in einem Rezept nicht gültig ist. Suchen Sie im Protokoll nach dem ungültigen URI, aktualisieren Sie den URI im Rezept und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

EMPTY\$1ARTIFACT\$1URI  
Dieser Fehler kann auftreten, wenn die URI eines Artefakts nicht in einem Rezept angegeben ist. Suchen Sie im Protokoll nach dem Artefakt, dem ein URI fehlt, aktualisieren Sie den URI im Rezept und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

EMPTY\$1ARTIFACT\$1SCHEME  
Dieser Fehler kann auftreten, wenn für ein Artefakt kein URI-Schema definiert ist. Suchen Sie im Protokoll nach dem URI, der nicht gültig ist, aktualisieren Sie den URI im Rezept und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

UNSUPPORTED\$1ARTIFACT\$1SCHEME  
Dieser Fehler wird möglicherweise angezeigt, wenn ein URI-Schema von der laufenden Nucleus-Version nicht unterstützt wird. Entweder ist ein URI nicht gültig oder Sie müssen die Nucleus-Version aktualisieren. Wenn der URI nicht gültig ist, suchen Sie im Protokoll nach dem ungültigen URI, aktualisieren Sie den URI im Rezept und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

RECIPE\$1MISSING\$1MANIFEST  
Möglicherweise wird dieser Fehler angezeigt, wenn der Manifestabschnitt nicht im Rezept enthalten ist. Fügen Sie das Manifest zum Rezept hinzu und versuchen Sie es erneut mit der Bereitstellung.

RECIPE\$1MISSING\$1ARTIFACT\$1HASH\$1ALGORITHM  
Dieser Fehler kann auftreten, wenn ein Artefakt, das nicht lokal ist, in einem Rezept ohne Hash-Algorithmus angegeben wird. Fügen Sie den Algorithmus dem Artefakt hinzu und versuchen Sie es dann erneut mit der Anfrage.

ARTIFACT\$1CHECKSUM\$1MISMATCH  
Dieser Fehler kann auftreten, wenn ein heruntergeladenes Artefakt einen anderen Digest als den im Rezept angegebenen hat. Stellen Sie sicher, dass das Rezept den richtigen Digest enthält, und versuchen Sie dann erneut, die Bereitstellung durchzuführen. Weitere Informationen finden Sie unter [Error: com.aws.greengrass.componentmanager.exceptions.ArtifactChecksumMismatchException: Integrity check for downloaded artifact failed. Probably due to file corruption.](troubleshooting.md#core-error-failed-to-download-artifact-checksum-mismatch-exception).

COMPONENT\$1DEPENDENCY\$1NOT\$1VALID  
Dieser Fehler wird möglicherweise angezeigt, wenn der in einem Bereitstellungsrezept angegebene Abhängigkeitstyp nicht gültig ist. Überprüfen Sie das Rezept und versuchen Sie es dann erneut mit Ihrer Anfrage.

CONFIG\$1INTERPOLATE\$1ERROR  
Dieser Fehler kann auftreten, wenn Sie eine Rezeptvariable interpolieren. Einzelheiten finden Sie im Protokoll.

IO\$1MAPPING\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn beim Analysieren des Bereitstellungsdokuments oder I/O -rezepts ein Fehler auftritt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

## AWS Komponentenfehler, Benutzerkomponentenfehler, Komponentenfehler
<a name="component-error"></a>

Die folgenden Fehlercodes werden zurückgegeben, wenn ein Problem mit einer Komponente auftritt. Der tatsächlich gemeldete Fehlertyp hängt von der spezifischen Komponente ab, die den Fehler ausgelöst hat. Wenn der Greengrass-Kern die Komponente als eine Komponente identifiziert, die von bereitgestellt wird AWS IoT Greengrass, kehrt sie zurück`AWS_COMPONENT_ERROR`. Wenn die Komponente als Benutzerkomponente identifiziert wird, kehrt der Greengrass-Kern zurück`USER_COMPONENT_ERROR`. Wenn der Greengrass-Kern das nicht weiß, kehrt er zurück`COMPONENT_ERROR`.

COMPONENT\$1UPDATE\$1ERROR  
Dieser Fehler kann auftreten, wenn eine Komponente während einer Bereitstellung nicht aktualisiert wird. Überprüfen Sie alle weiteren Fehlercodes oder schauen Sie im Protokoll nach, was den Fehler verursacht hat.

COMPONENT\$1BROKEN  
Dieser Fehler kann auftreten, wenn eine Komponente während einer Bereitstellung defekt ist. Überprüfen Sie das Komponentenprotokoll auf Fehlerdetails und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

REMOVE\$1COMPONENT\$1ERROR  
Dieser Fehler kann auftreten, wenn der Nucleus eine Komponente während einer Bereitstellung nicht entfernen kann. Überprüfen Sie das Protokoll auf Fehlerdetails und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

COMPONENT\$1BOOTSTRAP\$1TIMEOUT  
Dieser Fehler tritt möglicherweise auf, wenn die Bootstrap-Aufgabe einer Komponente länger als das konfigurierte Timeout gedauert hat. Erhöhen Sie das Timeout oder reduzieren Sie die Ausführungszeit der Bootstrap-Aufgabe und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

COMPONENT\$1BOOTSTRAP\$1ERROR  
Dieser Fehler tritt möglicherweise auf, wenn bei der Bootstrap-Aufgabe einer Komponente ein Fehler auftritt. Überprüfen Sie das Protokoll auf Fehlerdetails und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

COMPONENT\$1CONFIGURATION\$1NOT\$1VALID  
Dieser Fehler kann auftreten, wenn der Nucleus die bereitgestellte Konfiguration für die Komponente nicht validieren kann. Überprüfen Sie das Protokoll auf Fehlerdetails und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

## Gerätefehler
<a name="device-error"></a>

IO\$1WRITE\$1ERROR  
Dieser Fehler kann auftreten, wenn Sie in eine Datei schreiben. Einzelheiten finden Sie im Protokoll.

IO\$1READ\$1ERROR  
Dieser Fehler kann auftreten, wenn Sie aus einer Datei lesen. Einzelheiten finden Sie im Protokoll.

DISK\$1SPACE\$1CRITICAL  
Dieser Fehler wird möglicherweise angezeigt, wenn nicht genügend Speicherplatz zur Verfügung steht, um eine Bereitstellungsanfrage abzuschließen. Sie müssen über mindestens 20 MB verfügbarer Speicherplatz verfügen oder über ausreichend Speicherplatz für ein größeres Artefakt verfügen. Geben Sie Speicherplatz frei und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

IO\$1FILE\$1ATTRIBUTE\$1ERROR  
Dieser Fehler kann auftreten, wenn die vorhandene Dateigröße nicht aus dem Dateisystem abgerufen werden kann. Einzelheiten finden Sie im Protokoll.

SET\$1PERMISSION\$1ERROR  
Dieser Fehler kann auftreten, wenn die Berechtigungen für ein heruntergeladenes Artefakt oder ein Artefaktverzeichnis nicht festgelegt werden können. Einzelheiten finden Sie im Protokoll.

IO\$1UNZIP\$1ERROR  
Dieser Fehler kann auftreten, wenn ein Artefakt nicht entpackt werden kann. Einzelheiten finden Sie im Protokoll.

LOCAL\$1RECIPE\$1NOT\$1FOUND  
Dieser Fehler kann auftreten, wenn die lokale Kopie einer Rezeptdatei nicht gefunden werden konnte. Versuchen Sie die Bereitstellung erneut.

LOCAL\$1RECIPE\$1CORRUPTED  
Dieser Fehler kann auftreten, wenn sich die lokale Kopie des Rezepts seit dem Herunterladen geändert hat. Löschen Sie die vorhandene Kopie des Rezepts und versuchen Sie es erneut mit der Bereitstellung.

LOCAL\$1RECIPE\$1METADATA\$1NOT\$1FOUND  
Dieser Fehler kann auftreten, wenn die lokale Kopie der Rezept-Metadatendatei nicht gefunden werden konnte. Versuchen Sie die Bereitstellung erneut.

LAUNCH\$1DIRECTORY\$1CORRUPTED  
Dieser Fehler kann auftreten, wenn das Verzeichnis, das zum Starten von Greengrass Nucleus (`/greengrass/v2/alts/current`) verwendet wurde, seit dem letzten Start des Nucleus geändert wurde. Starten Sie den Nucleus neu und versuchen Sie dann erneut, das Deployment durchzuführen.

HASHING\$1ALGORITHM\$1UNAVAILABLE  
Dieser Fehler kann auftreten, wenn die Java-Distribution des Geräts den erforderlichen Hash-Algorithmus nicht unterstützt oder wenn der in einem Komponentenrezept angegebene Hash-Algorithmus nicht gültig ist.

DEVICE\$1CONFIG\$1NOT\$1VALID\$1FOR\$1ARTIFACT\$1DOWNLOAD  
Dieser Fehler wird möglicherweise angezeigt, wenn ein Fehler in der Gerätekonfiguration vorliegt, der das Herunterladen des Artefakts durch die Bereitstellung von Amazon S3 oder der Greengrass-Cloud verhindert hat. Überprüfen Sie das Protokoll auf einen bestimmten Konfigurationsfehler und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

## Abhängigkeitsfehler
<a name="dependency-error"></a>

DOCKER\$1ERROR  
Möglicherweise wird dieser Fehler beim Abrufen eines Docker-Images angezeigt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

DOCKER\$1SERVICE\$1UNAVAILABLE  
Möglicherweise wird dieser Fehler angezeigt, wenn Greengrass sich nicht bei der Docker-Registrierung anmelden konnte. Überprüfen Sie das Protokoll auf einen bestimmten Fehler und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

DOCKER\$1LOGIN\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn bei der Anmeldung bei Docker ein unerwarteter Fehler auftritt. Überprüfen Sie das Protokoll auf einen bestimmten Fehler und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

DOCKER\$1PULL\$1ERROR  
Dieser Fehler kann auftreten, wenn beim Abrufen eines Docker-Images aus der Registrierung ein unerwarteter Fehler auftritt. Überprüfen Sie das Protokoll auf einen bestimmten Fehler und versuchen Sie dann erneut, die Bereitstellung durchzuführen.

DOCKER\$1IMAGE\$1NOT\$1VALID  
Möglicherweise wird dieser Fehler angezeigt, wenn das angeforderte Docker-Image nicht existiert. Suchen Sie im Protokoll nach einem bestimmten Fehler und versuchen Sie die Bereitstellung erneut.

DOCKER\$1IMAGE\$1QUERY\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn bei der Abfrage von Docker nach verfügbaren Images ein unerwarteter Fehler auftritt. Suchen Sie im Protokoll nach dem spezifischen Fehler und versuchen Sie die Bereitstellung erneut.

S3\$1ERROR  
Dieser Fehler kann auftreten, wenn Sie ein Amazon S3 S3-Artefakt herunterladen. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

S3\$1RESOURCE\$1NOT\$1FOUND  
Dieser Fehler kann auftreten, wenn ein Amazon S3 S3-Vorgang einen 404-Fehler zurückgibt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

S3\$1BAD\$1REQUEST  
Dieser Fehler kann auftreten, wenn ein Amazon S3 S3-Vorgang einen 400-Fehler zurückgibt. Überprüfen Sie das Protokoll auf einen bestimmten Fehler und versuchen Sie es erneut mit der Anfrage.

## HTTP-Fehler
<a name="http-error"></a>

HTTP\$1REQUEST\$1ERROR  
Dieser Fehler kann auftreten, wenn bei einer HTTP-Anfrage ein Fehler aufgetreten ist. Überprüfen Sie das Protokoll auf den spezifischen Fehler.

DOWNLOAD\$1DEPLOYMENT\$1DOCUMENT\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn beim Herunterladen des Bereitstellungsdokuments ein HTTP-Fehler aufgetreten ist. Suchen Sie im Protokoll nach dem spezifischen HTTP-Fehler.

GET\$1GREENGRASS\$1ARTIFACT\$1SIZE\$1ERROR  
Dieser Fehler kann auftreten, wenn beim Abrufen der Größe eines Artefakts einer öffentlichen Komponente ein HTTP-Fehler aufgetreten ist. Suchen Sie im Protokoll nach dem spezifischen HTTP-Fehler.

DOWNLOAD\$1GREENGRASS\$1ARTIFACT\$1ERROR  
Dieser Fehler kann auftreten, wenn beim Herunterladen eines Artefakts einer öffentlichen Komponente ein HTTP-Fehler aufgetreten ist. Suchen Sie im Protokoll nach dem spezifischen HTTP-Fehler.

## Netzwerkfehler
<a name="network-error"></a>

NETWORK\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn während einer Bereitstellung ein Verbindungsproblem auftritt. Überprüfen Sie die Verbindung des Geräts mit dem Internet und versuchen Sie die Bereitstellung erneut.

## Nucleus-Fehler
<a name="nucleus-error"></a>

BAD\$1REQUEST  
Dieser Fehler wird möglicherweise angezeigt, wenn ein AWS Cloud-Vorgang einen 400-Fehler zurückgibt. Sehen Sie im Protokoll nach, welche API den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer späteren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

NUCLEUS\$1VERSION\$1NOT\$1FOUND  
Dieser Fehler kann auftreten, wenn ein Core-Gerät die Version des aktiven Nucleus nicht finden kann. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

NUCLEUS\$1RESTART\$1FAILURE  
Dieser Fehler kann auftreten, wenn der Nucleus während einer Bereitstellung, die einen Nucleus-Neustart erfordert, nicht neu gestartet wird. Sehen Sie im Loader-Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support. 

INSTALLED\$1COMPONENT\$1NOT\$1FOUND  
Dieser Fehler kann auftreten, wenn der Nucleus eine installierte Komponente nicht finden kann. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

DEPLOYMENT\$1DOCUMENT\$1NOT\$1VALID  
Möglicherweise wird dieser Fehler angezeigt, wenn das Gerät ein Bereitstellungsdokument empfängt, das nicht gültig ist. Überprüfen Sie alle weiteren Fehlercodes oder schauen Sie im Protokoll nach, was den Fehler verursacht hat.

EMPTY\$1DEPLOYMENT\$1REQUEST  
Dieser Fehler kann auftreten, wenn ein Gerät eine leere Bereitstellungsanfrage erhält. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

DEPLOYMENT\$1DOCUMENT\$1PARSE\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn das Format der Bereitstellungsanforderung nicht dem erwarteten Format entspricht. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdate-Seite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

COMPONENT\$1METADATA\$1NOT\$1VALID\$1IN\$1DEPLOYMENT  
Dieser Fehler wird möglicherweise angezeigt, wenn die Bereitstellungsanfrage Komponentenmetadaten enthält, die nicht gültig sind. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

LAUNCH\$1DIRECTORY\$1CORRUPTED  
Dieser Fehler kann auftreten, wenn Sie ein Greengrass-Gerät von einer Dinggruppe in eine andere verschieben und dann zurück zur ursprünglichen Gruppe mit Bereitstellungen, für die Greengrass neu gestartet werden muss. Um den Fehler zu beheben, erstellen Sie das Startverzeichnis für Greengrass auf dem Gerät neu.  
Weitere Informationen finden Sie unter [Error: com.aws.greengrass.deployment.exceptions.DeploymentException: Unable to process deployment. Greengrass launch directory is not set up or Greengrass is not set up as a system service](troubleshooting.md#deployment-error-unable-to-process-deployment).

## Serverfehler
<a name="server-error"></a>

SERVER\$1ERROR  
Dieser Fehler tritt möglicherweise auf, wenn ein AWS Dienstvorgang einen Fehler vom Typ 500 zurückgibt, weil der Dienst die Anfrage momentan nicht verarbeiten kann. Versuchen Sie die Bereitstellung später erneut.

S3\$1SERVER\$1ERROR  
Dieser Fehler kann auftreten, wenn ein Amazon S3 S3-Vorgang einen Fehler vom Typ 500 zurückgibt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

## Fehler beim Cloud-Dienst
<a name="cloud-service-error"></a>

RESOLVE\$1COMPONENT\$1CANDIDATES\$1BAD\$1RESPONSE  
Dieser Fehler kann auftreten, wenn der Greengrass-Cloud-Dienst eine inkompatible Antwort auf den `ResolveComponentCandidates` Vorgang sendet. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

DEPLOYMENT\$1DOCUMENT\$1SIZE\$1EXCEEDED  
Dieser Fehler wird möglicherweise angezeigt, wenn das angeforderte Bereitstellungsdokument das maximale Größenkontingent überschritten hat. Reduzieren Sie die Größe des Bereitstellungsdokuments und versuchen Sie es erneut.

GREENGRASS\$1ARTIFACT\$1SIZE\$1NOT\$1FOUND  
Dieser Fehler kann auftreten, wenn Greengrass die Größe eines Artefakts einer öffentlichen Komponente nicht ermitteln kann. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns. Support

DEPLOYMENT\$1DOCUMENT\$1NOT\$1VALID  
Möglicherweise wird dieser Fehler angezeigt, wenn das Gerät ein Bereitstellungsdokument empfängt, das nicht gültig ist. Überprüfen Sie alle weiteren Fehlercodes oder schauen Sie im Protokoll nach, was den Fehler verursacht hat.

EMPTY\$1DEPLOYMENT\$1REQUEST  
Dieser Fehler kann auftreten, wenn ein Gerät eine leere Bereitstellungsanfrage erhält. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

DEPLOYMENT\$1DOCUMENT\$1PARSE\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn das Format der Bereitstellungsanforderung nicht dem erwarteten Format entspricht. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdate-Seite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

COMPONENT\$1METADATA\$1NOT\$1VALID\$1IN\$1DEPLOYMENT  
Dieser Fehler wird möglicherweise angezeigt, wenn die Bereitstellungsanfrage Komponentenmetadaten enthält, die nicht gültig sind. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

## Generische Fehler
<a name="generic-error"></a>

Diesen generischen Fehlern ist kein Fehlertyp zugeordnet.

DEPLOYMENT\$1INTERRUPTED  
Dieser Fehler tritt möglicherweise auf, wenn eine Bereitstellung aufgrund eines Herunterfahrens von Nucleus oder eines anderen externen Ereignisses nicht abgeschlossen werden kann. Weitere Informationen finden Sie in allen weiteren Fehlercodes oder Protokollen.

ARTIFACT\$1DOWNLOAD\$1ERROR  
Dieser Fehler kann auftreten, wenn beim Herunterladen eines Artefakts ein Problem auftritt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

NO\$1AVAILABLE\$1COMPONENT\$1VERSION  
Dieser Fehler kann auftreten, wenn eine Komponentenversion nicht in der Cloud oder lokal existiert oder wenn ein Konflikt bei der Abhängigkeitsauflösung vorliegt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

COMPONENT\$1PACKAGE\$1LOADING\$1ERROR  
Dieser Fehler kann auftreten, wenn bei der Verarbeitung der heruntergeladenen Artefakte ein Fehler auftritt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

WOLKE\$1 API\$1ERROR  
Möglicherweise wird dieser Fehler angezeigt, wenn beim Aufrufen einer AWS Service-API ein Fehler aufgetreten ist. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

IO\$1ERROR  
Dieser Fehler wird möglicherweise angezeigt, wenn während einer I/O Bereitstellung ein Fehler auftritt. Weitere Informationen finden Sie in allen zusätzlichen Fehlercodes oder Protokollen.

COMPONENT\$1UPDATE\$1ERROR  
Dieser Fehler kann auftreten, wenn eine Komponente während einer Bereitstellung nicht aktualisiert wird. Überprüfen Sie alle weiteren Fehlercodes oder schauen Sie im Protokoll nach, was den Fehler verursacht hat.

## Unbekannter Fehler
<a name="unknown-error"></a>

DEPLOYMENT\$1FAILURE  
Dieser Fehler tritt möglicherweise auf, wenn eine Bereitstellung fehlschlägt, weil eine ungeprüfte Ausnahme ausgelöst wurde. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Softwareupdateseite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

DEPLOYMENT\$1TYPE\$1NOT\$1VALID  
Dieser Fehler wird möglicherweise angezeigt, wenn der Bereitstellungstyp nicht gültig ist. Sehen Sie im Protokoll nach, was den Fehler verursacht hat, und schauen Sie dann auf der Nucleus-Software-Update-Seite nach, ob das Problem in einer neueren Version von Nucleus behoben wurde, oder kontaktieren Sie uns Support.

# Detaillierte Statuscodes für Komponenten
<a name="troubleshooting-component"></a>

Verwenden Sie die Statuscodes und Lösungen in diesen Abschnitten, um Probleme mit Komponenten zu lösen, wenn Sie Greengrass Nucleus Version 2.8.0 oder höher verwenden.

Viele der Status in diesem Thema enthalten zusätzliche Informationen in den AWS IoT Greengrass Core-Protokollen. Diese Protokolle werden im lokalen Dateisystem des Kerngeräts gespeichert. Es gibt Protokolle für jede einzelne Komponente. Informationen zum Zugriff auf die Protokolle finden Sie unter[Greifen Sie auf Dateisystemprotokolle zu](monitor-logs.md#access-local-logs).

INSTALL\$1ERROR  
Dies kann auftreten, wenn beim Ausführen eines Installationsskripts ein Fehler auftritt. Der Fehlercode wird im Komponentenprotokoll gemeldet. Überprüfen Sie das Installationsskript auf Fehler und stellen Sie Ihre Komponente erneut bereit.

INSTALL\$1CONFIG\$1NOT\$1VALID  
Dieser Fehler kann auftreten, wenn die Installation einer Komponente nicht abgeschlossen werden konnte, weil der `install` Abschnitt des Rezepts nicht gültig ist. Überprüfen Sie den Installationsabschnitt Ihres Rezepts auf Fehler und versuchen Sie es erneut mit der Bereitstellung.

INSTALL\$1IO\$1ERROR  
Dies kann auftreten, wenn bei der Installation einer Komponente ein I/O-Fehler aufgetreten ist. Einzelheiten zu dem Fehler finden Sie im Fehlerprotokoll der Komponente.

INSTALL\$1MISSING\$1DEFAULT\$1RUNWITH  
Dieser Fehler tritt möglicherweise auf, wenn Sie nicht ermitteln AWS IoT Greengrass können, welcher Benutzer oder welche Gruppe bei der Installation einer Komponente verwendet werden soll. Vergewissern Sie sich, dass der `runWith` Abschnitt Ihrer Installationsanleitung einen gültigen Benutzer oder eine gültige Gruppe enthält. 

INSTALL\$1TIMEOUT  
Möglicherweise wird dieser Fehler angezeigt, wenn das Installationsskript nicht innerhalb des konfigurierten Timeouts abgeschlossen wurde. Verlängern Sie entweder den im `install` Abschnitt des Rezepts angegebenen `Timeout` Zeitraum oder ändern Sie Ihr Installationsskript so, dass es innerhalb des konfigurierten Timeouts abgeschlossen wird.

STARTUP\$1ERROR  
Dies kann auftreten, wenn beim Ausführen eines Startskripts ein Fehler auftritt. Der Fehlercode wird im Komponentenprotokoll gemeldet. Überprüfen Sie das Installationsskript auf Fehler und stellen Sie Ihre Komponente erneut bereit.

STARTUP\$1CONFIG\$1NOT\$1VALID  
Dieser Fehler kann auftreten, wenn die Installation einer Komponente nicht abgeschlossen werden konnte, weil der `startup` Abschnitt des Rezepts nicht gültig ist. Suchen Sie im Startbereich Ihres Rezepts nach Fehlern und versuchen Sie es erneut mit der Bereitstellung.

STARTUP\$1IO\$1ERROR  
Dies kann auftreten, wenn beim Start einer Komponente ein I/O-Fehler aufgetreten ist. Einzelheiten zu dem Fehler finden Sie im Fehlerprotokoll der Komponente.

STARTUP\$1MISSING\$1DEFAULT\$1RUNWITH  
Dieser Fehler tritt möglicherweise auf, wenn Sie nicht ermitteln AWS IoT Greengrass können, welcher Benutzer oder welche Gruppe beim Ausführen einer Komponente verwendet werden soll. Vergewissern Sie sich, dass der `runWith` Abschnitt Ihres Startrezepts einen gültigen Benutzer oder eine gültige Gruppe enthält.

STARTUP\$1TIMEOUT  
Möglicherweise wird dieser Fehler angezeigt, wenn das Startskript nicht innerhalb des konfigurierten Timeout-Zeitraums abgeschlossen wurde. Verlängern Sie entweder den im `startup` Abschnitt des Rezepts angegebenen `Timeout` Zeitraum oder ändern Sie Ihr Startskript so, dass es innerhalb des konfigurierten Timeouts abgeschlossen wird.

RUN\$1ERROR  
Dies kann auftreten, wenn beim Ausführen eines Komponentenskripts ein Fehler auftritt. Der Fehlercode wird im Komponentenprotokoll gemeldet. Überprüfen Sie das Run-Skript auf Fehler und stellen Sie Ihre Komponente erneut bereit.

RUN\$1MISSING\$1DEFAULT\$1RUNWITH  
Dieser Fehler tritt möglicherweise auf, wenn Sie nicht ermitteln AWS IoT Greengrass können, welcher Benutzer oder welche Gruppe beim Ausführen einer Komponente verwendet werden soll. Vergewissern Sie sich, dass der `runWith` Abschnitt Ihres Ausführungsrezepts einen gültigen Benutzer oder eine gültige Gruppe enthält.

RUN\$1CONFIG\$1NOT\$1VALID  
Dieser Fehler kann auftreten, wenn eine Komponente nicht ausgeführt werden konnte, weil der `run` Abschnitt des Rezepts nicht gültig ist. Suchen Sie im Abschnitt „Ausführen“ Ihres Rezepts nach Fehlern und versuchen Sie es erneut mit der Bereitstellung.

RUN\$1IO\$1ERROR  
Dies kann auftreten, wenn während der Ausführung der Komponente ein I/O-Fehler aufgetreten ist. Einzelheiten zu dem Fehler finden Sie im Fehlerprotokoll der Komponente.

RUN\$1TIMEOUT  
Möglicherweise wird dieser Fehler angezeigt, wenn das Ausführungsskript nicht innerhalb des konfigurierten Timeout-Zeitraums abgeschlossen wurde. Verlängern Sie entweder den im `run` Abschnitt des Rezepts angegebenen `Timeout` Zeitraum oder ändern Sie Ihr Ausführungsskript so, dass es innerhalb des konfigurierten Timeouts abgeschlossen wird.

SHUTDOWN\$1ERROR  
Dies kann auftreten, wenn beim Herunterfahren eines Komponentenskripts ein Fehler auftritt. Der Fehlercode wird im Komponentenprotokoll gemeldet. Überprüfen Sie das Shutdown-Skript auf Fehler und stellen Sie Ihre Komponente erneut bereit.

SHUTDOWN\$1TIMEOUT  
Möglicherweise wird dieser Fehler angezeigt, wenn das Shutdown-Skript nicht innerhalb des konfigurierten Timeout-Zeitraums abgeschlossen wurde. Verlängern Sie entweder den im `shutdown` Abschnitt des Rezepts angegebenen `Timeout` Zeitraum oder ändern Sie Ihr Ausführungsskript so, dass es innerhalb des konfigurierten Timeouts abgeschlossen wird.