Installa AWS IoT Greengrass Software di base con provisioning personalizzato delle risorse

Installa il runtime Java, che AWS IoT Greengrass Il software principale richiede l'esecuzione. Ti consigliamo di utilizzare Amazon Corretto o Apri JDK versioni di supporto a lungo termine. È richiesta la versione 8 o successiva. I seguenti comandi mostrano come installare OpenJDK sul tuo dispositivo.

Al termine dell'installazione, esegui il comando seguente per verificare che Java funzioni sul tuo dispositivo Linux.

java -version

Il comando stampa la versione di Java in esecuzione sul dispositivo. Ad esempio, su un Debian-based distribuzione, l'output potrebbe essere simile all'esempio seguente.

openjdk version "11.0.9.1" 2020-11-04
OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

(Facoltativo) Crea l'utente e il gruppo di sistema predefiniti che eseguono i componenti sul dispositivo. Puoi anche scegliere di lasciare che AWS IoT Greengrass L'installatore del software principale crei questo utente e gruppo durante l'installazione con --component-default-user argomento dell'installatore. Per ulteriori informazioni, consulta Argomenti dell'installatore.

sudo useradd --system --create-home ggc_user
sudo groupadd --system ggc_group

Verifica che l'utente che esegue il AWS IoT Greengrass Software di base (in genere root), ha il permesso di funzionare sudo con qualsiasi utente e gruppo.

1. Esegui il seguente comando per aprire il /etc/sudoers file.

   sudo visudo

2. Verifica che l'autorizzazione per l'utente sia simile all'esempio seguente.

   root    ALL=(ALL:ALL) ALL

(Facoltativo) A eseguire funzioni Lambda containerizzate, è necessario abilitare cgroups v1, ed è necessario abilitare e montare il memoria e dispositivi gruppi. Se non hai intenzione di eseguire funzioni Lambda containerizzate, puoi saltare questo passaggio.

Per abilitare queste opzioni di cgroups, avvia il dispositivo con i seguenti parametri del kernel Linux.

cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

Per informazioni sulla visualizzazione e l'impostazione dei parametri del kernel per il dispositivo, consultate la documentazione del sistema operativo e del boot loader. Segui le istruzioni per impostare in modo permanente i parametri del kernel.

Installa tutte le altre dipendenze richieste sul tuo dispositivo come indicato dall'elenco dei requisiti in Requisiti per il dispositivo.

Installa il runtime Java, che AWS IoT Greengrass Il software principale richiede l'esecuzione. Ti consigliamo di utilizzare Amazon Corretto o Apri JDK versioni di supporto a lungo termine. È richiesta la versione 8 o successiva.

Verificare se Java è disponibile su PERCORSO variabile di sistema e aggiungila in caso contrario. La LocalSystem l'account esegue il AWS IoT Greengrass Software di base, quindi è necessario aggiungere Java alla variabile di sistema PATH anziché alla variabile utente PATH per l'utente. Esegui questa operazione:

1. Premete il tasto Windows per aprire il menu di avvio.

2. Digitare environment variables per cercare le opzioni di sistema dal menu di avvio.

3. Nei risultati di ricerca del menu di avvio, scegli Modifica le variabili di ambiente del sistema per aprire il proprietà del sistema finestra.

4. Scegli Variabili di ambiente... per aprire il Variabili d'ambiente finestra.

5. Sotto Variabili di sistema, seleziona Percorso, quindi scegli Modifica. Nel Modifica la variabile di ambiente finestra, puoi visualizzare ogni percorso su una riga separata.

6. Controlla se il percorso dell'installazione di Java è bin la cartella è presente. Il percorso potrebbe essere simile all'esempio seguente.

   C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

7. Se l'installazione di Java bin la cartella è mancante da Percorso, scegli Nuovo per aggiungerlo, quindi scegli OK.

Aprire il prompt dei comandi di Windows (cmd.exe) come amministratore.

Crea l'utente predefinito in LocalSystem account sul dispositivo Windows. Sostituisci password con una password sicura.

net user /add ggc_user password

Scarica e installa PsExec utilità da Microsoft sul dispositivo.

Usa il PsExec utilità per memorizzare il nome utente e la password per l'utente predefinito nell'istanza di Credential Manager per LocalSystem account. Sostituisci password con la password utente impostata in precedenza.

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

Se PsExec License Agreement si apre, scegli Accept per accettare la licenza ed eseguire il comando.

Sul tuo dispositivo principale, scarica AWS IoT Greengrass Software di base per un file denominato greengrass-nucleus-latest.zip.

Scaricando questo software accetti l'Accordo di licenza del software Greengrass Core.

(Facoltativo) Per verificare la firma del software Greengrass nucleus

1. Utilizzate il seguente comando per verificare la firma del vostro artefatto Greengrass Nucleus:

   Linux or Unix

   jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   Il nome del file potrebbe avere un aspetto diverso a seconda della versione JDK installata. Sostituisci jdk17.0.6_10 con la versione JDK installata.

   "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip

   PowerShell

   Il nome del file potrebbe avere un aspetto diverso a seconda della versione JDK installata. Sostituisci jdk17.0.6_10 con la versione JDK installata.

   'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip

2. La jarsigner l'invocazione produce un output che indica i risultati della verifica.

   1. Se il file zip Greengrass nucleus è firmato, l'output contiene la seguente dichiarazione:

      jar verified.

   2. Se il file zip Greengrass nucleus non è firmato, l'output contiene la seguente dichiarazione:

      jar is unsigned.

3. Se hai fornito il Jarsigner -certs opzione insieme a -verify e -verbose opzioni, l'output include anche informazioni dettagliate sul certificato del firmatario.

Decomprimi il AWS IoT Greengrass Software di base in una cartella del dispositivo. Sostituisci GreengrassInstaller con la cartella che desideri utilizzare.

(Facoltativo) Esegui il comando seguente per visualizzare la versione di AWS IoT Greengrass Software di base.

java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Controlla la versione di AWS IoT Greengrass Software di base.

java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Utilizzate un editor di testo per creare un file di configurazione denominato config.yaml da fornire all'installatore.

Ad esempio, su un Linux-based sistema, puoi eseguire il seguente comando per usare GNU nano per creare il file.

nano GreengrassInstaller/config.yaml

Copia il seguente contenuto YAML nel file.

---
system:
  rootpath: "/greengrass/v2"
  # The following values are optional. Return them from the provisioning plugin or set them here.
  # certificateFilePath: ""
  # privateKeyPath: ""
  # rootCaPath: ""
  # thingName: ""
services:
  aws.greengrass.Nucleus:
    version: "2.18.4"
    configuration:
      # The following values are optional. Return them from the provisioning plugin or set them here.
      # awsRegion: ""
      # iotRoleAlias: ""
      # iotDataEndpoint: ""
      # iotCredEndpoint: ""
  com.example.CustomProvisioning:
    configuration:
      # You can specify configuration parameters to provide to your plugin.
      # pluginParameter: ""

Successivamente, esegui queste operazioni:

---
system:
  rootpath: "/greengrass/v2"
  # The following values are optional. Return them from the provisioning plugin or set them here.
  # certificateFilePath: ""
  # privateKeyPath: ""
  # rootCaPath: ""
  # thingName: ""
services:
  aws.greengrass.Nucleus:
    version: "2.18.4"
    configuration:
      mqtt:
        port: 443
      greengrassDataPlanePort: 443
      networkProxy:
        noProxyAddresses: "http://192.168.0.1,www.example.com"
        proxy:
          url: "http://my-proxy-server:1100"
          username: "Mary_Major"
          password: "pass@word1357"
      # The following values are optional. Return them from the provisioning plugin or set them here.
      # awsRegion: ""
      # iotRoleAlias: ""
      # iotDataEndpoint: ""
      # iotCredEndpoint: ""
  com.example.CustomProvisioning:
    configuration:
      # You can specify configuration parameters to provide to your plugin.
      # pluginParameter: ""

Eseguire il programma di installazione. Specificare --trusted-plugin per fornire il plug-in di provisioning personalizzato e specificare --init-config per fornire il file di configurazione.

Se si specifica --setup-system-service true, il programma di installazione stampa Successfully set up Nucleus as a system service se ha impostato ed eseguito il software come servizio di sistema. Altrimenti, il programma di installazione non emette alcun messaggio se installa il software correttamente.

Verifica l'installazione visualizzando i file nella cartella principale.

Se l'installazione è riuscita, la cartella principale contiene diverse cartelle, ad esempio config, packages, e logs.