在 Windows 系统上配置代理程序

可以使用 IBM Performance Management 窗口在 Windows 操作系统上配置代理程序。更新配置值后，启动代理程序以保存更新后的值。

过程

  1. 单击开始 > 所有程序 > IBM Monitoring 代理程序 > IBM® Cloud Application Performance Management。
  2. 在 IBM Performance Management 窗口中，右键单击 Monitoring Agent for Oracle Database 模板，然后单击配置代理程序。
    切记： 首次配置代理程序实例之后，配置代理程序选项处于禁用状态。要再次配置该代理程序实例，请右键单击它，然后单击重新配置。
  3. 在 Monitoring Agent for Oracle Database窗口中，完成下列步骤：
    1. 为 Monitoring Agent for Oracle Database实例输入唯一的实例名称，然后单击确定。
  4. 在“配置 ITCAM Extended Agent for Oracle Database”窗口的“缺省数据库配置”窗格上，执行下列步骤：
    1. 输入缺省用户名。这是数据库连接的缺省数据库用户标识。
      此用户标识就是代理程序用于访问受监视数据库实例的标识。此用户标识必须对代理程序所需的动态性能视图和表具有 SELECT 特权。
    2. 输入缺省密码。这是与指定的缺省数据库用户标识相关联的密码。
    3. 如果 Oracle 代理程序版本为 8.0，请执行此步骤。
      1. 输入 Oracle JDBC Jar 文件。这是用来与 Oracle 数据库进行通信的 Oracle JDBC 驱动程序 Jar 文件的完整路径。在代理程序计算机上，必须要有支持 Oracle 代理程序所监视 Oracle 数据库版本的 Oracle Java 数据库连接 (JDBC) 驱动程序。
    4. 如果 Oracle 代理程序版本为 6.3.1.10，请执行这些步骤。
      1. 如果 Oracle Database 代理程序是安装在受监视的 Oracle 数据库服务器上，请选中使用 Oracle 主目录中的库，并输入 Oracle 主目录。（可选）要进行本地监视，可将 Oracle 主目录设置保留为空白，在此情况下，将使用 ORACLE_HOME 系统环境变量。
      2. 如果 Oracle Database 代理程序远离受监视的 Oracle 数据库服务器，请选中使用 Oracle 即时客户机中的库，并输入 Oracle 即时客户机安装目录。
    5. 如果您需要设置高级配置选项，请选中显示高级选项，否则前进到步骤 5。
    6. Net Configuration Files Directories 可以保留为空并使用缺省目录。如果 Oracle 代理程序版本为 6.3.1.10，您可输入多个网络配置文件目录，并以分号 (;) 进行分隔。Oracle 代理程序 V8.0 只支持一个目录。
      此设置包含一个或多个 Oracle 数据库网络配置文件。目录由每个 Oracle 数据库实例的 TNS_ADMIN 环境变量进行定义。缺省目录为 %ORACLE_HOME%\NETWORK\ADMIN。如果未配置这个项，那么将使用缺省目录。要禁止使用缺省目录，请将下列代理程序环境变量设置为 false：KRZ_LOAD_ORACLE_NET=false。
    7. 将 定制 SQL 定义文件名保留为空。不使用该属性。
    8. 选择是否在此工作站上配置缺省动态侦听器。
      缺省动态侦听器是 (PROTOCOL=TCP)(HOST=localhost)(PORT=1521)。如果在此工作站上配置了缺省动态侦听器，请将这个值设置为是。
    9. 单击下一步。
  5. 在“配置 ITCAM Extended Agent for Oracle Database”窗口的实例配置窗格上，执行下列步骤：
    这是定义实际数据库连接实例的位置。您必须至少添加一个数据库连接实例。这也是您编辑和删除数据库连接实例的位置。如果存在多个数据库连接实例配置，请使用数据库连接选项来选择要编辑或删除的实例。
    1. 按数据库连接部分中的新建。
    2. 输入数据库连接名称，作为数据库连接的别名。
      此别名用来代表数据库连接，可以随您选择，但有下列限制。只有字母、阿拉伯数字、下划线字符和减号可用于连接名称中。连接名称的最大长度为 25 个字符。
    3. 选择连接类型
      1. （可选）基本

        缺省连接类型（也就是最常用的连接类型）是基本。如果您不确定需要何种连接类型，建议您选择此连接类型。

        1. 当目标受监视数据库是单个实例（例如，标准文件系统实例或单个 ASM 实例）时，请选择基本连接类型。
        2. 输入主机名，作为数据库的主机名或 IP 地址。
        3. 输入该数据库所使用的端口号。
        4. 选择服务名称或 SID。
          1. 如果选择服务名称，请输入作为数据库逻辑表示的服务名称（即，本身是全局数据库服务名称的字符串）。

            服务名称是数据库的逻辑表示，这是向客户端呈现数据库的方法。一个数据库可以呈现为多个服务，而一个服务可以实现为多个数据库实例。服务名称是本身为全局数据库名称的字符串，即，由数据库名称和域名所组成，并在安装或数据库创建期间输入的名称。如果您不确定全局数据库名称为何，您可从初始化参数文件中的 SERVICE_NAMES 参数值获取此名称。

          2. 如果选择 SID，请输入用于标识运行中数据库的特定实例的 Oracle 系统标识。

            这是识别特定数据库实例的 Oracle 系统标识。

            前进到步骤 5d。

      2. （可选）TNS
        1. 如果已设置 ORACLE_HOME 系统环境变量，且已在 $ORACLE_HOME/network/admin/tnsnames.ora 文件中定义目标受监视数据库的 TNS 别名，请选择 TNS 连接类型。
        2. 输入 TNS 别名。

          前进到步骤 5d。

      3. （可选）Advanced
        1. 当目标受监视数据库的多个物理节点中有多个 Oracle 实例时，请选择 Advanced 连接类型。例如，带有 Real Applications Cluster (RAC) 数据库的 ASM。
        2. 输入 Oracle 连接字符串。
          此属性支持所有 Oracle 网络命名方法，如下所示：
          • 以下格式的 SQL Connect URL 字符串：//host:port/service name。例如，//dlsun242:1521/bjava21。
          • Oracle Net 键/值对。例如， 
            (DESCRIPTION=(ADDRESS=(PROTOCOL=tcp) (HOST=dlsun242) (PORT=1521)) 
(CONNECT_DATA=(SERVICE_NAME=bjava21)))
          • TNSNAMES 条目，例如，inst1，其中设置了 TNS_ADMIN 或 ORACLE_HOME 环境变量且配置了配置文件。

          前进到步骤 5d。

    4. 选中此连接的使用不同的用户名和密码，以使用不同于步骤 4a 和步骤 4b中所设置缺省凭证的凭证。否则，请前进到步骤 5g。
    5. 输入此连接的数据库用户名。
      此用户标识就是代理程序用于访问受监视数据库实例的标识。此用户标识必须对代理程序所需的动态性能视图和表具有 SELECT 特权。
    6. 输入数据库密码。这是与指定的数据库用户标识相关联的密码。
    7. 选择与授予数据库连接凭证的许可权匹配的角色。
      角色是与连接关联的一组特权。对于已获授予 SYSDBA 系统特权的用户，请指定包括该特权的角色。对于 ASM 实例，请使用 SYSDBA 或 SYSASM 角色。
    8. 如果您从这个代理程序实例监视远程 Oracle 警报日志，请选中显示远程日志监视选项，否则请前进到步骤 5k。
    9. 输入路径或使用浏览以选择 Oracle 警报日志文件路径。
      用于此数据库连接中远程数据库实例的已映射警报日志文件的绝对路径。代理程序通过读取这些文件监视警报日志。其通常位于 $ORACLE_BASE/diag/rdbms/DB_NAME/SID/trace/alert_SID.log。例如，如果 DB_NAME 和 SID 都是 db11g，而 ORACLE_BASE 是 /home/dbowner/app/oracle，那么警报日志将位于 /home/dbowner/app/oracle/diag/rdbms/db11g/db11g/trace/alert_db11g.log。

      Windows如果 Oracle Database 代理程序运行并通过网络读取警报日志文件，那么远程文件路径必须遵循 Windows 系统的通用命名约定。例如，\\tivx015\path\alert_orcl.log。

      Windows
      要点： 同时输入路径和警报日志文件名。警报日志路径不支持映射的网络驱动器。

      Linux 或 AIX如果 Oracle Database 代理程序在远程服务器上，那么需要本地挂装的文件系统，才能监视其远程警报日志。

      Windows多个文件由分号 (;) 分隔。

      Linux 或 AIX多个文件由冒号 (:) 分隔。

      每个文件都使用 alert_instance.log 文件名模式与一个数据库实例匹配，如果不匹配，那么会将其忽略。

      系统会自动发现本地数据库实例警报日志文件。

    10. 选择或输入 Oracle 警报日志文件字符集。这是所映射的警报日志文件的代码页。
      如果此参数为空白，那么会使用系统的当前语言环境设置，例如：
      • ISO8859_1，ISO 8859-1 西欧编码
      • UTF-8，UTF-8 Unicode 编码
      • GB18030，简体中文 GB18030 编码
      • CP950，繁体中文编码
      • EUC_JP，日语编码
      • EUC_KR，韩语编码

      有关所有受支持代码页的完整列表，请参阅 ICU 受支持代码页。

    11. 单击应用以将此数据库连接实例的设置保存在数据库连接部分中。
    12. （可选）对新的数据库连接进行测试。
      1. 在数据库连接部分中，选择新的数据库连接。
      2. 单击测试连接。
      3. 在“测试连接”结果窗口中观察结果。
        • 成功测试结果示例：
          正在测试连接 config1 ...
成功
        • 不成功测试结果示例：
          正在测试连接 config1 ...
KBB_RAS1_LOG；将 MAXFILES 设置为 1
ORA-12514：TNS：侦听器当前无法识别连接描述符中所请求的服务 
失败
    13. 单击下一步。
  6. 阅读“配置 ITCAM Extended Agent for Oracle Database”窗口中摘要窗格上的信息，然后单击确定以完成代理程序实例的配置。
  7. 在 IBM Performance Management 窗口中，右键单击 Monitoring Agent for Oracle Database，然后单击启动。

下一步做什么

  • 登录 Cloud APM 控制台可在仪表板中查看代理程序所收集的数据。有关使用 Cloud APM 控制台的信息，请参阅启动 Cloud APM 控制台。