安装具有 Amazon IoT 队列配置功能的 C Amazon IoT Greengrass ore 软件

1. 获取您的 Amazon IoT 数据端点 Amazon Web Services 账户。

   aws iot describe-endpoint --endpoint-type iot:Data-ATS

   如果请求成功，响应类似如下示例。

   {
     "endpointAddress": "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
   }

2. 获取您的 Amazon IoT 凭证终端节点 Amazon Web Services 账户。

   aws iot describe-endpoint --endpoint-type iot:CredentialProvider

   如果请求成功，响应类似如下示例。

   {
     "endpointAddress": "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
   }

将声明证书下载到设备

1. 将声明证书和私钥复制到设备。如果在开发计算机和设备上启用了 SSH 和 SCP，则可以在开发计算机上使用 scp 命令传输声明证书和私钥。以下示例命令会将开发计算机上名为 claim-certs 的文件夹中的这些文件传输到设备。device-ip-address替换为设备的 IP 地址。

   scp -r claim-certs/ device-ip-address:~

2. 在设备上创建 Greengrass 根文件夹。稍后，您将将 Amazon IoT Greengrass Core 软件安装到此文件夹。

   注意

   Windows 的路径长度限制为 260 个字符。如果您使用的是 Windows，请使用 C:\greengrass\v2 或 D:\greengrass\v2 等根文件夹，将 Greengrass 组件的路径保持在 260 个字符的限制以下。

   Linux or Unix

   • 将 /greengrass/v2 替换为要使用的文件夹。

   sudo mkdir -p /greengrass/v2

   Windows Command Prompt

   • 将 C:\greengrass\v2 替换为要使用的文件夹。

   mkdir C:\greengrass\v2

   PowerShell

   • 将 C:\greengrass\v2 替换为要使用的文件夹。

   mkdir C:\greengrass\v2

3. （仅限 Linux）设置 Greengrass 根文件夹的父文件夹的权限。

   • /greengrass替换为根文件夹的父文件夹。

   sudo chmod 755 /greengrass

4. 将声明证书移动到 Greengrass 根文件夹。

   • 用 Greengrass 根文件夹替换/greengrass/v2或C:\greengrass\v2。

   Linux or Unix

   sudo mv ~/claim-certs /greengrass/v2

   Windows Command Prompt (CMD)

   move %USERPROFILE%\claim-certs C:\greengrass\v2

   PowerShell

   mv -Path ~\claim-certs -Destination C:\greengrass\v2

5. 下载 Amazon 根证书颁发机构 (CA) 证书。 Amazon IoT 默认情况下，证书与亚马逊的根 CA 证书相关联。

   Linux or Unix

   sudo curl -o /greengrass/v2/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem

   Windows Command Prompt (CMD)

   curl -o C:\greengrass\v2\\AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem

   PowerShell

   iwr -Uri https://www.amazontrust.com/repository/AmazonRootCA1.pem -OutFile C:\greengrass\v2\\AmazonRootCA1.pem

设置 Linux 设备用于 Amazon IoT Greengrass V2

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

   • 对于基于 Debian 或基于 Ubuntua 的发行版：

     sudo apt install default-jdk

   • 对于基于 Red Hat 的发行版：

     sudo yum install java-11-openjdk-devel

   • 对于 Amazon Linux 2：

     sudo amazon-linux-extras install java-openjdk11

   • 对于 Amazon Linux 2023：

     sudo dnf install java-11-amazon-corretto -y

   安装完成后，运行以下命令以验证 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)

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

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

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

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

      sudo visudo

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

      root    ALL=(ALL:ALL) ALL

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

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

   cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

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

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

要将 Windows 设备设置为 Amazon IoT Greengrass V2

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

2. 检查在 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 文件夹，请选择新建，添加该文件夹，然后选择确定。

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

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

   net user /add ggc_user password

   提示

   根据您的 Windows 配置，用户密码可能会设置为在将来某个日期过期。为确保您的 Greengrass 应用程序继续运行，请跟踪密码过期时间，并在密码过期之前对其进行更新。您还可以将用户的密码设置为永不过期。

   • 要检查用户及其密码的过期时间，请运行以下命令。

     net user ggc_user | findstr /C:expires

   • 要将用户密码设置为永不过期，请运行以下命令。

     wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

   • 如果你使用的是已弃用该wmic命令的 Windows 10 或更高版本，请运行以下 PowerShell 命令。

     Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

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

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

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

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

   注意

   在 Windows 设备上，该 LocalSystem 帐户运行 Greengrass 核心，您必须使用 PsExec 该实用程序在帐户中存储默认用户信息。 LocalSystem 使用凭据管理器应用程序将此信息存储在当前登录用户的 Windows 帐户中，而不是 LocalSystem 帐户中。

下载 Amazon IoT Greengrass 核心软件

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

   Linux or Unix

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   PowerShell

   iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

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

2. （可选）验证 Greengrass Nucleus 软件签名

   注意

   此功能适用于 Greengrass Nucleus 版本 2.9.5 及更高版本。

   1. 使用以下命令验证您 Greengrass Nucleus 构件的签名：

      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 选项，则输出还将包含详细的签名者证书信息。

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

   Linux or Unix

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip

   PowerShell

   Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller
   rm greengrass-nucleus-latest.zip

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

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

下载 Amazon IoT 舰队配置插件

• 在您的设备上，将 Amazon IoT 队列配置插件下载到名为的文件中aws.greengrass.FleetProvisioningByClaim.jar。GreengrassInstaller替换为要使用的文件夹。

  Linux or Unix

  curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

  Windows Command Prompt (CMD)

  curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

  PowerShell

  iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar -OutFile GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

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

安装 Amazon IoT Greengrass 核心软件

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

   • GreengrassInstaller替换为包含该软件的文件夹的路径。

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

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

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

   nano GreengrassInstaller/config.yaml

   将以下 YAML 内容复制到该文件中。此部分配置文件会指定实例集预置插件的参数。有关可以指定的选项的更多信息，请参阅配置 Amazon IoT 舰队配置插件。

   Linux or Unix

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "/greengrass/v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt"
         claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key"
         rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"

   Windows

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "C:\\greengrass\\v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "C:\\greengrass\\v2\\claim-certs\\claim.pem.crt"
         claimCertificatePrivateKeyPath: "C:\\greengrass\\v2\\claim-certs\\claim.private.pem.key"
         rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"

   然后执行以下操作：

   • 2.14.0替换为 Amazon IoT Greengrass Core 软件的版本。

   • 用 Greengrass 根C:\greengrass\v2文件夹替换/greengrass/v2或的每个实例。

     注意

     在 Windows 设备上，您必须将路径分隔符指定为双反斜杠 (\\)，例如 C:\\greengrass\\v2。

   • us-west-2替换为您创建置备模板和其他资源的 Amazon 区域。

   • iotDataEndpoint用您的 Amazon IoT 数据端点替换。

   • 用您的iotCredentialEndpoint Amazon IoT 凭证终端节点替换。

   • GreengrassCoreTokenExchangeRoleAlias替换为令牌交换角色别名的名称。

   • GreengrassFleetProvisioningTemplate替换为队列配置模板的名称。

   • 将 claimCertificatePath 替换为设备上声明证书的路径。

   • 将 claimCertificatePrivateKeyPath 替换为设备上声明证书私钥的路径。

   • 将模板参数（templateParameters）替换为用于预置设备的值。此示例参考用于定义 ThingName 和 ThingGroupName 参数的示例模板。

   注意

   在此配置文件中，您可以自定义其他配置选项（例如要使用的端口和网络代理），如以下示例所示。有关更多信息，请参阅 Greengrass Nucleus 配置。

   Linux or Unix

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.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"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "/greengrass/v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt"
         claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key"
         rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"
         mqttPort: 443
         proxyUrl: "http://my-proxy-server:1100"
         proxyUserName: "Mary_Major"
         proxyPassword: "pass@word1357"

   Windows

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.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"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "C:\\greengrass\\v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "C:\\greengrass\\v2\\claim-certs\\claim.pem.crt"
         claimCertificatePrivateKeyPath: "C:\\greengrass\\v2\\claim-certs\\claim.private.pem.key"
         rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"
         mqttPort: 443
         proxyUrl: "http://my-proxy-server:1100"
         proxyUserName: "Mary_Major"
         proxyPassword: "pass@word1357"

   要使用 HTTPS 代理，您必须使用 1.1.0 版本或更高版本的实例集预置插件。您还必须在 system 下指定 rootCaPath，如以下示例所示。

   Linux or Unix

   ---
   system:
     rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
   services:
     ...

   Windows

   ---
   system:
     rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem"
   services:
     ...

3. 运行安装程序。指定 --trusted-plugin 来提供实例集预置插件，并指定 --init-config 来提供配置文件。

   • 将 /greengrass/v2 替换为 Greengrass 根文件夹。

   • 将的GreengrassInstaller每个实例替换为解压安装程序所在的文件夹。

   Linux or Unix

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar \
     --init-config ./GreengrassInstaller/config.yaml \
     --component-default-user ggc_user:ggc_group \
     --setup-system-service true

   Windows Command Prompt (CMD)

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
     -jar ./GreengrassInstaller/lib/Greengrass.jar ^
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar ^
     --init-config ./GreengrassInstaller/config.yaml ^
     --component-default-user ggc_user ^
     --setup-system-service true

   PowerShell

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
     -jar ./GreengrassInstaller/lib/Greengrass.jar `
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar `
     --init-config ./GreengrassInstaller/config.yaml `
     --component-default-user ggc_user `
     --setup-system-service true

   重要

   在 Windows 核心设备上，--setup-system-service true必须指定将 Amazon IoT Greengrass 核心软件设置为系统服务。

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

   注意

   在没有 deploy-dev-tools 参数的情况下运行安装程序时，您不能使用 --provision true 参数来部署本地开发工具。有关直接在您的设备上部署 Greengrass CLI 的信息，请参阅 Greengrass 命令行界面。

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

   Linux or Unix

   ls /greengrass/v2

   Windows Command Prompt (CMD)

   dir C:\greengrass\v2

   PowerShell

   ls C:\greengrass\v2

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