

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

# Fase 3: Installare il software AWS IoT Greengrass Core
<a name="install-greengrass-v2"></a>

**Suggerimento**  
Ti consigliamo di provare [AWS IoT Greengrass AI Agents Context Pack](https://github.com/aws-greengrass/greengrass-agent-context-pack) per configurare e sperimentare rapidamente IoT AWS Greengrass. L'agent context pack consentirà agli agenti AI di configurare Greengrass Nucleus e Nucleus Lite, distribuire componenti e risolvere problemi comuni.

Segui i passaggi di questa sezione per configurare il tuo Raspberry Pi come dispositivo AWS IoT Greengrass principale da utilizzare per lo sviluppo locale. In questa sezione, scarichi ed esegui un programma di installazione che esegue le seguenti operazioni per configurare il software AWS IoT Greengrass Core per il tuo dispositivo:
+ Installa il componente Greengrass nucleus. Il nucleus è un componente obbligatorio ed è il requisito minimo per eseguire il software AWS IoT Greengrass Core su un dispositivo. Per ulteriori informazioni, vedere [Greengrass nucleus](greengrass-nucleus-component.md) component.
+ Registra il dispositivo come AWS IoT oggetto e scarica un certificato digitale che consente la connessione al dispositivo. AWS Per ulteriori informazioni, consulta [Autenticazione e autorizzazione del dispositivo per AWS IoT Greengrass](device-auth.md).
+ Aggiunge l' AWS IoT elemento del dispositivo a un gruppo di oggetti, che è un gruppo o una flotta di AWS IoT oggetti. I gruppi di cose consentono di gestire flotte di dispositivi core Greengrass. Quando distribuite componenti software sui vostri dispositivi, potete scegliere di distribuirli su singoli dispositivi o su gruppi di dispositivi. Per ulteriori informazioni, consulta [Managing devices with AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-thing-management.html) nella *AWS IoT Core Developer* Guide.
+ Crea il ruolo IAM che consente al dispositivo principale Greengrass di interagire con AWS i servizi. Per impostazione predefinita, questo ruolo consente al dispositivo di interagire AWS IoT e inviare log ad Amazon CloudWatch Logs. Per ulteriori informazioni, consulta [Autorizza i dispositivi principali a interagire con i servizi AWS](device-service-role.md).
+ Installa l'interfaccia a riga di AWS IoT Greengrass comando (`greengrass-cli`), che puoi usare per testare componenti personalizzati sviluppati sul dispositivo principale. Per ulteriori informazioni, consulta [Interfaccia a riga di comando Greengrass](gg-cli.md).

# Installare il software AWS IoT Greengrass Core (console)
<a name="install-greengrass-v2-console"></a>

1. Accedere alla [console AWS IoT Greengrass](https://console.aws.amazon.com/greengrass).

1. In **Inizia a usare Greengrass**, scegli **Configura dispositivo principale**.

1. Nel **Passaggio 1: registra un dispositivo principale Greengrass**, per **Nome dispositivo Core, inserisci il nome** dell' AWS IoT oggetto per il tuo dispositivo principale Greengrass. Se l'oggetto non esiste, il programma di installazione lo crea.

1. Nel **Passaggio 2: Aggiungi a un gruppo di oggetti per applicare una distribuzione continua**, per **Thing group**, scegli il AWS IoT gruppo di oggetti a cui desideri aggiungere il dispositivo principale. 
   + Se si seleziona **Inserisci un nuovo nome di gruppo**, in **Thing group name**, inserisci il nome del nuovo gruppo da creare. Il programma di installazione crea automaticamente il nuovo gruppo.
   + Se si seleziona **Seleziona un gruppo esistente**, in **Nome gruppo** di oggetti, scegli il gruppo esistente che desideri utilizzare.
   + Se si seleziona **Nessun gruppo**, il programma di installazione non aggiunge il dispositivo principale a un gruppo di oggetti.

1. Nel **Passaggio 3: Installare il software Greengrass Core**, completare i seguenti passaggi.

------
#### [ Nucleus classic ]

   1. Scegliete **Nucleus classic** come runtime software del vostro dispositivo principale.

   1. Scegli il sistema operativo del tuo dispositivo principale: **Linux** o **Windows**.

   1. <a name="installer-export-aws-credentials"></a>Fornisci AWS le tue credenziali al dispositivo in modo che l'installatore possa fornire le risorse AWS IoT e IAM per il tuo dispositivo principale. Per aumentare la sicurezza, ti consigliamo di ottenere credenziali temporanee per un ruolo IAM che consenta solo le autorizzazioni minime necessarie per il provisioning. Per ulteriori informazioni, consulta [Policy IAM minima per l'installatore per il provisioning delle risorse](provision-minimal-iam-policy.md).
**Nota**  
Il programma di installazione non salva né archivia le tue credenziali.

      Sul dispositivo, esegui una delle seguenti operazioni per recuperare le credenziali e renderle disponibili al programma di installazione del AWS IoT Greengrass software Core:
      + (Consigliato) Utilizza credenziali temporanee da AWS IAM Identity Center

        1. Fornisci l'ID della chiave di accesso, la chiave di accesso segreta e il token di sessione dall'IAM Identity Center. Per ulteriori informazioni, consulta Aggiornamento **manuale delle credenziali in Acquisizione e aggiornamento** [delle credenziali temporanee nella guida](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) per l'utente di *IAM Identity Center*.

        1. Esegui i seguenti comandi per fornire le credenziali al software Core. AWS IoT Greengrass 

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

           ```
           export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=
           ```

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

           ```
           set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=
           ```

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

           ```
           $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
           $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
           $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="
           ```

------
      + Utilizza credenziali di sicurezza temporanee da un ruolo IAM:

        1. Fornisci l'ID della chiave di accesso, la chiave di accesso segreta e il token di sessione da un ruolo IAM che assumi. *Per ulteriori informazioni su come recuperare queste credenziali, consulta la sezione [Richiesta di credenziali di sicurezza temporanee nella Guida per l'utente](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html) IAM.*

        1. Esegui i seguenti comandi per fornire le credenziali al software Core. AWS IoT Greengrass 

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

           ```
           export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=
           ```

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

           ```
           set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=
           ```

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

           ```
           $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
           $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
           $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="
           ```

------
      + Utilizza le credenziali a lungo termine di un utente IAM:

        1. Fornisci l'ID della chiave di accesso e la chiave di accesso segreta per il tuo utente IAM. Puoi creare un utente IAM per il provisioning da eliminare successivamente. Per la policy IAM da fornire all'utente, consulta[Policy IAM minima per l'installatore per il provisioning delle risorse](provision-minimal-iam-policy.md). Per ulteriori informazioni su come recuperare le credenziali a lungo termine, consulta [Managing access keys for IAM users nella IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) *User Guide*.

        1. Esegui i seguenti comandi per fornire le credenziali al AWS IoT Greengrass software Core.

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

           ```
           export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           ```

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

           ```
           set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           ```

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

           ```
           $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
           $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
           ```

------

        1. (Facoltativo) Se hai creato un utente IAM per il provisioning del tuo dispositivo Greengrass, elimina l'utente.

        1. (Facoltativo) Se hai utilizzato l'ID della chiave di accesso e la chiave di accesso segreta di un utente IAM esistente, aggiorna le chiavi dell'utente in modo che non siano più valide. Per ulteriori informazioni, consulta [Aggiornamento delle chiavi di accesso](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_RotateAccessKey) nella *guida AWS Identity and Access Management per l'utente*.

   1. In **Esegui il programma di installazione**, completa i seguenti passaggi.

      1. In **Scarica il programma di installazione**, scegli **Copia** ed esegui il comando copiato sul tuo dispositivo principale. Questo comando scarica l'ultima versione del software AWS IoT Greengrass Core e la decomprime sul tuo dispositivo.

      1. In **Esegui il programma di installazione**, scegli **Copia** ed esegui il comando copiato sul tuo dispositivo principale. Questo comando utilizza i nomi degli AWS IoT oggetti e dei gruppi di oggetti specificati in precedenza per eseguire il programma di installazione del software AWS IoT Greengrass Core e configurare AWS le risorse per il dispositivo principale.

         Questo comando esegue inoltre le seguenti operazioni:
         + <a name="install-argument-system-service"></a>Configura il software AWS IoT Greengrass Core come servizio di sistema che viene eseguito all'avvio. Sui dispositivi Linux, ciò richiede il [sistema di inizializzazione Systemd](https://en.wikipedia.org/wiki/Systemd).
**Importante**  <a name="windows-system-service-requirement-important-note"></a>
Sui dispositivi Windows core, è necessario configurare il software AWS IoT Greengrass Core come servizio di sistema.
         + <a name="install-argument-dev-tools"></a>Implementa il componente [AWS IoT Greengrass CLI](gg-cli.md), che è uno strumento da riga di comando che ti consente di sviluppare componenti Greengrass personalizzati sul dispositivo principale.
         + <a name="install-argument-component-default-user"></a>Specificare di utilizzare l'utente `ggc_user` del sistema per eseguire componenti software sul dispositivo principale. Sui dispositivi Linux, questo comando specifica anche di utilizzare il gruppo di `ggc_group` sistema e il programma di installazione crea automaticamente l'utente e il gruppo di sistema.

         Quando si esegue questo comando, dovrebbero essere visualizzati i seguenti messaggi per indicare che l'installazione è riuscita.

         ```
         Successfully configured Nucleus with provisioned resource details!
         Configured Nucleus to deploy aws.greengrass.Cli component
         Successfully set up Nucleus as a system service
         ```
**Nota**  <a name="installer-linux-no-systemd-message"></a>
Se avete un dispositivo Linux che non ha [systemd](https://en.wikipedia.org/wiki/Systemd), il programma di installazione non configurerà il software come servizio di sistema e non vedrete il messaggio di successo relativo alla configurazione del nucleus come servizio di sistema.

------
#### [ Nucleus lite ]

   1. Scegliete **Nucleus lite** come runtime software del vostro dispositivo principale.

   1. Seleziona il metodo di configurazione del dispositivo per eseguire il provisioning del dispositivo su un dispositivo principale Greengrass.

   **Opzione 1: configura un dispositivo con download del pacchetto (circa 1 MB)**

   1. Crea AWS IoT qualcosa e il ruolo per Greengrass.

   1. Scarica il file zip che contiene AWS IoT le risorse a cui il tuo dispositivo ha bisogno per connettersi a AWS IoT:
      + Un certificato e una chiave privata generati utilizzando l'autorità AWS IoT di certificazione.
      + Un file di schema per avviare l'installazione di Greengrass per il tuo dispositivo.

   1. Scarica il pacchetto che installerà l'ultimo runtime Greengrass Nucleus lite sul tuo Raspberry Pi.

   1. Fai in modo che il tuo dispositivo diventi un dispositivo AWS IoT Greengrass Core e collegalo a: AWS IoT

      1. a. Trasferisci il pacchetto Greengrass e il kit di connessione sul tuo dispositivo utilizzando una chiavetta USB, SCP/FTP o schede SD.

      1. b. Decomprimi il file greengrass-package.zip nella directory/sul dispositivo. GreengrassInstaller

      1. c. Decomprimi il file zip del kit di connessione nella directory /del dispositivo. 

      1. d. Esegui il comando fornito sul dispositivo da installare AWS IoT Greengrass

   1. Quindi, scegli **Visualizza i dispositivi principali**.

   **Opzione 2: configura un dispositivo con il download di un'immagine di esempio dell'intero disco preconfigurata (circa 100 MB)**

   1. Crea AWS IoT qualcosa e il ruolo per Greengrass.

   1. Scarica il file zip che contiene AWS IoT le risorse a cui il tuo dispositivo ha bisogno per connettersi a AWS IoT:
      + Un certificato e una chiave privata generati utilizzando l'autorità AWS IoT di certificazione.
      + Un file di schema per avviare l'installazione di Greengrass per il tuo dispositivo.

   1. Scarica l'immagine campione dell'intero disco preconfigurata che contiene Greengrass e il sistema operativo.

      1. Per trasferire il kit di connessione e flashare l'immagine sul dispositivo, segui il file readme scaricato con l'immagine.

      1. Per avviare l'installazione di Greengrass, accendi e avvia il dispositivo dall'immagine flashata

   1. Quindi, scegli **Visualizza i dispositivi principali**.

   **Opzione 3: configura un dispositivo con la tua build personalizzata**

   1. Crea AWS IoT qualcosa e il ruolo per Greengrass.

   1. Scarica il file zip che contiene AWS IoT le risorse a cui il tuo dispositivo ha bisogno per connettersi a AWS IoT:
      + Un certificato e una chiave privata generati utilizzando l'autorità AWS IoT di certificazione.
      + Un file di schema per avviare l'installazione di Greengrass per il tuo dispositivo.

   1. Per personalizzare e creare la tua immagine usando Yocto dal codice sorgente, e poi usa il kit di connessione per installare nucleus lite, segui le istruzioni su. GitHub

      1. Quindi, scegli **Visualizza** i dispositivi principali.

------

# Installazione del software AWS IoT Greengrass Core (CLI)
<a name="install-greengrass-v2-cli"></a>

**Nota**  
Questi passaggi non si applicano a nucleus lite.

**Per installare e configurare il software AWS IoT Greengrass Core**

1. Sul tuo dispositivo principale Greengrass, esegui il seguente comando per passare alla home directory.

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

   ```
   cd ~
   ```

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

   ```
   cd %USERPROFILE%
   ```

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

   ```
   cd ~
   ```

------

1. <a name="installation-download-ggc-software-step"></a>Sul tuo dispositivo principale, scarica il software AWS IoT Greengrass Core in un file denominato`greengrass-nucleus-latest.zip`.

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

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

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

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

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

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

------

   <a name="core-software-license"></a>Scaricando questo software accetti l'[Accordo di licenza del software Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf).

1. <a name="installation-unzip-ggc-software-step"></a>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-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip
   ```

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

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

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

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

------

1. Esegui il comando seguente per avviare il programma di installazione del software AWS IoT Greengrass Core. Questo comando funziona nel modo seguente:
   + <a name="install-argument-aws-resources"></a>Crea le AWS risorse necessarie per il funzionamento del dispositivo principale.
   + <a name="install-argument-system-service"></a>Configura il software AWS IoT Greengrass Core come servizio di sistema che viene eseguito all'avvio. Sui dispositivi Linux, ciò richiede il [sistema di inizializzazione Systemd](https://en.wikipedia.org/wiki/Systemd).
**Importante**  <a name="windows-system-service-requirement-important-note"></a>
Sui dispositivi Windows core, è necessario configurare il software AWS IoT Greengrass Core come servizio di sistema.
   + <a name="install-argument-dev-tools"></a>Implementa il componente [AWS IoT Greengrass CLI](gg-cli.md), che è uno strumento da riga di comando che ti consente di sviluppare componenti Greengrass personalizzati sul dispositivo principale.
   + <a name="install-argument-component-default-user"></a>Specificare di utilizzare l'utente `ggc_user` del sistema per eseguire componenti software sul dispositivo principale. Sui dispositivi Linux, questo comando specifica anche di utilizzare il gruppo di `ggc_group` sistema e il programma di installazione crea automaticamente l'utente e il gruppo di sistema.

   Sostituite i valori degli argomenti nel comando come segue.<a name="installer-replace-arguments"></a>

   1. `/greengrass/v2`oppure*C:\$1greengrass\$1v2*: il percorso della cartella principale da utilizzare per installare il software AWS IoT Greengrass Core.

   1. *GreengrassInstaller*. Il percorso della cartella in cui è stato decompresso il programma di installazione del software AWS IoT Greengrass Core.

   1. *region*. Il Regione AWS luogo in cui trovare o creare risorse.

   1. *MyGreengrassCore*. Il nome del AWS IoT dispositivo principale Greengrass. Se l'oggetto non esiste, l'installatore lo crea. Il programma di installazione scarica i certificati per autenticarsi come oggetto. AWS IoT Per ulteriori informazioni, consulta [Autenticazione e autorizzazione del dispositivo per AWS IoT Greengrass](device-auth.md).
**Nota**  <a name="install-argument-thing-name-constraint"></a>
Il nome dell'oggetto non può contenere i due punti (`:`).

   1. *MyGreengrassCoreGroup*. Il nome del AWS IoT gruppo di oggetti per il tuo dispositivo principale Greengrass. Se il gruppo di oggetti non esiste, il programma di installazione lo crea e vi aggiunge l'oggetto. Se il gruppo di oggetti esiste e dispone di una distribuzione attiva, il dispositivo principale scarica ed esegue il software specificato dalla distribuzione.
**Nota**  <a name="install-argument-thing-group-name-constraint"></a>
Il nome del gruppo di cose non può contenere i due punti (`:`).

   1. *GreengrassV2IoTThingPolicy*. Il nome della AWS IoT policy che consente ai dispositivi core Greengrass di comunicare con AWS IoT e. AWS IoT Greengrass Se la AWS IoT politica non esiste, il programma di installazione crea una AWS IoT politica permissiva con questo nome. Puoi limitare le autorizzazioni di questa politica in base al tuo caso d'uso. Per ulteriori informazioni, consulta [AWS IoT Politica minima per i dispositivi AWS IoT Greengrass V2 principali](device-auth.md#greengrass-core-minimal-iot-policy).

   1. *GreengrassV2TokenExchangeRole*. Il nome del ruolo IAM che consente al dispositivo principale Greengrass di ottenere credenziali temporanee AWS . Se il ruolo non esiste, l'installatore lo crea e crea e allega una policy denominata. `GreengrassV2TokenExchangeRoleAccess` Per ulteriori informazioni, consulta [Autorizza i dispositivi principali a interagire con i servizi AWS](device-service-role.md).

   1. *GreengrassCoreTokenExchangeRoleAlias*. L'alias del ruolo IAM che consente al dispositivo principale Greengrass di ottenere credenziali temporanee in un secondo momento. Se l'alias del ruolo non esiste, il programma di installazione lo crea e lo indirizza al ruolo IAM specificato. Per ulteriori informazioni, consulta [Autorizza i dispositivi principali a interagire con i servizi AWS](device-service-role.md).

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

   ```
   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --aws-region region \
     --thing-name MyGreengrassCore \
     --thing-group-name MyGreengrassCoreGroup \
     --thing-policy-name GreengrassV2IoTThingPolicy \
     --tes-role-name GreengrassV2TokenExchangeRole \
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
     --component-default-user ggc_user:ggc_group \
     --provision true \
     --setup-system-service true \
     --deploy-dev-tools true
   ```

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

   ```
   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
     -jar ./GreengrassInstaller/lib/Greengrass.jar ^
     --aws-region region ^
     --thing-name MyGreengrassCore ^
     --thing-group-name MyGreengrassCoreGroup ^
     --thing-policy-name GreengrassV2IoTThingPolicy ^
     --tes-role-name GreengrassV2TokenExchangeRole ^
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias ^
     --component-default-user ggc_user ^
     --provision true ^
     --setup-system-service true ^
     --deploy-dev-tools true
   ```

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

   ```
   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
     -jar ./GreengrassInstaller/lib/Greengrass.jar `
     --aws-region region `
     --thing-name MyGreengrassCore `
     --thing-group-name MyGreengrassCoreGroup `
     --thing-policy-name GreengrassV2IoTThingPolicy `
     --tes-role-name GreengrassV2TokenExchangeRole `
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias `
     --component-default-user ggc_user `
     --provision true `
     --setup-system-service true `
     --deploy-dev-tools true
   ```

------
**Nota**  
<a name="jvm-tuning-note"></a>Se utilizzi AWS IoT Greengrass un dispositivo con memoria limitata, puoi controllare la quantità di memoria utilizzata dal software AWS IoT Greengrass Core. Per controllare l'allocazione della memoria, è possibile impostare le opzioni relative alla dimensione dell'heap JVM nel parametro di `jvmOptions` configurazione del componente nucleus. Per ulteriori informazioni, consulta [Controlla l'allocazione della memoria con le opzioni JVM](configure-greengrass-core-v2.md#jvm-tuning).

   Quando esegui questo comando, dovresti vedere i seguenti messaggi per indicare che l'installazione è riuscita.

   ```
   Successfully configured Nucleus with provisioned resource details!
   Configured Nucleus to deploy aws.greengrass.Cli component
   Successfully set up Nucleus as a system service
   ```
**Nota**  <a name="installer-linux-no-systemd-message"></a>
Se avete un dispositivo Linux che non ha [systemd](https://en.wikipedia.org/wiki/Systemd), il programma di installazione non configurerà il software come servizio di sistema e non vedrete il messaggio di successo relativo alla configurazione del nucleus come servizio di sistema.

# (Facoltativo) Esegui il software Greengrass (Linux)
<a name="run-the-software"></a>

**Nota**  
Questi passaggi non si applicano a nucleus lite.

Se il software è stato installato come servizio di sistema, il programma di installazione lo esegue automaticamente. In caso contrario, è necessario eseguire il software. Per verificare se il programma di installazione ha configurato il software come servizio di sistema, cercate la riga seguente nell'output dell'installatore.

```
Successfully set up Nucleus as a system service
```

Se non vedi questo messaggio, procedi come segue per eseguire il software:

1. Esegui il comando seguente per eseguire il software.

   ```
   sudo /greengrass/v2/alts/current/distro/bin/loader
   ```

   Il software stampa il seguente messaggio se viene avviato correttamente.

   ```
   Launched Nucleus successfully.
   ```

1. È necessario lasciare aperta la shell dei comandi corrente per mantenere in esecuzione il software AWS IoT Greengrass Core. Se usi SSH per connetterti al dispositivo principale, esegui il comando seguente sul tuo computer di sviluppo per aprire una seconda sessione SSH da utilizzare per eseguire comandi aggiuntivi sul dispositivo principale. Sostituiscilo *username* con il nome dell'utente a cui accedere e sostituiscilo *pi-ip-address* con l'indirizzo IP del dispositivo.

   ```
   ssh username@pi-ip-address
   ```

Per ulteriori informazioni su come interagire con il servizio di sistema Greengrass, vedere. [Configurare il nucleo Greengrass come servizio di sistema](configure-greengrass-core-v2.md#configure-system-service)

# Verifica l'installazione della CLI di Greengrass sul dispositivo
<a name="verify-local-development-tools"></a>

**Nota**  
Questi passaggi non si applicano a nucleus lite.

L'implementazione della CLI di Greengrass può richiedere fino a un minuto. Esegui il comando seguente per verificare lo stato della distribuzione. Sostituiscilo *MyGreengrassCore* con il nome del tuo dispositivo principale.

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

`coreDeviceExecutionStatus`Indica lo stato della distribuzione sul dispositivo principale. Quando lo stato è`SUCCEEDED`, esegui il comando seguente per verificare che la CLI Greengrass sia installata e funzionante. Sostituisci `/greengrass/v2` con il percorso della cartella principale.

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

```
/greengrass/v2/bin/greengrass-cli help
```

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

```
C:\greengrass\v2\bin\greengrass-cli help
```

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

```
C:\greengrass\v2\bin\greengrass-cli help
```

------

Il comando fornisce informazioni di aiuto per la CLI di Greengrass. Se `greengrass-cli` non viene trovato, la distribuzione potrebbe non essere riuscita a installare la CLI di Greengrass. Per ulteriori informazioni, consulta [Risoluzione dei problemi AWS IoT Greengrass V2](troubleshooting.md).

Puoi anche eseguire il comando seguente per distribuire manualmente la AWS IoT Greengrass CLI sul tuo dispositivo.
+ *region*Sostituiscila con quella Regione AWS che usi. Assicurati di utilizzare lo stesso Regione AWS che hai usato per configurarli AWS CLI sul tuo dispositivo.
+ *account-id*Sostituiscilo con il tuo Account AWS ID.
+ Sostituiscilo *MyGreengrassCore* con il nome del tuo dispositivo principale.

------
#### [ Linux, macOS, or Unix ]

```
aws greengrassv2 create-deployment \
  --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" \
  --components '{
    "aws.greengrass.Cli": {
      "componentVersion": "2.17.0"
    }
  }'
```

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

```
aws greengrassv2 create-deployment ^
  --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" ^
  --components "{\"aws.greengrass.Cli\":{\"componentVersion\":\"2.17.0\"}}"
```

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

```
aws greengrassv2 create-deployment `
  --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" `
  --components '{\"aws.greengrass.Cli\":{\"componentVersion\":\"2.17.0\"}}'
```

------

**Suggerimento**  
È possibile aggiungere `/greengrass/v2/bin` (Linux) o `C:\greengrass\v2\bin` (Windows) alla variabile di `PATH` ambiente per eseguirla `greengrass-cli` senza il percorso assoluto.

Il software AWS IoT Greengrass Core e gli strumenti di sviluppo locale vengono eseguiti sul dispositivo. Successivamente, puoi sviluppare un AWS IoT Greengrass componente Hello World sul tuo dispositivo.