Instalación del software AWS IoT Greengrass Core

Para desinstalar el software AWS IoT Greengrass Core y conservar la información de configuración

• Ejecute el siguiente comando para eliminar los paquetes de software AWS IoT Greengrass Core y conservar la información de configuración en la carpeta /greengrass.

  sudo apt remove aws-iot-greengrass-core aws-iot-greengrass-keyring

Para desinstalar el software AWS IoT Greengrass core y conservar la información de configuración

1. Ejecute el siguiente comando para eliminar los paquetes de software AWS IoT Greengrass Core y eliminar la información de configuración de /greengrass folder.

   sudo apt purge aws-iot-greengrass-core aws-iot-greengrass-keyring

2. Elimine el repositorio de software AWS IoT Greengrass Core de su lista de fuentes. Para obtener más información, consulte Elimine las fuentes del repositorio del software AWS IoT Greengrass Core.

Para eliminar el repositorio de APT de la lista de fuentes

• Ejecute los siguientes comandos para eliminar el repositorio del software AWS IoT Greengrass Core de la lista de fuentes.

  sudo rm /etc/apt/sources.list.d/greengrass.list
  sudo apt update

1. Instale el snap de core18 ejecutando el siguiente comando en el terminal del dispositivo:

   sudo snap install core18

   El snap core18 es una snap básico que proporciona un entorno de tiempo de ejecución con bibliotecas de uso frecuente. Este snap se ha creado a partir de Ubuntu 18.04 LTS.

2. Actualice snapd ejecutando el siguiente comando:

   sudo snap install --channel=edge snapd; sudo snap refresh --channel=edge snapd

3. Ejecute el comando snap list para comprobar si tiene el snap AWS IoT Greengrass instalado.

   El siguiente ejemplo de respuesta muestra que snapd está instalado, pero aws-iot-greengrass no lo está.

   Name              Version               Rev    Tracking         Publisher   Notes
   amazon-ssm-agent  3.0.161.0             2996   latest/stable/…  aws✓        classic
   core              16-2.48               10444  latest/stable    canonical✓  core
   core18            20200929              1932   latest/stable    canonical✓  base
   lxd               4.0.4                 18150  4.0/stable/…     canonical✓  -
   snapd             2.48+git548.g929ccfb  10526  latest/edge      canonical✓  snapd

4. Elija una de las siguientes opciones para instalar el snap AWS IoT Greengrass 1.11.x.

   • Ejecute el siguiente siguiente comando para instalar el snap de AWS IoT Greengrass.

     sudo snap install aws-iot-greengrass

     Respuesta de ejemplo:

     aws-iot-greengrass 1.11.5 from Amazon Web Services (aws) installed

   • Para migrar de una versión anterior a la versión 1.11.x o actualizar a la última versión de parche disponible, ejecute el siguiente comando:

     sudo snap refresh --channel=1.11.x aws-iot-greengrass

   Al igual que otros snaps, el snap AWS IoT Greengrass usa canales para administrar las versiones secundarias. Los snaps se actualizan automáticamente a la última versión del canal actual. Por ejemplo, si especifica --channel=1.11.x, su snap AWS IoT Greengrass se actualiza a la versión 1.11.5.

   Puede ejecutar el comando snap info aws-iot-greengrass para obtener la lista de canales disponibles para AWS IoT Greengrass.

   Respuesta de ejemplo:

   name:      aws-iot-greengrass
   summary:   AWS supported software that extends cloud capabilities to local devices.
   publisher: Amazon Web Services (aws✓)
   store-url: https://snapcraft.io/aws-iot-greengrass
   contact:   https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass
   license:   Proprietary
   description: |
     AWS IoT Greengrass seamlessly extends AWS onto edge devices so they can act locally on the data
     they generate, while still using the cloud for management, analytics, and durable storage.
     AWS IoT Greenrgrass snap v1.11.0 enables you to run a limited version of AWS IoT Greengrass with
     all necessary dependencies in a containerized environment.
     The AWS IoT Greengrass snap doesn't support connectors and machine learning (ML) inference.
     By downloading this software you agree to the Greengrass Core Software License Agreement
     (https://s3-us-west-2.amazonaws.com/greengrass-release-license/greengrass-license-v1.pdf).
     For more information, see Run AWS IoT Greengrass in a snap
     (https://docs.aws.amazon.com/greengrass/latest/developerguide/install-ggc.html#gg-snap-support) in
     the AWS IoT Greengrass Developer.
     If you need help, try the AWS IoT Greengrass tag on AWS re:Post
     (https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass) or connect with an AWS IQ expert
     (https://iq.aws.amazon.com/services/aws/greengrass).
   snap-id: SRDuhPJGj4XPxFNNZQKOTvURAp0wxKnd
   channels:
     latest/stable:    1.11.3 2021-06-15 (59) 111MB -
     latest/candidate: 1.11.3 2021-06-14 (59) 111MB -
     latest/beta:      1.11.3 2021-06-14 (59) 111MB -
     latest/edge:      1.11.3 2021-06-14 (59) 111MB -
     1.11.x/stable:    1.11.3 2021-06-15 (59) 111MB -
     1.11.x/candidate: 1.11.3 2021-06-15 (59) 111MB -
     1.11.x/beta:      1.11.3 2021-06-15 (59) 111MB -
     1.11.x/edge:      1.11.3 2021-06-15 (59) 111MB -

5. Para acceder a los recursos específicos que necesitan sus funciones de Lambda, puede conectarse a interfaces adicionales.

   Ejecute el siguiente comando para obtener la lista de interfaces compatibles con el snap AWS IoT Greengrass:

   snap connections aws-iot-greengrass

   Respuesta de ejemplo:

   Interface                Plug                                                Slot                 Notes
   camera                   aws-iot-greengrass:camera                           -                    -
   dvb                      aws-iot-greengrass:dvb                              -                    -
   gpio                     aws-iot-greengrass:gpio                             -                    -
   gpio-memory-control      aws-iot-greengrass:gpio-memory-control              -                    -
   greengrass-support       aws-iot-greengrass:greengrass-support-no-container  :greengrass-support  -
   hardware-observe         aws-iot-greengrass:hardware-observe                 :hardware-observe    manual
   hardware-random-control  aws-iot-greengrass:hardware-random-control          -                    -
   home                     aws-iot-greengrass:home-for-greengrassd             -                    -
   home                     aws-iot-greengrass:home-for-hooks                   :home                manual
   hugepages-control        aws-iot-greengrass:hugepages-control                :hugepages-control   manual
   i2c                      aws-iot-greengrass:i2c                              -                    -
   iio                      aws-iot-greengrass:iio                              -                    -
   joystick                 aws-iot-greengrass:joystick                         -                    -
   log-observe              aws-iot-greengrass:log-observe                      :log-observe         manual
   mount-observe            aws-iot-greengrass:mount-observe                    :mount-observe       manual
   network                  aws-iot-greengrass:network                          :network             -
   network-bind             aws-iot-greengrass:network-bind                     :network-bind        -
   network-control          aws-iot-greengrass:network-control                  :network-control     -
   opengl                   aws-iot-greengrass:opengl                           :opengl              -
   optical-drive            aws-iot-greengrass:optical-drive                    :optical-drive       -
   process-control          aws-iot-greengrass:process-control                  :process-control     -
   raw-usb                  aws-iot-greengrass:raw-usb                          -                    -
   removable-media          aws-iot-greengrass:removable-media                  -                    -
   serial-port              aws-iot-greengrass:serial-port                      -                    -
   spi                      aws-iot-greengrass:spi                              -                    -
   system-observe           aws-iot-greengrass:system-observe                   :system-observe      -

   Si ve un guion (-) en la columna Slot (Ranura), la interfaz correspondiente no está conectada.

6. Siga Instalación del software AWS IoT Greengrass Core para crear un objeto AWS IoT, un grupo de Greengrass, recursos de seguridad que permitan una comunicación segura con AWS IoT y el archivo de configuración del software de AWS IoT Greengrass Core. El archivo de configuración, config.json, contiene la configuración específica de su núcleo de Greengrass, como la ubicación de los archivos de certificado y el punto de enlace de datos del dispositivo AWS IoT.

   nota

   Si descargó el archivo en un dispositivo diferente, siga este paso para transferir los archivos al dispositivo del núcleo AWS IoT Greengrass.

7. Para el snap AWS IoT Greengrass, asegúrese de actualizar el archivo config.json, como se muestra a continuación:

   • Reemplace cada instancia de certificateId por la identificación del certificado en el nombre de los archivos de certificado y clave.

   • Si ha descargado un certificado de CA raíz de Amazon diferente al de Amazon Root CA 1, sustituya cada instancia de AmazonRootCA1.pem por el nombre del archivo de CA raíz de Amazon.

   {
     ...
     "crypto" : {
       "principals" : {
         "SecretsManager" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.keyy"
         },
         "IoTCertificate" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.key",
           "certificatePath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-certificate.pem.crt"
         }
       },
       "caPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/AmazonRootCA1.pem"
     },
     "writeDirectory": "/var/snap/aws-iot-greengrass/current/ggc-write-directory",
     "pidFileDirectory": "/var/snap/aws-iot-greengrass/current/pidFileDirectory"
   }

8. Ejecute el siguiente comando para añadir sus certificados de AWS IoT Greengrass y archivos de configuración:

   sudo snap set aws-iot-greengrass gg-certs=/home/ubuntu/my-certs

1. Ejecute el siguiente comando para iniciar el daemon de AWS IoT Greengrass.

   sudo snap start aws-iot-greengrass

   Respuesta de ejemplo:

   Started.

   nota

   Si aparece un error, puede usar el comando snap run para obtener un mensaje de error detallado. Para obtener más información sobre solución de problemas, consulte error: no se pueden realizar las siguientes tareas: - Ejecute el comando de servicio «start» para los servicios ["greengrassd"] de snap "" ([start snap. aws-iot-greengrass aws-iot-greengrass.greengrassd.service] falló con el estado de salida 1: Job for snap. aws-iot-greengrass.greengrassd.service falló porque el proceso de control finalizó con un código de error. Consulte «resumen de estado de systemctl». aws-iot-greengrass.greengrassd.service y journalctl -xe para obtener más información.) .

2. Ejecute el siguiente comando para confirmar que el daemon se está ejecutando:

   snap services aws-iot-greengrass.greengrassd

   Respuesta de ejemplo:

   Service                         Startup   Current  Notes
   aws-iot-greengrass.greengrassd  disabled  active   -

3. Siga el módulo 3 (parte 1): funciones de Lambda en AWS IoT Greengrass para crear e implementar una función de Lambda de Hello World. Sin embargo, antes de implementar la función de Lambda, complete el siguiente paso.

4. Asegúrese de que la función de Lambda se ejecute como usuario snap_daemon y en modo sin contenedor. Para actualizar la configuración de su grupo de Greengrass, haga lo siguiente en la consola de AWS IoT Greengrass:

   1. Inicie sesión en la consola de AWS IoT Greengrass.

   2. En el panel de navegación de la consola AWS IoT, en Administrar, expanda los dispositivos Greengrass y, a continuación, elija Grupos (V1).

   3. En Grupos de Greengrass, elija su grupo objetivo.

   4. En la página de configuración del grupo, en el panel de navegación, elija la pestaña Funciones de lambda

   5. En Entorno de tiempo de ejecución de funciones de Lambda predeterminado, elija Editar, y haga lo siguiente:

      1. En Usuario y grupo del sistema predeterminados, elija Otro ID de usuario/ID de grupo y, a continuación, introduzca 584788 tanto para ID de usuario del sistema (número) como para ID de grupo del sistema (número).

      2. Para la creación de contenedores predeterminada de la función de Lambda, elija Sin contenedor.

      3. Seleccione Guardar.

Para archivar la instalación actual e instalar una nueva versión

1. Descargue el paquete de instalación del software AWS IoT Greengrass Core al que desee actualizar.

2. Copie el paquete en el dispositivo de núcleo de destino. Para obtener instrucciones sobre cómo transferir archivos, consulte este paso.

   nota

   Copiará los certificados, las claves y el archivo de configuración actuales en la nueva instalación más adelante.

   Ejecute los comandos de los siguientes pasos en el terminal del dispositivo de núcleo.

3. Asegúrese de que el demonio de Greengrass está detenido en el dispositivo de núcleo.

   1. Para comprobar si el daemon está en ejecución:

      ps aux | grep -E 'greengrass.*daemon'

      Si la salida contiene una entrada root para /greengrass/ggc/packages/ggc-version/bin/daemon, el daemon está en ejecución.

      nota

      Este procedimiento parte del supuesto de que el software de AWS IoT Greengrass Core está instalado en el directorio /greengrass.

   2. Para detener el daemon :

      cd /greengrass/ggc/core/
      sudo ./greengrassd stop

4. Mueva el directorio raíz de Greengrass actual a otro directorio.

   sudo mv /greengrass /greengrass_backup

5. Descomprima el nuevo software en el dispositivo de núcleo. Sustituya los marcadores de posición os-architecture y version del comando.

   sudo tar –zxvf greengrass-os-architecture-version.tar.gz –C /

6. Copie los certificados, las claves y el archivo de configuración archivados en la nueva instalación.

   sudo cp /greengrass_backup/certs/* /greengrass/certs
   sudo cp /greengrass_backup/config/* /greengrass/config

7. Inicie el demonio:

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

Para restaurar la instalación archivada

1. Detenga el demonio.

2. Elimine el nuevo directorio /greengrass.

3. Mueva el directorio /greengrass_backup de nuevo a /greengrass.

4. Inicie el daemon.