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

Visualizza i registri del software e dei componenti AWS IoT Greengrass principali

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.

AWS IoT Greengrass Problemi software principali

Risolvi i problemi relativi AWS IoT Greengrass al software Core.

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 software AWS IoT Greengrass Core.

Impossibile avviare il software AWS IoT Greengrass Core come servizio di sistema

Se il software AWS IoT Greengrass Core non si avvia, controlla i registri dei servizi di sistema 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. 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 di queste operazioni:

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:

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.

Impossibile installare Greengrass CLI

È possibile che venga visualizzato il seguente messaggio sulla console quando si utilizza l'--deploy-dev-toolsargomento 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.

User root is not allowed to execute

Potresti visualizzare questo errore quando l'utente che esegue il software AWS IoT Greengrass Core (in genereroot) non dispone dell'autorizzazione per l'esecuzione 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 <command> 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: Could not determine user/group to run with

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, consulta Configurare l'utente che esegue i componenti e Configura l'utente predefinito del componente.

Failed to map segment from shared object: operation not permitted

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) utilizza la /tmp cartella per impostazione predefinita.

Esegui una di queste operazioni:

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, consultaPiattaforme supportate.

Se è necessario utilizzare Windows 2016, è possibile effettuare le seguenti operazioni:

com.aws.greengrass.util.exceptions.TLSAuthException: Failed to get trust manager

Potresti visualizzare questo errore quando installi il software AWS IoT Greengrass Core senza un file di autorità di certificazione (CA) principale.

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..

com.aws.greengrass.deployment.IotJobsHelper: No connection available during subscribing to Iot Jobs descriptions topic. Will retry in sometime

Potresti visualizzare questo messaggio di avviso quando il dispositivo principale non riesce a connettersi per iscriversi AWS IoT Core alle notifiche dei lavori di distribuzione. Esegui questa operazione:

software.amazon.awssdk.services.iam.model.IamException: The security token included in the request is invalid

Potresti visualizzare questo errore quando installi il software AWS IoT Greengrass Core con provisioning automatico e il programma di installazione utilizza un token di AWS sessione non valido. Esegui questa operazione:

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 o Installa il software AWS IoT Greengrass Core con il provisioning AWS IoT della flotta.

software.amazon.awssdk.services.iot.model.IotException: User: <user> is not authorized to perform: iot:GetPolicy

Potresti visualizzare questo errore quando installi il software AWS IoT Greengrass Core con provisioning automatico 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

Controlla le autorizzazioni per l'identità IAM delle credenziali e concedi all'identità IAM tutte le autorizzazioni richieste mancanti.

Error: com.aws.greengrass.shadowmanager.sync.model.FullShadowSyncRequest: Could not execute cloud shadow get request

Potresti visualizzare questo errore quando usi il componente shadow manager per sincronizzare le ombre del dispositivo con. AWS IoT Core 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:

Controlla la AWS IoT politica del dispositivo principale e aggiungi le autorizzazioni necessarie mancanti. Per ulteriori informazioni, consulta gli argomenti seguenti:

Operation aws.greengrass#<operation> is not supported by Greengrass

Potresti visualizzare questo errore quando utilizzi un'operazione di comunicazione tra processi (IPC) 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 richiesto al momento della distribuzione del componente.

java.io.FileNotFoundException: <stream-manager-store-root-dir>/stream_manager_metadata_store (Permission denied)

Potresti visualizzare questo errore nel file di log di stream manager (aws.greengrass.StreamManager.log) quando configuri stream manager per utilizzare una cartella principale che non esiste o dispone delle autorizzazioni corrette. Per ulteriori informazioni su come configurare questa cartella, consulta la configurazione dello stream manager.

com.aws.greengrass.security.provider.pkcs11.PKCS11CryptoKeyService: Private key or certificate with label <label> does not exist

Questo errore si verifica quando il componente del provider PKCS #11 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). Esegui questa operazione:

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: User: <user> is not authorized to perform: secretsmanager:GetSecretValue on resource: <arn>

Questo errore può verificarsi quando si utilizza il componente Secret Manager per distribuire un AWS Secrets Manager segreto. Se il ruolo IAM di scambio di token del dispositivo principale non concede l'autorizzazione per ottenere il segreto, l'implementazione fallisce e i log di Greengrass includono questo errore.

software.amazon.awssdk.services.secretsmanager.model.SecretsManagerException: Access to KMS is not allowed

Questo errore può verificarsi quando si utilizza il componente del gestore segreto per distribuire un AWS Secrets Manager segreto crittografato da una AWS Key Management Service chiave. Se il ruolo IAM di scambio di token 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:Decryptautorizzazione al ruolo di scambio di token del dispositivo principale. Per ulteriori informazioni, consulta gli argomenti seguenti:

java.lang.NoClassDefFoundError: com/aws/greengrass/security/CryptoKeySpi

Potresti visualizzare questo errore quando tenti di installare il software AWS IoT Greengrass Core con sicurezza hardware 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 componente.

Greengrass core device stuck on 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:

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.

An error occurred (AccessDeniedException) when calling the CreateComponentVersion operation: User: arn:aws:iam::123456789012:user/<username> is not authorized to perform: null

Potresti visualizzare questo errore quando crei una versione del componente dalla AWS IoT Greengrass console o con l'CreateComponentVersionoperazione.

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.

Invalid Input: Encountered following errors in Artifacts: {<s3ArtifactUri> = Specified artifact resource cannot be accessed}

Potresti visualizzare questo errore quando crei una versione del componente dalla console o con l' AWS IoT Greengrass operazione. CreateComponentVersion Questo errore indica che un artefatto S3 nella ricetta del componente non è valido.

Esegui questa operazione:

INACTIVE deployment status

Potresti ottenere uno stato di INACTIVE implementazione quando chiami l'ListDeploymentsAPI senza le politiche dipendenti richieste. AWS IoT È 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 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

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.

Error: com.aws.greengrass.componentmanager.exceptions.PackageDownloadException: Failed to download artifact

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.

software.amazon.awssdk.services.s3.model.S3Exception: null (Service: S3, Status Code: 403, Request ID: null, ...)

L'PackageDownloadException errore potrebbe includere questa traccia dello stack nei seguenti casi:

software.amazon.awssdk.services.s3.model.S3Exception: Access Denied (Service: S3, Status Code: 403, Request ID: <requestID>

L'PackageDownloadException errore potrebbe includere questa traccia dello stack quando il dispositivo principale non è autorizzato a chiamare. 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 del dispositivo principale consenta s3:GetBucketLocation il bucket S3 in cui è disponibile l'artefatto.

Error: com.aws.greengrass.componentmanager.exceptions.ArtifactChecksumMismatchException: Integrity check for downloaded artifact failed. Probably due to file corruption.

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:

Error: com.aws.greengrass.componentmanager.exceptions.NoAvailableComponentVersionException: Failed to negotiate component <name> version with cloud and no local applicable version satisfying requirement <requirements>

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 oLOCAL_DEPLOYMENT, che rappresenta la distribuzione locale sul dispositivo principale.

Questo problema può verificarsi nei seguenti casi:

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 Per ulteriori informazioni su come rivedere le distribuzioni locali, consulta il comando AWS IoT Greengrass CLI deployment create.

software.amazon.awssdk.services.greengrassv2data.model.ResourceNotFoundException: The latest version of Component <componentName> doesn't claim platform <coreDevicePlatform> compatibility

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 di queste operazioni:

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

Potresti visualizzare questo errore quando distribuisci un componente che dipende dal nucleo di Greengrass 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.

È necessario modificare la distribuzione per specificare la versione di Greengrass nucleus che si desidera utilizzare. Esegui una di queste operazioni:

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

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 chiamatofix_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

Info: com.aws.greengrass.deployment.exceptions.RetryableDeploymentDocumentDownloadException: Greengrass Cloud Service returned an error when getting full deployment configuration

È possibile che venga visualizzato 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 distribuzioni destinate a oggetti) o 31 KB (per 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:GetDeploymentConfigurationautorizzazione alla politica del AWS IoT dispositivo principale. Per ulteriori informazioni, consulta Aggiorna la politica di un dispositivo principale AWS IoT.

Warn: com.aws.greengrass.deployment.DeploymentService: Failed to get thing group hierarchy

Potresti visualizzare questo avviso quando il dispositivo principale riceve una distribuzione e la AWS IoT politica del dispositivo principale non consente l'greengrass:ListThingGroupsForCoreDeviceautorizzazione. 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 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

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:ListThingGroupsForCoreDeviceautorizzazione alla AWS IoT politica del dispositivo principale. Per ulteriori informazioni, consulta Aggiorna la politica di un dispositivo principale AWS IoT.

Info: com.aws.greengrass.deployment.DeploymentDocumentDownloader: Calling Greengrass cloud to get full deployment configuration

È 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.

Caused by: software.amazon.awssdk.services.greengrassv2data.model.GreengrassV2DataException: null (Service: GreengrassV2Data, Status Code: 403, Request ID: <some_request_id>, Extended Request ID: null)

Potresti visualizzare questo errore quando un'API dataplane non dispone iot:Connect dell'autorizzazione. Se non disponi della politica corretta, riceverai un. GreengrassV2DataException: 403 Per creare una politica di autorizzazione, segui queste istruzioni:Creazione di una policy AWS IoT.

Problemi principali relativi ai componenti del dispositivo

Risolvi i problemi relativi ai componenti Greengrass sui dispositivi principali.

Warn: '<command>' is not recognized as an internal or external command

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 esempioggc_user, non riesce a trovare l'eseguibile del comando nelle cartelle del PATH.

Sui dispositivi Windows, verifica che la cartella che contiene l'eseguibile sia disponibile PATH per l'utente di sistema che esegue il componente. Se manca inPATH, esegui una delle seguenti operazioni:

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:

Per ulteriori informazioni su come verificare che lo script Python emetta messaggi di log, vedere. Monitora AWS IoT Greengrass i registri

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.

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.

com.aws.greengrass.authorization.exceptions.AuthorizationException: Duplicate policy ID "<id>" for principal "<componentList>"

Potresti visualizzare questo errore se più politiche di autorizzazione IPC, inclusi tutti i 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.

com.aws.greengrass.tes.CredentialRequestHandler: Error in retrieving AwsCredentials from TES (HTTP 400)

Potresti visualizzare questo errore quando un dispositivo principale non riesce a ottenere AWS le credenziali dal servizio di scambio di token. Il codice di stato HTTP 400 indica che questo errore si è verificato perché il ruolo IAM per lo scambio di token 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:

com.aws.greengrass.tes.CredentialRequestHandler: Error in retrieving AwsCredentials from TES (HTTP 403)

Potresti visualizzare questo errore quando un dispositivo principale non riesce a ottenere AWS le credenziali dal servizio di scambio di token. Il codice di stato HTTP 403 indica che questo errore si è verificato perché le AWS IoT politiche del dispositivo principale non concedono l'iot:AssumeRoleWithCertificateautorizzazione per l'alias di AWS IoT ruolo del dispositivo principale.

Esamina AWS IoT le politiche del dispositivo principale e aggiungi l'iot:AssumeRoleWithCertificateautorizzazione 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 IoTPolitica minima per i dispositivi AWS IoT Greengrass V2 principali eAggiorna la politica di un dispositivo principale AWS IoT.

com.aws.greengrass.tes.CredentialsProviderError: Could not load credentials from any providers

Potresti visualizzare questo errore quando il componente tenta di richiedere le AWS credenziali e non riesce a connettersi al servizio di scambio di token.

Esegui questa operazione:

Received error when attempting to retrieve ECS metadata: Could not connect to the endpoint URL: "<tokenExchangeServiceEndpoint>"

Potresti visualizzare questo errore quando il componente non esegue il servizio di scambio di token e un componente tenta di richiedere le AWS credenziali.

Esegui questa operazione:

copyFrom: <configurationPath> is already a container, not a leaf

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:

Quindi, puoi impostare quel valore di configurazione su una stringa, un numero o un valore booleano.

com.aws.greengrass.componentmanager.plugins.docker.exceptions.DockerLoginException: Error logging into the registry using credentials - 'The stub received bad data.'

Potresti visualizzare questo errore nei registri del nucleo di Greengrass quando il componente Docker Application Manager tenta di scaricare un'immagine Docker 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 docker-credential-wincred Di conseguenza, Amazon ECR non è in grado di memorizzare le credenziali di accesso.

Esegui una delle seguenti azioni:

java.io.IOException: Cannot run program "cmd" ...: [LogonUser] The password for this account has expired.

Potresti visualizzare questo errore su un dispositivo Windows Core quando l'utente di sistema che esegue i processi del componente, ad esempioggc_user, ha una password scaduta. Di conseguenza, il software AWS IoT Greengrass Core non è in grado di eseguire i processi dei componenti come utente del sistema.

aws.greengrass.StreamManager: Instant exceeds minimum or maximum instant

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

Problemi relativi ai componenti della funzione Lambda del dispositivo principale

Risolvi i problemi relativi ai componenti della funzione Lambda sui dispositivi principali.

The following cgroup subsystems are not mounted: devices, memory

Potresti visualizzare questo errore quando esegui una funzione Lambda containerizzata nei seguenti casi:

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

ipc_client.py:64,HTTP Error 400:Bad Request, b'No subscription exists for the source <label-or-lambda-arn> and subject <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. 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.

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 devi rivedere, procedi come segue utilizzando: AWS Command Line Interface

Problemi relativi all'interfaccia a riga di comando di Greengrass

Risolvi i problemi con la CLI di Greengrass.

java.lang.RuntimeException: Unable to create ipc client

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:

AWS Command Line Interface problemi

Risolvi i AWS CLI problemi relativi a. AWS IoT Greengrass V2

Error: Invalid choice: 'greengrassv2'

È possibile che venga visualizzato questo errore quando si esegue 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:

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 Guida per l'AWS Command Line Interface utente.