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

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

安装完成后，运行以下命令以验证 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 Corrett o 或JDK开放长期支持版本。需要版本 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 帐户中创建默认用户。Replace（替换） password 使用安全的密码。

net user /add ggc_user password

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

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

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版本，文件名可能有所不同。Replace（替换） 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版本，文件名可能有所不同。Replace（替换） 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 软件解压缩到设备上的某个文件夹。Replace（替换） 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.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: ""

然后执行以下操作：

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

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

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

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

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