建置代理程式執行檔已在 SMP/E 安裝期間安裝到 yourPathPrefix/usr/lpp/jazz/bfagent 中。
請完成這些步驟,來完成安裝和啟動
Rational® Build Agent:
- 如果不用 Antz 建置,便可以手動或透過 INETD 來啟動建置代理程式。
如果要透過 INTED 來啟動建置代理程式,請參閱下面的「inetd 或 xinetd 的使用提示」。
如果要手動啟動建置代理程式,請切換至 yourPathPrefix/usr/lpp/jazz/v2.1/bfagent,然後使用 -s 選項:
bfagent -s -f /etc/jazz/bfagent.conf
代理程式會以獨立式常駐程式形式執行,並使用預設代理程式埠 5555。如果要變更預設埠,請在 bfagent.conf 中使用埠設定。請參閱 bfagent 參照。另請參閱以下的 inetd 提示。
- 如果您計劃使用 Antz 建置延伸,必須從設定其他環境變數的 Shell Script 中啟動 Rational Build Agent。Build System Toolkit for System z® 包含一個範例 Shell Script,它會配置這些環境變數及啟動代理程式。如需詳細資訊,請參閱配置 Rational Build Agent Shell Script。
- 如果要測試在 z/OS® 系統上執行的建置代理程式,請利用 telnet 指令來測試連線。請參閱測試連線。
註: 建置代理程式通常利用 root 或 admin 等管理專用權來登入作業系統。
另外,建置代理程式是利用啟動代理程式之使用者的許可權來執行所有指令,而不是登入時所用的使用者名稱。
如果建置代理程式不是以 root 或 admin 使用者身分執行,當測試連線時,您可能會收到鑑別錯誤。
如果要從非 root 或非 admin 使用者 ID 來執行這個代理程式,請配置 bfagent.conf 中的 magic_login 設定。
這是標準系統鑑別的替代方案。
透過這項設定,系統可以使用單一使用者名稱與密碼來鑑別您的登入。如果要查看配置 magic_login 所需要的步驟,請參閱
bfagent.conf 參照。
inetd 或 xinetd 的使用提示
如果 UNIX® TCP/IP 常駐程式
(inetd 或 xinetd)已安裝在 z/OS 系統上,且為作用中,您可以將 Rational Build Agent 設定成以服務形式執行,並且自動啟動。如需配置 inetd 的相關資訊,請參閱位於
http://publib.boulder.ibm.com/infocenter/zos/v1r9/index.jsp?topic=/com.ibm.zos.r9.cs3/cs3.htm 的「z/OS V1R9 資訊中心」(或適用於您 z/OS 版本的資訊中心)。inetd 的完整配置已超出本文件的說明範圍。在簡式範例中,您可以:
- 加入下列字行來修改 /etc/inetd.conf:
bfagent stream tcp nowait userID /usr/lpp/jazz/v2.0/bfagent/bfagent -f /etc/jazz/bfagent.conf
- bfagent
- 常駐程式的服務名稱。預設值是 bfagent(小寫)。此名稱必須和
/etc/services 中使用的名稱相符。
- stream tcp nowait
- 特定的 inetd 配置陳述式(Socket 類型、通訊協定、wait 旗標)。請勿修改。
- 使用者 ID
- 常駐程序的使用者 ID。預設值是 OMVSKERN。這個使用者 ID 必須具備有效的 OMVS 安全區段、BPX.DAEMON 許可權,以及安裝與配置目錄的 READ 與 EXECUTE 許可權。
- /usr/lpp/jazz/v2.0/bfagent/bfagent
- 伺服器程式(bfagent 的絕對位置)。預設值是 /usr/lpp/jazz/v2.0/bfagent/bfagent。
這個 inetd 引數之後的引數都是伺服器引數。
- -f /etc/jazz/bfagent.conf
- 工作目錄(Build Forge® 伺服器配置檔的位置)。預設值是 /etc/jazz/bfagent.conf。
重要: 請將自訂的 Rational Build Agent 配置檔複製到新目錄
(例如 /etc/jazz/)中,以免套用維護時改寫它們。這裡所定義的工作目錄必須反映這項變更。
- 將下列內容新增至 /etc/services:
bfagent 5555/tcp #BUILD FORGE AGENT
- 更新 bfagent.conf 中的埠,以對映至您的服務項目:
port 5555
- 重新啟動 inetd。