本节描述如何在 z/OS® 上开始运行
Rational® 构建代理程序。
代理程序作为独立守护程序运行,并使用缺省代理程序端口 5555。要更改缺省端口,请使用
bfagent.conf 中的端口设置。有关如何找到 bfagent.conf 文件并更改缺省端口的信息,请参阅在 z/OS 上配置代理程序一节。
完成以下步骤以完成安装,并启动 Rational 构建代理程序:
- 通过下列其中一种方法启动构建代理程序:
- 方法 1:如果您计划使用 带有企业扩展的 Ant 构建,那么必须从已设置其他环境变量的 Shell 脚本启动
Rational 构建代理程序。对于 z/OS,构建系统工具箱 包含用于配置那些环境变量并启动代理程序的样本 Shell 脚本。有关更多信息,请参阅配置 Rational 构建代理程序 Shell 脚本。
要启动
Rational 构建代理程序,请按照作业中的指示信息配置 hlq.SBLZSAMP 库中提供的样本启动式任务
BLZBFA。您可以在系统启动时将 Rational 构建代理程序作为启动式任务来运行。您必须将此作业复制到系统分配的 PROCLIB 并设置必需的安全性设置才能使其作为启动式作业运行。
另外,您也可以从 OMVS 以手动方式启动
startbfa.sh 脚本。
注: 直接从 Rational Developer for System z® UNIX Shell 将
startbfa.sh 作为 Shell 脚本启动可能会导致冲突,这是因为 ISPF 网关将从
Rational Developer for System z 的 rsed.envvars 中获取配置文件。为了避免潜在冲突,请通过因特网守护程序 (InetD) 将
Rational 构建代理程序作为启动式任务启动,也可以对其进行配置,以便直接在 z/OS 上的 OMVS 中进行调用,而不通过
Rational Developer for System z。
- 选项 2:直接启动构建代理程序。此方法不会设置“具有企业扩展的 Ant”所需要的环境变量。请将目录切换至 @pathPrefix@/usr/lpp/jazz/v4.0/buildagent,并使用 -s 选项:
/usr/lpp/jazz/v4.0/buildagent/bfagent -s -f /etc/jazz40/ccm/bfagent.conf
- 选项 3:通过 InetD 来启动构建代理程序。请参阅在 z/OS 上配置 Rational 构建代理程序以通过 InetD 进行启动。
- 要测试 z/OS 系统上运行的构建代理程序,请使用 telnet 命令来测试连接。请参阅测试连接。
注: 构建代理程序通常使用管理特权(例如 root 或 admin)来登录操作系统。此外,构建代理程序使用启动代理程序的用户(而非用来登录的用户名)的许可权运行所有命令。如果未以 root 或 admin 用户身份运行构建代理程序,那么您可能会在测试连接时收到认证错误。要从非 root 或非 admin 用户标识运行代理程序,请在 bfagent.conf 中配置 magic_login 设置。这是标准系统认证的替代认证。使用此设置,系统可以使用单一用户名和密码认证登录。要查看配置 magic_login 所需要的步骤,请参阅
bfagent.conf 参考。