正在安装 DataProvider 4.3 - 一般SAP指南

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

正在安装 DataProvider 4.3

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

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

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

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

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

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

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

SSM-代理

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

Java 运行时

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

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

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

  • 亚马逊 Corretto 8 或 Open 8 JDK

  • 亚马逊 Corretto 11 或 Open 11 JDK

  • Amazon Corretto 17 或 Open 17 JDK

有关如何在您的亚马逊EC2实例上下载和安装JDK的更多信息,请参阅 Amazon Corretto 文档。

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

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钥匙

  • 登录您的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. 在搜索栏中键入 AWS SAPTools-DataProvider,然后选择软件包。

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

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

    “创建关联” 页面
  6. 在 “参数” 部分的 “操作” 中,选择 “安装”。

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

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

    • 选择 “按计划

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

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

      “指定日程安排” 部分
  9. 在 “输出选项” 部分,选择 “创建关联”。

    输出选项部分
  10. 创建关联后,选择关联 ID

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

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

    用户界面中的输出示例
  13. 安装完成后,登录实例,调用终端节点 DataProvider 以允许获取指标。

    • Linux 示例

    来自 Linux 终端的输出示例
    • Windows 示例

    Windows 实例上浏览器的输出示例

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

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

注意

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

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

在 Linux 上安装

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

SUSELinux 企业服务器

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

  • 标准:aws-sap-dataprovider-sles.x86 _64.rpm 和 Key GPG

  • 中国:aws-sap-dataprovider-sles.x86 _64.rpm 和 Key GPG

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

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

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

以 systemd 身份启动 aws-dataProvider 服务

RPM软件包安装

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

端口 8888 上有监听器的 netstat-ant 的输出

在 Linux 上验证安装情况

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

示例日志文件

在 Linux 上验证连接和授权

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

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

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

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

的 AWS Data Provider 设计SAP为在有或没有连接的情况下运行,但是如果没有连接,您就无法获得更新。如果您没有适当的授权,Amazon CloudWatch 和 Amazon EC2 将返回空值。

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

Linux 上的指标输出示例

在 Linux 上查看指标

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

  • SLES11、甲骨文 Linux 6 和红帽 Linux 6:

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

    systemctl [start|stop] aws-dataprovider

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

  1. 停止 AWS 使用数据提供器SAP。

  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. 启动 “ AWS 数据提供器” SAP。

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

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

  • Red Hat

    默认值: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目录中看到该文件。

    • 安装还会创建并启动名为 “AWS 数据提供器” 的 Windows 服务SAP。

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

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

    1. 停止 AWS 使用数据提供器SAP。

    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. 启动 “ AWS 数据提供器” SAP。

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

    在 Windows 上验证安装情况

    在 Windows 上验证安装情况

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

    在 Windows 上检查诊断程序

    在 Windows 上检查诊断程序

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

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

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

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

的 AWS Data Provider 设计SAP为在有或没有连接的情况下运行,但是如果没有连接,您就无法获得更新。如果您没有适当的授权,Amazon CloudWatch 和 Amazon 会EC2返回空值。

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

Windows 上的指标输出示例

在 Windows 上查看指标

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

在 Windows SAP 上停止并重新启动 AWS 数据提供器

在 Windows SAP 上停止并重新启动 AWS 数据提供器

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

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

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

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

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

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

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

    区域 ARN
    默认 arn:aws:sns:us-east-1:804845276281:AWS-DataProvider-SAP-Update
    AWS GovCloud (美国西部)和 AWS 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. 协议-选择电子邮件或SMS。

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

      注意

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

    • SMS— 在 Endpo int 字段中输入您想要接收通知的电话号码。

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

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

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

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

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