正在安装 DataProvider 4.3 - SAP 通用指南
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

正在安装 DataProvider 4.3

适用于 SAP Amazon 的数据提供程序作为一项服务运行,该服务在启动时自动启动,并收集、聚合指标并将其公开给 SAP 主机代理。指标来自各种提供商,这些提供商从平台的相关领域提取指标。SAP Amazon 的数据提供程序旨在继续运行,无论其提供商是否具有连接或访问他们所请求的Amazon服务指标的权限。无法达到他们正在收集的指标的提供商会返回空值。

例如,如果您的 Amazon EC2 实例没有与其关联的 IAM 角色来授予对 Amazon CloudWatch GetMetricStatistics API 的显式访问权限,则 CloudWatch 提供商将无法在 Amazon EC2 实例上执行GetMetricStatistics操作并返回空值。

需要在每个 SAP 生产系统上安装该提供商,才有资格获得 SAP 支持。您一次只能在系统上安装一个提供程序实例。

适用于 SAP Amazon 的数据提供程序旨在自动更新自身,以便为你提供最新的指标。当 SAP Amazon 的数据提供程序启动时,内置更新服务会从Amazon托管 Amazon S3 存储桶中检索其组件和指标定义的最新版本。如果 SAP Amazon 的数据提供程序无法访问更新服务,它将继续按原样运行。

使用 SSM 分销商安装 — DataProvider 4.3(推荐)

DataProvider 4.3 版本允许您通过 SSM 发行商安装软件包。 Amazon建议使用这种方法进行安装,你可以 DataProvider 使用 Linux 或 Windows 平台进行安装。

DataProvider 使用 SSM 分发服务器安装的先决条件

SSM-Agent

必须先在实例上ssm-agent安装了,然后才能使用 SSM 分发服务器安装 DataProvider 代理。使用以下Amazon Systems Manager用户指南在您的实例ssm-agent上安装。

Java 运行时

DataProvider 是一个 Java 应用程序,需要在实例上安装 Java 运行时才能运行。

如果您的实例尚未安装 Java 运行时,则可以使用 Amazon Corretto 提供的 OpenJDK 来安装 Java 运行时。

DataProvider 4.3 支持以下 Java 运行时版本:

  • 亚马逊 Corretto 8 或 OpenJDK 8

  • 亚马逊 Corretto 11 或 OpenJDK 11

  • 亚马逊 Corretto 17 或 OpenJDK 17

有关如何在 Amazon EC2 实例上下载和安装 JDK 的更多信息,请参阅 Amazon C orretto 文档

在终端中,运行以下命令以验证安装。

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 密钥网址:G PG 密钥

  • 登录您的 SUSE 实例并运行以下命令来导入密钥:

    wget https//<url to GPG key>
    rpm --import RPM-GPG-KEY-AWS

使用 SSM 分发服务器安装 DataProvider 代理

使用以下步骤安装 DataProvider 4.3。

  1. 打开 Systems Manager 控制台

  2. 在左侧导航窗格的 “节点管理” 部分下,选择 Distrib utor

  3. 在搜索栏中,键入 AmazonSapTools-DataProvider,然后选择软件包。

  4. 要在新版本发布 DataProvider 时接收自动更新,请选择 “按计划安装”。

  5. 在 “创建关联” 页面上,键入关联的名称

  6. 在 “参数” 部分的 “操作” 中,选择 “安装”。

  7. 在 “> 目标” 部分中,在 “目标选择” 中,选择 “手动选择实例”。然后,选择要安装的实例 DataProvider。

  8. 在 “指定日程安排” 部分中,进行以下选择:

    • 选择 “按计划

    • 对于 “指定方式”,选择 “费率明细表生成器”。

    • 对于助理跑步,请选择 30 天。 (Amazon建议 30 天)

  9. 在 “输出选项” 部分,选择 “创建关联”。

  10. 创建关联后,选择关联 ID

  11. 选择 “执行历史记录” 选项卡。然后,选择执行 ID。

  12. 在 “执行 ID” 页面上,选择 “输出” 以查看安装结果。

  13. 安装完成后,登录实例,调用终端节点 DataProvider 以允许获取指标。

    • Linux 示例

    • Windows 示例

使用可下载的安装程序进行安装 — 4.3 DataProvider

如果您选择不使用 SSM 安装 DataProvider 4.3,则 DataProvider 可以使用以下步骤手动安装。

注意

在开始手动安装之前,必须安装 “先决条件” 部分中列出的项目。您无需安装SSM-Agent. 可下载内容 DataProvider 不提供自动更新,要获得最新版本,您必须手动检查和下载新版本。

为您的环境下载以下文件。默认情况下,文件将在 us-east-1 区域下载,如果您想将文件下载到其他区域,请在下载之前更改默认区域。

在 Linux 上安装

在 Linux 上,数据提供程序以 RPM 包的形式提供。

SUSE Linux Enterprise Server

要在 SUSE Linux 企业服务器 (SLES) 上安装适用于 SAP Amazon 的数据提供程序,请下载以下文件:

  • 标准:aws-sap-dataprovider-sles.x86_6 4.rpm 和 GPG Key

  • 中国:aws-sap-dataprovider-sles.x86_6 4.rpm 和 GPG Key

这些文件完全相同,但由于在中国工作时可能出现连接问题,因此Amazon提供了这两个位置选项。

要安装数据提供器,请运行以下命令:

wget https://<url to rpm package> wget https://<url to GPG key> rpm ––import RPM-GPG-KEY-AWS zypper install -y <rpm package>

示例:

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 软件包后,代理会作为守护程序启动,如下图所示。


              Amazon适用于 SAP 更新服务的数据提供器

RPM 软件包安装

通过调用netstat -ant确定侦听器是否在 localhost 端口 8888 上运行,验证服务是否正在运行。

在 Linux 上完成安装


              在 Linux 上验证安装情况

在 Linux 上验证安装情况

您还应该在上查看日志文件/var/log/Amazon-dataprovider/messages,以确保守护程序具有访问所需指标的适当连接和授权。

在 Linux 上验证连接和授权

启动时,监视代理会运行三组诊断:

  • Amazon连接诊断可确保与 Amazon S3 的网络连接,从而自动获取 SAP Amazon 数据提供程序的更新。

  • 第二个诊断测试访问权限 CloudWatch。此授权需要使用允许访问的 IAM 策略为您正在运行的 Amazon EC2 实例分配一个 IAM 角色 CloudWatch。有关详细信息,请参阅本指南前面的 IAM 角色

  • 第三个诊断测试访问亚马逊 EC2 的授权,还需要一个与 Amazon EC2 实例关联的 IAM 角色。

适用于 SAP Amazon 的数据提供程序设计为在有或没有连接的情况下运行,但是如果没有连接,您就无法获得更新。如果您没有适当的授权,Amazon CloudWatch 和 Amazon EC2 将返回空值。

您也可以直接致电 SAP Amazon 的数据提供商来查看指标。调用wget http://localhost:8888/vhostmd会返回一个包含指标的文件。您可以查看文件内部以查看返回的指标,如下所示。


              在 Linux 上查看指标

在 Linux 上查看指标

现在,每次操作系统启动时,适用于 SAP Amazon 的数据提供程序都会自动启动。您也可以使用以下命令手动停止并重新启动 SAP Amazon 数据提供器,具体取决于您的操作系统版本:

  • SLES 11、Oracle Linux 6 和红帽 Linux 6:

    service aws-dataprovider [start|stop]
  • SLES 12、SLES 15、Oracle Linux 7、甲骨文 Linux 8、Red Hat Linux 7 和红帽 Linux 8。

    systemctl [start|stop] aws-dataprovider

如果您对互联网没有透明 HTTP/HTTPS 访问权限,则可以将Amazon数据提供者配置为使用代理。

  1. 停止 SAP Amazon 的数据提供商。

  2. 在位于的文件中输入代理信息(如下所示)/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=
  3. 启动适用于 SAP Amazon 的数据提供程序。

在红帽和甲骨文企业 Linux 上安装

对于 Red Hat 和 Oracle Enterprise Linux,安装步骤与上述 SLES 的安装步骤相同,但是 RPM 文件和安装 RPM 软件包的命令有所不同。

  • 红帽

    默认值:aws-sap-dataprovider-rhel.x 86_64.rpm

  • 甲骨文企业 Linu

    默认值:aws-sap-dataprovider-oel.x 86_64.rpm

要安装数据提供器,请运行以下命令:

wget https://<url to rpm package> yum -y install <rpm package>

示例:

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 脚本安装系统)可执行文件的形式提供。

  1. 打开 Web 浏览器并下载安装程序:

  2. 运行下载的 exe 文件。

  3. 验证安装。

    • 安装完成后,您可以在C:\Program Files\Amazon\DataProvider目录中看到该文件。

    • 安装还会创建并启动一项名为 “适用于 SAP Amazon 的数据提供器” 的 Windows 服务。

    • 在 Web 浏览器中输入 http://localhost:8888/vhostmd 以验证服务是否正在运行。如果安装成功,该页面会返回来自 SAP Amazon 数据提供商的指标。

  4. 如果您对互联网没有透明 HTTP/HTTPS 访问权限,则可以将Amazon数据提供者配置为使用代理。

    1. 停止 SAP Amazon 的数据提供商。

    2. 在位于的文件中输入代理信息(如下所示)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=
    3. 启动适用于 SAP Amazon 的数据提供程序。

  5. 通过netstat -ant从命令窗口或 Windows PowerShell 脚本调用,以确定侦听器是否在本地主机端口 8888 上运行,验证服务是否正在运行。

    
                在 Windows 上验证安装情况

    在 Windows 上验证安装情况

  6. 导航到 Windows 事件日志,然后从 SAP Amazon 数据提供程序中查找启动事件的应用程序日志。检查诊断信息。

    
                在 Windows 上检查诊断程序

    在 Windows 上检查诊断程序

启动时,监视代理会运行三组诊断:

  • Amazon连接诊断可确保与 Amazon S3 的网络连接,从而自动获取 SAP Amazon 数据提供程序的更新。

  • 第二个诊断测试访问授权 CloudWatch,这需要使用允许访问的 IAM 策略为您正在运行的 EC2 实例分配一个 IAM 角色 CloudWatch。有关详细信息,请参阅本指南前面的 IAM 角色

  • 第三个诊断测试访问亚马逊 EC2 的授权,还需要一个与 Amazon EC2 实例关联的 IAM 角色。

适用于 SAP Amazon 的数据提供程序设计为在有或没有连接的情况下运行,但是如果没有连接,您就无法获得更新。如果您没有适当的授权,Amazon CloudWatch 和 Amazon EC2 会返回空白值。

您也可以直接从 Web 浏览器调用 SAP Amazon 数据提供程序来查看指标,如图所示。


            在 Windows 上查看指标

在 Windows 上查看指标

Amazon现在,每次操作系统启动时,适用于 SAP 的数据提供程序都会自动启动。您也可以手动停止和重启适用于 SAP Amazon 的数据提供程序,就像停止并重新启动任何其他 Windows 服务一样。


            在 Windows 上停止并重新启动适用于 SAP Amazon 的数据提供器

在 Windows 上停止并重新启动适用于 SAP Amazon 的数据提供器

要配置代理设置,可以将自定义proxy.properties文件放在 Windows 的临时目录中,该目录由 Windows 系统变量 %TEMP% 指定。

订阅Amazon数据提供者代理以获取通知

当新版本Amazon的数据提供者代理发布时,亚马逊简单通知服务可以通知您。使用以下步骤设置此订阅。

  1. 打开 https://console.aws.amazon.com/sns/v3/home

  2. 确保您位于美国弗吉尼亚北部 (us-east-1) 区域。

  3. 在左侧导航窗格中,选择订阅 > 创建订阅

  4. 根据您使用Amazon数据提供器代理Amazon Web Services 区域的内容添加主题 ARN

    区域 ARN
    默认值 arn:aws:sns:us-east-1:804845276281:AWS-DataProvider-SAP-Update
    Amazon GovCloud (美国西部)和 Amazon GovCloud (美国东部) arn:aws-us-gov:sns:us-gov-west-1:140982767562:AWS-DataProvider-SAP-Update
    中国(北京)区域和中国(宁夏)区域 arn:aws-cn:sns:cn-north-1:001645243879:AWS-DataProvider-SAP-Update
  5. 协议-选择电子邮件或短信。

    • 电子邮件-在 “终端节点” 字段中输入您想要接收通知的电子邮件地址。

      注意

      要启用电子邮件通知,您必须按照提供的电子邮件地址上收到的说明确认您的电子邮件订阅。

    • 短信 — 在 “终端节点” 字段中输入您想要接收通知的电话号码。

  6. 选择 Create subscription(创建订阅)。现在,无论何时发布新版本Amazon的数据提供者代理,您都可以收到通知。

要取消订阅通知,请按以下步骤操作。

  1. 打开 https://console.aws.amazon.com/sns/v3/home

  2. 在左侧导航窗格中,选择 “订阅”。

  3. 从您的订阅列表中选择订阅,然后选择 “删除”。