本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在上托管 SiteWise Edge 网关 Siemens Industrial Edge
使用 Edge 应用程序将您的网关托管在西门子工业 AWS IoT SiteWise 边缘上。与之类似 AWS IoT Greengrass V2，您可以使用 SiteWise Edge on 来优化制造流程或改善操作工作流程Siemens Industrial Edge。
通过在设备上运行 Edge 网关，您可以将来自西门子工业 SiteWise 边缘设备的数据提取到您的 AWS 账户。为此，请向 Edge 支持团队申请 AWS IoT SiteWise Ed SiteWise ge 应用程序的访问权限。然后，创建 SiteWise 边缘网关资源，部署目标为**西门子工业边缘设备（全新**）。接下来，下载配置文件，然后通过 Siemens Industrial Edge Management 门户将其上传到您的应用程序。有关在 Siemens Industrial Edge 上运行应用程序的更多信息，包括如何设置所需的 Siemens 资源，请参阅 Siemens 文档中的 [What is Industrial Edge?](https://docs.eu1.edge.siemens.cloud/)。
**注意**
西门子不是 SiteWise Edge 的供应商或供应商。Siemens Industrial Edge 商城是一个独立的市场。
**Topics**
+ [安全性](#sa-security)
+ [Siemens Secure Storage和 AWS IoT SiteWise Edge 应用程序](#sa-secure-storage)
+ [Siemens Industrial Edge设备的目的地](#siemens-destinations)
+ [从预览版应用程序迁移](#sa-migrate)
+ [问题排查](#sa-troubleshoot)
+ [AWS IoT SiteWise Edge 应用程序更新日志](#sa-changelog)
+ [AWS IoT SiteWise 边缘应用程序的要求](siemens-app-gateway-requirements.md)
+ [为 Siemens Industrial Edge 创建网关](sa-create-config.md)
+ [为应用程序创建 Siemens Databus user](sa-databus-user.md)
+ [访问 AWS IoT SiteWise Edge 应用程序](sa-get-app.md)
+ [将应用程序安装到Siemens设备上](sa-install-app.md)
+ [更新 AWS IoT SiteWise Edge 应用程序配置](sa-update-config.md)
+ [AWS IoT SiteWise — 使用此服务生成的数据](sa-data-legal.md)
## 安全性
作为我们的客户和合作伙伴之间[AWS责任共担模式](https://aws.amazon.com/compliance/shared-responsibility-model/)的一部分，以下内容描述了谁对安全的不同方面负责：
**客户责任**
+ 审查合作伙伴。
+ 配置授予合作伙伴的网络访问权限。
+ 对运行 SiteWise Edge 的设备进行物理保护。
**AWS 责任**
+ 将合作伙伴与客户的 AWS 云资源隔离开来。
**合作伙伴的责任**
+ 使用安全的默认值。
+ 通过补丁和其他适当更新确保解决方案随着时间的推移而保持安全。
+ 对客户数据保密。
+ 审查合作伙伴市场上可用的其他应用程序。
## Siemens Secure Storage和 AWS IoT SiteWise Edge 应用程序
为了保护运行 AWS IoT SiteWise Edge 应用程序所需的凭据和机密，Siemens Industrial Edge提供了在设备上安全存储凭据的机制。如果 AWS IoT SiteWise Edge 应用程序不支持安全存储这些凭证，则该应用程序将无法在设备上运行。由于缺少安全存储支持而导致的运行失败会被记录在日志文件中。
安装和运行 E AWS IoT SiteWise dge 应用程序需要以下最低操作系统版本。将您的设备升级到最新版本以安装该应用程序。
+ **对于虚拟设备：**IEVD 版本 1.19 或更高版本
+ **对于物理设备：**IED-OS 版本 2.2 或更高版本
在升级设备之前，开启的 AWS IoT SiteWise Edge 应用程序Siemens Industrial Edge将无法运行。
## Siemens Industrial Edge设备的目的地
在上使用 AWS IoT SiteWise Edge 应用程序时Siemens Industrial Edge，目的地会帮助准备数据，然后再将其发送到以 AWS IoT SiteWise 供进一步分析和分发。您可以使用 Amazon S3 或使用实时数据提取配置缓冲数据摄取的数据目标设置。两者都允许您使用Siemens Industrial Edge设备部署目标上的路径过滤器订阅 MQTT 主题。
网关上的Siemens Industrial Edge部署目标支持两种主要的数据处理方法：
+ **AWS IoT SiteWise 实时设置**-数据在收集 AWS IoT SiteWise 时直接发送到
+ **AWS IoT SiteWise 使用 Amazon S3 设置进行缓冲**-数据在发送到 Amazon S3 之前会分批临时收集和存储
有关配置这些选项的更多信息，请参见[使用 Amazon S3 添加 AWS IoT SiteWise 缓冲目的地](destinations-buffered.md)和[添加 AWS IoT SiteWise Edge 实时目的地](destinations-real-time.md)。
### 路径过滤器的前缀
使用Siemens Industrial Edge部署目标的网关路径筛选器将主题和数据流名称结合起来，为您的数据创建唯一标识符。带有数据流名称的组合主题在Siemens Industrial Edge网关中被称为**前缀**。这与自托管网关不同，在自托管网关中，路径过滤器仅基于 MQTT 主题。
**Example 西门子数据流的路径过滤器结构**
西门子数据流的典型路径过滤器包括主题路径和数据流名称：
```
ie/d/device1/application1/datastream1
```
其中：
+ `ie/d/`是西门子数据流所需的前缀
+ `device1/application1`表示分层路径
+ `datastream1`是特定的数据流名称
**注意**
处理Siemens Industrial Edge数据流时，请确保在路径筛选器中同时包含元数据 (`ie/m/``ie/d/`) 和数据 () 主题，以接收有关数据流的完整信息。
#### 目的地和路径过滤器
查看以下主题，详细了解启用 MQTT 的网关中的目的地和路径过滤器：
+ [了解 AWS IoT SiteWise 边缘目的地](gw-destinations.md#source-destination)
+ [添加 AWS IoT SiteWise Edge 实时目的地](destinations-real-time.md)
+ [使用 Amazon S3 添加 AWS IoT SiteWise 缓冲目的地](destinations-buffered.md)
+ [了解 AWS IoT SiteWise Edge 目标的路径过滤器了解路径筛选条件](gw-destinations.md#destinations-path-filters)
+ [向 AWS IoT SiteWise Edge 目标添加路径过滤器](destinations-add-path-filters.md)
+ [管理 AWS IoT SiteWise 边缘目的地](destinations-manage.md)
## 从预览版应用程序迁移
如果您Siemens Industrial Edge在预览阶段运行了 SiteWise Edge，则需要从预览版 1.0.1 升级到最新版本。按照以下步骤进行迁移：
1. 创建新的 SiteWise 边缘网关。有关更多信息，请参阅 [为 Siemens Industrial Edge 创建网关](sa-create-config.md)。
1. 为每个新网关创建一个新 Siemens Databus user。有关更多信息，请参阅 [为应用程序创建 Siemens Databus user](sa-databus-user.md)。
1. 在 IED 上卸载 1.0.1 版 AWS IoT SiteWise 边缘网关应用程序。
**注意**
在重新配置 E AWS IoT SiteWise dge 应用程序预览版之前使用的 AWS IoT SiteWise 资产时，为数据流中断做好准备。在保留数据历史记录的同时，重新安装新网关时可能会导致数据丢失。
1. 在中删除您在预览期间创建的 SiteWise Edge 网关[AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/home?region=us-east-1#/gateway)。
1. 使用新的网关配置文件在 I AWS IoT SiteWise ED 上安装 Edge 网关应用程序。有关更多信息，请参阅 [将应用程序安装到Siemens设备上](sa-install-app.md)。
**重要**
安装新网关会覆盖 SiteWise Edge 应用程序的预览版。安装当前版本后，无法返回到 1.0.1 版。
配置新网关和 Siemens Databus user 后，您的数据将流向您的属性。
您也可以直接从版本升级 SiteWise Edge 应用程序。但是，仍然需要新的网关配置。
## 问题排查
要对Siemens Industrial Edge设备上的 SiteWise Edge 网关进行故障排除，请参阅[对 AWS IoT SiteWise Edge 应用程序进行故障排除 Siemens Industrial Edge](troubleshooting-gateway.md#troubleshoot-siemens-app)。
您也可以访问 [AWS re:Post](https://repost.aws) 来查找问题的答案。
## AWS IoT SiteWise Edge 应用程序更新日志
下表描述了每个版本的 AWS IoT SiteWise Edge 应用程序中的更改。
| **版本** | **更改** |
| --- | --- |
| 3.0.1 | 错误修复和改进 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) |
| 3.0.0 | 新特征 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) 错误修复和改进 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) |
| 2.0.1 | 错误修复和改进 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) |
| 2.0.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) |
| 1.0.1 | 初始版本 |
# AWS IoT SiteWise 边缘应用程序的要求
要在上面运行 AWS IoT SiteWise EdgeSiemens Industrial Edge，你需要以下内容：
+ 一个 [Siemens Digital Exchange 平台](https://www.dex.siemens.com/)账户。
+ 一个 Siemens Industrial Edge Hub（iehub）账户。
+ 一个 Siemens Industrial Edge Management 实例。
+ IE 应用程序配置服务。要了解更多信息，请参阅 *Siemens Industrial Edge Management* 文档中的[https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_management/how_to_setup_operate/vm/operation/app_projects/app_configurations/ie_application_configuration_service/installing_the_ie_acs_manually.html](https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_management/how_to_setup_operate/vm/operation/app_projects/app_configurations/ie_application_configuration_service/installing_the_ie_acs_manually.html)。
+ 访问 AWS IoT SiteWise Edge 应用程序的 2.0.1 或更高版本。有关更多信息，请参阅 [访问 AWS IoT SiteWise Edge 应用程序](sa-get-app.md)。
+ Siemens Industrial Edge Device（IED）或 Siemens Industrial Edge Virtual Device（IEVD）。
+ 至少 15 GB 的磁盘空间，以满足硬件要求。
+ 1 GB 内存和额外 1 GB 的交换内存。
+ 设备配置以支持端口 443 和 8883 的出站流量。
+ x86-64 位处理器。
+ Siemens Industrial Edge Management 版本 1.13.10 或更高版本。
+ 设备符合 Siemens Secure Storage 要求。
+ 在虚拟设备上，使用 IEVD 版本 1.19 或更高版本。
+ 在物理设备上，使用 IED-OS 版本 2.2 或更高版本。
+ 最新版本的 Docker Compose。
+ Docker Engine 版本 18.091 或更高版本。
+ 必需的域访问权限。有关更多信息，请参阅 [AWS IoT SiteWise 端点](endpoints-and-quotas.md#endpoints)。
# 为 Siemens Industrial Edge 创建网关
拥有适当的西门子帐户和 IEM 实例后，您可以创建部署类型为**西门子工业 SiteWise 边缘设备的边缘**网关。
**注意**
请确保您满足在 Siemens Industrial Edge Management 上运行设备的所有要求。有关更多信息，请参阅 [AWS IoT SiteWise 边缘应用程序的要求](siemens-app-gateway-requirements.md)。
**要创建配置文件，请执行以下步骤：**
1. 导航至 [AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/)。
1. 在导航窗格中，选择 **Edge 网关**。
1. 选择**创建网关**。
1. 对于**部署类型**，请选择**西门子工业边缘设备**。
1. 输入 E SiteWise dge 网关的名称或使用生成的名称 AWS IoT SiteWise。
1. （可选）在**高级配置**下，执行以下操作：
1. 输入 AWS IoT Core 事物的名称或使用生成的名称 AWS IoT SiteWise。
1. 选择**创建网关**。
1. 在**生成 SiteWise Edge 网关配置文件**对话框中，选择**生成并下载**。 AWS IoT SiteWise 自动生成用于配置 AWS IoT SiteWise Edge 应用程序的配置文件。
**重要**
保留网关配置文件作为备份，以备需要恢复 AWS IoT SiteWise Edge 应用程序实例时使用。[AWS Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)为此，您可以安全地将 SiteWise Edge 网关配置文件保存在中。Secrets Manager 可以安全地存储、管理和检索敏感信息。如果您放错位置或删除了此配置文件，则在需要恢复时，将无法将 AWS IoT SiteWise Edge 应用程序实例重新连接到其原始网关。您需要同时创建新的网关和新的配置文件。
# 为应用程序创建 Siemens Databus user
AWS IoT SiteWise Ed Siemens Industrial Edge ge on 从Siemens Databus应用程序中提取数据。要将 SiteWise Edge 连接到Siemens Databus，您需要一个Siemens Databus user能够访问要安全传输到的数据的访问权限 AWS IoT SiteWise。首先，创建一个，Siemens Databus user然后向 SiteWise Edge 应用程序提供证书。
**要创建 Siemens Databus user，请执行以下步骤：**
1. 在您的 Siemens Industrial Edge Management 实例中，在**平台应用程序**部分中选择**边缘管理**。
1. 选择**数据连接**图标。
1. 选择 **Databus**。此时，系统会显示已连接设备列表。
1. 选择要连接到 AWS IoT SiteWise Edge 应用程序的设备。
1. 选择**启动**。此时，系统将显示适用于您所选设备的 Databus Configurator。
1. 在**用户**下为您的 Edge 设备创建用户。有关创建用户的更多信息，请参阅 *Siemens 工业边缘管理*文档中的[用户](https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_management/operation/iam/03_user-management.html)。
1. 选择此 Siemens Databus 应有权访问的主题。这些主题限制了 AWS IoT SiteWise Edge 可以访问的内容。
**重要**
Siemens Databus user有权访问的所有主题都已发布到 AWS IoT SiteWise。
**注意**
Siemens Databus user需要访问数据和元数据主题。以 `ie/d` 开头的主题是数据主题。以 `ie/m` 开头的主题是元数据主题。成对共享主题，这样 SiteWise Edge 就可以访问每个相应主题的数据和元数据。
![\[显示 Siemens 主题类型的屏幕截图。图像分别圈出文件路径中以 “ie/d" and "ie/m,” 开头的部分。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/gateway-sa-topics.png)
1. 为您的 Siemens Databus 配置设置适当的权限。
创建Siemens Databus配置后，您可以在上安装 AWS IoT SiteWise Edge 应用程序Siemens Industrial Edge Management。有关更多信息，请参阅 [将应用程序安装到Siemens设备上](sa-install-app.md)。
您也可以选择为Siemens Industrial Edge网关配置目的地和路径过滤器。有关更多信息，请参阅 [目的地和路径过滤器](gw-destinations.md)。
# 访问 AWS IoT SiteWise Edge 应用程序
要访问上的 AWS IoT SiteWise Edge 应用程序Siemens Industrial Edge，请[发送一封电子邮件](mailto:aws-iot-swe-siemens-app-support@amazon.com?subject=Access request for SiteWise Edge on Siemens Industrial Edge)请求访问 SiteWise Edge 支持团队。
在您的电子邮件中，请包含以下信息：
+ 您的姓名和联系信息
+ 公司名称
+ Siemens Industrial Edge 租户 ID
# 将应用程序安装到Siemens设备上
通过向 AWS IoT SiteWise Edge 支持团队发送电子邮件获得 E SiteWise dge 应用程序的访问权限后Siemens Industrial Edge，将该应用程序分配给的Siemens Industrial Edge Management实例。然后，您可以在设备上安装 AWS IoT SiteWise Edge 应用程序。
**安装 Ed AWS IoT SiteWise ge 应用程序**
1. 验证中提供的Docker摘要是否与中列出的最新版本Siemens Industrial Edge Management相匹配[AWS IoT SiteWise Edge 应用程序更新日志](sitewise-edge-on-siemens.md#sa-changelog)。
有关查找 Siemens Docker 摘要值的更多信息，请参阅Siemens文档中的 “在*Siemens Industrial Edge设备*中[管理应用程序](https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_device/operation/management.html#managing-an-app)”。
Siemens Industrial Edge Management一次支持一个版本的 AWS IoT SiteWise Edge 应用程序。在Siemens Industrial Edge设备上安装 AWS IoT SiteWise Edge 应用程序之前，请执行此步骤以确保您使用的是最新版本的应用程序。
1. 将 **AWS IoT SiteWise Edge** 应用程序分配给 Siemens Industrial Edge Management。有关更多信息，请参阅 Siemens 文档“Industrial Edge Management”**部分的 [Managing an app](https://docs.eu1.edge.siemens.cloud/get_started_and_operate/industrial_edge_management/how_to_setup_operate/vm/operation/my_installed_apps/managing_an_app.html)。
1. 在**边缘管理**中，浏览 **AWS IoT SiteWise Edge** 的目录并选择它。
1. 选择**安装**。
**注意**
如果显示 “**联系我们**” 按钮，请选择该按钮，然后按照步骤请求访问 AWS IoT SiteWise Edge 应用程序Siemens Industrial Edge。有关更多信息，请参阅 [访问 AWS IoT SiteWise Edge 应用程序](sa-get-app.md)。
1. 在“架构配置”选项中选择 **Databus\$1Configuration**。
1. 为 Databus 配置输入**用户名**和**密码**。有关创建 Siemens Databus user 的更多信息，请参阅 [为应用程序创建 Siemens Databus user](sa-databus-user.md)。
1. 选择 **Databus\$1Configuration** 旁边的灰色圆形小对勾图标，将图标变为绿色。
**注意**
仅当对勾图标从灰色变为绿色时，输入配置才适用。否则，输入配置将被忽略。
![\[Siemens Databus Configurator 屏幕的截图，显示未完成的过程，其中带有灰色对勾圆圈图标。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/gateway-sa-gray-checkmark.png)
![\[Siemens Databus Configurator 屏幕的截图，显示已完成的过程，其中带有绿色对勾圆圈图标。\]](http://docs.aws.amazon.com/zh_cn/iot-sitewise/latest/userguide/images/gateway-sa-green-checkmark.png)
1. 选择**下一步**转到**其他配置**，您可以在其中上传网关配置文件。
1. 选择 **SiteWise\$1Edge\$1Gateway\$1Config 作为上传网关配置文件**的位置。
**注意**
**确保选择 **SiteWise\$1Edge\$1Gateway\$1Config 而不是 \$1Edge\$1Support\$1Config\$1Config\$1Opti** onal SiteWise**
1. 选择要安装该应用程序的设备。
1. 选择**立即安装**。
您可以选择将发布者组件配置为将数据导出到 AWS 云端。有关更多信息，请参阅 [configure the AWS IoT SiteWise publisher component](configure-publisher-component.md)。
要为Siemens Industrial Edge网关配置目的地，请参阅[目的地和路径过滤器](gw-destinations.md)。
# 更新 AWS IoT SiteWise Edge 应用程序配置
在上更新 AWS IoT SiteWise Edge 应用程序配置时，需要考虑一些事项**Siemens Industrial Edge**。
**注意**
对 AWS IoT SiteWise Edge 应用程序配置的任何更改都需要重新启动应用程序。
**重新启动 E AWS IoT SiteWise dge 应用程序的原因**
+ AWS IoT SiteWise Edge 应用程序的新增Siemens Databus user功能。
+ 对网关配置文件（您的 **SiteWise\$1Edge\$1Gateway\$1Config** 文件）的更改。
+ 代理配置更新（还需要完全重启 IEVD）
+ 要为调试问题启用调试日志，请执行以下步骤：
## 重新启动应用程序
1. 在您的 Siemens Industrial Edge Management 实例中，在**平台应用程序**部分中选择**边缘管理**。
1. 选择**我安装的应用程序**。
1. 选择 AWS IoT SiteWise Edge 应用程序。
1. 选择**重新启动**。
# AWS IoT SiteWise — 使用此服务生成的数据
AWS IoT SiteWise on Siemens Industrial Edge 将云功能扩展到工业边缘环境，支持本地数据处理、分析和决策。 SiteWise Edge 与其他 AWS 服务集成，提供全面的工业 AWS IoT 解决方案。 AWS IoT SiteWise
数据类型
SiteWise Siemens Industrial Edge 上的边缘应用程序生成有关应用程序性能、使用情况以及与其他 AWS 服务（特别是 Amazon S3）交互的数据。
数据量和收集
生成的数据量因您使用应用程序和服务的方式而异。
数据存储
您的应用程序中的数据安全地存储在 AWS 服务器上。它以机器可读的格式存储。
数据访问
您可以通过您的 AWS 帐户访问您的数据。您可以按照本用户指南 [SiteWise Edge on Siemens](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/sitewise-edge-on-siemens.html) 中列出的说明下载数据副本。要获取应用程序的配置数据，您可以按照本用户指南 “[查询工业数据](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/query-industrial-data.html)” 中的说明进行操作。有关批量数据访问和导出的更多说明，请参阅[运行批量操作导出](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/running-bulk-operations-export.html)。
数据管理
要详细了解您的应用程序的数据实践，请查看我们的[服务条款](https://aws.amazon.com/service-terms/)、[隐私声明](https://aws.amazon.com/privacy/)和[服务文档](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/what-is-sitewise.html)，其中包括有关如何管理数据的材料。
数据删除
有关数据保留和删除选项的信息，请访问用户指南中的以下页面：[管理数据存储](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/manage-data-storage.html)、[删除数据流](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-data-streams-method.html)以及[删除模型和资产](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/delete-assets-and-models.html)。
与他人共享数据
您可以通过我们的[身份和访问管理流程授权第三方访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html)您的 AWS 资源。 AWS 在[AWS 隐私声明](https://aws.amazon.com/privacy/)中包含的有限情况下，与第三方共享个人数据。
需要帮助吗？
请访问 C [ust](https://aws.amazon.com/contact-us/) omer Support 联系我们的支持团队。这不影响您根据适用法律提出投诉的权利。
数据持有者
Amazon Web Services EMEA SARL，约翰·肯尼迪大道 38 号，L-1855，卢森堡