通过对提示做出响应来配置代理程序

要在 Linux 和 UNIX 操作系统上配置此代理程序，请运行命令行配置脚本并对提示做出响应。

过程

  1. 打开 install_dir/bin 目录，其中，install_dir 是 Oracle Database 代理程序的安装目录。
  2. （可选）要列出任何已配置的现有代理程序实例的名称，请运行以下命令：./cinfo -o rz。
  3. 要配置 Oracle Database 代理程序，请运行以下命令：./oracle_database-agent.sh config instance_name。
  4. 当出现 Edit 'Monitoring Agent for Oracle Database' settings 提示时，请按 Enter 键。缺省值为 Yes。
  5. 要输入 Default Database Configuration 信息，请执行下列步骤：
    注： Default Database Configuration 节不是数据库连接实例配置。这是一个模板节，用于设置当您从步骤 6 开始添加实际的数据库连接实例配置时，要用作缺省值的内容。
    1. 当出现 Default Username 提示时，请输入数据库连接的缺省数据库用户标识，并按 Enter 键。
      此用户标识就是代理程序用于访问受监视数据库实例的标识。此用户标识必须对代理程序所需的动态性能视图和表具有 SELECT 特权。
    2. 当出现 Enter Default Password 提示时，请输入与指定的缺省数据库用户标识相关联的密码，然后按 Enter 键。接着，如果出现提示，请确认密码。
    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 Home Directory 提示时，如果 Oracle Database 代理程序是安装在受监视的 Oracle 数据库服务器上，请输入 Oracle 主目录，然后按 Enter 键。如果 Oracle Database 代理程序不是安装在将要监视的 Oracle 数据库服务器上，请将此设置保留为空，按 Enter 键，并执行下一步。如果要清除 Oracle Home Directory 目录值，请按空格键，然后按 Enter 键。
        注： （可选）要进行本地监视，可将 Oracle Home Directory 和 Oracle Instant Client Installation Directory 保留为空，在此情况下，将使用 ORACLE_HOME 系统环境变量。
      2. 如果 Oracle Database 代理程序远离受监视的 Oracle 数据库服务器，请输入 Oracle Instant Client Installation Directory 目录，然后按 Enter 键。如果已在步骤 5.d.i 中设置 Oracle Home Directory，那么将忽略此值。
    5. Net Configuration Files Directories 可以保留为空并使用缺省目录。如果 Oracle 代理程序版本为 6.3.1.10，您可输入多个网络配置文件目录，并以Windows“;”或Linux 或 AIX“:”进行分隔。Oracle 代理程序 V8.0 只支持一个目录。按 Enter 键。
      此设置包含一个或多个 Oracle 数据库网络配置文件。目录由每个 Oracle 数据库实例的 TNS_ADMIN 环境变量进行定义。缺省目录为 Linux 或 AIX$ORACLE_HOME/network/admin 或 Windows%ORACLE_HOME%\NETWORK\ADMIN。如果未配置这个项，那么将使用缺省目录。要禁止使用缺省目录，请将下列代理程序环境变量设置为 false：KRZ_LOAD_ORACLE_NET=false。
    6. 选择是否在此工作站上配置缺省动态侦听器，并按 Enter 键。
      缺省动态侦听器是 (PROTOCOL=TCP)(HOST=localhost)(PORT=1521)。如果在此工作站上配置了缺省动态侦听器，请将这个值设置为 True。
    7. 将 定制 SQL 定义文件名保留为空。不使用该属性。
  6. 在屏幕上看到下列输出之后，系统会显示 Edit 'Database Connection' settings 提示： 
    Instance Configuration :
Summary :
Database Connection :
    注： 此步骤是定义实际数据库连接实例的位置。您必须至少添加一个数据库连接实例。这也是您编辑和删除数据库连接实例的位置。如果存在多个数据库连接实例配置，请使用 Next 选项来跳过不需要编辑或删除的实例，直至到达您需要编辑或删除的实例为止。
  7. 要添加新的数据库连接，请输入 1，并按 Enter 键。
  8. 要输入数据库连接信息，请执行以下步骤：
    1. 当出现 Database Connection Name 提示时，请输入数据库连接的别名，并按 Enter 键。
      此别名用来代表数据库连接，可以随您选择，但有下列限制。只有字母、阿拉伯数字、下划线字符和减号可用于连接名称中。连接名称的最大长度为 25 个字符。
    2. 当出现 Connection Type 提示时，请选择下列其中一种连接类型：
      1. （可选）Basic

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

        1. 当目标受监视数据库是单个实例（例如，标准文件系统实例或单个 ASM 实例）时，请选择基本连接类型。
        2. 当出现 Hostname 提示时，请输入 Oracle 数据库的主机名或 IP 地址，并按 Enter 键。
        3. 当出现 Port 提示时，请输入端口号，并按 Enter 键。
        4. 输入随后两项设置中的一个。即，Service Name 或 SID。
          1. （可选）当出现 Service Name 提示时，请输入作为数据库逻辑表示的服务名称（即，本身是全局数据库服务名称的字符串），按 Enter 键，然后前进到步骤 8c。

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

          2. （可选）当出现 SID 提示时，请输入用于标识运行中数据库的特定实例的 Oracle 系统标识，按 Enter 键，然后前进到步骤 8c。

            此参数是识别特定数据库实例的 Oracle 系统标识。如果已在步骤 8.b.i.4.a 中定义 Service Name，那么可将这个项保留为空白。

      2. （可选）TNS
        1. 如果已设置 ORACLE_HOME 系统环境变量，且已在 $ORACLE_HOME/network/admin/tnsnames.ora 文件中定义目标受监视数据库的 TNS 别名，请选择 TNS 连接类型。
        2. 输入 TNS 别名，按 Enter 键，然后前进到步骤 8c。
      3. （可选）Advanced
        1. 当目标受监视数据库的多个物理节点中有多个 Oracle 实例时，请选择 Advanced 连接类型。例如，带有 Real Applications Cluster (RAC) 数据库的 ASM。
        2. 输入 Oracle 连接字符串，按 Enter 键，然后前进到步骤 8c。
          此属性支持所有 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 环境变量且配置了配置文件。
          注： 命令行配置期间所显示的描述可能会在冒号 (\:) 和等号 (\=) 之前附加反斜杠。在连接字符串中，请勿输入反斜杠。在描述中显示反斜杠，是为了避开将等号解释为命令组成部分的一般行为，而改为将其仅仅解释为文本。
        3. 前进到步骤 8c。
    3. 当出现 Database Username 提示时，请输入连接的数据库用户标识，并按 Enter 键。

      对于标准文件系统实例，此用户标识必须对代理程序所需的动态性能视图和表具有 SELECT 特权。

      针对 ASM 实例，使用具有 SYSDBA 或 SYSASM 角色的帐户。例如，sys 帐户。

    4. 当出现 Enter Database Password 提示时，请输入与指定的数据库用户标识关联的密码。
    5. 当出现 Role 提示时，请选择与授予所指定用户标识的许可权匹配的角色，并按 Enter 键。

      角色是与连接关联的一组特权。对于已获授予 SYSDBA 系统特权的用户，请指定包括该特权的角色。

      对于 ASM 实例，请使用 SYSDBA 或 SYSASM 角色。

    6. 当出现 Oracle Alert Log File Paths (including alert log file name) 提示时，请输入警报日志路径，并按 Enter 键。

      此参数是指定此数据库连接中，远程数据库实例的映射警报日志文件的任何绝对文件路径。代理程序通过读取这些文件监视警报日志。其通常位于 $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。
      要点： 同时输入路径和警报日志文件名。警报日志路径不支持映射的网络驱动器。

      Linux 或 AIX如果 Oracle Database 代理程序运行，那么远程警报日志需要本地安装的文件系统。

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

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

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

      本地数据库实例警报日志文件可以自动发现。

    7. 当出现 Oracle Alert Log File Charset 提示时，请输入映射的警报日志文件的代码页，并按 Enter 键。
      如果此参数为空白，那么会使用系统的当前语言环境设置，例如：
      • ISO8859_1，ISO 8859-1 西欧编码
      • UTF-8，UTF-8 Unicode 编码
      • GB18030，简体中文 GB18030 编码
      • CP950，繁体中文编码
      • EUC_JP，日语编码
      • EUC_KR，韩语编码

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

  9. 当再次出现 Edit 'Database Connection' settings 提示时，您会看到步骤 8a 中设置的数据库连接名称。您可再次进行编辑，或将其删除。如果您已配置多个数据库连接实例，请使用下一步来逐个处理这些实例。
  10. （可选）要添加另一个数据库连接，以使用此代理程序实例来监视多个数据库实例，请输入 1，按 Enter 键，然后回到步骤 8。
  11. 完成修改数据库连接之后，请输入 5，然后按 Enter 键以退出配置过程。
  12. 要启动代理程序，请输入：
    install_dir/bin/oracle_database-agent.sh start instance_name.

下一步做什么

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