安装 AWS IoT Greengrass Core 软件

卸载 AWS IoT Greengrass Core 软件并保留配置信息

• 运行以下命令，以删除 AWS IoT Greengrass Core 软件包并将配置信息保留在 /greengrass 文件夹中。

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

卸载 AWS IoT Greengrass Core 软件并删除配置信息

1. 运行以下命令，以删除 AWS IoT Greengrass Core 软件包并从 /greengrass folder 中删除配置信息。

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

2. 从来源列表中删除 AWS IoT Greengrass Core 软件存储库。有关更多信息，请参阅 删除 AWS IoT Greengrass Core 软件存储库来源。

从来源列表中删除 APT 存储库

• 运行以下命令，以从来源列表中删除 AWS IoT Greengrass Core 软件存储库。

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

1. 通过在设备的终端中运行以下命令来安装 core18 snap：

   sudo snap install core18

   core18 Snap 是一种基础 Snap，为运行时环境提供了常用的库。此 Snap 是基于 Ubuntu 18. 04 LTS 构建的。

2. 通过运行以下命令来升级 snapd：

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

3. 运行 snap list 命令，以检查是否安装了 AWS IoT Greengrass Snap。

   以下示例响应显示 snapd 已经安装，但 aws-iot-greengrass 尚未安装。

   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. 选择以下选项之一，以安装 AWS IoT Greengrass Snap 1.11.x。

   • 要安装 AWS IoT Greengrass snap，请运行下面的命令：

     sudo snap install aws-iot-greengrass

     响应示例：

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

   • 要从早期版本迁移到 v1.11.x 或更新为最新的可用补丁版本，请运行以下命令：

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

   与其他 Snap 一样，AWS IoT Greengrass Snap 使用频道来管理次要版本。Snap 会自动更新至当前频道的最新可用版本。例如，如果您指定 --channel=1.11.x，则 AWS IoT Greengrass Snap 会更新到 v1.11.5。

   您可以运行 snap info aws-iot-greengrass 命令来获取可供 AWS IoT Greengrass 使用的频道列表。

   响应示例：

   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. 要访问 Lambda 函数所需的特定资源，您可以连接到其他接口。

   运行以下命令，以获取 AWS IoT Greengrass Snap 支持的接口列表：

   snap connections aws-iot-greengrass

   响应示例：

   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      -

   如果您在 Slot 列中看到连字符 (-)，则表示相应接口尚未连接。

6. 按照安装 AWS IoT Greengrass Core 软件的步骤操作，以创建 AWS IoT 事物、Greengrass 组、支持与 AWS IoT 进行安全通信的安全资源，以及 AWS IoT Greengrass Core 软件配置文件。配置文件 config.json 包含特定于 Greengrass 核心的配置，例如证书文件的位置和 AWS IoT 设备数据端点。

   注意

   如果您将该文件下载到其他设备，请按照此步骤操作，将文件传输到 AWS IoT Greengrass 核心设备。

7. 对于 AWS IoT Greengrass Snap，请务必更新 config.json 文件，如下所示：

   • 将 certificateId 的每个实例替换为证书和密钥文件名称中的证书 ID。

   • 如果您下载的亚马逊根 CA 证书与亚马逊根 CA 1 的证书不同，请将 ca1.pem 的每个 AmazonRootca1.pem 实例替换为亚马逊根 CA 文件的名称。

   {
     ...
     "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. 运行以下命令以添加您的 AWS IoT Greengrass 证书和配置文件：

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

1. 运行以下命令，以启动 AWS IoT Greengrass 进程守护程序。

   sudo snap start aws-iot-greengrass

   响应示例：

   Started.

   注意

   如果看到错误，您可以使用 snap run 命令来获取详细的错误消息。有关问故障排除的更多信息，请参阅错误：无法执行以下任务：-对 snap “” 的服务 ["greengrassd"] 运行服务命令 “start”（[start aws-iot-greengrass snap。 aws-iot-greengrass.greengrassd.service] 失败，退出状态 1：Job for snap。 aws-iot-greengrass.greengrassd.service 失败，因为控制进程退出时出现错误代码。 请参阅 “systemctl 状态快照”。 aws-iot-greengrass.greengrassd.service” 和 “journalctl-xe” 了解详情。）。

2. 运行以下命令，以确认进程守护程序正在运行：

   snap services aws-iot-greengrass.greengrassd

   响应示例：

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

3. 按照模块 3（第 1 部分）：AWS IoT Greengrass 上的 Lambda 函数中所述，开始创建和部署 Hello World Lambda 函数。但在部署 Lambda 函数之前，请先完成下面这一步。

4. 确保您的 Lambda 函数以 snap_daemon 用户身份在无容器模式下运行。要更新 Greengrass 组设置，请在 AWS IoT Greengrass 控制台中执行以下操作：

   1. 登录 AWS IoT Greengrass 控制台。

   2. 在 AWS IoT 控制台导航窗格的管理下，展开 Greengrass 设备，然后选择组 (V1)。

   3. 在 Greengrass 组下，选择目标组。

   4. 在组配置页面上的导航窗格中，选择 Lambda 函数选项卡。

   5. 在默认 Lambda 函数运行时环境下，选择编辑，然后执行以下操作：

      1. 在默认系统用户和组中，选择其他用户 ID/组 ID，然后在系统用户 ID（数字）和系统组 ID（数字）中都输入 584788。

      2. 对于默认 Lambda 函数容器化，请选择无容器。

      3. 选择保存。

存档当前安装并安装新版本

1. 下载您要升级到的 AWS IoT Greengrass Core 软件安装程序包。

2. 将此程序包复制到目标核心设备。有关描述如何传输文件的说明，请参阅此步骤。

   注意

   稍后，您将当前的证书、密钥和配置文件复制到新的安装。

   在核心设备终端中，在以下步骤中运行命令。

3. 确保 Greengrass 守护进程在您的核心设备上停止。

   1. 要检查进程守护程序是否正在运行，请执行以下操作：

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

      如果输出包含 root 的 /greengrass/ggc/packages/ggc-version/bin/daemon 条目，则表示进程守护程序正在运行。

      注意

      编写此过程的前提是 AWS IoT Greengrass 核心软件已安装在 /greengrass 目录中。

   2. 停止 进程守护程序：

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

4. 将当前 Greengrass 根目录移至其他目录。

   sudo mv /greengrass /greengrass_backup

5. 将新的软件解压缩到核心设备上。替换命令中的 os-architecture 和 version 占位符。

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

6. 将存档的证书、密钥和配置文件复制到新的安装。

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

7. 启动守护程序：

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

还原已存档的安装

1. 停止守护程序。

2. 删除新的 /greengrass 目录。

3. 将 /greengrass_backup 目录移回 /greengrass。

4. 启动进程守护程序。