本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置 AWS IoT Greengrass V1 SiteWise Edge 网关
边 AWS IoT SiteWise 缘网关充当您的工业设备和之间的中介 AWS IoT SiteWise。您可以在任何可以运行的设备上部署 SiteWise Edge 网关软件 AWS IoT Greengrass。有关更多信息,请参阅 选择 AWS IoT Greengrass V1 SiteWise Edge 网关设备。
您可以使用 E AWS IoT SiteWise dge 网关上的数据处理包在边 SiteWise 缘设备上本地处理数据。当您将 SiteWise Edge 网关添加到中时,即可执行此操作 AWS IoT SiteWise。有关在边缘处理数据的更多信息,请参阅 开启边缘数据处理。
注意
建议您与对您的本地和公司网络具有 IT 管理访问权限的人员完成以下步骤。这些步骤可能需要了解您的工业设备并有权配置防火墙设置的人员。
主题
设置 SiteWise Edge 网关环境
在此过程中,您将安装 AWS IoT Greengrass 并配置您的 SiteWise Edge 网关以与一起使用 AWS IoT SiteWise。
注意
此节包括使用 apt
命令安装软件包的说明。适用于运行 Ubuntu 或类似工具的系统。如果您使用的不是类似的系统,请参阅供您分发的文档并使用推荐的软件包安装程序。
设置 E SiteWise dge 网关
-
根据需要修改 SiteWise Edge 网关的BIOS
设置,如下所示。 -
如果适用,请确保 SiteWise Edge 网关在可能出现停电后自动重启。
-
如果适用,请确保 SiteWise Edge 网关不会进入休眠或睡眠状态。
-
-
确保 SiteWise Edge 网关连接到互联网。
-
(可选)要在没有鼠标、键盘和显示器的情况下使用 SiteWise Edge 网关,请执行以下步骤在 SiteWise Edge 网关
ssh
上进行设置:-
如果您尚未安装该SSH软件包,请运行以下命令。
sudo apt install ssh
-
运行以下命令。
service ssh status
-
在输出
Active: active (running)
中搜索以确认SSH服务器正在运行, -
按 Q 退出。
运行以下命令以用于从另一台计算机连接SSH到 SiteWise Edge 网关。Replace(替换)
username
使用用户登录和IP
使用边 SiteWise 缘网关的 IP 地址。ssh
username
@IP
您可以使用
-p
参数连接到默认端口 22 以外的端口。port-number
-
-
下载并安装 AWS IoT Greengrass 核心软件 v1.10.2 或更高版本,然后为您 SiteWise 的 Edge 网关创建一个 AWS IoT Greengrass 群组。为此,请参阅AWS IoT Greengrass 开发人员指南中的AWS IoT Greengrass入门。
建议您运行 AWS IoT Greengrass 设备设置脚本以快速开始。如果您想更仔细地查看 AWS IoT Greengrass 需求和流程,可以按照模块 1 和模块 2 中的步骤进行设置 AWS IoT Greengrass。
重要
查看支持AWSAWS IoT SiteWise 的地区。在为其选择区域时 AWS IoT Greengrass,请确保该区域也支持 AWS IoT SiteWise。否则,您将无法将 SiteWise Edge 网关连接到 AWS IoT SiteWise。
在继续下一步之前,您应该在 SiteWise Edge 网关上安装 AWS IoT Greengrass Core 软件。
-
运行以下命令安装 Java 8:
sudo apt update sudo apt install openjdk-8-jre
您将在本指南后面安装的 SiteWise Edge 网关软件使用 Java 8 运行时。
-
运行以下命令验证是否已成功安装 Java。
java -version
-
C AWS IoT Greengrass ore 软件假设一个
java8
目录。运行以下命令将 Java 安装链接到该java8
目录。sudo ln -s /usr/bin/java /usr/bin/java8
-
运行以下命令创建
/var/sitewise
数据目录并授予该目录的ggc_user
权限。 AWS IoT SiteWise 将数据存储在此目录中。您是在本过程 AWS IoT Greengrass 前面进行设置ggc_user
时创建的。sudo mkdir /var/sitewise sudo chown ggc_user /var/sitewise sudo chmod 700 /var/sitewise
/var/sitewise
是 AWS IoT SiteWise 使用的默认目录。您可以自定义目录路径(例如,/var/sitewise
替换为/var/
),但这样做需要在创建 SiteWise Edge 网关之后执行额外的步骤。有关更多信息,请参阅配置 AWS IoT SiteWise 连接器中的步骤 6。custom
/path
/ -
如果需要,请求您的 IT 管理员将以下终端节点和端口添加到本地网络的允许列表:
-
端口 443、8443 和 8883
重要
您可以将 AWS IoT Greengrass Core 配置为仅使用端口 443 进行所有网络通信。有关更多信息,请参阅AWS IoT Greengrass 开发人员指南中的通过端口 443 或网络代理连接。
-
您的 SiteWise 边缘网关的 IP 地址(端口 443)。要获取 IP 地址,请运行
ip address
或ifconfig
命令,并记下inet
值(例如,203.0.113.0
)。 -
AWS IoT SiteWise 数据端点:
data.iotsitewise.
(端口 443)。region
.amazonaws.com -
SiteWise Edge 网关使用的以下 AWS 终端节点。您可以在
/
文件中找到这些内容。Replace(替换)greengrass-root
/config/config.jsongreengrass-root
使用 AWS IoT Greengrass 安装的根目录。-
ggHost:
greengrass-ats.iot.
(端口 443、8443 和 8883)。region
.amazonaws.com -
iotHost:
(端口 443、8443 和 8883)。prefix
-ats.iot.region
.amazonaws.com
有关更多信息,请参阅 AWS IoT Greengrass 终端节点和限额。
-
-
-
如果 AWS IoT Greengrass Core 软件尚未运行,请运行以下命令来启动 AWS IoT Greengrass Core 软件。Replace(替换)
greengrass-root
使用 AWS IoT Greengrass 安装的根目录。默认greengrass-root
是/greengrass
。cd /
greengrass-root
/ggc/core sudo ./greengrassd start您应该会看到以下消息:
Greengrass successfully started with PID:
some-PID-number
-
将 AWS IoT Greengrass Core 软件配置为在 SiteWise Edge 网关开启时自动启动。请参阅 SiteWise Edge 网关操作系统的文档。
创建IAM策略和角色
您必须创建 AWS Identity and Access Management (IAM) 策略和角色才能允许 SiteWise Edge 网关 AWS IoT SiteWise 代表您进行访问。
创建IAM策略和角色
-
导航到 IAM 控制台
。 -
在导航窗格中,选择 策略,然后选择 创建策略。
-
在JSON选项卡上,删除策略字段的当前内容,然后将以下策略粘贴到该字段中。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*" } ] }
注意
为了提高安全性,您可以在
Condition
属性中指定 AWS IoT SiteWise 资产层次结构路径。以下示例是指定资产层次结构路径的信任策略。{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iotsitewise:BatchPutAssetPropertyValue", "Resource": "*", "Condition": { "StringLike": { "iotsitewise:assetHierarchyPath": [ "/
root node asset ID
", "/root node asset ID
/*" ] } } } ] } -
选择查看策略。
-
输入策略的名称和描述,然后选择 创建角色。
-
在导航窗格中,选择 角色,然后选择 创建角色。
-
在 选择受信任实体的类型 下,选择 AWS 服务。在 选择将使用此角色的服务 下面,选择 Greengrass 作为将使用该角色的服务,然后选择 下一步:权限。
-
搜索您创建的策略,选中复选框,然后选择下一步:标签。
-
(可选)将标签添加到您的角色,然后选择 下一步:审核。
-
输入角色的名称和描述,然后选择创建角色。
-
在绿色横幅中,选择指向新角色的链接。您还可以使用搜索字段查找该角色。
-
选择 信任关系 选项卡,然后选择 编辑信任关系。
-
将策略字段的当前内容替换为以下内容,然后选择 更新信任策略。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "greengrass.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
配置群 AWS IoT Greengrass 组
将IAM角色附加到群组并启用直播管理器
-
在左侧导航窗格中的 Greengrass 下,选择 组,然后选择您在 设置 SiteWise Edge 网关环境 中创建的组。
-
在左侧导航窗格中,选择 设置。在 组角色 部分中,选择 添加角色。
-
选择在 创建IAM策略和角色 中创建的角色,然后选择 保存。
-
在 设置 页面上的 流管理器 部分中,选择 编辑。
流管理器是一项功能 AWS IoT Greengrass ,它使您的 C AWS IoT Greengrass ore 能够将数据流式传输到 AWS 云端。 SiteWise Edge 网关要求启用流管理器。有关更多信息,请参阅《AWS IoT Greengrass Version 1 开发人员指南》中的管理 AWS IoT Greengrass 核心上的数据流。
-
选择 启用,然后选择 保存。
-
在左上角,选择 服务 为下一过程做好准备。
配置 AWS IoT SiteWise 连接器
在此过程中,您将在 Greengrass 组上配置 AWS IoT SiteWise 连接器。组件是预先构建的模块,可加快常见边缘场景的开发生命周期。有关更多信息,请参阅AWS IoT Greengrass Version 1 开发人员指南中的 AWS IoT Greengrass 连接器。
配置 AWS IoT SiteWise 连接器
-
在左侧导航窗格中的 Greengrass 下,选择 组,然后选择您在 设置 SiteWise Edge 网关环境 中创建的组。
-
在左侧导航页面中,选择 连接器。在连接器页面上,选择 添加连接器。
-
SiteWise从列表中选择 IoT,然后选择下一步。
-
如果您的服务器需要身份验证,则可以使用服务器的用户名和密码创建 AWS Secrets Manager 密钥。然后,您可以将每个密钥附加到您的 Greengrass 群组,然后在 “用户名/密码密钥列表” 下选择它们。ARNs有关如何创建和配置密钥的更多信息,请参阅 配置源认证。也可以稍后将密钥添加到连接器。
-
如果您将 SiteWise Edge 网关设置为不同的路径
/var/sitewise
,请输入该路径作为本地存储路径。 -
(可选)输入连接器的最大磁盘缓冲区大小。如果内 AWS IoT Greengrass 核失去与 AWS 云的连接,连接器会缓存数据,直到它能够成功连接。如果缓存大小超过最大磁盘缓冲区大小,则连接器会丢弃队列中最旧的数据。
-
选择添加。
-
在右上角的 操作 菜单中,选择 部署。
-
选择 自动检测 启动部署。
如果部署失败,请再次选择 Deploy (部署)。如果部署仍然失败,请参阅 AWS IoT Greengrass 部署故障排除。
将 SiteWise Edge 网关添加到 AWS IoT SiteWise
在此过程中,您将 SiteWise 边缘网关的 Greengrass 组添加到。 AWS IoT SiteWise向注册 SiteWise Edge 网关后 AWS IoT SiteWise,该服务可以将您的数据源配置部署到您的 SiteWise Edge 网关。
将 SiteWise Edge 网关添加到 AWS IoT SiteWise
-
导航到 AWS IoT SiteWise 控制台
。 -
选择 添加网关。
-
在添加 SiteWise 网关页面上,执行以下操作:
-
输入 E SiteWise dge 网关的名称。考虑在名称中包含 SiteWise Edge 网关的位置,这样您就可以轻松识别它。
-
在 Greengrass 组 ID 上,选择您此前创建的 Greengrass 组。
-
(可选)在边缘功能中,选择数据处理包。这使您的 SiteWise Edge 网关与为边缘配置的任何资产模型和资产之间可以进行通信。有关更多信息,请参阅 开启边缘数据处理。
重要
如果将数据处理包添加到 SiteWise Edge 网关,则必须在 AWS IoT Greengrass 组中配置和部署 SiteWise Edge 连接器。按下列步骤操作。
-
选择 添加网关。
-
-
如果您将数据处理包添加到 SiteWise Edge 网关,请在您的 AWS IoT Greengrass 群组上配置和部署 AWS IoT SiteWise 数据处理器连接器。按照中的配置 AWS IoT SiteWise 连接器步骤配置 AWS IoT SiteWise 数据处理器连接器:
-
对于 “在 AWS IoT Greengrass 控制台中选择连接器”,选择 “AWS IoT SiteWise 数据处理器”。
-
在本地存储路径中,输入 SiteWise Edge 网关的路径。
-
选择添加。
-
在右上角的操作菜单中,选择部署,再选择自动检测开始部署。
-
部署 SiteWise 边缘网关后,您可以为希望边 SiteWise 缘网关从中提取数据的每台工业设备添加一个来源。有关更多信息,请参阅 配置数据源。
您可以查看 Amazon CloudWatch 指标以验证您的 SiteWise Edge 网关是否已连接 AWS IoT SiteWise。有关更多信息,请参阅 AWS IoT Greengrass Version 1 网关指标。