在 z/OS 上配置 Rational 构建代理程序以通过 InetD 进行启动

您可以将 Rational® 构建代理程序配置为,在服务器使用因特网守护程序 (InetD) 重新启动时自动启动。

关于此任务

Build System Toolkit 随附了一个用于 z/OS® 的 Shell 脚本 (startbfa.sh),可以定制此脚本以在 z/OS UNIX 系统服务 (USS) 下启动 Rational 构建代理程序。此脚本将建立必需的系统环境,然后将该代理程序作为独立守护程序来启动。除了使用此脚本之外,您可以将 Rational 构建代理程序配置为,在服务器重新启动时在必需的系统环境下自动启动。请完成下列步骤以将此构建代理程序添加至您的 InetD 配置。

过程

更新 InetD 配置文件

  1. 通过向 /etc/services 文件添加以下行,从而在 USS 系统上定义 Rational 构建代理程序 (bfagent) 服务:
    bfagent       8888/tcp    #Rational Build Agent
  2. 将 8888 替换为在 bfagent.conf 端口属性中定义的端口号。此行将名为 bfagent 的服务映射至所指定的端口。当 InetD 在所指定的端口上接收到服务请求时,它将按 InetD 配置文件中的定义来启动 bfagent 服务。
  3. 向 /etc/inetd.conf 中添加以下行来定义 InetD 的服务:
    stream tcp nowait <user>   <agentPath>/bfagent bfagent -f <configPath>/bfagent.conf 
    其中:
    1. <user> 是应当用来运行此服务的 RACF® 用户标识
    2. <agentPath> 是 bfagent 可执行文件的完整路径
    3. <configPath> 是 bfagent.conf 配置文件的完整路径
  4. 在已经定义此服务之后,必须强制 InetD 守护程序重新读取配置。有多个选项可用于强制此守护程序重新读取配置。最容易的方式是停止此守护程序,然后使用以下命令将其重新启动:
    kill `cat /etc/inetd.pid`
    /usr/sbin/inetd /etc/inetd.conf

设置构建环境

  1. 当“具有企业扩展的 Ant”构建正在运行时,bfagent 要求定义多个环境变量。这些变量通常由 startbfa.sh 脚本定义,并在启动 bfagent 守护程序之前导出这些变量。要在您通过 InetD 运行此代理程序时运行构建,必须定义下列变量:
    • HOME
    • ZLANG
    • _TIMEOUT
    • _CMDSRV
    • _BASE_HOME
    • SCM_WORK
    • BLD_TOOLKIT
    • JAVA_HOME
    • JAZZ_USER
    • JAZZ_PASSWORD_FILE
    • STEPLIB
    • ANT_HOME
    要查找这些变量的期望值以及确定您所在环境需要那些变量值,请参阅 startbfa.sh 脚本中的注释,此脚本位于以下目录中:@pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa/startbfa.sh。
    注: 您的设置可能不需要这些变量中的某些变量。
  2. 将这些变量定义为您所在项目区域的构建引擎的属性。要定义变量,请完成下列步骤:
    1. 定义 Rational 构建代理程序类型构建引擎。有关详细信息,请参阅使用“具有企业扩展的 Ant”构建定义编辑器
    2. 在构建定义编辑器中,指定您在 /etc/services 文件中定义的端口。
    3. 在构建引擎编辑器的概述选项卡上的属性部分,定义以上所列示的变量。

反馈