代理控制器 - 发行说明

已知问题和变通方法

 1.1 安装在 Windows Desktop 文件夹中的代理控制器不起作用
 1.2 在 Windows 和 Linux 上安装代理控制器
 1.3 代理控制器安装找不到缺省 Java 运行时
 1.4 在非 Windows 平台上,代理控制器日志文件可能没有公用写许可权
 1.5 在 Windows 上不能访问位于网络驱动器上的类
 1.6 不能在非 Windows 平台上重新启动代理控制器进程
 1.7 代理控制器安装检测不到现有的 V4.0.3 代理控制器
 1.8 另一用户重新启动代理控制器后,不能远程导入日志文件
 1.9 SetConfig 安全性选项不受支持

1.1 安装在 Windows Desktop 文件夹中的代理控制器不起作用

当代理控制器安装在 Windows 系统上的 Windows Desktop 文件夹时,它不起作用。例如,如果将安装目录指定为 C:\Documents and Settings\Administrator\Desktop,则该代理控制器不起作用。

要解除此局限性,将代理控制器安装在另一目录中。

1.2 在 Windows 和 Linux 上安装代理控制器

在 Windows 和 Linux 上安装代理控制器将除去已经安装的现有代理控制器。在继续安装之前确保已经备份了必要的数据。

1.3 代理控制器安装找不到缺省 Java 运行时

代理控制器安装可能未检测到该机器上安装的任何 Java 运行时。

在“Java 运行时”安装对话框中指定的缺省值可能是指向安装程序用于安装的临时 Java 运行时。必须提供想要代理控制器使用的另一 Java 运行时安装。

1.4 在非 Windows 平台上,代理控制器日志文件可能没有公用写许可权

日志文件 <Agent Controller install location>/config/servicelog.log 可能没有必需的许可权位(666)。这将使得任何非 root 用户的代理控制器进程无法向日志文件写入内容。

要解决此问题,只需要在安装后作为 root 用户运行以下命令:

chmod 666 <Agent Controller install location>/config/servicelog.log

1.5 在 Windows 上不能访问位于网络驱动器上的类

代理控制器服务经过配置,作为“本地系统帐户”登录。因此,它可能对已安装的网络驱动器没有访问权,当前用户标识通常使用 net use 访问这些网络驱动器。

为了使代理控制器能够使用网络驱动器上的类,请遵循下列步骤:

  1. 打开 Windows 的“服务”窗口。
  2. 选择 IBM Rational 代理控制器。
  3. 单击“属性”工具栏按钮。
  4. 选择“登录”窗格。
  5. 选择此帐户单选按钮并填写用户标识信息。这是连接至驱动器(通过使用 net use 或同等功能)的用户标识。
  6. 单击“确定”。
  7. 重新启动 IBM Rational 代理控制器服务。
  8. 重新启动该应用程序。

注意:这将允许使用网络驱动器,但会将代理控制器的访问权限制为当前用户所具有的访问权。

1.6 不能在非 Windows 平台上重新启动代理控制器进程

只能在 Windows 平台上重新启动代理控制器。

要解决此问题,请遵循下列步骤:

  1. 关闭连接至代理控制器的所有 Eclipse 工作台。
  2. 发出以下命令
     kill -s HUP < process ID of the inetd process > 
    (必须作为 root 用户)
  3. 使用 netstat 来检查端口 10002(缺省值)是否仍被占用。等待该端口被释放为止,然后重新启动代理控制器。
  4. 或者,可在代理控制器配置文件
    <Agent Controller install location>/config/serviceconfig.xml
    中将端口从 10002 更改为另一个值并立即重新启动代理控制器。

为避免发生这种情况,在重新启动代理控制器进程之前应关闭所有连接的工作台。

1.7 代理控制器安装检测不到现有 4.0.3 代理控制器

如果代理控制器 4.0.3 是作为独立的产品安装的,则在安装版本 6.0.0 时将检测到版本 4.0.3 并正确卸载它。如果代理控制器是作为 WSAD V4.0.3 的一部分安装的,则 V6.0.0 安装将检测不到它并且不会卸载这一旧版本。这是 Microsoft Installer 的局限性。

要解除这一局限性,需要完全卸载 WSAD V4.0.3,因为它是已安装的代理控制器 V4.0.3 的父代产品。通过检查代理控制器安装目录是否为空以确保代理控制器 V4.0.3 已被正确除去,并验证注册表值 HKLM\SOFTWARE\IBM\IBM Agent Controller 和 HKLM\SYSTEM\*\SERVICES\IBM Agent Controller 是否不再存在。

1.8 另一用户重新启动代理控制器后,不能远程导入日志文件

临时文件 hgla.log 是用启动代理控制器的同一用户标识在系统的临时目录中创建的。如果代理控制器是使用另一非 root 用户标识重新启动的,则这一非 root 用户不能除去临时文件 hgla.log 并且会导致远程日志导入失败。

为解除这一局限性,在远程导入日志之前手工除去 hgla.log 文件。

1.9 SetConfig 安全性选项不受支持

自动计算工具不支持安全性。在运行 SetConfig 脚本时不要启用安全性。

返回到主自述文件