本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 正在安装 DataProvider 4.3 适用于 SAP AWS 的数据提供程序作为一项服务运行，该服务在启动时自动启动，并收集、聚合指标并将其公开给 SAP 主机代理。指标来自各种提供程序，这些提供程序从平台的相关领域提取指标。SAP AWS 的数据提供程序旨在继续运行，无论其提供商是否具有连接或访问他们所请求的 AWS 服务指标的权限。对于无法访问的指标，提供程序会返回空白值。 例如，如果您的 Amazon EC2 实例没有与其关联的 IAM 角色来授予对 Amazon CloudWatch **GetMetricStatistics**API 的显式访问权限，则 CloudWatch 提供商将无法在 Amazon EC2 实例上执行操作，并将返回空值。**GetMetricStatistics** 每个 SAP 生产系统上都需要安装该提供程序，才有资格获得 SAP 支持。一个系统上一次只能安装一个提供程序实例。 适用于 SAP AWS 的数据提供程序旨在自动更新自身，以便为你提供最新的指标。当 SAP AWS 的数据提供程序启动时，内置更新服务会从 AWS 托管 Amazon S3 存储桶中检索其组件和指标定义的最新版本。如果 SAP AWS 的数据提供程序无法访问更新服务，它将继续按原样运行。 ## 使用 SSM 发行商安装 — DataProvider 4.3（推荐） DataProvider 4.3 版本允许您通过 SSM 发行商安装软件包。 AWS 建议使用这种方法进行安装，你可以 DataProvider 使用 Linux 或 Windows 平台进行安装。 ### DataProvider 使用 SSM 分发服务器安装的先决条件 #### SSM-Agent 必须先在实例上`ssm-agent`安装了，然后才能使用 SSM 分发服务器安装 DataProvider 代理。使用以下 AWS Systems Manager 用户指南`ssm-agent`在您的实例上安装。 + RHEL：[在 Red Hat Enterprise Linux 实例上手动安装 SSM Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/agent-install-rhel.html) + SUSE：[在 SUSE Linux Enterprise Server 实例上手动安装 SSM Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/agent-install-sles.html) + Oracle：[在 Oracle Linux 实例上手动安装 SSM Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/agent-install-oracle.html) + Windows：[在适用于 Windows Server 的 EC2 实例上手动安装载 SSM Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html) #### Java 运行时 DataProvider 是一个 Java 应用程序，需要在实例上安装 Java 运行时才能运行。 如果您的实例尚未安装 Java 运行时，可以使用 Amazon Corretto 提供的 OpenJDK 来安装 Java 运行时。 DataProvider 4.3 支持以下 Java 运行时版本： + Amazon Corretto 8 或 OpenJDK 8 + Amazon Corretto 11 或 OpenJDK 11 + Amazon Corretto 17 或 OpenJDK 17 有关如何在 Amazon EC2 实例上下载和安装 JDK 的详细信息，请参阅 [Amazon Corretto 文档](https://docs.aws.amazon.com/corretto/index.html)。 在终端上，运行以下命令来验证安装。 ``` java -version ``` 例如，Coretto-8.252.09.1 的预期输出应为： ``` openjdk version "1.8.0_252"OpenJDK Runtime Environment Corretto-8.252.09.1 (build 1.8.0_252-b09)OpenJDK 64-Bit Server VM Corretto-8.252.09.1 (build 25.252-b09, mixed mode) ``` #### GPG 密钥 如果您是 SUSE 用户，则必须下载 DataProvider GPG 密钥并在安装前将其导入。 + GPG 密钥 URL：[GPG 密钥](https://aws-sap-data-provider.s3.amazonaws.com/Installers/RPM-GPG-KEY-AWS) + 登录到 SUSE 实例并运行以下命令来导入密钥： ``` wget https// ``` ``` rpm --import RPM-GPG-KEY-AWS ``` ## 使用 SSM 分发服务器安装 DataProvider 代理 使用以下步骤安装 DataProvider 4.3。 1. 打开 [Systems Manager 控制台](https://console.aws.amazon.com//systems-manager/)。 1. 在左侧导航窗格中的“节点管理”部分下，选择**分发服务器**。 ![\[导航窗格\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-distributor.png) 1. 在搜索栏中 **AWSSAPTools-DataProvider**，键入并选择软件包。 ![\[搜索栏\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-package.png) 1. 要在新版本发布 DataProvider 时接收自动更新，请选择 “**按计划安装**”。 ![\[“详细信息”页面\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-schedule.png) 1. 在**创建关联**页面上，键入关联的**名称**。 ![\[“创建关联”页面\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-association.png) 1. 在**参数**部分，对于**操作**选择**安装**。 ![\[“参数”部分\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-parameters.png) 1. 在**目标**部分，对于**目标选择**，选择**手动选择实例**。然后，选择要安装的实例 DataProvider。 ![\[“目标”部分\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-instances.png) 1. 在**指定计划**部分中，进行以下选择： + 选择**按计划**。 + 对于**指定方式**，选择 **Rate 计划生成器**。 + 对于**助理跑步**，请选择 **30 天**。 （AWS 建议 30 天） ![\[“指定计划”部分\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-schedule-selection.png) 1. 在**输出选项**部分，选择**创建关联**。 ![\[忽略“输出选项”部分。\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-create.png) 1. 创建关联后，选择**关联 ID**。 ![\[“关联”列表\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-association-id.png) 1. 选择**执行历史记录**选项卡。然后，选择“执行 ID”。 ![\[“执行历史记录”选项卡\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-execution.png) 1. 在**执行 ID** 页面上，选择**输出**以查看安装结果。 ![\[用户界面中的输出示例\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-output.png) 1. 安装完成后，登录实例，然后 http://localhost:8888/vhostmd [调用端点] DataProvider 以允许获取指标。 + Linux 示例 ![\[Linux 终端的输出示例\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-linux-example.png) + Windows 示例 ![\[Windows 实例上的浏览器输出示例\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-windows-example.png) ## 使用可下载的安装程序进行安装 — 4.3 DataProvider 如果您选择不使用 SSM 安装 DataProvider 4.3，则 DataProvider 可以使用以下步骤手动安装。 **注意** 在开始手动安装之前，必须安装[先决条件](#prerequisites-ssm)部分中列出的项目。您不需要安装 `SSM-Agent`。可下载内容 DataProvider 不提供自动更新，要获得最新版本，您必须手动检查和下载新版本。 为您的环境下载以下文件。默认情况下，文件将在 us-east-1 区域下载，如果您要将文件下载到其他区域，请在下载之前更改默认区域。 + **红帽** [https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/RHEL/aws-sap-dataprovider-rhel-standalone.x86_64.rpm](https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/RHEL/aws-sap-dataprovider-rhel-standalone.x86_64.rpm) + **SUSE** [https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/SUSE/aws-sap-dataprovider-sles-standalone.x86_64.rpm](https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/SUSE/aws-sap-dataprovider-sles-standalone.x86_64.rpm) + **甲骨文 Lin** [https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/ORACLE/aws-sap-dataprovider-oel-standalone.x86_64.rpm](https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/ORACLE/aws-sap-dataprovider-oel-standalone.x86_64.rpm) + **Windows** https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/ installers/win/aws-data-provider-installer-win-x64-Standalone.exe + GPG Key **GPG 密钥**：安装程序/rp [m-gpg-k](https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/RPM-GPG-KEY-AWS) ey-aws https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/ ## 在 Linux 上安装 在 Linux 上，数据提供程序以 RPM 软件包的形式提供。 ### SUSE Linux Enterprise Server 要在 SUSE Linux 企业服务器 (SLES) 上安装适用于 SAP AWS 的数据提供程序，请下载以下文件： + **标准：aws-sap-dataprovider-sles**[[.x86\$16](https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/SUSE/aws-sap-dataprovider-sles-standalone.x86_64.rpm) 4.rpm 和 GPG Key](https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/RPM-GPG-KEY-AWS) + **中国 aws-sap-dataprovider-sles** [[：](https://aws-sap-dataprovider-cn-north-1.s3.cn-north-1.amazonaws.cn/v4/installers/linux/SUSE/aws-sap-dataprovider-sles-standalone.x86_64.rpm).x86\$164.rpm 和 GPG Key](https://aws-sap-dataprovider-cn-north-1.s3.cn-north-1.amazonaws.cn/v4/installers/RPM-GPG-KEY-AWS) 这些文件完全相同，但由于在中国工作时可能出现连接问题，因此 AWS 提供了这两个位置选项。 要安装数据提供程序，请运行以下命令： ``` wget https:// wget https:// rpm ––import RPM-GPG-KEY-AWS zypper install -y ``` 示例： ``` wget https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/SUSE/aws-sap-dataprovider-sles-standalone.x86_64.rpm wget https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/RPM-GPG-KEY-AWS rpm ––import RPM-GPG-KEY-AWS zypper install -y aws-sap-dataprovider-sles-standalone.x86_64.rpm ``` 安装 RPM 软件包后，代理会作为进程守护程序启动，如下图所示。 **RPM 软件包安装** ![\[以 systemd 身份启动 aws-dataprovider 服务\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/rpm-package-install.png) 调用 `netstat -ant` 以确定侦听器是否在本地主机端口 8888 上运行，来验证服务是否正在运行。 **在 Linux 上验证安装情况** ![\[端口 8888 上有侦听器的 netstat -ant 的输出\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-verify-linux-install.png) 您还应该查看位于 `/var/log/aws-dataprovider/messages.0` 的日志文件，确保进程守护程序具有访问所需指标的相应连接和授权。 **在 Linux 上验证连接和授权** ![\[示例日志文件\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-verify-connectivity-linux.png) 启动时，监控代理会运行三组诊断功能： + AWS 连接诊断可确保与 Amazon S3 的网络连接，从而自动获取 SAP AWS 数据提供程序的更新。 + 第二个诊断测试访问权限 CloudWatch。此授权需要使用允许访问的 IAM 策略为您正在运行的 Amazon EC2 实例分配一个 IAM 角色 CloudWatch。有关详细信息，请参阅本指南前文中的 [IAM 角色](data-provider-req.md#data-provider-iam-roles)。 + 第三组诊断功能测试是否获得了访问 Amazon EC2 的授权，这同样需要将 IAM 角色关联到 Amazon EC2 实例。 适用于 SAP AWS 的数据提供程序设计为在有或没有连接的情况下运行，但是如果没有连接，您就无法获得更新。如果您没有适当的授权，Amazon CloudWatch 和 Amazon EC2 将返回空值。 您也可以直接致电 SAP AWS 的数据提供商来查看指标。调用 `wget http://localhost:8888/vhostmd` 会返回一个包含指标的文件。您可以在文件中查看返回的指标，如下所示。 **在 Linux 上查看指标** ![\[Linux 上的指标输出示例\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-linux-view-metrics.png) 现在，每次操作系统启动时，适用于 SAP AWS 的数据提供程序都会自动启动。您也可以使用以下命令手动停止并重新启动 SAP AWS 数据提供器，具体取决于您的操作系统版本： + SLES 11、Oracle Linux 6 和 Red Hat Linux 6： ``` service aws-dataprovider [start|stop] ``` + SLES 12、SLES 15、Oracle Linux 7、Oracle Linux 8、Red Hat Linux 7 和 Red Hat Linux 8。 ``` systemctl [start|stop] aws-dataprovider ``` 如果您无法透明地 HTTP/HTTPS 访问互联网，则可以将 AWS 数据提供者配置为使用代理。 1. 停止 SAP AWS 的数据提供商。 1. 在位于 `/usr/local/ec2/aws-dataprovider/proxy.properties` 的文件中输入代理信息（如下所示）。 ``` #proxy.properties #used to set web proxy settings for the {aws} Data Provider for SAP #Https is the only supported proxy method #Blank values for everything means no proxy set https.proxyHost= https.proxyPort= https.proxyDomain= https.proxyUsername= https.proxyPassword= ``` 1. 启动适用于 SAP AWS 的数据提供程序。 ## 在 Red Hat 和 Oracle Enterprise Linux 上进行安装 对于 Red Hat 和 Oracle Enterprise Linux，安装步骤与上述 SLES 的安装步骤相同，但 RPM 文件以及用于安装 RPM 软件包的命令有所不同。 + **Red Hat** **默认值：aws-sap-dataprovider-rhel**[.x](https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/RHEL/aws-sap-dataprovider-rhel-standalone.x86_64.rpm) 86\$164.rpm + **Oracle Enterprise Linux** **默认值：aws-sap-dataprovider-oel**[.x](https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/linux/ORACLE/aws-sap-dataprovider-oel-standalone.x86_64.rpm) 86\$164.rpm 要安装数据提供程序，请运行以下命令： ``` wget https:// yum -y install ``` 示例： ``` wget https://aws-sap-data-provider.s3.amazonaws.com/Installers/aws-sap-dataprovider-rhel.x86_64.rpm yum -y install aws-sap-dataprovider-rhel.x86_64.rpm ``` ## 在 Windows 上安装 在 Windows 上，安装程序以 NSIS（Nullsoft Scriptable Install System，Nullsoft 可脚本化安装系统）可执行文件的形式提供。 1. 打开 Web 浏览器并下载安装程序： + **默认：aws-data-provider-installer**[-win-x64.exe](https://aws-sap-dataprovider-us-east-1.s3.us-east-1.amazonaws.com/v4/installers/win/aws-data-provider-installer-win-x64-Standalone.exe) 1. 运行下载的 **exe** 文件。 1. 验证安装。 + 安装完成后，您可以在 `C:\Program Files\Amazon\DataProvider` 目录中看到该文件。 + 安装还会创建并启动一项名为 “适用于 **SAP AWS 的数据提供器” 的** Windows 服务。 + 在 Web 浏览器中输入 http://localhost:8888/vhostmd，验证服务是否在运行。如果安装成功，该页面会返回来自 SAP AWS 数据提供商的指标。 1. 如果您无法透明地 HTTP/HTTPS 访问互联网，则可以将 AWS 数据提供者配置为使用代理。 1. 停止 SAP AWS 的数据提供商。 1. 在位于 `C:\Program Files\Amazon\DataProvider\proxy.properties` 的文件中输入代理信息（如下所示）。 ``` #proxy.properties #used to set web proxy settings for the {aws} Data Provider for SAP #Https is the only supported proxy method #Blank values for everything means no proxy set https.proxyHost= https.proxyPort= https.proxyDomain= https.proxyUsername= https.proxyPassword= ``` 1. 启动适用于 SAP AWS 的数据提供程序。 1. 通过`netstat -ant`从命令窗口或 Windows PowerShell 脚本调用，以确定侦听器是否在本地主机端口 8888 上运行，验证服务是否正在运行。 ![\[在 Windows 上验证安装情况\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-verify-windows.png) **在 Windows 上验证安装情况** 1. 导航到 Windows 事件日志，然后从 SAP AWS 数据提供程序中查找启动事件的应用程序日志。检查诊断信息。 ![\[在 Windows 上检查诊断信息\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-windows-diagnostic.png) **在 Windows 上检查诊断信息** 启动时，监控代理会运行三组诊断功能： + AWS 连接诊断可确保与 Amazon S3 的网络连接，从而自动获取 SAP AWS 数据提供程序的更新。 + 第二个诊断测试访问授权 CloudWatch，这需要使用允许访问的 IAM 策略为您正在运行的 EC2 实例分配一个 IAM 角色 CloudWatch。有关详细信息，请参阅本指南前文中的 [IAM 角色](data-provider-req.md#data-provider-iam-roles)。 + 第三组诊断功能测试是否获得了访问 Amazon EC2 的授权，这同样需要将 IAM 角色关联到 Amazon EC2 实例。 适用于 SAP AWS 的数据提供程序设计为在有或没有连接的情况下运行，但是如果没有连接，您就无法获得更新。如果您没有适当的授权，Amazon CloudWatch 和 Amazon EC2 会返回空白值。 您也可以直接从 Web 浏览器调用 SAP AWS 数据提供程序来查看指标，如图所示。 **在 Windows 上查看指标** ![\[Windows 上的指标输出示例\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-windows-view-metrics.png) AWS 现在，每次操作系统启动时，适用于 SAP 的数据提供程序都会自动启动。您也可以手动停止和重启适用于 SAP AWS 的数据提供程序，就像停止并重新启动任何其他 Windows 服务一样。 **在 Windows 上停止并重新启动适用于 SAP AWS 的数据提供器** ![\[在 Windows 上停止和重启适用于 SAP 的数据提供程序\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/images/data-provider-windows-stop-start.png) 要配置代理设置，您可以将自定义 `proxy.properties` 文件放在 Windows 的临时目录中，该目录通过 Windows 系统变量 %TEMP% 指定。 ## 订阅 AWS 数据提供者代理以获取通知 当 AWS 数据提供程序代理的新版本发布时，Amazon 简单通知服务可以通知您。使用以下步骤设置此订阅。 1. 打开 https://console.aws.amazon.com/sns/ v3/home。 1. 确保您位于**美国东部（弗吉尼亚州北部）**（us-east-1）区域。 1. 在左侧导航窗格中，依次选择**订阅** > **创建订阅**。 1. 根据您使用 AWS 数据提供器代理的 AWS 区域添加**主题 ARN**。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/sap/latest/general/data-provider-installation.html) 1. **协议**：选择电子邮件或 SMS。 + **电子邮件**：在**端点**字段中，输入您想要用于接收通知的电子邮件地址。 **注意** 要启用电子邮件通知，您必须按照在所提供的电子邮件地址中收到的说明，确认您的电子邮件订阅。 + **SMS**：在**端点**字段中，输入您想要用于接收通知的手机号码。 1. 选择**创建订阅**。现在，无论何时发布新版本 AWS 的数据提供者代理，您都可以收到通知。 要取消订阅通知，请使用以下步骤。 1. 打开 https://console.aws.amazon.com/sns/ v3/home。 1. 在左侧导航窗格中，选择**订阅**。 1. 从订阅列表中选择该订阅，然后选择**删除**。