在 z/OS 上配置 Rational Build Agent,以透過 InetD 啟動

您可以配置 Rational® Build Agent,以便在使用「網際網路常駐程式 (InetD)」重新啟動伺服器時自動啟動它。

關於這項作業

Build System Toolkit 隨附一個適用於 z/OS® 的 Shell Script (startbfa.sh),您可以自訂它,以便在 z/OS UNIX System Services (USS) 之下啟動 Rational Build Agent。Script 會建立必要的系統環境,然後將代理程式當成一個獨立式常駐程式啟動。您可以不使用 Script,改將 Rational Build Agent 配置成在伺服器重新啟動時,隨必要的系統環境自動啟動。請完成下列步驟,將建置代理程式新增至您的 InetD 配置。

程序

更新 InetD 配置檔

  1. 在 /etc/services 檔中新增下列字行,以便將 Rational Build Agent (bfagent) 服務定義在您的 USS 系統上:
    bfagent       8888/tcp    #Rational Build Agent
  2. 以您在 bfagent.conf 埠內容中所定義的埠號,取代 8888。此行將名稱為 bfagent 的服務,對映至指定埠。當 InetD 收到指定埠上的服務要求時,它會按照 InetD 配置檔中的定義來啟動 bfagent 服務。
  3. 在 /etc/inetd.conf 中新增下列字行,針對 InetD 定義服務:
    stream tcp nowait <user>   <agentPath>/bfagent bfagent -f <configPath>/bfagent.conf 
    其中:
    1. <user> 是執行服務時應使用的 RACF® 使用者 ID
    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 Script 來定義,並且在啟動 bfagent 常駐程式之前匯出。在您透過 InetD 執行代理程式時,如果要執行建置,您必須定義下列變數:
    • HOME
    • ZLANG
    • _TIMEOUT
    • _CMDSRV
    • _BASE_HOME
    • SCM_WORK
    • BLD_TOOLKIT
    • JAVA_HOME
    • JAZZ_USER
    • JAZZ_PASSWORD_FILE
    • STEPLIB
    • ANT_HOME
    如果要尋找這些變數的期望值,並判斷哪些是您環境需要的,請參閱 startbfa.sh Script 中的註解,這個 Script 位於下列目錄:@pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa/startbfa.sh。
    註: 您的設定可能不需要其中的某些變數。
  2. 將這些變數定義成您專案區域中的建置引擎內容。如果要定義變數,請執行下列動作:
    1. 定義 Rational Build Agent 類型建置引擎。如需詳細資料,請參閱透過 Enterprise Extensions 建置定義編輯器來使用 Ant
    2. 在建置定義編輯器中,指定您在 /etc/services 檔中指定的埠。
    3. 在建置引擎編輯器概觀標籤的內容區段中,定義上述的變數。

意見