Instale el software AWS IoT Greengrass principal con aprovisionamiento de recursos personalizado

Instale el motor de ejecución de Java, que el software AWS IoT Greengrass principal necesita para ejecutarse. Le recomendamos que utilice las versiones de soporte a JDK largo plazo de Amazon Corretto o Open. Se requiere la versión 8 o superior. Los siguientes comandos le muestran cómo instalar Open JDK en su dispositivo.

Cuando se complete la instalación, ejecute el siguiente comando para comprobar que Java se ejecuta en su dispositivo Linux.

java -version

El comando imprime la versión de Java que se ejecuta en el dispositivo. Por ejemplo, en una distribución basada en Debian, el resultado podría tener un aspecto similar al del siguiente ejemplo.

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)

(Opcional) Cree el usuario y el grupo predeterminados del sistema que ejecutan los componentes del dispositivo. También puede optar por permitir que el instalador del software AWS IoT Greengrass principal cree este usuario y grupo durante la instalación con el argumento del --component-default-user instalador. Para obtener más información, consulte Argumentos de instalación.

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

Compruebe que el usuario que ejecuta el software AWS IoT Greengrass principal (normalmenteroot) tiene permiso para ejecutar sudo con cualquier usuario y grupo.

1. Ejecute el siguiente comando para abrir el /etc/sudoers archivo.

   sudo visudo

2. Compruebe que el permiso del usuario es similar al del ejemplo siguiente.

   root    ALL=(ALL:ALL) ALL

(Opcional) Para ejecutar funciones Lambda en contenedores, debe habilitar cgroups v1 y debe habilitar y montar los cgroups de memoria y dispositivos. Si no planea ejecutar funciones Lambda en contenedores, puede omitir este paso.

Para habilitar estas opciones de cgroups, arranque el dispositivo con los siguientes parámetros del kernel de Linux.

cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

Para obtener información sobre cómo ver y configurar los parámetros del núcleo de su dispositivo, consulte la documentación del sistema operativo y del gestor de arranque. Siga las instrucciones para configurar permanentemente los parámetros del núcleo.

Instale todas las demás dependencias necesarias en su dispositivo tal y como se indica en Requisitos de los dispositivos la lista de requisitos de.

Instale el motor de ejecución de Java, que el software AWS IoT Greengrass principal necesita para ejecutarse. Le recomendamos que utilice las versiones de soporte a JDK largo plazo de Amazon Corretto o Open. Se requiere la versión 8 o superior.

Compruebe si Java está disponible en la variable de PATHsistema y agréguelo si no lo está. La LocalSystem cuenta ejecuta el software AWS IoT Greengrass principal, por lo que debe agregar Java a la variable de PATH sistema en lugar de a la variable de PATH usuario de su usuario. Haga lo siguiente:

1. Pulse la tecla Windows para abrir el menú de inicio.

2. Escriba environment variables para buscar las opciones del sistema en el menú de inicio.

3. En los resultados de la búsqueda del menú de inicio, seleccione Editar las variables de entorno del sistema para abrir la ventana de propiedades del sistema.

4. Seleccione Variables de entorno... para abrir la ventana Variables de entorno.

5. En Variables de sistema, seleccione Ruta y, a continuación, elija Editar. En la ventana Editar variables de entorno, puede ver cada ruta en una línea independiente.

6. Compruebe si la ruta a la bin carpeta de la instalación de Java está presente. La ruta puede tener un aspecto similar al del siguiente ejemplo.

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

7. Si la bin carpeta de la instalación de Java no aparece en Path, seleccione Nueva para añadirla y, a continuación, pulse Aceptar.

Abre la línea de comandos de Windows (cmd.exe) como administrador.

Cree el usuario predeterminado en la LocalSystem cuenta del dispositivo Windows. Reemplazar password con una contraseña segura.

net user /add ggc_user password

Descargue e instale la PsExecutilidad de Microsoft en el dispositivo.

Utilice la PsExec utilidad para almacenar el nombre de usuario y la contraseña del usuario predeterminado en la instancia de Credential Manager de la LocalSystem cuenta. Reemplazar password con la contraseña de usuario que configuró anteriormente.

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

Si se PsExec License Agreementabre, elija Acceptaceptar la licencia y ejecutar el comando.

En su dispositivo principal, descargue el software AWS IoT Greengrass Core en un archivo denominadogreengrass-nucleus-latest.zip.

Al descargar este software, acepta el acuerdo de licencia del software de Greengrass Core.

(Opcional) Para verificar la firma del software Greengrass Nucleus

1. Usa el siguiente comando para verificar la firma del artefacto núcleo de Greengrass:

   Linux or Unix

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

   Windows Command Prompt (CMD)

   El nombre del archivo puede tener un aspecto diferente en función de la JDK versión que instale. Reemplazar jdk17.0.6_10 con la versión que ha instalado. JDK

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

   PowerShell

   El nombre del archivo puede tener un aspecto diferente en función de la JDK versión que instale. Reemplazar jdk17.0.6_10 con la versión que ha instalado. JDK

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

2. La jarsigner invocación produce un resultado que indica los resultados de la verificación.

   1. Si el archivo zip del núcleo de Greengrass está firmado, el resultado contiene la siguiente declaración:

      jar verified.

   2. Si el archivo zip del núcleo de Greengrass no está firmado, el resultado contiene la siguiente declaración:

      jar is unsigned.

3. Si ha proporcionado la -certs opción Jarsigner junto con -verbose las opciones -verify y, el resultado también incluye información detallada del certificado de firmante.

Descomprime el software AWS IoT Greengrass principal en una carpeta de tu dispositivo. Reemplazar GreengrassInstaller con la carpeta que quieras usar.

(Opcional) Ejecute el siguiente comando para ver la versión del software AWS IoT Greengrass principal.

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

Compruebe la versión del software AWS IoT Greengrass principal.

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

Utilice un editor de texto para crear un archivo de configuración con el nombre config.yaml para proporcionárselo al instalador.

Por ejemplo, en un sistema basado en Linux, puede ejecutar el siguiente comando para usar GNU nano para crear el archivo.

nano GreengrassInstaller/config.yaml

Copie el siguiente YAML contenido en el archivo.

---
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.13.0"
    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: ""

A continuación, proceda del modo siguiente:

---
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.13.0"
    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: ""

Ejecute el instalador. Especifique si --trusted-plugin desea proporcionar su complemento de aprovisionamiento personalizado y especifique si desea --init-config proporcionar el archivo de configuración.

Si lo especifica--setup-system-service true, el instalador Successfully set up Nucleus as a system service imprimirá si configuró y ejecutó el software como un servicio del sistema. De lo contrario, el instalador no mostrará ningún mensaje si instala el software correctamente.

Compruebe la instalación consultando los archivos de la carpeta raíz.

Si la instalación se realizó correctamente, la carpeta raíz contiene varias carpetasconfig, comopackages, ylogs.