
# --------------------------- 添加 -------------------------------------------

<Add>
添加

用法：单击“添加”；填写对话框；单击“添加”。

您可以通过向 CandleDBConfig 提供以下信息来手工添加服务器：

1) 服务器名称 － 要监视的数据库服务器的名称。

2) 主目录 － 安装了服务器的目录的标准名称。

3) $Product 版本 － 数据库可执行文件的版本或发行版级别。

4) Init 文件名 － 数据库初始化文件的标准名称。
   此字段是可选的，仅供参考。OMA for $Product 不需要 init 文件名。

5) 登录标识 － 用来与 $Product 连接的数据库登录标识。

6) 密码 － 与“登录标识”一起使用的密码。

提供此信息之后，将更新 CandleDBConfig 中显示的数据库服务器列表以包含新服务器。

</Add>

# --------------------------- 更改 ---------------------------------------
#
# 因为它只与 98R2 最接近，所以已将它除去。

# --------------------------- 显示 ---------------------------------------
#
# “显示”已与“修改”合并。


# --------------------------- 排除 ---------------------------------------

<Exclude/Include>
排除/包含

用法：从 CandleDBConfig 中显示的数据库服务器中选择一个或多个服务器；单击“排除”。

“排除”实际上是一次切换。使用它可以排除不需要监视的服务器。如果当前排除了某个服务器，则“排除”将重新激活该服务器并将它包含到您正在监视的服务器中。
 
如果“搜索”还要查找未运行的服务器，则 CandleDBConfig 将考虑让任何指向实数据库的有效 $init_name 文件来代表服务器。
但是，$init_name 文件可能是实验性的或已过时。“排除”允许您在以后的考虑中排除这些服务器。

注意，因为服务器未运行，所以不必排除该服务器。您可以配置一个代理程序来监视未运行的服务器，甚至可以启动该代理程序。该代理程序将向 CMS 注册，并将定期尝试与数据库建立连接。如果数据库启动了，则该代理程序将开始对它进行报告。因而，您可以定义一个代理程序来监视部分时间工作的 $Product 数据库，该代理程序将在数据库活动发生时报告此活动。

CandleDBConfig 中显示的数据库服务器的“状态”字段将更新以显示已排除的服务器。

</Exclude/Include>

# --------------------------- 信息   ---------------------------------------
#
# 未使用。

# --------------------------- 列出 ------------------------------------------

<列出配置文件>
列出配置文件

用法：从 CandleDBConfig 中显示的数据库服务器中选择一个或多个服务器；单击“列出”；查看配置文件；如果此时显示出配置文件，则使用“上一个”和“下一个”按钮来查看不同的配置文件；单击“取消”。

“列出”可用来查看由 CandleDBConfig 创建的数据库服务器配置文件的内容。此时，只能查看文件；不能从 CandleDBConfig 编辑这些文件。

</列出配置文件>

# --------------------------- 查找 ----------------------------------------

<搜索 II（磁盘搜索）>
搜索 II（磁盘搜索）

用法：单击“搜索 II”；选择搜索类型；单击“开始”。

如果“搜索”找不到要监视的所有数据库，则“搜索 II”将提供几种可以使用的搜索技术。“搜索 II”选项有：

1) 在 \$PATH 中搜索脚本以查找 $home_name。

   如果您通常使用本地编写的脚本来启动数据库应用程序，则每个脚本必须包含将 $home_name 设置为数据库安装目录的语句。此选项将搜索 UNIX \$PATH 中的所有脚本来查找这样的语句。

2) 从某个特定目录开始搜索。此目录通常是数据库所有者的 \$HOME。但是，如果使用了完整路径名，则可以指定任何目录。除了搜索范围限制在指定目录下的目录（而不是 \$PATH 中提供的目录）之外，此选项与 1) 类似。
   
3) 搜索可能是 $Product 的所有者的用户。

   您可以请求 CandleDBConfig 在可能拥有数据库安装的 UNIX 用户的 \$HOME 目录下搜索磁盘文件。然后将显示其标识或描述中具有字符“$Prd”或“dba”的所有 UNIX 用户的列表，这些用户可能是 $Product 所有者。   在从此列表中选择用户之后，CandleDBConfig 将搜索这些用户的目录树来查找 $Product 安装。

   请注意，此选项支持 /etc/passwd 文件或者“yp”或“"nis”共享登录数据库中定义的用户。还要注意列表中提供了文件系统。因为此字段告诉您用户磁盘实际所在的位置，所以它将帮助您确定是否考虑用户。

   警告：如果文件系统由速度较慢的通信链路另一端中的机器管理，则搜索 NFS 文件系统可能要花费很长的时间。但是，这样的文件系统通常不包含在此机器上运行的数据库服务器。


然后 CandleDBConfig 中显示的数据库服务器列表将更新以包含使用“搜索 II”技术找到的任何其他服务器。

</搜索 II（磁盘搜索）>

# --------------------------- 登录  ----------------------------------------

<指定登录标识/密码>
指定登录标识/密码

用法：从 CandleDBConfig 中显示的数据库服务器中选择一个或多个服务器；单击“指定”；填写对话框；单击“确定”。

“指定”使您能够定义代理程序用来访问数据库的数据库登录标识和密码。您可以自由选择任何新的或现有的数据库登录标识。缺省登录标识为“candle”。请注意，数据库标识是由数据库管理员定义的，并允许对数据库进行访问。UNIX 登录标识不一定是数据库登录标识，但这两个标识可以具有相同的名称。已定义到 OMA for $Product 但不具有任何登录标识或密码信息的服务器都以 (I) 显示，表示在 CandleDBConfig 中不完整。

“指定”只告知 Candle 监视代理程序如何连接数据库。CandleDBConfig 不创建数据库登录标识，也不为标识指定密码或授予必需的权限。您必须确保数据库登录标识和密码与此处指定的标识和密码匹配。但是，“验证”将检查 CandleDBConfig 中指定的登录标识/密码实际上是否对数据库有效。

如果您将密码字段留空，则 CandleDBConfig 将询问您是否真的希望密码为空。密码为空意味着将数据库登录配置为不需要密码就可以工作。出于安全考虑，密码在日志文件 $CANDLEHOME/logs/<host_name>_dd_config.log 中显示为“xxxxxx”

对于 Oracle 7.1.4，请注意：Oracle 7.1.4 只允许内部管理登录标识“sys”来读取性能视图。这是一个错误，Oracle 已在更高的发行版中对它进行了修订，但是没有修订程序可用于 7.1.4。因而，当连接 Oracle 7.1.4 数据库时，您必须指定数据库登录标识“sys”。

然后 CandleDBConfig 中显示的数据库服务器列表将更新以显示所有新的登录标识。

</指定登录标识/密码>

# --------------------------- 修改  ---------------------------------------

<修改/显示>
修改/显示

用法：从 CandleDBConfig 中显示的数据库服务器中选择一个或多个服务器；单击“修改”；在对话框中输入或更改值；单击“修改”。

“修改”列出了服务器的以下所有已配置的属性，并允许您更改除服务器名称外的任何属性。

1) 主目录 － 安装了服务器的目录的标准名称。

2) $Product 版本 － 数据库可执行文件的版本或发行版级别。

3) Init 文件名 － 数据库初始化文件的标准名称。
   此字段是可选的，仅供参考。OMA for $Product 不需要 init 文件名。

   重要信息：如果服务器更改了名称，则不要使用此字段来指向新 $init_name 文件。而是包含此服务器，并让 CandleDBConfig 添加新名称作为新服务器。

4) 登录标识 － 用来与 $Product 连接的数据库登录标识。

5) 密码 － 与“登录标识”一起使用的密码。

然后 CandleDBConfig 中显示的数据库服务器列表将更新以显示所有新的配置信息。

</修改/显示>

# --------------------------- 选项 ------------------------------------------

<选项>
选项

用法：单击“选项”；选择选项；单击“确定”。

“选项”可用来设置 CandleDBConfig 操作的运行时行为。如果选择了“验证配置文件”，则每个 CandleDBConfig 操作将确保 $CANDLEHOME/config 中的数据库配置文件具有正确的格式。

缺省情况下（“使用现有日志文件”），CandleDBConfig 每次执行操作时，都会将条目写入现有的日志文件 $CANDLEHOME/logs/<host_name>_dd_config.log 中。如果您希望只记录最近执行的操作或根本不记录任何操作，则选择“创建新日志文件”或“不写入日志文件中”。

</选项>

# --------------------------- 所有者  ----------------------------------------
#
# “所有者”现在是搜索 2 的一部分。

# --------------------------- 扫描 ------------------------------------------

<搜索>
搜索

用法：如果需要，则选中“未运行”；单击“选项”；选择选项；单击“确定”；单击“搜索”。

当您调用 CandleDBConfig 或按“搜索”时，CandleDBConfig 将对您的环境执行初始扫描以查找所有正在运行的 $Product 服务器。如果您选中了“未运行”，则 CandleDBConfig 还将搜索当前未运行的数据库。搜索结果显示在 CandleDBConfig 对话框中。
 
CandleDBConfig 检查所有正在运行的 $Product 服务器，找出 UNIX 系统中安装这些服务器的位置并获取关于它们的其他信息。完成搜索所需的时间取决于您正在运行的 UNIX 的版本。

如果您要求 CandleDBConfig 搜索未运行的服务器，则它将创建所有可能存在的 $home_name 目录的内部列表，并查找在该列表中定义的任何服务器。CandleDBConfig 将从以下位置生成可能的 $home_name 目录列表：

1) 任何正在运行的服务器的 $home_name 目录。

2) $home_name 环境变量（如果有）的当前设置。

3) 创建 $home_name 环境变量的数据库所有者 \$HOME 目录中自动脚本（.profile、.login 等等）里的任何语句。

4) 如果在安装 Oracle 时运行 Oracle 安装后根脚本 \$ORACLE_HOME/orainst/root.sh，则该脚本将创建名为 /etc/oratab 的注册表文件。Oracle 和 Candle 都建议您运行此脚本，这样可以轻松地找到 Oracle 服务器。请注意，CandleDBConfig 假定注册表或 oratab 文件名为 /etc/oratab。

如果“搜索”找到了您不希望监视的服务器，则可以使用“排除”按钮来将它排除。此外，直到您更改了使用“选项”按钮选择的搜索选项之后，它们才会生效。

</搜索>

# --------------------------- 系统 ---------------------------------------

<系统/数据库配置>
系统/数据库配置

以下是 OMEGAMON Monitoring Agent（OMA）监视数据库之前需要的系统和数据库准备的简要描述。请参阅文档“在 UNIX 上安装 Candle 产品”以获取完整的详细信息。

系统

1) kddos 可执行文件需要特殊的 UNIX 许可权。安装 OMA 时应该已设置了这些许可权。如果未设置，则可以使用 Candle 产品安装程序来进行设置。请参阅“在 UNIX 上安装 Candle 产品”文档以获取详细信息。

2) 必须将适当的种子数据植入 CMS 中。安装 OMA 时应该已将种子数据植入 CMS 中。如果未植入，则可以使用 Candle 产品安装程序来将种子数据植入 CMS 中。请参阅“在 UNIX 上安装 Candle 产品”文档以获取详细信息。

数据库

INFORMIX

Informix 所需的唯一权限是连接数据库的权限。$CANDLEHOME/misc/koxgrant.sql 具有执行此操作的正确 SQL 语法。

OMA for Informix 包含需要作为可选 Informix ALARMPROGRAM 运行的程序。请修改 ONCONFIG，这样 ALARMPROGRAM 就是您的 UNIX 系统的 $CANDLEHOME/<arch>/koxerr。如果您已具有定制 ALARMPROGRAM，则将 ONCONFIG ALARMPROGRAM 语句修改为指向 koxerr.sh，并将 koxerr.sh 修改为指向您的程序。koxerr.sh 脚本具有完整的指示信息。

ORACLE


OMA for Oracle 使用 Oracle 登录标识来连接数据库。除了 Oracle 7.1.4 外，OMA 可以使用任何 Oracle 标识，甚至是用于其他用途的标识。CandleDBConfig 不创建此标识。如果您希望，也可以在定义标识时不指定密码。如果是这样，则向 CandleDBConfig 指示密码为空。此外，Oracle 登录标识和密码不区分大小写。

以下 Oracle SQL 语句为 Oracle 定义了标识和密码。在此示例中，“oralogin”指示了您将使用的 Oracle 登录标识，“password”指示了该标识的密码。

  CREATE USER oralogin IDENTIFIED BY password;

这些 Oracle 发行版的安全需求有所不同：

  7.1.4  必须以“sys”的身份连接 OMA for Oracle。这是 Oracle 限制。

  7.1.6  您可以使用任何 Oracle 登录标识，但该标识必须有权读取任何表。如果该标识为“candle”，您将授予此权限，方法是使用具有 DBA 特权的 Oracle 登录标识来连接 Oracle 并发出以下 SQL 语句：

           GRANT SELECT ANY TABLE TO oralogin;

         此要求是 Oracle 限制。

  7.2 和更高版本。您可以使用任何 Oracle 登录标识，并且只需要向该标识授予特定特权。Candle 提供了执行这些授权操作的 SQL 脚本。此脚本在 $CANDLEHOME/misc/korgrant.sql 中。      此处是运行此脚本的简要指示信息。请参阅“在 UNIX 上安装 Candle 产品”文档以获取更多详细信息。

      a) 为此安装设置 Oracle 环境变量 ORACLE_SID 和 ORACLE_HOME。如果您完成了数据库的配置，则可以“查找”配置目录中的文件来设置这些变量。

      b) 启动 sqlplus。

      c) 在 SQL 提示符后面发出以下命令：SQL> @korgrant candle

      警告：sqldba 和 svrmgr(l) 不允许参数与 sql 脚本一起使用。 
      如果您将 korgrant.sql 与以下某一程序一起运行，则必须修改它以将出现的所有 &1 都替换为希望使用的登录标识。

OMA for Oracle 要求安装 Oracle 性能视图和同义词。如果 Oracle 安装程序运行到完成为止，则它将创建这些 Oracle 性能视图和同义词。性能视图和同义词还可由 ORACLE_HOME/rdbms/admin 中相应的 SQL 脚本创建。请参阅 Oracle 文档以获取详细信息。请注意，如果您使用 Oracle“sys”登录标识（对于 Oracle 7.1.4，必须使用此标识），则不作此要求。

只有在 Oracle 7.2 中，Oracle 才忽略对 V\$LATCH 表的授权。要更正这个问题，请应用 Oracle 补丁来更正“库错误 #254661”。此补丁使您能够查看“高速缓存总数报告”中的数据。如果没有安装此补丁，则必须使用“sys”登录标识安装 Oracle。

OMA for Oracle 不需要访问 SYS.DBA_VIEWS 和 SYS.DBA_SYNONYMS 表，但 CandleDBConfig 的“验证”过程需要。如果 CandleDBConfig 无法读取这些表，则无法完全验证安装。但是 OMA 仍将运行。

SYBASE

OMA for Sybase 使用 Sybase 登录标识来连接数据库。它可以使用任何 Sybase 标识，甚至是用于其他用途的标识。CandleDBConfig 不创建此标识。如果您希望，也可以在定义标识时不指定密码。如果是这样，则向 CandleDBConfig 指示密码为空。此外，Sybase 登录标识和密码是区分大小写的。

以下 Sybase isql 语句为 Sybase 定义了标识和密码。在此示例中，“syblogin”指示了您将使用的 Sybase 登录标识，“password”指示了该标识的密码：

  sp_addlogin syblogin,password
  go

Candle 还提供了 SQL 脚本 $CANDLEHOME/misc/koygrant.sql 来授予必需的权限。

OMEGAMON Monitoring Agent for Sybase 使用 Sybase“Open Client”库来连接 Sybase。如果您的 Sybase 系统上未安装“Open Client”，则代理程序将无法连接 Sybase，并且您将在 col.out 文件中接收到一条显示 CT-INIT 失败的消息。可以通过在 Sybase 主目录下查找 lib/libct.a 来确定是否安装了“Open Client”。

如果未安装“Open Client”，则必须获取以下任意一项：

1) 来自 Sybase 的“Open Client”产品。我们可以认为每个 Sybase 服务器许可证都向客户授予了单个免费的“Open Client”许可证。请联系 Sybase 以获取更多信息。

2) CTlib for Sybase 的运行时版本。由 Candle 级别 2 支持免费提供。Candle 具有分发 CTlib 运行时部分的 Sybase 许可权。

</系统/数据库配置>

# --------------------------- 验证 ---------------------------------------

<验证 OMA 安装>
验证 OMA 安装

用法：单击“验证”；选中对话框中显示的结果；单击“取消”。

“验证”将通过检查以下内容来确保 OMA 已正确安装：

1) 是否存在有效的 UNIX 版本。

2) 对 $CANDLEHOME 下关键字目录的 UNIX 许可权是否正确。

3) 是否为 kddos 设置了特殊的 UNIX 许可权。

4) 此主机中是否存在产品配置文件。

对于每个已配置的服务器，“验证”将检查：

5) 配置文件是否有效以及配置是否已完成。

6) 数据库主目录和数据库初始化文件是否存在以及您是否有权读取该文件。

7) 是否为服务器安装了 Sybase Open Client 产品。

8) 数据库服务器是否正在运行。如果未运行，则对用于此数据库的 OMA 验证将无法继续。

9) 是否能成功登录到数据库。

10) 是否能访问 Oracle V\$ 性能表。如果不能访问，则可能是由以下原因造成的：

    a) 未创建表（请参阅规划指南第 5 章中标题为“V\$ 动态性能表”的这一节）。

    b) korgrant.sql 脚本未运行。

    如果没有 DBA 权限，将无法知道是哪种原因。

    请注意，“验证”将测试所有 Oracle 性能视图和同义词。由于在 Oracle 安装过程中只创建了部分性能视图和同义词，所以 OMA for Oracle 在某些站点上失败了。另外，此测试要求 Oracle 用户具有对 SYS.DBA_VIEWS 和 SYS.DBA_SYNONYMS 的 SELECT 权限。这些授权不是 korgrant.sql 脚本的一部分，因为大多数 Oracle 安装都将 SELECT 授予 PUBLIC 中的目录表。

11) 是否能访问 Oracle 7.2 SYS.V_\$LATCH 性能视图。如果不能，请参阅“在 UNIX 上安装 Candle 产品”文档。

12) Sybase koygrant.sql 脚本是否已运行。此脚本会将 sa_role 授予您的 Sybase 登录标识。

13) 对于 Informix，您的站点是否对 ONCONFIG 文件 ALARMPROGRAM 语句作出了必要的修改。请参阅“在 UNIX 上安装 Candle 产品”文档。

14) CMS 主机是否对 ping 作出响应。

15) 代理程序是否能够连接 CMS。如果不能连接，则可能是由以下原因造成的：

    a) CMS 主机、CMS 端口号或 CMS 名称不正确。

    b) CMS 未运行。

    如果不能直接访问 CMS 机器并且不知道该机器中安装 CMS 的确切位置，CandleDBConfig 将无法报告是哪种原因。

16) 是否向 CMS 植入了种子数据，以及自植入种子数据以来是否重新启动了 CMS。如果刚刚重新启动了 CMS，则早期的结果可能还不确定。因此，“验证”将使代理程序运行长达 5 分钟之后，再断定 CMS 是停止了还是未植入种子数据。但是，如果代理程序确定 CMS 已停止，则 IVP 代理程序将立即重新启动，因为缺省行为是等待十分钟之后再尝试重新连接。
 
“验证”将不检查：

1) CMS 上的 cat、atr、sql（种子数据）及其文件的级别与已安装的代理程序级别是否一致。

2) 计时问题是否导致通信超时。

3) 对于 Informix，您的站点是否从 PUBLIC 撤销了对系统表的 SELECT 权限。koxgrant.sql 脚本不包含这些权限的特定授权 － 假定您的站点在 Informix 最初提供这些授权时已将它们保留。

</验证 OMA 安装>

