1. 监视和分析 Oracle E-Business Suite 健康状况和性能
  2. 执行一般先决条件任务

执行一般先决条件任务

要将 Oracle Management Cloud 设置为监视您的 Oracle E-Business Suite 环境，您需要执行一组常规任务。

启用 Enterprise Edition 许可证

Oracle Management Cloud 产品在不同的许可证版本（包括 Enterprise Edition）中进行分类和提供。

Oracle Management Cloud – Enterprise Edition 提供以下信息：

  • Oracle Application Performance Monitoring：提供用于监视和管理应用程序的平台。

  • Oracle Infrastructure Monitoring：从单个平台监视整个信息技术基础结构的状态和健康状况，并提醒管理员有关问题。

  • Oracle 业务流程：通过调用 REST api 或使用第三方自动化框架，自动执行云和内部部署基础结构并执行任务。

  • Oracle IT Analytics：为 360-degree 提供对应用程序和基础结构投资的性能、可用性和能力的深入分析。

为主机 Oracle Cloud Infrastructure 系统和 Oracle E-Business Suite 启用 Oracle Management Cloud - Enterprise Edition。

  1. 以 Oracle Management Cloud 管理员身份登录到 Oracle Management Cloud 控制台。
    如果未显示管理云导航窗格，则单击左上角的 OMC 导航图标。
  2. 在 Oracle Management Cloud 控制台导航窗格中，单击管理，然后单击实体配置。
  3. 单击许可，然后单击选择实体。
  4. 找到并选择所需的实体，然后单击选择按钮。
  5. Select Enterprise Edition for each entity listed or click License Edition and select Set All to Enterprise.
  6. 单击保存。

安装 Oracle Management Cloud 代理

安装检索监视度量的 Oracle Management Cloud 代理。

  • 网关代理：在具有 Oracle Management Cloud Internet 访问权限的主机上安装网关代理，并且可以由部署云代理的所有主机访问。所有 Oracle Management Cloud 代理都应使用通用网关。

  • 云代理：在 Oracle E-Business Suite 拓扑中的每个主机上安装云代理，以便从驻留在这些主机上的实体监视和收集数据（例如，度量、配置信息和日志）。

安装代理之前

在 Oracle E-Business Suite 上安装代理之前，请确保您解决以下注意事项。

对于安装代理的代理基目录 :

  • 请确保只有 root 用户和 agent installation 用户对代理基目录及其父目录具有写权限 , 即使在安装代理后也是如此。这可确保所有代理生命周期操作（例如更新或删除）均已成功完成。

  • 如果在安装前创建了代理基目录 , 请确保该目录为空。代理安装用户必须具有目录的写入访问权限。

  • 如果在安装前未创建代理基目录，则默认情况下将在提取代理软件 zip 文件的目录下创建该目录。请确保代理安装用户对创建代理基目录的父目录具有写访问权限。

创建或下载注册密钥

注册密钥针对您的身份域发布，在部署云代理时使用。在随注册密钥一起安装代理后，可以从 Oracle Management Cloud 中删除该密钥。

创建注册密钥时，指定密钥的使用计数。如果使用计数大于等于创建关键字时指定的最大使用量 , 则将失效关键字。

  1. 以 Oracle Management Cloud 管理员身份登录到 Oracle Management Cloud 控制台。
    如果未显示管理云导航窗格，则单击左上角的 OMC 导航图标。
  2. 在 Oracle Management Cloud 控制台导航窗格中，单击管理，然后单击代理。
  3. 单击右侧的菜单，然后选择管理注册密钥。
  4. 在“注册密钥”页中输入所需详细信息，然后单击创建新密钥，即可创建新的注册密钥。
  5. 要下载现有的注册密钥，请执行以下步骤：
    1. 从注册密钥列表中，找到要下载的密钥。
    2. 单击页面右侧的操作菜单，然后选择下载。
      包含注册密钥值的文本文件 registrationKey.txt 将下载到本地驱动器。要查看密钥值，请打开 registrationKey.txt 文件。
您将在响应文件的 AGENT_REGISTRATION_KEY 参数中添加密钥值。

下载网关代理

使用 Oracle Management Cloud 控制台将网关代理软件安装绑定 ZIP 文件下载到主机上。

提取网关 ZIP 文件时，示例响应文件 gateway.rsp 将作为模板提供。

  1. 以 Oracle Management Cloud 管理员身份登录到 Oracle Management Cloud 控制台。
    如果未显示管理云导航窗格，则单击左上角的 OMC 导航图标。
  2. 在 Oracle Management Cloud 控制台导航窗格中，单击管理，然后单击代理。
  3. 单击右侧的菜单，然后选择下载代理。
  4. 单击代理类型，然后选择网关。
  5. 单击操作系统，然后选择要在其中安装代理的操作系统。
  6. 记下显示在代理链接下的 TENANT_NAME 和 OMC_URL 参数值。安装网关代理时，需要使用这些值更新响应文件。
  7. 单击操作系统的代理软件链接可下载网关软件 ZIP 文件。
  8. 通过将下载文件的 SHA1 校验和值与代理下载页上为代理列出的文件进行比较 , 确保下载的 ZIP 文件完成 :
    sha1sum <agent_binary_filename>.zip
    用户界面中 SHA1 校验和列的值应与输出匹配。
  9. 导航到软件包已下载到的目录并解压缩软件。
    unzip <agent_binary_filename>.zip

下载云代理

使用 Oracle Management Cloud 控制台将云代理软件安装绑定 ZIP 文件下载到您的主机上。

提取代理 ZIP 文件时，示例响应文件 agent.rsp 将作为模板提供。

  1. 以 Oracle Management Cloud 管理员身份登录到 Oracle Management Cloud 控制台。
    如果未显示管理云导航窗格，则单击左上角的 OMC 导航图标。
  2. 在 Oracle Management Cloud 控制台导航窗格中，单击管理，然后单击代理。
  3. 单击右侧的菜单，然后选择下载代理。
  4. 单击代理类型，然后选择云代理。
  5. 单击操作系统，然后选择要在其中安装代理的操作系统。
  6. 记下显示在代理链接下的 TENANT_NAME 和 OMC_URL 参数值。安装网关代理时，需要使用这些值更新响应文件。
  7. 单击操作系统的代理软件链接可下载网关软件 ZIP 文件。
  8. 通过将下载文件的 SHA1 校验和值与代理下载页上为代理列出的文件进行比较 , 确保下载的 ZIP 文件完成 :
    sha1sum <agent_binary_filename>.zip
    用户界面中 SHA1 校验和列的值应与输出匹配。
  9. 导航到软件包已下载到的目录并解压缩软件。
    unzip <agent_binary_filename>.zip

安装网关代理

网关代理在 Oracle Management Cloud 与所有其他 Oracle Management Cloud 代理之间充当受保护通道。

要安装网关代理，请执行以下操作：

  1. 在文本编辑器中编辑网关响应文件 gateway.rsp （在下载并提取网关 ZIP 文件时获取的文本）, 并提供安装网关所需的参数的值。

    下表列出了网关安装所需的参数。

    参数 说明

    TENANT_NAME

    或

    TENANT_ID （在较早版本中受支持，保持向后兼容）

    运行 Oracle Management Cloud 的租户的名称。通过导航到管 理>代理>下载，然后从代理类型下拉列表中选择代理类型，可以获取代理的 TENANT_NAME 值。TENANT_NAME 值显示在页面底部。

    OMC_URL

    或

    UPLOAD_ROOT （在较早版本中受支持，保持向后兼容）

    连接到 Oracle Management Cloud 以上载特定 TENANT_NAME 数据所需的绝对 URL，其中包含连接所需的协议。要获取此值，请导航到管 理>代理 >下载，然后从代理类型下拉列表中选择代理类型。OMC_URL 值显示在页面底部。

    AGENT_REGISTRATION_KEY

    Key to validate the identity of the tenant and the authenticity of the installation. You can get the registration key from Oracle Management Cloud Dashboard, by navigating to Administration > Agents > Registration Keys.

    AGENT_BASE_DIRECTORY

    主机上必须安装代理的空目录。如果指定的目录不存在 , 则会在安装期间创建一个目录。

    注 : 对于 Windows, 包括驱动器盘符在内的目录路径长度应小于 23 个字符。

  2. 保存响应文件。
  3. 运行先决条件检查以验证参数。使用命令行界面运行传递参数 EXECUTE_PREREQ=true 的 AgentInstall.sh 脚本。
    $ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed for [Gateway].

    该脚本运行先决条件检查。如果先决条件检查失败，则脚本将停止，并显示相关错误消息。

    有关详细信息 , 请参阅位于 <AGENT_ZIP_FILE_EXTRACTED_DIRECTORY>/AgentInstall_<timestamp>.log 下的日志文件。在安装网关之前修复所有错误。

  4. 通过将响应文件名作为参数运行 AgentInstall.sh 脚本来安装代理。

    ./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the gateway.rsp file>

安装云代理

云代理从您部署云代理的主机中收集实体数据。

云代理安装需要主机的全限定域名(FQDN)。对于 UNIX 环境，请在 /etc/hosts 文件中添加 FQDN 并确保它映射到主机的正确主机名和 IP 地址。

注： 在每个应用程序层主机和数据库主机上安装云代理。

要安装云代理，请执行以下操作：

  1. 在文本编辑器中编辑云代理响应文件 agent.rsp （在下载并提取云代理 ZIP 文件时获取的文本），并为安装云代理所需的参数提供值。

    下表列出了使用网关通过代理服务器与 Oracle Management Cloud 进行通信的云代理安装之前所列的网关安装参数和上方所需的参数。

    参数 说明

    GATEWAY_HOST

    如果云代理正在使用网关与 Oracle Management Cloud 通信，则提供网关的全限定域名(FQDN)。安装云代理时，请确保提供安装网关所用的相同网关主机名。

    例如，在部署网关时，如果指定 ORACLE_HOSTANME=abc.xyz.com 并在安装云代理时指定 GATEWAY_HOST=abc，则会导致云代理注册失败。网关代理必须安装在主机上且已启动且正在运行。

    GATEWAY_PORT

    当云代理使用网关与 Oracle Management Cloud 进行通信时，您必须指定网关端口。

    可通过执行以下命令获取端口号：

    $Gateway_Agent_Home/agent_inst/bin/omcli status agent

    OMC_PROXYHOST

    要用于连接的代理服务器的地址。请确保您未使用代理主机详细信息传递 https:// 值。

    OMC_PROXYPORT

    代理服务器的端口。

    OMC_PROXYUSER

    访问代理服务器所需的用户名。

    OMC_PROXYPWD

    访问代理服务器所需的口令。

    OMC_PROXYREALM

    要用于访问代理服务器的验证领域（如果有）。

    AGENT_PORT

    代理进程将绑定到的端口号。如果在安装时此端口占用，AgentInstall 脚本将停止安装过程。

  2. 保存响应文件。
  3. 运行先决条件检查以验证参数。使用命令行界面运行传递参数 EXECUTE_PREREQ=true 的 AgentInstall.sh 脚本。
    $ ./AgentInstall.sh EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Gateway...
Executing Pre-requisite checks only for Gateway..
Gateway parameter validation started...
Gateway pre-requisite checks started...
Pre-requisite checks successfully completed.

    该脚本运行先决条件检查。如果先决条件检查失败，则脚本将停止，并显示相关错误消息。

  4. 通过将响应文件名作为参数运行 AgentInstall.sh 脚本来安装代理。

    ./AgentInstall.sh AGENT_RSP_FILE=<absolute path to the agent.rsp file>

验证代理安装

安装网关和云代理后 , 请验证是否已成功部署代理。

  1. 以 Oracle Management Cloud 管理员身份登录到 Oracle Management Cloud 控制台。
    如果未显示管理云导航窗格，则单击左上角的 OMC 导航图标。
  2. 在 Oracle Management Cloud 控制台导航窗格中，单击管理，然后单击代理。
  3. 单击代理类型的选项卡，例如网关或云代理。
  4. 确保已部署网关或云代理的主机名存在于可用代理列表中。