

Avviso di fine del supporto: il 7 ottobre 2026, AWS il supporto per. AWS IoT Greengrass Version 1 Dopo il 7 ottobre 2026, non potrai più accedere alle risorse. AWS IoT Greengrass V1 Per ulteriori informazioni, visita [Migrate](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html) from. AWS IoT Greengrass Version 1

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

# Modulo 2: Installazione del software AWS IoT Greengrass Core
<a name="module2"></a>

Questo modulo mostra come installare il software AWS IoT Greengrass Core sul dispositivo scelto. In questo modulo, si crea innanzitutto un gruppo e un core di Greengrass. Quindi, scaricare, configurare e avviare il software sul dispositivo core. Per ulteriori informazioni sulle funzionalità del software AWS IoT Greengrass Core, consulta [Configura il AWS IoT Greengrass core](gg-core.md).

Prima di iniziare, assicurarsi di aver completato la procedura di configurazione nel [Modulo 1](module1.md) per il dispositivo scelto.

**Suggerimento**  
<a name="ggc-install-options"></a>AWS IoT Greengrass fornisce anche altre opzioni per l'installazione del software AWS IoT Greengrass Core. Ad esempio, è possibile utilizzare la [configurazione del dispositivo Greengrass](quick-start.md) per configurare l'ambiente e installare l'ultima versione del software AWS IoT Greengrass Core. Oppure, sulle piattaforme Debian supportate, è possibile utilizzare il [gestore di pacchetti APT](install-ggc.md#ggc-package-manager) per installare o aggiornare il AWS IoT Greengrass software Core. Per ulteriori informazioni, consulta [Installare il software AWS IoT Greengrass Core](install-ggc.md).

Il completamento di questo modulo dovrebbe richiedere meno di 30 minuti.

**Topics**
+ [Fornitura di AWS IoT qualsiasi cosa da utilizzare come core Greengrass](provision-core.md)
+ [Crea un AWS IoT Greengrass gruppo per il core](create-group.md)
+ [Installa ed esegui AWS IoT Greengrass sul dispositivo principale](start-greengrass.md)

# Fornitura di AWS IoT qualsiasi cosa da utilizzare come core Greengrass
<a name="provision-core"></a>

I *core* Greengrass sono dispositivi che eseguono il software AWS IoT Greengrass Core per gestire i processi IoT locali. Per configurare un core Greengrass, crei un AWS IoT *oggetto*, che rappresenta un dispositivo o un'entità logica a cui si connette. AWS IoT Quando si registra un dispositivo come AWS IoT oggetto, quel dispositivo può utilizzare un certificato digitale e delle chiavi che gli consentono l'accesso AWS IoT. Si utilizza una [AWS IoT policy](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) per consentire al dispositivo di comunicare con i AWS IoT Greengrass servizi AWS IoT and.

In questa sezione, registri il tuo dispositivo come AWS IoT qualsiasi cosa per usarlo come core Greengrass.

**Per creare qualsiasi cosa AWS IoT**

1. Passare alla [console AWS IoT](https://console.aws.amazon.com/iot).

1. In **Gestisci**, espandi **Tutti i dispositivi**, quindi scegli **Cose**.

1. Sulla pagina **Things (Oggetti)**, scegli **Create things (Creazione di oggetti)**.

1. <a name="gg-group-create-single-thing"></a>Nella pagina **Crea elementi**, scegli **Crea un singolo elemento**, quindi scegli **Avanti**.

1. Nella pagina **Specificare le proprietà** dell'oggetto, procedi come segue:

   1. Per **Nome oggetto**, immettere un nome che rappresenti il dispositivo, ad esempio**MyGreengrassV1Core**.

   1. Scegli **Next (Successivo)**.

1. <a name="gg-group-create-device-configure-certificate"></a>Nella pagina **Configura il certificato del dispositivo**, scegli **Avanti**.

1. Nella pagina **Allega le politiche al certificato**, esegui una delle seguenti operazioni:
   + **Seleziona una politica esistente che conceda le autorizzazioni richieste dai core, quindi scegli Crea oggetto.**

     Si apre una finestra modale in cui è possibile scaricare i certificati e le chiavi utilizzati dal dispositivo per connettersi a. Cloud AWS
   + Crea e allega una nuova politica che conceda le autorizzazioni principali del dispositivo. Esegui questa operazione:

     1. Scegli **Crea policy**.

        La pagina **Create policy (Crea policy)** viene aperta in una nuova scheda.

     1. Nella pagina **Create policy (Crea policy)**, eseguire le operazioni seguenti:

        1. Per **Nome della politica**, inserisci un nome che descriva la politica, ad esempio. **GreengrassV1CorePolicy**

        1. Nella scheda **Dichiarazioni politiche**, in **Documento di politica**, scegli **JSON**.

        1. Inserisci il seguente documento di policy. Questa policy consente al core di comunicare con il AWS IoT Core servizio, interagire con le ombre dei dispositivi e comunicare con il AWS IoT Greengrass servizio. Per informazioni su come limitare l'accesso a questa policy in base al tuo caso d'uso, consulta[AWS IoT Politica minima per il dispositivo AWS IoT Greengrass principale](device-auth.md#gg-config-sec-min-iot-policy).

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

****  

           ```
           {
             "Version":"2012-10-17",		 	 	 
             "Statement": [
               {
                 "Effect": "Allow",
                 "Action": [
                   "iot:Publish",
                   "iot:Subscribe",
                   "iot:Connect",
                   "iot:Receive"
                 ],
                 "Resource": [
                   "*"
                 ]
               },
               {
                 "Effect": "Allow",
                 "Action": [
                   "iot:GetThingShadow",
                   "iot:UpdateThingShadow",
                   "iot:DeleteThingShadow"
                 ],
                 "Resource": [
                   "*"
                 ]
               },
               {
                 "Effect": "Allow",
                 "Action": [
                   "greengrass:*"
                 ],
                 "Resource": [
                   "*"
                 ]
               }
             ]
           }
           ```

------

        1. Scegliere **Crea** per creare la policy.

     1. Torna alla scheda del browser con la pagina **Allega politiche al certificato** aperta. Esegui questa operazione:

        1. Nell'elenco **Politiche**, seleziona la politica che hai creato, ad esempio **GreengrassV1CorePolicy**.

           Se non vedi la politica, scegli il pulsante di aggiornamento.

        1. Scegli **Create thing (Crea oggetto)**.

           Si apre una finestra modale in cui è possibile scaricare i certificati e le chiavi a cui il core utilizza per connettersi. AWS IoT

1. Torna alla scheda del browser con la pagina **Allega politiche al certificato** aperta. Esegui questa operazione:

   1. Nell'elenco **Politiche**, seleziona la politica che hai creato, ad esempio **GreengrassV1CorePolicy**.

      Se non vedi la politica, scegli il pulsante di aggiornamento.

   1. Scegli **Create thing (Crea oggetto)**.

      Si apre una finestra modale in cui è possibile scaricare i certificati e le chiavi a cui il core utilizza per connettersi. AWS IoT

1. <a name="gg-group-create-device-download-certs"></a>Nella modalità **Scarica certificati e chiavi**, scarica i certificati del dispositivo.
**Importante**  
Prima di scegliere **Fine**, scarica le risorse di sicurezza.

   Esegui questa operazione:

   1. Per **Certificato del dispositivo**, scegli **Scarica** per scaricare il certificato del dispositivo.

   1. Per il **file della chiave pubblica**, scegli **Scarica** per scaricare la chiave pubblica per il certificato.

   1. Per **File di chiave privata**, scegli **Scarica** per scaricare il file di chiave privata per il certificato.

   1. Consulta [l'autenticazione del server](https://docs.aws.amazon.com/iot/latest/developerguide/server-authentication.html) nella *Guida per gli AWS IoT sviluppatori* e scegli il certificato CA principale appropriato. Ti consigliamo di utilizzare gli endpoint Amazon Trust Services (ATS) e i certificati CA root ATS. In **Certificati CA root**, scegli **Scarica** per un certificato CA root.

   1. Seleziona **Fatto**.

   Prendi nota dell'ID del certificato che è comune nei nomi dei file per il certificato e le chiavi del dispositivo. perché sarà necessaria in seguito.

# Crea un AWS IoT Greengrass gruppo per il core
<a name="create-group"></a>

AWS IoT Greengrass *i gruppi* contengono impostazioni e altre informazioni sui relativi componenti, come dispositivi client, funzioni Lambda e connettori. Un gruppo definisce la configurazione di un core, incluso il modo in cui i suoi componenti possono interagire tra loro.

In questa sezione, crei un gruppo per il tuo core.

**Suggerimento**  
Per un esempio che utilizza l' AWS IoT Greengrass API per creare e distribuire un gruppo, consulta il repository [gg\$1group\$1setup](https://github.com/awslabs/aws-greengrass-group-setup) su. GitHub

**Per creare un gruppo per il core**

1. Passare alla [console AWS IoT](https://console.aws.amazon.com/iot).

1. In **Gestisci**, espandi **i dispositivi Greengrass** e scegli **Gruppi (V1)**.
**Nota**  
Se non vedi il menu dei **dispositivi Greengrass**, passa a uno Regione AWS che supporti. AWS IoT Greengrass V1 Per l'elenco delle regioni supportate, consulta [Endpoint e quote AWS IoT Greengrass V1](https://docs.aws.amazon.com/general/latest/gr/greengrass.html) in *Riferimenti generali di AWS*. Devi [creare il dispositivo per AWS IoT il tuo core](provision-core.md) in una regione in cui AWS IoT Greengrass V1 è disponibile.

1. Nella pagina dei **gruppi Greengrass**, scegli **Crea** gruppo.

1. Nella pagina del **gruppo Create Greengrass**, effettuate le seguenti operazioni:

   1. Per il **nome del gruppo Greengrass**, inserisci un nome che descriva il gruppo, ad esempio. **MyGreengrassGroup**

   1. Per **Greengrass core**, scegli AWS IoT ciò che hai creato in precedenza, ad esempio **MyGreengrassV1Core**.

      La console seleziona automaticamente il certificato del dispositivo dell'oggetto.

   1. Seleziona **Crea gruppo**.

# Installa ed esegui AWS IoT Greengrass sul dispositivo principale
<a name="start-greengrass"></a>

**Nota**  
Questo tutorial fornisce istruzioni per eseguire il software AWS IoT Greengrass Core su un Raspberry Pi, ma puoi utilizzare qualsiasi dispositivo supportato.

In questa sezione, configuri, installi ed esegui il software AWS IoT Greengrass Core sul tuo dispositivo principale.

**Per installare ed eseguire AWS IoT Greengrass**

1. Dalla sezione [AWS IoT Greengrass Core software](what-is-gg.md#gg-core-download-tab) di questa guida, scaricate il pacchetto di installazione del software AWS IoT Greengrass Core. Scegli il pacchetto che meglio si adatta all'architettura della CPU, alla distribuzione e al sistema operativo del tuo dispositivo core.
   + Per Raspberry Pi, scarica il pacchetto per l'architettura ARMv7L e il sistema operativo Linux.
   + Per un' EC2 istanza Amazon, scarica il pacchetto per l'architettura x86\$164 e il sistema operativo Linux.
   + Per NVIDIA Jetson TX2, scarica il pacchetto per l'architettura Armv8 () e il sistema operativo Linux. AArch64
   + Per Intel Atom, scarica il pacchetto per l'architettura x86\$164 e il sistema operativo Linux.

1. Nei passaggi precedenti, hai scaricato cinque file sul tuo computer:
   + `greengrass-OS-architecture-1.11.6.tar.gz`— Questo file compresso contiene il software AWS IoT Greengrass Core che viene eseguito sul dispositivo principale.
   + `certificateId-certificate.pem.crt`— Il file di certificato del dispositivo.
   + `certificateId-public.pem.key`— Il file della chiave pubblica del certificato del dispositivo.
   + `certificateId-private.pem.key`— Il file della chiave privata del certificato del dispositivo.
   + `AmazonRootCA1.pem`— Il file Amazon Root Certificate Authority (CA).

   In questa fase, trasferisci questi file dal computer al dispositivo principale. Esegui questa operazione:

   1. Se non conosci l'indirizzo IP del tuo dispositivo principale Greengrass, apri un terminale sul dispositivo principale ed esegui il seguente comando.
**Nota**  
Questo comando potrebbe non restituire l'indirizzo IP corretto per alcuni dispositivi. Consulta la documentazione del dispositivo per recuperare l'indirizzo IP del dispositivo.

      ```
      hostname -I
      ```

   1. <a name="transfer-files-to-device"></a>Trasferisci questi file dal computer al dispositivo principale. Le fasi di trasferimento dei file variano a seconda del sistema operativo del computer. Scegli il sistema operativo per le fasi che mostrano come trasferire i file sul tuo dispositivo Raspberry Pi.
**Nota**  
Per un Raspberry Pi, il nome utente predefinito è **pi** e la password predefinita è **raspberry**.  
Per un NVIDIA Jetson TX2, il nome utente predefinito è **nvidia** e la password predefinita è. **nvidia**

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

      Per trasferire i file compressi dal computer a un dispositivo principale Raspberry Pi, utilizza uno strumento come [WinSCP](https://winscp.net/eng/download.php) oppure il comando [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) **pscp** Per utilizzare il comando **pscp**, apri una finestra del prompt dei comandi sul computer ed esegui:

      ```
      cd path-to-downloaded-files
      pscp -pw Pi-password greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi
      pscp -pw Pi-password certificateId-certificate.pem.crt pi@IP-address:/home/pi
      pscp -pw Pi-password certificateId-public.pem.key pi@IP-address:/home/pi
      pscp -pw Pi-password certificateId-private.pem.key pi@IP-address:/home/pi
      pscp -pw Pi-password AmazonRootCA1.pem pi@IP-address:/home/pi
      ```

**Nota**  
<a name="use-correct-package-version"></a>Il numero di versione in questo comando deve corrispondere alla versione del pacchetto software AWS IoT Greengrass Core.

------
#### [ macOS ]

      Per trasferire i file compressi dal Mac a un dispositivo principale Raspberry Pi, apri una finestra del terminale sul computer ed esegui i comandi seguenti. In genere *path-to-downloaded-files* è`~/Downloads`.

**Nota**  
Potrebbe esserti richiesto di immettere due password. In questo caso, la prima password è per il comando `sudo` del Mac e la seconda è la password per il Raspberry Pi.

      ```
      cd path-to-downloaded-files
      scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi
      scp certificateId-certificate.pem.crt pi@IP-address:/home/pi
      scp certificateId-public.pem.key pi@IP-address:/home/pi
      scp certificateId-private.pem.key pi@IP-address:/home/pi
      scp AmazonRootCA1.pem pi@IP-address:/home/pi
      ```

**Nota**  
<a name="use-correct-package-version"></a>Il numero di versione in questo comando deve corrispondere alla versione del pacchetto software AWS IoT Greengrass Core.

------
#### [ UNIX-like system ]

      Per trasferire i file compressi dal computer a un dispositivo principale Raspberry Pi, apri una finestra del terminale sul computer ed esegui i comandi seguenti:

      ```
      cd path-to-downloaded-files
      scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi
      scp certificateId-certificate.pem.crt pi@IP-address:/home/pi
      scp certificateId-public.pem.key pi@IP-address:/home/pi
      scp certificateId-private.pem.key pi@IP-address:/home/pi
      scp AmazonRootCA1.pem pi@IP-address:/home/pi
      ```

**Nota**  
<a name="use-correct-package-version"></a>Il numero di versione di questo comando deve corrispondere alla versione del pacchetto software AWS IoT Greengrass Core.

------
#### [ Raspberry Pi web browser ]

      Se hai utilizzato il browser web del Raspberry Pi per scaricare i file compressi, i file dovrebbero trovarsi nella `~/Downloads` cartella del Raspberry Pi, ad esempio. `/home/pi/Downloads` Altrimenti, i file compressi dovrebbero trovarsi nella `~` cartella del Pi, ad esempio. `/home/pi`

------

1. Sul dispositivo principale Greengrass, apri un terminale e vai alla cartella che contiene il software e i AWS IoT Greengrass certificati Core. Sostituiscilo *path-to-transferred-files* con il percorso in cui hai trasferito i file sul dispositivo principale. Ad esempio, su un Raspberry Pi, `cd /home/pi` esegui.

   ```
   cd path-to-transferred-files
   ```

1. Disimballate il software AWS IoT Greengrass Core sul dispositivo principale. Esegui il comando seguente per decomprimere l'archivio software trasferito sul dispositivo principale. Questo comando utilizza l'`-C /`argomento per creare la `/greengrass` cartella nella cartella principale del dispositivo principale.

   ```
   sudo tar -xzvf greengrass-OS-architecture-1.11.6.tar.gz -C /
   ```
**Nota**  
<a name="use-correct-package-version"></a>Il numero di versione di questo comando deve corrispondere alla versione del pacchetto software AWS IoT Greengrass Core.

1. Spostate i certificati e le chiavi nella cartella del software AWS IoT Greengrass Core. Esegui i seguenti comandi per creare una cartella per i certificati e spostarvi i certificati e le chiavi. Sostituiscila *path-to-transferred-files* con il percorso in cui hai trasferito i file sul dispositivo principale e *certificateId* sostituiscila con l'ID del certificato nei nomi dei file. Ad esempio, su un Raspberry Pi, sostituisci *path-to-transferred-files* con **/home/pi**

   ```
   sudo mv path-to-transferred-files/certificateId-certificate.pem.crt /greengrass/certs
   sudo mv path-to-transferred-files/certificateId-public.pem.key /greengrass/certs
   sudo mv path-to-transferred-files/certificateId-private.pem.key /greengrass/certs
   sudo mv path-to-transferred-files/AmazonRootCA1.pem /greengrass/certs
   ```

1. Il software AWS IoT Greengrass Core utilizza un file di configurazione che specifica i parametri del software. Questo file di configurazione specifica i percorsi dei file di certificato e gli Cloud AWS endpoint da utilizzare. In questo passaggio, crei il file di configurazione del software AWS IoT Greengrass Core per il tuo core. Esegui questa operazione:

   1. Ottieni l'Amazon Resource Name (ARN) per le tue attività principali. AWS IoT Esegui questa operazione:

      1. Nella [AWS IoT console](https://console.aws.amazon.com/iot), in **Gestione**, in **Dispositivi Greengrass**, scegli **Gruppi (V1**).

      1. Nella pagina dei **gruppi Greengrass**, scegli il gruppo che hai creato in precedenza.

      1. In **Panoramica**, scegli **Greengrass core**.

      1. Nella pagina dei dettagli principali, copia l'**ARN dell'AWS IoT oggetto** e salvalo per utilizzarlo nel file di configurazione AWS IoT Greengrass Core.

   1. Ottieni l'endpoint dei dati del AWS IoT dispositivo per la tua Account AWS regione corrente. I dispositivi utilizzano questo endpoint per connettersi a oggetti simili AWS . AWS IoT Esegui questa operazione:

      1. Nella [AWS IoT console](https://console.aws.amazon.com/iot), scegli **Impostazioni.**

      1. In **Device data endpoint**, copia l'**endpoint** e salvalo per utilizzarlo nel file di configurazione AWS IoT Greengrass principale.

   1. Crea il file di configurazione del software AWS IoT Greengrass Core. Ad esempio, è possibile eseguire il comando seguente per utilizzare GNU nano per creare il file.

      ```
      sudo nano /greengrass/config/config.json
      ```

      Sostituisci il contenuto del file con il seguente documento JSON.

      ```
      {
        "coreThing" : {
          "caPath": "AmazonRootCA1.pem",
          "certPath": "certificateId-certificate.pem.crt",
          "keyPath": "certificateId-private.pem.key",
          "thingArn": "arn:aws:iot:region:account-id:thing/MyGreengrassV1Core",
          "iotHost": "device-data-prefix-ats.iot.region.amazonaws.com",
          "ggHost": "greengrass-ats.iot.region.amazonaws.com",
          "keepAlive": 600
        },
        "runtime": {
          "cgroup": {
            "useSystemd": "yes"
          }
        },
        "managedRespawn": false,
        "crypto": {
          "caPath": "file:///greengrass/certs/AmazonRootCA1.pem",
          "principals": {
            "SecretsManager": {
              "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key"
            },
            "IoTCertificate": {
              "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key",
              "certificatePath": "file:///greengrass/certs/certificateId-certificate.pem.crt"
            }
          }
        }
      }
      ```

      Successivamente, esegui queste operazioni:
      + Se hai scaricato un certificato Amazon Root CA diverso da Amazon Root CA 1, sostituisci ogni istanza di *AmazonRootCA1.pem* con il nome del file Amazon root CA.
      + Sostituisci ogni istanza di *certificateId* con l'ID del certificato nel nome del certificato e dei file chiave.
      + Sostituiscilo *arn:aws:iot:*region*:*account-id*:thing/MyGreengrassV1Core* con l'ARN del file principale che hai salvato in precedenza.
      + Sostituiscilo *MyGreengrassV1core* con il nome dell'oggetto del tuo core.
      + *device-data-prefix-ats.iot.region.amazonaws.com*Sostituiscilo con l'endpoint dei dati del AWS IoT dispositivo che hai salvato in precedenza.
      + Sostituisci *region* con il tuo. Regione AWS

      Per ulteriori informazioni sulle opzioni di configurazione che è possibile specificare in questo file di configurazione, vedere[AWS IoT Greengrass file di configurazione principale](gg-core.md#config-json).

1. Assicurati che il dispositivo principale sia connesso a Internet. Quindi, avvia AWS IoT Greengrass dal tuo dispositivo principale.

   ```
   cd /greengrass/ggc/core/
   sudo ./greengrassd start
   ```

   Viene visualizzato un messaggio `Greengrass successfully started`. Prendere nota del PID.
**Nota**  
Per configurare il dispositivo principale in modo che si avvii AWS IoT Greengrass all'avvio del sistema, consulta[Configurazione del sistema di inizializzazione per avviare il daemon Greengrass](gg-core.md#start-on-boot).

   È possibile eseguire il comando seguente per confermare il funzionamento del software AWS IoT Greengrass Core (daemon Greengrass). Sostituisci *PID-number* con il tuo PID:

   ```
   ps aux | grep PID-number
   ```

   Dovresti visualizzare una voce per il PID con un percorso per il daemon Greengrass in esecuzione (ad esempio, `/greengrass/ggc/packages/1.11.6/bin/daemon`). Se riscontri problemi di avvio AWS IoT Greengrass, consulta[Risoluzione dei problemi AWS IoT Greengrass](gg-troubleshooting.md).