Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Risoluzione dei problemi AWS IoT Greengrass V2
Utilizza le informazioni e le soluzioni per la risoluzione dei problemi contenute in questa sezione per risolvere i problemi relativi a. AWS IoT Greengrass Version 2
**Topics**
+ [Vista AWS IoT Greengrass Software di base e registri dei componenti](#troubleshoot-with-logs)
+ [AWS IoT Greengrass Problemi software principali](#greengrass-core-issues)
+ [AWS IoT Greengrass problemi relativi al cloud](#greengrass-cloud-issues)
+ [Problemi principali di distribuzione dei dispositivi](#greengrass-core-deployment-issues)
+ [Problemi principali relativi ai componenti del dispositivo](#greengrass-core-component-issues)
+ [Problemi relativi ai componenti della funzione Lambda del dispositivo principale](#greengrass-core-lambda-function-issues)
+ [La versione del componente è stata interrotta](#discontinued-component-version)
+ [Problemi relativi all'interfaccia a riga di comando di Greengrass](#greengrass-cli-issues)
+ [AWS Command Line Interface problemi](#aws-cli-issues)
+ [Codici di errore di distribuzione dettagliati](troubleshooting-deployment.md)
+ [Codici di stato dettagliati dei componenti](troubleshooting-component.md)
## Vista AWS IoT Greengrass Software di base e registri dei componenti
Il software AWS IoT Greengrass Core scrive i log nel file system locale che è possibile utilizzare per visualizzare informazioni in tempo reale sul dispositivo principale. Puoi anche configurare i dispositivi principali per scrivere i log nei CloudWatch registri, in modo da poter risolvere i problemi dei dispositivi principali in remoto. Questi registri possono aiutarti a identificare i problemi relativi ai componenti, alle implementazioni e ai dispositivi principali. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).
## AWS IoT Greengrass Problemi software principali
Risolvi i problemi relativi AWS IoT Greengrass al software Core.
**Topics**
+ [ThrottlingException dall'API ListDeployments](#ThrottlingException)
+ [Impossibile configurare il dispositivo principale](#unable-to-set-up-core-device)
+ [Impossibile avviare il AWS IoT Greengrass Software di base come servizio di sistema](#unable-to-start-system-service)
+ [Impossibile configurare nucleus come servizio di sistema](#unable-to-set-up-system-service)
+ [Impossibile connettersi a AWS IoT Core](#core-error-unable-to-connect-to-aws-iot)
+ [Errore di memoria esaurita](#java-out-of-memory)
+ [Impossibile installare Greengrass CLI](#unable-to-install-greengrass-cli)
+ [L'utente root non può eseguire](#user-not-allowed-to-execute)
+ [com.aws.greengrass.lifecyclemanager. GenericExternalService: Impossibile determinare di eseguirlo con user/group](#missing-default-run-with-user)
+ [Impossibile mappare il segmento dall'oggetto condiviso: operazione non consentita](#tmp-folder-noexec)
+ [Impossibile configurare il servizio Windows](#failed-to-set-up-windows-service)
+ [com.aws.greengrass.util.exceptions. TLSAuthException: Impossibile ottenere il Trust Manager](#failed-to-get-trust-manager)
+ [com.aws.greengrass.deployment. IotJobsHelper: Nessuna connessione disponibile durante la sottoscrizione all'argomento delle descrizioni di Iot Jobs. Riproverò tra qualche volta](#iot-jobs-no-connection-available)
+ [software.amazon.awssdk.services.iam.model. IamException: il token di sicurezza incluso nella richiesta non è valido](#error-invalid-security-token)
+ [software.amazon.awssdk.services.iot.model. IotException: Utente: l'utente non è autorizzato a eseguire: iot: < > GetPolicy](#missing-automatic-provisioning-permissions)
+ [Errore: com.aws.greengrass.shadowmanager.sync.model. FullShadowSyncRequest: impossibile eseguire la richiesta cloud shadow get](#shadow-manager-error-could-not-execute-shadow-get-request)
+ [L'operazione aws.greengrass\# < non > è supportata da Greengrass](#ipc-operation-not-supported)
+ [java.io. FileNotFoundException: < stream-manager-store-root-dir > /stream\_manager\_metadata\_store (Autorizzazione negata)](#stream-manager-store-root-folder-not-found)
+ [com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: La chiave privata o il certificato con etichetta non esiste < >](#pkcs11-provider-error-private-key-or-certificate-does-not-exist)
+ [software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: Utente: l'utente non è autorizzato a eseguire: secretsmanager: on resource: arn < > GetSecretValue < >](#secret-manager-error-not-authorized-to-perform-get-secret-value)
+ [software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: L'accesso a KMS non è consentito](#secret-manager-error-no-kms-access)
+ [java.lang. NoClassDefFoundError:// com/awsgreengrass/securityCryptoKeySpi](#hardware-security-incompatible-nucleus-version)
+ [com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: CKR\_OPERATION\_NOT\_INITIALIZED](#ckr-operation-not-initialized)
+ [Dispositivo core Greengrass bloccato su nucleus v2.12.3](#v2.12.3-revise-deployment)
+ [Problema del modello systemd Greengrass nucleus v2.14.0](#v2.14.0-systemd-template)
### ThrottlingException dall'API ListDeployments
`ThrottlingException`dall'`ListDeployments`API: potresti vederlo quando hai in conto un gran numero di implementazioni.
Per risolvere questo problema, esegui una delle seguenti operazioni:
+ Se usi SDK, specifica il MaxResult parametro. Ad esempio, per [JavaSDK](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/greengrassv2/model/ListDeploymentsRequest.html#maxResults) con un valore piccolo (ad esempio 5).
+ Puoi utilizzare [AWS Service Quotas](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html) per richiedere un aumento del limite di velocità dell'`DescribeJob`API. Puoi andare alla console di Service Quota, selezionare le quote di AWS IoT e il nome del limite è **DescribeJob throttle** limit. Puoi aumentarlo da 10 a 50.
### Impossibile configurare il dispositivo principale
Se il programma di installazione del software AWS IoT Greengrass Core fallisce e non riesci a configurare un dispositivo principale, potresti dover disinstallare il software e riprovare. Per ulteriori informazioni, consulta [Disinstalla il AWS IoT Greengrass Software di base](uninstall-greengrass-core-v2.md).
### Impossibile avviare il AWS IoT Greengrass Software di base come servizio di sistema
Se il software AWS IoT Greengrass Core non si avvia, [controlla i registri dei servizi di sistema](monitor-logs.md#access-system-service-logs) per identificare il problema. Un problema comune è rappresentato dalla mancata disponibilità di Java nella variabile di ambiente PATH (Linux) o nella variabile di sistema PATH (Windows).
### Impossibile configurare nucleus come servizio di sistema
Potresti visualizzare questo errore quando il programma di installazione del software AWS IoT Greengrass Core non riesce a configurarsi AWS IoT Greengrass come servizio di sistema. Sui dispositivi Linux, questo errore si verifica in genere se il dispositivo principale non dispone del [sistema systemd init](https://en.wikipedia.org/wiki/Systemd). Il programma di installazione può configurare correttamente il software AWS IoT Greengrass Core anche se non riesce a configurare il servizio di sistema.
Esegui una delle seguenti operazioni:
+ Configura ed esegui il software AWS IoT Greengrass Core come servizio di sistema. È necessario configurare il software come servizio di sistema per utilizzare tutte le funzionalità di AWS IoT Greengrass. È possibile installare [systemd](https://en.wikipedia.org/wiki/Systemd) o utilizzare un sistema di inizializzazione diverso. Per ulteriori informazioni, consulta [Configurare il nucleo Greengrass come servizio di sistema](configure-greengrass-core-v2.md#configure-system-service).
+ Esegui il software AWS IoT Greengrass Core senza un servizio di sistema. È possibile eseguire il software utilizzando uno script di caricamento che il programma di installazione configura nella cartella principale di Greengrass. Per ulteriori informazioni, consulta [Esegui il software AWS IoT Greengrass Core senza un servizio di sistema](run-greengrass-core-v2.md#run-greengrass-core-no-system-service).
### Impossibile connettersi a AWS IoT Core
Potresti visualizzare questo errore quando il software AWS IoT Greengrass Core non riesce a connettersi AWS IoT Core a per recuperare i lavori di distribuzione, ad esempio. Esegui questa operazione:
+ Verifica che il tuo dispositivo principale sia in grado di connettersi a Internet e AWS IoT Core. Per ulteriori informazioni sull' AWS IoT Core endpoint a cui si connette il dispositivo, consulta[Configurare il software AWS IoT Greengrass Core](configure-greengrass-core-v2.md).
+ Verifica che il dispositivo AWS IoT principale del tuo dispositivo utilizzi un certificato che consenta le`iot:Connect`, `iot:Publish``iot:Receive`, e le `iot:Subscribe` autorizzazioni.
+ Se il dispositivo principale utilizza un [proxy di rete](configure-greengrass-core-v2.md#configure-network-proxy), verifica che il dispositivo principale abbia un [ruolo di dispositivo](device-service-role.md) e che tale ruolo consenta le`iot:Connect`, `iot:Publish``iot:Receive`, e le `iot:Subscribe` autorizzazioni.
### Errore di memoria esaurita
Questo errore si verifica in genere se il dispositivo non dispone di memoria sufficiente per allocare un oggetto nell'heap Java. Sui dispositivi con memoria limitata, potrebbe essere necessario specificare una dimensione massima dell'heap per controllare l'allocazione della memoria. Per ulteriori informazioni, consulta [Controlla l'allocazione della memoria con le opzioni JVM](configure-greengrass-core-v2.md#jvm-tuning).
### Impossibile installare Greengrass CLI
È possibile che venga visualizzato il seguente messaggio sulla console quando si utilizza l'`--deploy-dev-tools`argomento nel comando di installazione per AWS IoT Greengrass Core.
```
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
```
Ciò si verifica quando il componente Greengrass CLI non è installato perché il dispositivo principale è membro di un gruppo di oggetti con una distribuzione esistente. Se vedi questo messaggio, puoi distribuire manualmente il `aws.greengrass.Cli` componente Greengrass CLI () sul dispositivo per installare la Greengrass CLI. Per ulteriori informazioni, consulta [Installazione della CLI di Greengrass](install-gg-cli.md).
### L'utente root non può eseguire
Potresti visualizzare questo errore quando l'utente che esegue il software AWS IoT Greengrass Core (in genere`root`) non è autorizzato a funzionare `sudo` con alcun utente e gruppo. Per l'utente `ggc_user` di sistema predefinito, questo errore è simile al seguente:
```
Sorry, user root is not allowed to execute as ggc_user:ggc_group.
```
Verifica che il `/etc/sudoers` file dia all'utente il permesso di funzionare `sudo` come altri gruppi. L'autorizzazione per l'utente `/etc/sudoers` dovrebbe essere simile all'esempio seguente.
```
root ALL=(ALL:ALL) ALL
```
### com.aws.greengrass.lifecyclemanager. GenericExternalService: Impossibile determinare di eseguirlo con user/group
Potresti visualizzare questo errore quando il dispositivo principale tenta di eseguire un componente e il nucleo di Greengrass non specifica un utente di sistema predefinito da utilizzare per eseguire i componenti.
Per risolvere questo problema, configura il nucleo Greengrass per specificare l'utente di sistema predefinito che esegue i componenti. Per ulteriori informazioni, consultare [Configurare l'utente che esegue i componenti](configure-greengrass-core-v2.md#configure-component-user) e [Configura l'utente predefinito del componente](configure-greengrass-core-v2.md#configure-default-component-user).
### Impossibile mappare il segmento dall'oggetto condiviso: operazione non consentita
Potresti visualizzare questo errore quando il software AWS IoT Greengrass Core non si avvia perché la `/tmp` cartella è montata con `noexec` le autorizzazioni. La [libreria AWS Common Runtime (CRT)](https://github.com/awslabs/aws-crt-java) utilizza la `/tmp` cartella per impostazione predefinita.
Esegui una delle seguenti operazioni:
+ Esegui il comando seguente per rimontare la `/tmp` cartella con le `exec` autorizzazioni e riprova.
```
sudo mount -o remount,exec /tmp
```
+ Se si esegue Greengrass nucleus v2.5.0 o versione successiva, è possibile impostare un'opzione JVM per modificare la cartella utilizzata dalla libreria CRT. AWS È possibile specificare il `jvmOptions` parametro nella configurazione del componente Greengrass nucleus in una distribuzione o quando si installa il AWS IoT Greengrass software Core. {{/path/to/use}}Sostituitelo con il percorso di una cartella utilizzabile dalla libreria AWS CRT.
```
{
"jvmOptions": "-Daws.crt.lib.dir=\"{{/path/to/use}}\""
}
```
### Impossibile configurare il servizio Windows
Potresti visualizzare questo errore se installi il software AWS IoT Greengrass Core su un dispositivo Microsoft Windows 2016. Il software AWS IoT Greengrass Core non è supportato in Windows 2016. Per un elenco dei sistemi operativi supportati, consulta[Piattaforme supportate](greengrass-nucleus-component.md#greengrass-v2-supported-platforms).
Se è necessario utilizzare Windows 2016, è possibile effettuare le seguenti operazioni:
1. Decomprimi l'archivio di installazione AWS IoT Greengrass Core scaricato
1. Nella `Greengrass` directory apri il `bin/greengrass.xml.template` file.
1. Aggiungi il `` tag alla fine del file appena prima del `` tag.
```
false
```
### com.aws.greengrass.util.exceptions. TLSAuthException: Impossibile ottenere il Trust Manager
È possibile che venga visualizzato questo errore quando si installa il software AWS IoT Greengrass Core senza un file CA (root certificate authority).
```
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
```
Verificate di aver specificato un file CA root valido con il `rootCaPath` parametro nel file di configurazione fornito all'installatore. Per ulteriori informazioni, consulta [Installare il software AWS IoT Greengrass Core](install-greengrass-core-v2.md).
### com.aws.greengrass.deployment. IotJobsHelper: Nessuna connessione disponibile durante la sottoscrizione all'argomento delle descrizioni di Iot Jobs. Riproverò tra qualche volta
Potresti visualizzare questo messaggio di avviso quando il dispositivo principale non riesce a connettersi per iscriversi AWS IoT Core alle notifiche sui lavori di distribuzione. Esegui questa operazione:
+ Verifica che il dispositivo principale sia connesso a Internet e possa raggiungere l'endpoint di AWS IoT dati che hai configurato. Per ulteriori informazioni sugli endpoint utilizzati dai dispositivi principali, consulta. [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md)
+ Controlla i log di Greengrass per altri errori che rivelano altre cause principali.
### software.amazon.awssdk.services.iam.model. IamException: il token di sicurezza incluso nella richiesta non è valido
Potresti visualizzare questo errore quando [installi il software AWS IoT Greengrass Core con provisioning automatico](quick-installation.md) e il programma di installazione utilizza un token di AWS sessione non valido. Esegui questa operazione:
+ Se utilizzate credenziali di sicurezza temporanee, verificate che il token di sessione sia corretto e che stiate copiando e incollando il token di sessione completo.
+ Se utilizzi credenziali di sicurezza a lungo termine, verifica che il dispositivo non disponga di un token di sessione risalente a quando in precedenza utilizzavi credenziali temporanee. Esegui questa operazione:
1. Esegui il comando seguente per annullare l'impostazione della variabile di ambiente del token di sessione.
------
#### [ Linux or Unix ]
```
unset AWS_SESSION_TOKEN
```
------
#### [ Windows Command Prompt (CMD) ]
```
set AWS_SESSION_TOKEN=
```
------
#### [ PowerShell ]
```
Remove-Item Env:\AWS_SESSION_TOKEN
```
------
1. Controlla se il file AWS delle credenziali contiene un token di sessione`~/.aws/credentials`,. `aws_session_token` In tal caso, rimuovi quella riga dal file.
```
aws_session_token = {{AQoEXAMPLEH4aoAH0gNCAPyJxz4BlCFFxWNE1OPTgk5TthT+FvwqnKwRcOIfrRh3c/LTo6UDdyJwOOvEVPvLXCrrrUtdnniCEXAMPLE/IvU1dYUg2RVAJBanLiHb4IgRmpRV3zrkuWJOgQs8IZZaIv2BXIa2R4Olgk}}
```
Puoi anche installare il software AWS IoT Greengrass Core senza fornire AWS credenziali. Per ulteriori informazioni, consulta [Installa il software AWS IoT Greengrass Core con provisioning manuale delle risorse](manual-installation.md) o [Installa il software AWS IoT Greengrass Core con il provisioning AWS IoT della flotta](fleet-provisioning.md).
### software.amazon.awssdk.services.iot.model. IotException: Utente: l'utente non è autorizzato a eseguire: iot: < > GetPolicy
Potresti visualizzare questo errore quando [installi il software AWS IoT Greengrass Core con provisioning automatico](quick-installation.md) e il programma di installazione utilizza AWS credenziali che non dispongono delle autorizzazioni richieste. Per ulteriori informazioni sulle autorizzazioni richieste, consulta. [Policy IAM minima per l'installatore per il provisioning delle risorse](provision-minimal-iam-policy.md)
Controlla le autorizzazioni per l'identità IAM delle credenziali e concedi all'identità IAM tutte le autorizzazioni richieste mancanti.
### Errore: com.aws.greengrass.shadowmanager.sync.model. FullShadowSyncRequest: impossibile eseguire la richiesta cloud shadow get
Potresti visualizzare questo errore quando usi il [componente shadow manager](shadow-manager-component.md) per [sincronizzare le ombre del dispositivo con AWS IoT Core](sync-shadows-with-iot-core.md). Il codice di stato HTTP 403 indica che questo errore si è verificato perché la AWS IoT politica del dispositivo principale non concede l'autorizzazione alla chiamata. `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)
```
Per sincronizzare le ombre locali con AWS IoT Core, la AWS IoT politica del dispositivo principale deve concedere le seguenti autorizzazioni:
+ `iot:GetThingShadow`
+ `iot:UpdateThingShadow`
+ `iot:DeleteThingShadow`
Controlla la AWS IoT politica del dispositivo principale e aggiungi le autorizzazioni necessarie mancanti. Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [AWS IoT Core azioni politiche](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html) nella Guida per gli *AWS IoT sviluppatori*
+ [Aggiorna la politica di un dispositivo principale AWS IoT](device-auth.md#update-core-device-iot-policy)
### L'operazione aws.greengrass\# < non > è supportata da Greengrass
Potresti visualizzare questo errore quando utilizzi un'[operazione di comunicazione tra processi (IPC)](interprocess-communication.md) in un componente Greengrass personalizzato e il componente AWS fornito richiesto non è installato sul dispositivo principale.
Per risolvere questo problema, aggiungi il componente richiesto come [dipendenza nella ricetta del componente, in modo che il software AWS IoT Greengrass Core abbia installato il componente](component-recipe-reference.md#recipe-reference-component-dependencies) richiesto al momento della distribuzione del componente.
+ [Recupera valori segreti](ipc-secret-manager.md): `aws.greengrass.SecretManager`
+ [Interagisci con le ombre locali](ipc-local-shadows.md) — `aws.greengrass.ShadowManager`
+ [Gestisci le distribuzioni e i componenti locali](ipc-local-deployments-components.md): `aws.greengrass.Cli` v2.6.0 o versione successiva
+ [Autentica e autorizza i dispositivi client](ipc-client-device-auth.md): v2.2.0 o versione successiva `aws.greengrass.clientdevices.Auth`
### java.io. FileNotFoundException: < stream-manager-store-root-dir > /stream\_manager\_metadata\_store (Autorizzazione negata)
[Potresti visualizzare questo errore nel file di registro dello stream manager (`aws.greengrass.StreamManager.log`) quando configuri lo stream manager per utilizzare una cartella principale che non esiste o dispone delle autorizzazioni corrette.](stream-manager-component.md) Per ulteriori informazioni su come configurare questa cartella, consulta la [configurazione dello stream manager](stream-manager-component.md#stream-manager-component-configuration).
### com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: La chiave privata o il certificato con etichetta non esiste < >
Questo errore si verifica quando il [componente del provider PKCS \#11](pkcs11-provider-component.md) non riesce a trovare o caricare la chiave privata o il certificato specificato quando si configura il software AWS IoT Greengrass Core per l'utilizzo di un [modulo di sicurezza hardware (HSM](hardware-security.md)). Esegui questa operazione:
+ Verificate che la chiave privata e il certificato siano archiviati nell'HSM utilizzando lo slot, il PIN utente e l'etichetta dell'oggetto che configurate per l'uso del software AWS IoT Greengrass Core.
+ Verificate che la chiave privata e il certificato utilizzino la stessa etichetta dell'oggetto nell'HSM.
+ Se il tuo HSM supporta gli ID degli oggetti, verifica che la chiave privata e il certificato utilizzino lo stesso ID di oggetto nell'HSM.
Consulta la documentazione del tuo HSM per scoprire come richiedere dettagli sui token di sicurezza presenti nell'HSM. Se devi modificare lo slot, l'etichetta dell'oggetto o l'ID dell'oggetto per un token di sicurezza, consulta la documentazione del tuo HSM per scoprire come farlo.
### software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: Utente: l'utente non è autorizzato a eseguire: secretsmanager: on resource: arn < > GetSecretValue < >
Questo errore può verificarsi quando si utilizza il [componente secret manager](secret-manager-component.md) per distribuire un segreto. Gestione dei segreti AWS Se il [ruolo IAM di scambio di token](device-service-role.md) del dispositivo principale non concede l'autorizzazione per ottenere il segreto, l'implementazione fallisce e i log di Greengrass includono questo errore.
**Per autorizzare un dispositivo principale a scaricare un segreto**
1. Aggiungi l'`secretsmanager:GetSecretValue`autorizzazione al ruolo di scambio di token del dispositivo principale. La seguente dichiarazione politica di esempio concede il permesso di ottenere il valore di un segreto.
```
{
"Effect": "Allow",
"Action": [
"secretsmanager:GetSecretValue"
],
"Resource": [
"arn:aws:secretsmanager:us-west-2:123456789012:secret:MyGreengrassSecret-abcdef"
]
}
```
Per ulteriori informazioni, consulta [Autorizza i dispositivi principali a interagire con i servizi AWS](device-service-role.md).
1. Riapplica la distribuzione al dispositivo principale. Esegui una delle seguenti operazioni:
+ Rivedi la distribuzione senza apportare modifiche. Il dispositivo principale tenta di scaricare nuovamente il segreto quando riceve la distribuzione modificata. Per ulteriori informazioni, consulta [Rivedi le distribuzioni](revise-deployments.md).
+ Riavvia il software AWS IoT Greengrass Core per riprovare la distribuzione. Per ulteriori informazioni, consulta [Esegui il software AWS IoT Greengrass Core](run-greengrass-core-v2.md)
La distribuzione ha esito positivo se il gestore segreto scarica il segreto con successo.
### software.amazon.awssdk.services.secretsmanager.model. SecretsManagerException: L'accesso a KMS non è consentito
Questo errore può verificarsi quando si utilizza il [componente Secret Manager](secret-manager-component.md) per distribuire un Gestione dei segreti AWS segreto crittografato da una AWS Key Management Service chiave. Se il [ruolo IAM di scambio di token](device-service-role.md) del dispositivo principale non concede l'autorizzazione per decrittografare il segreto, l'implementazione fallisce e i log di Greengrass includono questo errore.
Per risolvere il problema, aggiungi l'`kms:Decrypt`autorizzazione al ruolo di scambio di token del dispositivo principale. Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [Crittografia e decrittografia segrete nella Guida](https://docs.aws.amazon.com/secretsmanager/latest/userguide/security-encryption.html) *per l'utente Gestione dei segreti AWS *
+ [Autorizza i dispositivi principali a interagire con i servizi AWS](device-service-role.md)
### java.lang. NoClassDefFoundError:// com/awsgreengrass/securityCryptoKeySpi
Potresti visualizzare questo errore quando tenti di installare il software AWS IoT Greengrass Core con [sicurezza hardware](hardware-security.md) e utilizzi una versione precedente di Greengrass nucleus che non supporta l'integrazione della sicurezza hardware. Per utilizzare l'integrazione della sicurezza hardware, è necessario utilizzare Greengrass nucleus v2.5.3 o versione successiva.
### com.aws.greengrass.security.provider.pkcs11. PKCS11CryptoKeyService: CKR\_OPERATION\_NOT\_INITIALIZED
Potresti visualizzare questo errore quando usi la libreria TPM2 quando esegui Core come servizio di sistema. AWS IoT Greengrass
Questo errore indica che è necessario aggiungere una variabile di ambiente che fornisca la posizione dell'archivio PKCS \#11 nel file di servizio AWS IoT Greengrass Core systemd.
Per ulteriori informazioni, consultate la sezione Requisiti della documentazione del [Fornitore PKCS \#11](pkcs11-provider-component.md) componente.
### Dispositivo core Greengrass bloccato su nucleus v2.12.3
Se il dispositivo principale Greengrass non modifica la distribuzione dalla versione Nucleus 2.12.3, potrebbe essere necessario scaricare e sostituire il file `Greengrass.jar` con Greengrass nucleus versione 2.12.2. Esegui questa operazione:
1. Sul tuo dispositivo Greengrass core, esegui il seguente comando per arrestare il software Greengrass Core.
------
#### [ Linux or Unix ]
```
sudo systemctl stop greengrass
```
------
#### [ Windows Command Prompt (CMD) ]
```
sc stop "greengrass"
```
------
#### [ PowerShell ]
```
Stop-Service -Name "greengrass"
```
------
1. Sul tuo dispositivo principale, scarica il AWS IoT Greengrass software in un file denominato. `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. Decomprimi il software AWS IoT Greengrass Core in una cartella sul dispositivo. Sostituiscilo {{GreengrassInstaller}} con la cartella che desideri utilizzare.
------
#### [ 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. Esegui il comando seguente per sovrascrivere il file JAR di nucleus versione 2.12.3 Greengrass con il file JAR Greengrass versione 2.12.2 di nucleus.
------
#### [ 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. Esegui il seguente comando per avviare il software Greengrass Core.
------
#### [ Linux or Unix ]
```
sudo systemctl start greengrass
```
------
#### [ Windows Command Prompt (CMD) ]
```
sc start "greengrass"
```
------
#### [ PowerShell ]
```
Start-Service -Name "greengrass"
```
------
### Problema del modello systemd Greengrass nucleus v2.14.0
Potresti riscontrare questo problema se hai installato Greengrass nucleus v2.14.0 su un dispositivo Linux con il suo modello di servizio systemd predefinito. Esegui questa operazione:
1. Sul tuo dispositivo principale Greengrass, esegui il comando seguente per ripristinare il file di servizio systemd allo stato in cui si trova in nucleus v2.13.0 e versioni precedenti.
------
#### [ 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. Applica le modifiche.
------
#### [ Linux or Unix ]
```
sudo systemctl daemon-reload
sudo systemctl restart greengrass
```
------
## AWS IoT Greengrass problemi relativi al cloud
Utilizza le seguenti informazioni per risolvere i problemi relativi alla AWS IoT Greengrass console e all'API. Ogni voce corrisponde a un messaggio di errore che potresti visualizzare quando esegui un'azione.
### Si è verificato un errore (AccessDeniedException) durante la chiamata dell' CreateComponentVersion operazione: User: arn:aws:iam: < :123456789012:user/ username is not authorized to perform: null >
Potresti visualizzare questo errore quando crei una versione del componente dalla console o con l'operazione. AWS IoT Greengrass [CreateComponentVersion](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateComponentVersion.html)
Questo errore indica che la ricetta non è valida in formato JSON o YAML. Controlla la sintassi della ricetta, risolvi eventuali problemi di sintassi e riprova. Puoi utilizzare un correttore di sintassi JSON o YAML online per identificare i problemi di sintassi nella tua ricetta.
### Inserimento non valido: sono stati rilevati i seguenti errori negli artefatti: {s3 = Impossibile accedere alla risorsa di artefatto specificata} < ArtifactUri >
Potresti visualizzare questo errore quando crei una versione del componente dalla console o con l' AWS IoT Greengrass operazione. [CreateComponentVersion](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateComponentVersion.html) Questo errore indica che un artefatto S3 nella ricetta del componente non è valido.
Esegui questa operazione:
+ Verifica che il bucket S3 si trovi nello stesso Regione AWS punto in cui crei il componente. AWS IoT Greengrass non supporta le richieste interregionali per gli artefatti dei componenti.
+ Verifica che l'URI dell'artefatto sia un URL di oggetto S3 valido e verifica che l'artefatto esista nell'URL dell'oggetto S3.
+ Verifica di disporre dell'autorizzazione per accedere all'artefatto all'URL dell'oggetto S3. Account AWS
### Stato di distribuzione INATTIVO
Potresti ottenere uno stato `INACTIVE` di implementazione quando chiami l'[ListDeployments](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_ListDeployments.html)API senza le AWS IoT politiche dipendenti richieste. È necessario disporre delle autorizzazioni necessarie per ottenere uno stato di distribuzione accurato. Puoi trovare le azioni dipendenti cercando nelle [Azioni definite da AWS IoT Greengrass V2 e seguendo le autorizzazioni](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotgreengrassv2.html#awsiotgreengrassv2-actions-as-permissions) necessarie per. `ListDeployments` Senza le AWS IoT autorizzazioni dipendenti richieste, continuerai a visualizzare lo stato della distribuzione, ma potresti visualizzare uno stato di distribuzione impreciso di. `INACTIVE`
### CreateDeployment restituisce una risposta riuscita ma GetDeployment restituisce un errore 404
È possibile riscontrare questo problema quando si chiama l'[CreateDeployment](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateDeployment.html)operazione per la distribuzione su un AWS IoT oggetto o un gruppo di oggetti. La `CreateDeployment` chiamata restituisce un codice di `200` stato con un ID di distribuzione valido. Tuttavia, quando chiami [GetDeployment](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_GetDeployment.html)con quell'ID di distribuzione, ricevi un `ResourceNotFoundException` errore. La AWS IoT Greengrass console mostra una pagina «Distribuzione non trovata» per l'URL di distribuzione. La distribuzione precedente per la destinazione potrebbe inoltre mostrare uno `INACTIVE` stato senza alcuna sostituzione.
Questo problema può verificarsi quando più `CreateDeployment` richieste hanno come obiettivo la stessa AWS IoT cosa contemporaneamente. Una condizione di gara può impedire al cloud di registrare l'implementazione. Il dispositivo principale continua a ricevere e applicare la distribuzione tramite l'ombra del AWS IoT dispositivo, ma il servizio AWS IoT Greengrass cloud non ne ha traccia. Una volta che si è verificato questo problema, potrebbe influire anche sulle distribuzioni successive sullo stesso obiettivo.
Effettua le seguenti operazioni per risolvere e prevenire questo problema:
+ Evita di inviare `CreateDeployment` richieste simultanee che hanno come obiettivo lo stesso AWS IoT oggetto. Serializza le richieste di distribuzione o aggiungi un ritardo tra di esse per garantire che solo una `CreateDeployment` chiamata abbia come obiettivo una cosa specifica alla volta.
+ Se questo problema riguarda già l'obiettivo, le distribuzioni successive potrebbero continuare a restituire errori 404. Per risolvere il problema, elimina il record di distribuzione non aggiornato per la destinazione interessata in modo che la distribuzione successiva possa procedere normalmente.
## Problemi principali di distribuzione dei dispositivi
Risolvi i problemi di distribuzione sui dispositivi core Greengrass. Ogni voce corrisponde a un messaggio di registro che potresti visualizzare sul tuo dispositivo principale.
**Topics**
+ [Errore: com.aws.greengrass.componentmanager.exceptions. PackageDownloadException: Impossibile scaricare l'artefatto](#core-error-failed-to-download-artifact-package-download-exception)
+ [Errore: com.aws.greengrass.componentmanager.exceptions. ArtifactChecksumMismatchException: controllo di integrità per l'elemento scaricato non riuscito. Probabilmente a causa del danneggiamento del file.](#core-error-failed-to-download-artifact-checksum-mismatch-exception)
+ [Errore: com.aws.greengrass.componentmanager.exceptions. NoAvailableComponentVersionException: impossibile negoziare la versione del nome del componente con il cloud e nessuna versione locale applicabile che soddisfi i requisiti dei requisiti < > < >](#core-error-no-available-component-version)
+ [software.amazon.awssdk.services.greengrassv2data.model. ResourceNotFoundException: L'ultima versione di Component componentName non rivendica la compatibilità dei componenti principali della piattaforma < > < DevicePlatform >](#deployment-error-no-platform-compatibility)
+ [com.aws.greengrass.componentmanager.exceptions. PackagingException: La distribuzione tenta di aggiornare il nucleo dalla versione aws.GreenGrass.Nucleus- alla versione aws.GreenGrass.NUCLEUS- ma nessun componente di tipo nucleus è stato incluso come componente di destinazione < > < >](#deployment-error-nucleus-minor-version-update)
+ [Errore: com.aws.greengrass.deployment.exceptions. DeploymentException: impossibile elaborare la distribuzione. La directory di avvio di Greengrass non è configurata o Greengrass non è configurata come servizio di sistema](#deployment-error-unable-to-process-deployment)
+ [Informazioni: com.aws.greengrass.deployment.exceptions. RetryableDeploymentDocumentDownloadException: Greengrass Cloud Service ha restituito un errore durante la configurazione completa della distribuzione](#core-error-getting-full-deployment-configuration)
+ [Avviso: com.aws.greengrass.deployment. DeploymentService: Impossibile ottenere la gerarchia dei gruppi di oggetti](#core-warning-failed-to-get-thing-group-hierarchy)
+ [Informazioni: com.aws.greengrass.deployment. DeploymentDocumentDownloader: Chiamata a Greengrass cloud per ottenere una configurazione di distribuzione completa](#core-info-repetitive-get-full-deployment-configuration)
+ [Causato da: software.amazon.awssdk.services.greengrassv2data.model. GreengrassV2DataException: null (Servizio: GreengrassV2Data, Codice di stato: 403, ID richiesta: some\_request\_id, ID richiesta estesa: null) < >](#greengrassv2dataexception)
### Errore: com.aws.greengrass.componentmanager.exceptions. PackageDownloadException: Impossibile scaricare l'artefatto
Potresti visualizzare questo errore quando il software AWS IoT Greengrass Core non riesce a scaricare un elemento del componente quando il dispositivo principale applica una distribuzione. La distribuzione non riesce a causa di questo errore.
Quando si riceve questo errore, il registro include anche una traccia dello stack che è possibile utilizzare per identificare il problema specifico. Ciascuna delle seguenti voci corrisponde a un messaggio che è possibile visualizzare nello stack trace del messaggio di `Failed to download artifact` errore.
**Topics**
+ [software.amazon.awssdk.services.s3.model.s3Exception: null (Servizio: S3, Codice di stato: 403, ID richiesta: null,...)](#core-error-failed-to-download-artifact-s3-permissions)
+ [software.amazon.awssdk.services.s3.model.S3Exception: accesso negato (servizio: S3, codice di stato: 403, ID richiesta: requestID) < >](#core-error-failed-to-download-artifact-get-bucket-location-403)
#### software.amazon.awssdk.services.s3.model.s3Exception: null (Servizio: S3, Codice di stato: 403, ID richiesta: null,...)
L'errore potrebbe includere questa traccia dello [PackageDownloadException stack](#core-error-failed-to-download-artifact-package-download-exception) nei seguenti casi:
+ L'elemento del componente non è disponibile all'URL dell'oggetto S3 specificato nella ricetta del componente. Verifica di aver caricato l'artefatto nel bucket S3 e che l'URI dell'artefatto corrisponda all'URL dell'oggetto S3 dell'artefatto nel bucket.
+ Il [ruolo di scambio di token](device-service-role.md) del dispositivo principale non consente al software AWS IoT Greengrass Core di scaricare l'elemento del componente dall'URL dell'oggetto S3 specificato nella ricetta del componente. Verifica che il ruolo di scambio di token `s3:GetObject` consenta l'URL dell'oggetto S3 in cui è disponibile l'artefatto.
#### software.amazon.awssdk.services.s3.model.S3Exception: accesso negato (servizio: S3, codice di stato: 403, ID richiesta: requestID) < >
[L'errore potrebbe includere questa traccia dello stack quando PackageDownloadException il dispositivo principale non è autorizzato a chiamare.](#core-error-failed-to-download-artifact-package-download-exception) `s3:GetBucketLocation` Il messaggio di errore include anche il seguente messaggio.
```
reason: Failed to determine S3 bucket location
```
Verifica che il [ruolo di scambio di token](device-service-role.md) del dispositivo principale consenta `s3:GetBucketLocation` il bucket S3 in cui è disponibile l'artefatto.
### Errore: com.aws.greengrass.componentmanager.exceptions. ArtifactChecksumMismatchException: controllo di integrità per l'elemento scaricato non riuscito. Probabilmente a causa del danneggiamento del file.
Potresti visualizzare questo errore quando il software AWS IoT Greengrass Core non riesce a scaricare un elemento del componente quando il dispositivo principale applica una distribuzione. La distribuzione non riesce perché il checksum del file di artefatto scaricato non corrisponde al checksum AWS IoT Greengrass calcolato al momento della creazione del componente.
Esegui questa operazione:
+ Controlla se il file degli artefatti è cambiato nel bucket S3 in cui lo ospiti. Se il file è cambiato dopo la creazione del componente, ripristinalo alla versione precedente prevista dal dispositivo principale. Se non riesci a ripristinare il file alla versione precedente o se desideri utilizzare la nuova versione del file, crea una nuova versione del componente con il file dell'artefatto.
+ Controlla la connessione Internet del tuo dispositivo principale. Questo errore può verificarsi se il file dell'artefatto viene danneggiato durante il download. Crea una nuova distribuzione e riprova.
### Errore: com.aws.greengrass.componentmanager.exceptions. NoAvailableComponentVersionException: impossibile negoziare la versione del nome del componente con il cloud e nessuna versione locale applicabile che soddisfi i requisiti dei requisiti < > < >
Potresti visualizzare questo errore quando un dispositivo principale non riesce a trovare una versione del componente che soddisfi i requisiti delle distribuzioni per quel dispositivo principale. Il dispositivo principale verifica la presenza del componente nel AWS IoT Greengrass servizio e sul dispositivo locale. Il messaggio di errore include la destinazione di ogni distribuzione e i requisiti di versione di tale distribuzione per il componente. L'obiettivo di distribuzione può essere un oggetto, un gruppo di oggetti o`LOCAL_DEPLOYMENT`, che rappresenta la distribuzione locale sul dispositivo principale.
Questo problema può verificarsi nei seguenti casi:
+ Il dispositivo principale è l'obiettivo di più distribuzioni con requisiti di versione dei componenti in conflitto. Ad esempio, il dispositivo principale potrebbe essere l'obiettivo di più distribuzioni che includono un `com.example.HelloWorld` componente, in cui una distribuzione richiede la versione 1.0.0 e l'altra richiede la versione 1.0.1. È impossibile avere un componente che soddisfi entrambi i requisiti, quindi l'implementazione non riesce.
+ La versione del componente non esiste nel AWS IoT Greengrass servizio o nel dispositivo locale. Il componente potrebbe essere stato eliminato, ad esempio.
+ Esistono versioni dei componenti che soddisfano i requisiti di versione, ma nessuna è compatibile con la piattaforma del dispositivo principale.
+ La AWS IoT politica del dispositivo principale non concede l'`greengrass:ResolveComponentCandidates`autorizzazione. Cerca `Status Code: 403` nel registro degli errori per identificare il problema. Per risolvere il problema, aggiungi l'`greengrass:ResolveComponentCandidates`autorizzazione alla AWS IoT politica principale del dispositivo. Per ulteriori informazioni, consulta [AWS IoT Politica minima per i dispositivi AWS IoT Greengrass V2 principali](device-auth.md#greengrass-core-minimal-iot-policy).
Per risolvere questo problema, rivedi le distribuzioni per includere le versioni dei componenti compatibili o rimuovere quelle incompatibili. Per ulteriori informazioni su come rivedere le distribuzioni cloud, consulta. [Rivedi le distribuzioni](revise-deployments.md) Per ulteriori informazioni su come rivedere le distribuzioni locali, consulta il comando [AWS IoT Greengrass CLI](gg-cli-deployment.md#deployment-create) deployment create.
### software.amazon.awssdk.services.greengrassv2data.model. ResourceNotFoundException: L'ultima versione di Component componentName non rivendica la compatibilità dei componenti principali della piattaforma < > < DevicePlatform >
Potresti visualizzare questo errore quando distribuisci un componente su un dispositivo principale e il componente non elenca una piattaforma compatibile con la piattaforma del dispositivo principale. Esegui una delle seguenti operazioni:
+ Se il componente è un componente Greengrass personalizzato, puoi aggiornarlo per renderlo compatibile con il dispositivo principale. Aggiungi un nuovo manifesto che corrisponda alla piattaforma del dispositivo principale o aggiorna un manifesto esistente in modo che corrisponda alla piattaforma del dispositivo principale. Per ulteriori informazioni, consulta [AWS IoT Greengrass riferimento alla ricetta del componente](component-recipe-reference.md).
+ Se il componente è fornito da AWS, controlla se un'altra versione del componente è compatibile con il dispositivo principale. Se nessuna versione è compatibile, contattaci [AWS re:Post](https://repost.aws/)utilizzando il [AWS IoT Greengrass tag](https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass) o contattaci [Supporto](https://aws.amazon.com/contact-us/).
### com.aws.greengrass.componentmanager.exceptions. PackagingException: La distribuzione tenta di aggiornare il nucleo dalla versione aws.GreenGrass.Nucleus- alla versione aws.GreenGrass.NUCLEUS- ma nessun componente di tipo nucleus è stato incluso come componente di destinazione < > < >
Potresti visualizzare questo errore quando distribuisci un componente che dipende dal nucleo di [Greengrass](greengrass-nucleus-component.md) e il dispositivo principale esegue una versione di Greengrass nucleus precedente all'ultima versione secondaria disponibile. Questo errore si verifica perché il software AWS IoT Greengrass Core tenta di aggiornare automaticamente i componenti all'ultima versione compatibile. Tuttavia, il software AWS IoT Greengrass Core impedisce l'aggiornamento del nucleo Greengrass a una nuova versione secondaria, poiché diversi componenti AWS forniti dipendono da versioni minori specifiche del nucleo Greengrass. Per ulteriori informazioni, consulta [Comportamento dell'aggiornamento del nucleo di Greengrass](update-greengrass-core-v2.md#ota-update-behavior-nucleus).
È necessario [modificare la distribuzione](revise-deployments.md) per specificare la versione di Greengrass nucleus che si desidera utilizzare. Esegui una delle seguenti operazioni:
+ Rivedi la distribuzione per specificare la versione Greengrass nucleus attualmente in esecuzione sul dispositivo principale.
+ Rivedi la distribuzione per specificare una versione secondaria successiva del nucleo Greengrass. Se si sceglie questa opzione, è necessario aggiornare anche le versioni di tutti i componenti AWS forniti che dipendono da specifiche versioni secondarie del nucleo Greengrass. Per ulteriori informazioni, consulta [AWS-componenti forniti](public-components.md).
### Errore: com.aws.greengrass.deployment.exceptions. DeploymentException: impossibile elaborare la distribuzione. La directory di avvio di Greengrass non è configurata o Greengrass non è configurata come servizio di sistema
Potresti visualizzare questo errore quando sposti un dispositivo Greengrass da un gruppo di oggetti a un altro e poi di nuovo al gruppo originale con distribuzioni che richiedono il riavvio di Greengrass.
Per risolvere questo problema, ricrea la directory di avvio del dispositivo. Raccomandiamo inoltre vivamente l'aggiornamento alla versione 2.9.6 o successiva del nucleo Greengrass.
Quello che segue è uno script Linux per ricreare la directory di avvio. Salva lo script in un file chiamato`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
```
Per eseguire lo script, esegui il seguente comando:
```
[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
```
### Informazioni: com.aws.greengrass.deployment.exceptions. RetryableDeploymentDocumentDownloadException: Greengrass Cloud Service ha restituito un errore durante la configurazione completa della distribuzione
Potresti visualizzare questo errore quando il dispositivo principale riceve un documento di distribuzione di grandi dimensioni, ovvero un documento di distribuzione di dimensioni superiori a 7 KB (per le distribuzioni destinate a oggetti) o 31 KB (per le distribuzioni destinate a gruppi di oggetti). Per recuperare un documento di distribuzione di grandi dimensioni, la AWS IoT policy di un dispositivo principale deve consentire l'autorizzazione. `greengrass:GetDeploymentConfiguration` Questo errore può verificarsi quando il dispositivo principale non dispone di questa autorizzazione. Quando si verifica questo errore, la distribuzione riprova a tempo indeterminato e lo stato è **In corso** ()`IN_PROGRESS`.
Per risolvere questo problema, aggiungi l'`greengrass:GetDeploymentConfiguration`autorizzazione alla politica del AWS IoT dispositivo principale. Per ulteriori informazioni, consulta [Aggiorna la politica di un dispositivo principale AWS IoT](device-auth.md#update-core-device-iot-policy).
### Avviso: com.aws.greengrass.deployment. DeploymentService: Impossibile ottenere la gerarchia dei gruppi di oggetti
Potresti visualizzare questo avviso quando il dispositivo principale riceve una distribuzione e la AWS IoT politica del dispositivo principale non consente l'`greengrass:ListThingGroupsForCoreDevice`autorizzazione. Quando si crea una distribuzione, il dispositivo principale utilizza questa autorizzazione per identificare i propri gruppi di oggetti e rimuovere i componenti di qualsiasi gruppo di oggetti da cui è stato rimosso il dispositivo principale. Se il dispositivo principale esegue [Greengrass nucleus](greengrass-nucleus-component.md) v2.5.0, la distribuzione non riesce. Se il dispositivo principale esegue Greengrass nucleus v2.5.1 o versione successiva, la distribuzione procede ma non rimuove i componenti. Per ulteriori informazioni sul comportamento di rimozione dei gruppi di oggetti, vedere. [Implementazione AWS IoT Greengrass dei componenti sui dispositivi](manage-deployments.md)
Per aggiornare il comportamento del dispositivo principale in modo da rimuovere i componenti per i gruppi di oggetti da cui rimuovi il dispositivo principale, aggiungi l'`greengrass:ListThingGroupsForCoreDevice`autorizzazione alla AWS IoT politica del dispositivo principale. Per ulteriori informazioni, consulta [Aggiorna la politica di un dispositivo principale AWS IoT](device-auth.md#update-core-device-iot-policy).
### Informazioni: com.aws.greengrass.deployment. DeploymentDocumentDownloader: Chiamata a Greengrass cloud per ottenere una configurazione di distribuzione completa
È possibile che questo messaggio informativo venga stampato più volte senza errori, poiché il dispositivo principale registra l'errore a livello di `DEBUG` registro. Questo problema può verificarsi quando il dispositivo principale riceve un documento di distribuzione di grandi dimensioni. Quando si verifica questo problema, la distribuzione riprova a tempo indeterminato e lo stato è **In corso** ()`IN_PROGRESS`. Per ulteriori informazioni su come risolvere questo problema, consulta [questa voce sulla risoluzione dei problemi](#core-error-getting-full-deployment-configuration).
### Causato da: software.amazon.awssdk.services.greengrassv2data.model. GreengrassV2DataException: null (Servizio: GreengrassV2Data, Codice di stato: 403, ID richiesta: some\_request\_id, ID richiesta estesa: null) < >
Potresti visualizzare questo errore quando un'API dataplane non dispone dell'autorizzazione. `iot:Connect` Se non disponi della politica corretta, riceverai un. `GreengrassV2DataException: 403` Per creare una politica di autorizzazione, segui queste istruzioni:[Crea una politica AWS IoT](fleet-provisioning-setup.md#create-iot-policy).
## Problemi principali relativi ai componenti del dispositivo
Risolvi i problemi relativi ai componenti Greengrass sui dispositivi principali.
**Topics**
+ [Avviso: il '' non è riconosciuto come comando interno o esterno](#component-warn-command-not-recognized)
+ [Lo script Python non registra i messaggi](#python-component-no-log-output)
+ [La configurazione dei componenti non si aggiorna quando si modifica la configurazione predefinita](#update-component-configuration-to-default-configuration)
+ [awsiot.greengrasscoreipc.model. UnauthorizedError](#ipc-unauthorized-error)
+ [com.aws.greengrass.authorization.exceptions. AuthorizationException: ID di policy duplicato "id" per il principale "ComponentList» < > < >](#ipc-duplicate-authorization-policy-ids)
+ [com.aws.greengrass.tes. CredentialRequestHandler: Errore nel recupero da TES (HTTP 400) AwsCredentials](#token-exchange-service-credentials-http-400)
+ [com.aws.greengrass.tes. CredentialRequestHandler: Errore nel recupero da TES (HTTP 403) AwsCredentials](#token-exchange-service-credentials-http-403)
+ [com.aws.greengrass.tes. CredentialsProviderError: Impossibile caricare le credenziali di alcun provider](#token-exchange-service-credentials-provider-error)
+ [Errore ricevuto durante il tentativo di recuperare i metadati ECS: impossibile connettersi all'URL dell'endpoint: "token» < ExchangeServiceEndpoint >](#token-exchange-service-not-running)
+ [copyFrom: < > ConfigurationPath è già un contenitore, non una foglia](#configuration-key-is-container-cannot-become-leaf)
+ [com.aws.greengrass.componentmanager.plugins.docker.exceptions. DockerLoginException: Errore durante l'accesso al registro utilizzando le credenziali: «Lo stub ha ricevuto dati errati».](#docker-login-stub-received-bad-data)
+ [java.io.IOException: Impossibile eseguire il programma «cmd»...: [LogonUser] La password per questo account è scaduta.](#windows-account-password-expired)
+ [aws.greengrass. StreamManager: Instant supera l'istante minimo o massimo](#stream-manager-instant-exceeds-maximun-minimum)
### Avviso: il '' non è riconosciuto come comando interno o esterno
Potresti visualizzare questo errore nei log di un componente Greengrass quando il software AWS IoT Greengrass Core non riesce a eseguire un comando nello script del ciclo di vita del componente. Lo stato del componente diventa il risultato `BROKEN` di questo errore. Questo errore può verificarsi se l'utente di sistema che esegue il componente, ad esempio`ggc_user`, non riesce a trovare l'eseguibile del comando nelle cartelle del [PATH](https://en.wikipedia.org/wiki/PATH_(variable)).
Sui dispositivi Windows, verifica che la cartella che contiene l'eseguibile sia disponibile `PATH` per l'utente di sistema che esegue il componente. Se non è presente in`PATH`, esegui una delle seguenti operazioni:
+ Aggiungi la cartella dell'eseguibile alla variabile di `PATH` sistema, che è disponibile per tutti gli utenti. Quindi, riavvia il componente.
Se si esegue Greengrass nucleus 2.5.0, dopo aver aggiornato la variabile di `PATH` sistema, è necessario riavviare il software AWS IoT Greengrass Core per eseguire i componenti con la versione aggiornata. `PATH` Se il software AWS IoT Greengrass Core non utilizza la versione aggiornata `PATH` dopo il riavvio del software, riavvia il dispositivo e riprova. Per ulteriori informazioni, consulta [Esegui il software AWS IoT Greengrass Core](run-greengrass-core-v2.md).
+ Aggiungi la cartella dell'eseguibile alla variabile `PATH` utente per l'utente di sistema che esegue il componente.
### Lo script Python non registra i messaggi
I dispositivi core Greengrass raccolgono registri che puoi utilizzare per identificare problemi con i componenti. Se gli script `stdout` e i `stderr` messaggi Python non compaiono nei log dei componenti, potrebbe essere necessario svuotare il buffer o disabilitare il buffer per questi flussi di output standard in Python. Effettua una delle seguenti operazioni:
+ Esegui Python con l'argomento [-u](https://docs.python.org/3/using/cmdline.html#cmdoption-u) per disabilitare il buffering su and. `stdout` `stderr`
------
#### [ Linux or Unix ]
```
python3 -u hello_world.py
```
------
#### [ Windows ]
```
py -3 -u hello_world.py
```
------
+ Usa [Setenv](component-recipe-reference.md#lifecycle-setenv-definition) nella ricetta del tuo componente per impostare la variabile di ambiente [PYTHONUNBUFFERED](https://docs.python.org/3/using/cmdline.html#envvar-PYTHONUNBUFFERED) su una stringa non vuota. Questa variabile di ambiente disabilita il buffering su and. `stdout` `stderr`
+ Svuota il buffer per i flussi or. `stdout` `stderr` Esegui una delle seguenti operazioni:
+ Svuota un messaggio quando stampi.
```
import sys
print('Hello, error!', file=sys.stderr, flush=True)
```
+ Svuota un messaggio dopo la stampa. Puoi inviare più messaggi prima di scaricare lo stream.
```
import sys
print('Hello, error!', file=sys.stderr)
sys.stderr.flush()
```
Per ulteriori informazioni su come verificare che lo script Python emetta messaggi di log, vedere. [Monitora AWS IoT Greengrass i registri](monitor-logs.md)
### La configurazione dei componenti non si aggiorna quando si modifica la configurazione predefinita
Quando si modifica la `DefaultConfiguration` ricetta di un componente, la nuova configurazione predefinita non sostituirà la configurazione esistente del componente durante una distribuzione. Per applicare la nuova configurazione predefinita, è necessario ripristinare la configurazione del componente alle impostazioni predefinite. Quando distribuisci il componente, specifica una singola stringa vuota come [aggiornamento di ripristino](update-component-configurations.md#reset-configuration-update).
------
#### [ Console ]
**Reimposta i percorsi**
```
[""]
```
------
#### [ AWS CLI ]
Il comando seguente crea una distribuzione su un dispositivo principale.
```
aws greengrassv2 create-deployment --cli-input-json file://reset-configuration-deployment.json
```
Il `reset-configuration-deployment.json` file contiene il seguente documento JSON.
```
{
"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 ]
Il seguente comando [Greengrass CLI](greengrass-cli-component.md) crea una distribuzione locale su un dispositivo principale.
```
sudo greengrass-cli deployment create \
--recipeDir recipes \
--artifactDir artifacts \
--merge "com.example.HelloWorld=1.0.0" \
--update-config reset-configuration-deployment.json
```
Il `reset-configuration-deployment.json` file contiene il seguente documento JSON.
```
{
"com.example.HelloWorld": {
"RESET": [""]
}
}
```
------
### awsiot.greengrasscoreipc.model. UnauthorizedError
Potresti visualizzare questo errore nei log di un componente Greengrass quando il componente non dispone dell'autorizzazione per eseguire un'operazione IPC su una risorsa. Per concedere a un componente l'autorizzazione a chiamare un'operazione IPC, definite una politica di autorizzazione IPC nella configurazione del componente. Per ulteriori informazioni, consulta [Autorizza i componenti a eseguire operazioni IPC](interprocess-communication.md#ipc-authorization-policies).
**Suggerimento**
Se modificate la `DefaultConfiguration` ricetta di un componente, dovete ripristinare la configurazione del componente alla nuova configurazione predefinita. Quando distribuite il componente, specificate una singola stringa vuota come [aggiornamento di ripristino](update-component-configurations.md#reset-configuration-update). Per ulteriori informazioni, consulta [La configurazione dei componenti non si aggiorna quando si modifica la configurazione predefinita](#update-component-configuration-to-default-configuration).
### com.aws.greengrass.authorization.exceptions. AuthorizationException: ID di policy duplicato "id" per il principale "ComponentList» < > < >
Potresti visualizzare questo errore se più politiche di autorizzazione IPC, incluse tutte le componenti del dispositivo principale, utilizzano lo stesso ID di policy.
Controlla le politiche di autorizzazione IPC dei tuoi componenti, correggi eventuali duplicati e riprova. Per creare ID di policy univoci, ti consigliamo di combinare il nome del componente, il nome del servizio IPC e un contatore. Per ulteriori informazioni, consulta [Autorizza i componenti a eseguire operazioni IPC](interprocess-communication.md#ipc-authorization-policies).
**Suggerimento**
Se si modifica la `DefaultConfiguration` ricetta di un componente, è necessario ripristinare la configurazione del componente alla nuova configurazione predefinita. Quando distribuite il componente, specificate una singola stringa vuota come [aggiornamento di ripristino](update-component-configurations.md#reset-configuration-update). Per ulteriori informazioni, consulta [La configurazione dei componenti non si aggiorna quando si modifica la configurazione predefinita](#update-component-configuration-to-default-configuration).
### com.aws.greengrass.tes. CredentialRequestHandler: Errore nel recupero da TES (HTTP 400) AwsCredentials
Potresti visualizzare questo errore quando un dispositivo principale non riesce a ottenere AWS le credenziali dal servizio di scambio di [token](interact-with-aws-services.md). Il codice di stato HTTP 400 indica che questo errore si è verificato perché il [ruolo IAM per lo scambio di token](device-service-role.md) del dispositivo principale non esiste o non esiste una relazione di fiducia che consenta al provider di AWS IoT credenziali di assumerlo.
Esegui questa operazione:
1. Identifica il ruolo di scambio di token utilizzato dal dispositivo principale. Il messaggio di errore include l'alias del AWS IoT ruolo del dispositivo principale, che rimanda al ruolo di scambio di token. Esegui il comando seguente sul tuo computer di sviluppo e sostituiscilo {{MyGreengrassCoreTokenExchangeRoleAlias}} con il nome dell'alias di AWS IoT ruolo contenuto nel messaggio di errore.
```
aws iot describe-role-alias --role-alias {{MyGreengrassCoreTokenExchangeRoleAlias}}
```
La risposta include l'Amazon Resource Name (ARN) del ruolo IAM per lo scambio di token.
```
{
"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. Verifica che il ruolo esista. Esegui il comando seguente e sostituiscilo {{MyGreengrassV2TokenExchangeRole}} con il nome del ruolo di scambio di token.
```
aws iam get-role --role-name {{MyGreengrassV2TokenExchangeRole}}
```
Se il comando restituisce un `NoSuchEntity` errore, il ruolo non esiste e devi crearlo. Per ulteriori informazioni su come creare e configurare questo ruolo, vedere[Autorizza i dispositivi principali a interagire con i servizi AWS](device-service-role.md).
1. Verifica che il ruolo abbia una relazione di fiducia che consenta al fornitore delle AWS IoT credenziali di assumerlo. La risposta del passaggio precedente contiene un`AssumeRolePolicyDocument`, che definisce le relazioni di fiducia del ruolo. Il ruolo deve definire una relazione di fiducia che `credentials.iot.amazonaws.com` consenta di assumerlo. Questo documento dovrebbe essere simile all'esempio seguente.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "credentials.iot.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
Se le relazioni di fiducia del ruolo non `credentials.iot.amazonaws.com` consentono di assumerlo, è necessario aggiungere questa relazione di fiducia al ruolo. Per ulteriori informazioni, consulta [Modifica di un ruolo](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) nella *AWS Identity and Access Management Guida per l'utente di IAM*.
### com.aws.greengrass.tes. CredentialRequestHandler: Errore nel recupero da TES (HTTP 403) AwsCredentials
[Potresti visualizzare questo errore quando un dispositivo principale non riesce a ottenere AWS le credenziali dal servizio di scambio di token.](interact-with-aws-services.md) Il codice di stato HTTP 403 indica che questo errore si è verificato perché le AWS IoT politiche del dispositivo principale non concedono l'`iot:AssumeRoleWithCertificate`autorizzazione per l'alias di AWS IoT ruolo del dispositivo principale.
Esamina AWS IoT le politiche del dispositivo principale e aggiungi l'`iot:AssumeRoleWithCertificate`autorizzazione per l'alias di AWS IoT ruolo del dispositivo principale. Il messaggio di errore include l'alias del AWS IoT ruolo corrente del dispositivo principale. Per ulteriori informazioni su questa autorizzazione e su come aggiornare le AWS IoT politiche del dispositivo principale, consulta [AWS IoT Politica minima per i dispositivi AWS IoT Greengrass V2 principali](device-auth.md#greengrass-core-minimal-iot-policy) e[Aggiorna la politica di un dispositivo principale AWS IoT](device-auth.md#update-core-device-iot-policy).
### com.aws.greengrass.tes. CredentialsProviderError: Impossibile caricare le credenziali di alcun provider
Potresti visualizzare questo errore quando il componente tenta di richiedere le AWS credenziali e non riesce a connettersi al servizio di [scambio di token](interact-with-aws-services.md).
Esegui questa operazione:
+ Verifica che il componente dichiari una dipendenza dal componente del servizio di scambio di token,. `aws.greengrass.TokenExchangeService` In caso contrario, aggiungi la dipendenza e ridistribuisci il componente.
+ Se il componente viene eseguito in docker, assicurati di applicare le impostazioni di rete e le variabili di ambiente corrette, in base a. [Usa AWS le credenziali nei componenti del contenitore Docker (Linux)](run-docker-container.md#docker-container-token-exchange-service)
+ [Se il componente è scritto in NodeJS, imposta dns.set su. DefaultResultOrder](https://nodejs.org/docs/latest/api/dns.html#dnssetdefaultresultorderorder) **ipv4first**
+ `/etc/hosts`Cerca una voce che inizi con e contenga. `::1` `localhost` Rimuovi la voce per vedere se ha causato la connessione del componente al servizio di scambio di token all'indirizzo sbagliato.
### Errore ricevuto durante il tentativo di recuperare i metadati ECS: impossibile connettersi all'URL dell'endpoint: "token» < ExchangeServiceEndpoint >
Potresti visualizzare questo errore quando il componente non esegue il [servizio di scambio di token](interact-with-aws-services.md) e un componente tenta di richiedere le credenziali. AWS
Esegui questa operazione:
+ Verifica che il componente dichiari una dipendenza dal componente del servizio di scambio di token,. `aws.greengrass.TokenExchangeService` In caso contrario, aggiungi la dipendenza e ridistribuisci il componente.
+ Verifica se il componente utilizza le AWS credenziali nel suo ciclo di vita. `install` AWS IoT Greengrass non garantisce la disponibilità del servizio di scambio di token durante il ciclo di vita. `install` Aggiorna il componente per spostare il codice che utilizza AWS le credenziali nel `run` ciclo di vita `startup` o, quindi ridistribuisci il componente.
### copyFrom: < > ConfigurationPath è già un contenitore, non una foglia
Potresti visualizzare questo errore quando modifichi un valore di configurazione da un tipo di contenitore (un elenco o un oggetto) a un tipo non contenitore (una stringa, un numero o un valore booleano). Esegui questa operazione:
1. Controlla la ricetta del componente per vedere se la sua configurazione predefinita imposta quel valore di configurazione su un elenco o un oggetto. In tal caso, rimuovi o modifica quel valore di configurazione.
1. Crea una distribuzione per ripristinare il valore di configurazione al valore predefinito. Per ulteriori informazioni, consultare [Creare distribuzione](create-deployments.md) e [Aggiornamento delle configurazioni dei componenti](update-component-configurations.md).
Quindi, puoi impostare quel valore di configurazione su una stringa, un numero o un valore booleano.
### com.aws.greengrass.componentmanager.plugins.docker.exceptions. DockerLoginException: Errore durante l'accesso al registro utilizzando le credenziali: «Lo stub ha ricevuto dati errati».
Potresti visualizzare questo errore nei registri del nucleo di Greengrass quando il [componente Docker Application Manager tenta di scaricare un'immagine Docker](docker-application-manager-component.md) da un repository privato in Amazon Elastic Container Registry (Amazon ECR). [Questo errore si verifica se si utilizza l'helper per le credenziali Docker (). `wincred`](https://github.com/docker/docker-credential-helpers) `docker-credential-wincred` Di conseguenza, Amazon ECR non è in grado di memorizzare le credenziali di accesso.
Esegui una delle seguenti azioni:
+ Se non usi l'helper per le credenziali `wincred` Docker, rimuovi il `docker-credential-wincred` programma dal dispositivo principale.
+ Se usi l'helper per le credenziali `wincred` Docker, procedi come segue:
1. Rinomina il `docker-credential-wincred` programma sul dispositivo principale. `wincred`Sostituiscilo con un nuovo nome per l'helper delle credenziali di Windows Docker. Ad esempio, puoi rinominarlo in. `docker-credential-wincredreal`
1. Aggiorna l'`credsStore`opzione nel file di configurazione Docker (`.docker/config.json`) per utilizzare il nuovo nome per l'helper delle credenziali di Windows Docker. Ad esempio, se hai rinominato il programma in`docker-credential-wincredreal`, aggiorna l'opzione in. `credsStore` `wincredreal`
```
{
"credsStore": "{{wincredreal}}"
}
```
### java.io.IOException: Impossibile eseguire il programma «cmd»...: [LogonUser] La password per questo account è scaduta.
Potresti visualizzare questo errore su un dispositivo Windows Core quando l'utente di sistema che esegue i processi del componente, ad esempio, ha una password scaduta. `ggc_user` Di conseguenza, il software AWS IoT Greengrass Core non è in grado di eseguire i processi dei componenti come utente del sistema.
**Per aggiornare la password di un utente del sistema Greengrass**
1. Esegui il seguente comando come amministratore per impostare la password dell'utente. Sostituiscilo {{ggc\_user}} con l'utente di sistema e sostituiscilo {{password}} con la password da impostare.
```
net user {{ggc_user}} {{password}}
```
1. Utilizzate l'[PsExec utilità](https://docs.microsoft.com/en-us/sysinternals/downloads/psexec) per memorizzare la nuova password dell'utente nell'istanza di Credential Manager per l' LocalSystem account. Sostituiscila {{password}} con la password dell'utente che hai impostato.
```
psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password
```
**Suggerimento**
A seconda della configurazione di Windows, la password dell'utente potrebbe essere impostata per scadere in date future. Per garantire che le tue applicazioni Greengrass continuino a funzionare, tieni traccia della scadenza della password e aggiornala prima che scada. Puoi anche impostare la password dell'utente in modo che non scada mai.
Per verificare la scadenza di un utente e della relativa password, esegui il comando seguente.
```
net user {{ggc_user}} | findstr /C:expires
```
Per impostare la password di un utente in modo che non scada mai, esegui il comando seguente.
```
wmic UserAccount where "Name='{{ggc_user}}'" set PasswordExpires=False
```
Se utilizzi Windows 10 o versioni successive in cui il [`wmic`comando è obsoleto, esegui il comando](https://learn.microsoft.com/en-us/windows/win32/wmisdk/wmic) seguente. PowerShell
```
Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = '{{ggc_user}}'" | Set-CimInstance -Property @{PasswordExpires="False"}
```
### aws.greengrass. StreamManager: Instant supera l'istante minimo o massimo
Quando aggiorni stream manager v2.0.7 a una versione compresa tra v2.0.8 e v2.0.11, potresti visualizzare il seguente errore nei log del componente stream manager se il componente non si avvia.
```
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}
```
Se hai distribuito stream manager v2.0.7 e desideri eseguire l'aggiornamento a una versione successiva, devi eseguire l'aggiornamento direttamente a stream manager v2.0.12. Per ulteriori informazioni sul componente stream manager, consulta. [Stream manager](stream-manager-component.md)
## Problemi relativi ai componenti della funzione Lambda del dispositivo principale
Risolvi i problemi relativi ai componenti della funzione Lambda sui dispositivi principali.
**Topics**
+ [I seguenti sottosistemi cgroup non sono montati: dispositivi, memoria](#lambda-cgroups-not-mounted)
+ [ipc\_client.py:64, Errore HTTP 400:Bad Request, B'non esiste alcuna sottoscrizione per l'etichetta sorgente label-or-lambda-arn e l'oggetto label-or-lambda-arn < > < >](#v1-lambda-no-subscription-exists)
### I seguenti sottosistemi cgroup non sono montati: dispositivi, memoria
Potresti visualizzare questo errore quando esegui una funzione Lambda containerizzata nei seguenti casi:
+ Il dispositivo principale non ha cgroup v1 abilitato per la memoria o i cgroup del dispositivo.
+ Il dispositivo principale ha cgroups v2 abilitato. Le funzioni Greengrass Lambda richiedono cgroups v1 e cgroups v1 e v2 si escludono a vicenda.
Per abilitare cgroups v1, avvia il dispositivo con i seguenti parametri del kernel Linux.
```
cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0
```
**Suggerimento**
Su un Raspberry Pi, modifica il `/boot/cmdline.txt` file per impostare i parametri del kernel del dispositivo.
### ipc\_client.py:64, Errore HTTP 400:Bad Request, B'non esiste alcuna sottoscrizione per l'etichetta sorgente label-or-lambda-arn e l'oggetto label-or-lambda-arn < > < >
[Potresti visualizzare questo errore quando esegui una funzione Lambda V1, che utilizza AWS IoT Greengrass Core SDK, su un dispositivo core V2 senza specificare un abbonamento nel componente legacy del router di abbonamento.](legacy-subscription-router-component.md) Per risolvere questo problema, distribuisci e configura il router di abbonamento legacy per specificare gli abbonamenti richiesti. Per ulteriori informazioni, consulta [Importa funzioni Lambda V1](set-up-v2-test-device.md#run-v1-lambda-functions).
## La versione del componente è stata interrotta
Potresti visualizzare una notifica sulla tua Personal Health Dashboard (PHD) quando una versione di un componente sul tuo dispositivo principale viene interrotta. La versione del componente invia questa notifica al tuo dottorato di ricerca entro 60 minuti dalla cessazione della produzione.
Per vedere quali implementazioni è necessario rivedere, procedi come segue utilizzando: AWS Command Line Interface
1. Esegui il comando seguente per ottenere un elenco dei tuoi dispositivi principali.
```
aws greengrassv2 list-core-devices
```
1. Esegui il comando seguente per recuperare lo stato dei componenti su ciascun dispositivo principale dal passaggio 1. Sostituiscilo `{{coreDeviceName}}` con il nome di ogni dispositivo principale da interrogare.
```
aws greengrassv2 list-installed-components --core-device-thing-name {{coreDeviceName}}
```
1. Raccogli i dispositivi principali con la versione del componente fuori produzione installata nei passaggi precedenti.
1. Esegui il comando seguente per recuperare lo stato di tutti i processi di distribuzione per ogni dispositivo principale dal Passaggio 3. Sostituisci `{{coreDeviceName}}` con il nome del dispositivo principale da interrogare.
```
aws greengrassv2 list-effective-deployments --core-device-thing-name {{coreDeviceName}}
```
La risposta contiene l'elenco dei processi di distribuzione per il dispositivo principale. È possibile modificare la distribuzione per scegliere un'altra versione del componente. [Per ulteriori informazioni su come rivedere una distribuzione, consulta Revisionare le distribuzioni.](https://docs.aws.amazon.com/greengrass/v2/developerguide/revise-deployments.html)
## Problemi relativi all'interfaccia a riga di comando di Greengrass
[Risolvi i problemi con la CLI di Greengrass.](gg-cli.md)
**Topics**
+ [java.lang. RuntimeException: Impossibile creare il client ipc](#greengrass-cli-unable-to-create-ipc-client)
### java.lang. RuntimeException: Impossibile creare il client ipc
Potresti visualizzare questo errore quando esegui un comando Greengrass CLI e specifichi una cartella principale diversa da quella in cui è installato il software AWS IoT Greengrass Core.
Effettuate una delle seguenti operazioni per impostare il percorso principale e sostituitelo `{{/greengrass/v2}}` con il percorso di installazione del software AWS IoT Greengrass Core:
+ Impostare la variabile di ambiente `GGC_ROOT_PATH` su `{{/greengrass/v2}}`.
+ Aggiungete l'`--ggcRootPath {{/greengrass/v2}}`argomento al comando come illustrato nell'esempio seguente.
```
greengrass-cli --ggcRootPath {{/greengrass/v2}} [arguments]
```
## AWS Command Line Interface problemi
Risolvi i AWS CLI problemi relativi a. AWS IoT Greengrass V2
**Topics**
+ [Errore: scelta non valida: 'greengrassv2'](#aws-cli-invalid-choice-greengrassv2)
### Errore: scelta non valida: 'greengrassv2'
Potresti visualizzare questo errore quando esegui un AWS IoT Greengrass V2 comando con AWS CLI (ad esempio,). `aws greengrassv2 list-core-devices`
Questo errore indica che hai una versione di AWS CLI che non supporta AWS IoT Greengrass V2. Per utilizzarlo AWS IoT Greengrass V2 con AWS CLI, è necessario disporre di una delle seguenti versioni o successive:
+ Versione minima AWS CLI V1: v1.18.197
+ Versione minima AWS CLI V2: v2.1.11
**Suggerimento**
Puoi eseguire il seguente comando per verificare la versione di cui disponi AWS CLI .
```
aws --version
```
Per risolvere questo problema, aggiornalo AWS CLI a una versione successiva che supporti AWS IoT Greengrass V2. Per ulteriori informazioni, vedere [Installazione, aggiornamento e disinstallazione di AWS CLI nella](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) *Guida per l'AWS Command Line Interface utente*.