Instalación del software AWS IoT Greengrass Core con aprovisionamiento de recursos personalizado

Instale el tiempo de ejecución de Java, que el software AWS IoT Greengrass Core necesita para ejecutarse. Le recomendamos que utilice las versiones de compatibilidad a largo plazo de Amazon Corretto u OpenJDK. Se requiere la versión 8 o posterior. Los siguientes comandos muestran cómo instalar OpenJDK 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 ser similar al 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 predeterminado del sistema que ejecutan los componentes del dispositivo. También puede optar por permitir que el instalador del software AWS IoT Greengrass Core cree este usuario y grupo durante la instalación con el argumento del instalador --component-default-user. Para obtener más información, consulte Argumentos del instalador.

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

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

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

   sudo visudo

2. Compruebe que el permiso del usuario se parezca al siguiente ejemplo.

   root    ALL=(ALL:ALL) ALL

(Opcional) Para ejecutar funciones de Lambda en contenedores, debe habilitar la versión 1 de cgroups y debe habilitar y montar los cgroups de memoria y dispositivos. Si no tiene previsto ejecutar funciones de 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 más información acerca de cómo ver y configurar los parámetros del kernel 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 kernel.

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

Instale el tiempo de ejecución de Java, que el software AWS IoT Greengrass Core necesita para ejecutarse. Le recomendamos que utilice las versiones de compatibilidad a largo plazo de Amazon Corretto u OpenJDK. Se requiere la versión 8 o posterior.

Compruebe si Java está disponible en la variable del sistema PATH y agréguelo si no lo está. La cuenta LocalSystem ejecuta el software AWS IoT Greengrass Core, por lo que debe agregar Java a la variable del sistema PATH en lugar de a la variable de usuario PATH 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, elija Editar las variables de entorno del sistema para abrir la ventana de Propiedades del sistema.

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

5. En Variables del sistema, elija Ruta y, luego, Editar. En la ventana Editar variables de entorno, puede ver cada ruta en una línea independiente.

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

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

7. Si la carpeta de la instalación de Java bin no aparece en Ruta, elija Nueva para agregarla y, a continuación, pulse Aceptar.

Abra el símbolo del sistema de Windows (cmd.exe) como administrador.

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

net user /add ggc_user password

Descargue e instale la utilidad PsExec de Microsoft en el dispositivo.

Use la utilidad PsExec para almacenar el nombre de usuario y la contraseña del usuario predeterminado en la instancia del administrador de credenciales de la cuenta de LocalSystem. Reemplace password por la contraseña del usuario que configuró anteriormente.

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

Si PsExec License Agreement se abre, elija Accept para aceptar la licencia y ejecute el comando.

En su dispositivo principal, descargue el software AWS IoT Greengrass Core a un archivo denominado greengrass-nucleus-latest.zip.

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

(Opcional) Verificación de la firma del software del núcleo de Greengrass

1. Use el siguiente comando para verificar la firma del artefacto del 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 según la versión de JDK que instale. Reemplace jdk17.0.6_10 por la versión de JDK que instaló.

   "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 según la versión de JDK que instale. Reemplace jdk17.0.6_10 por la versión de JDK que instaló.

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

2. La invocación jarsigner 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 opción -certs Jarsigner junto con las opciones -verify y -verbose, el resultado también incluye información detallada del certificado de firmante.

Descomprima el software AWS IoT Greengrass Core a una carpeta de su dispositivo. Reemplace GreengrassInstaller por la carpeta que desee usar.

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

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

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

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

Use un editor de texto para crear un archivo de configuración llamado config.yaml para proporcionárselo al instalador.

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

nano GreengrassInstaller/config.yaml

Copie el siguiente contenido YAML 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 --trusted-plugin para proporcionar su complemento de aprovisionamiento personalizado y especifique --init-config para proporcionar el archivo de configuración.

Si especifica --setup-system-service true, el instalador imprime Successfully set up Nucleus as a system service 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.

Verifique la instalación mediante la consulta de los archivos de la carpeta raíz.

Si la instalación se realizó correctamente, la carpeta raíz contiene varias carpetas, como config, packages y logs.