安装具有自定义资源配置功能的 C Amazon IoT Greengrass ore 软件

安装 Java 运行时， Amazon IoT Greengrass 核心软件需要运行该运行时。我们建议您使用 Amazon Cor retto 或 OpenJDK 长期支持版本。需要版本 8 或更高版本。以下命令向您展示了如何在您的设备上安装 OpenJDK。

安装完成后，运行以下命令以验证 Java 是否在您的 Linux 设备上运行。

java -version

该命令会打印设备上运行的 Java 版本。例如，在基于 Debian 的发行版上，输出可能与以下示例类似。

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)

（可选）创建在设备上运行组件的默认系统用户和组。您也可以选择让 Amazon IoT Greengrass 核心软件安装程序在安装过程中使用安装程序参数创建此用户和组。--component-default-user有关更多信息，请参阅 安装程序参数。

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

验证运行 Amazon IoT Greengrass Core 软件的用户（通常root）是否有权sudo与任何用户和任何组一起运行。

1. 运行以下命令打开该/etc/sudoers文件。

   sudo visudo

2. 验证用户的权限是否如以下示例所示。

   root    ALL=(ALL:ALL) ALL

（可选）要运行容器化 Lambda 函数，必须启用 c groups v1，并且必须启用并挂载内存和设备 cgroups。如果您不打算运行容器化 Lambda 函数，则可以跳过此步骤。

要启用这些 cgroups 选项，请使用以下 Linux 内核参数启动设备。

cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

有关查看和设置设备内核参数的信息，请参阅操作系统和启动加载程序的文档。按照说明永久设置内核参数。

按照中的要求列表所示，在您的设备上安装所有其他必需的依赖项设备要求。

安装 Java 运行时， Amazon IoT Greengrass 核心软件需要运行该运行时。我们建议您使用 Amazon Cor retto 或 OpenJDK 长期支持版本。需要版本 8 或更高版本。

检查 PATH 系统变量上是否有 Java 可用，如果没有，请添加它。该 LocalSystem 帐户运行 Amazon IoT Greengrass Core 软件，因此您必须将 Java 添加到 PATH 系统变量中，而不是用户的 PATH 用户变量。执行以下操作：

1. 按下 Windows 键打开开始菜单。

2. 键入environment variables以从 “开始” 菜单中搜索系统选项。

3. 在开始菜单搜索结果中，选择编辑系统环境变量以打开系统属性窗口。

4. 选择环境变量... 打开 “环境变量” 窗口。

5. 在 “系统变量” 下，选择 “路径”，然后选择 “编辑”。在 “编辑环境变量” 窗口中，可以在单独的行上查看每个路径。

6. 检查 Java 安装bin文件夹的路径是否存在。路径可能与以下示例类似。

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

7. 如果路径中缺少 Java 安装bin的文件夹，请选择 “新建” 将其添加，然后选择 “确定”。

以管理员身份打开 Windows 命令提示符 (cmd.exe)。

在 Windows 设备上的 LocalSystem 帐户中创建默认用户。将密码替换为安全密码。

net user /add ggc_user password

从微软下载该PsExec实用程序并将其安装到设备上。

使用该 PsExec 实用程序将默认用户的用户名和密码存储在 LocalSystem 账户的凭据管理器实例中。将密码替换为您之前设置的用户密码。

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

如果PsExec License Agreement打开，Accept请选择同意许可并运行命令。

在您的核心设备上，将 Amazon IoT Greengrass Core 软件下载到名为的文件中greengrass-nucleus-latest.zip。

下载此软件即表示您同意Greengrass Core 软件许可协议。

（可选）验证 Greengrass nucleus 软件签名

1. 使用以下命令验证你的 Greengrass 核工件的签名：

   Linux or Unix

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

   Windows Command Prompt (CMD)

   根据您安装的 JDK 版本，文件名可能有所不同。jdk17.0.6_10替换为您安装的 JDK 版本。

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

   PowerShell

   根据您安装的 JDK 版本，文件名可能有所不同。jdk17.0.6_10替换为您安装的 JDK 版本。

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

2. 该jarsigner调用会产生指示验证结果的输出。

   1. 如果 Greengrass nucleus zip 文件已签名，则输出将包含以下语句：

      jar verified.

   2. 如果 Greengrass nucleus zip 文件未签名，则输出将包含以下语句：

      jar is unsigned.

3. 如果您提供了 Jarsigner -certs 选项以及-verify和-verbose选项，则输出还包括详细的签名者证书信息。

将 Amazon IoT Greengrass Core 软件解压缩到设备上的某个文件夹。GreengrassInstaller替换为要使用的文件夹。

（可选）运行以下命令以查看 Amazon IoT Greengrass Core 软件的版本。

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

检查 Amazon IoT Greengrass 核心软件的版本。

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

使用文本编辑器创建名为的配置文件config.yaml以提供给安装程序。

例如，在基于 Linux 的系统上，你可以运行以下命令来使用 GNU nano 来创建文件。

nano GreengrassInstaller/config.yaml

将以下 YAML 内容复制到文件中。

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

然后执行以下操作：

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

运行安装程序。指定--trusted-plugin提供您的自定义配置插件，--init-config并指定提供配置文件。

如果您指定--setup-system-service true，则安装程序在将软件设置为系统服务并运行时会打印Successfully set up Nucleus as a system service出来。否则，如果安装程序成功安装了软件，则不会输出任何消息。

通过查看根文件夹中的文件来验证安装。

如果安装成功，则根文件夹包含多个文件夹，例如configpackages、和logs。