請遵循以下指示,在 System z 上手動解壓縮並編譯 Build Forge 代理程式原始碼。所提供的 z/OS 代理程式原始碼只是未編譯的原始碼。無法使用二進位碼發行套件。
所需的軟體與程式如下所示:
若要啟用 SSL,請確定已履行下列必要條件:
- 對用戶端和內部通訊啟用 SSL。請參閱對用戶端和內部連線啟用 SSL。
- 必須安裝系統 SSL 程式庫。
- 當您在編譯代理程式的程式碼時,請使用最新版的 SystemSSL。
如果要在 System z 平台上安裝代理程式,請執行下列動作:
- 使用產品安裝媒體或下載產品映像檔,找出代理程式原始檔套件的檔案:src-bfagent-<version>.tar.gz。
將原始檔套件複製或下載到非 z/OS 電腦上的目錄中。
- 在非 z/OS 電腦上的 Shell 提示中,輸入下列指令以從代理程式原始檔套件中解壓縮 tar 檔:
gzip -d src-bfagent-<version>tar.gz
- 使用 ftp 或另一種傳送方法,將 tar 檔當成二進位映像檔傳送到 z/OS 系統,並將它放在專用的 HFS
子目錄中(通常是使用者帳戶的 USS 起始目錄)。
- 在 z/OS 系統上,執行下列指令來建置代理程式原始碼:
- 首要步驟:如果您不需要啟用 SSL,則直接使用 ./configure-zos。否則,您需要提供 –with-system-ssl 及其路徑給系統 SSL。使用最新版的 SystemSSL:
- 自 BuildForge 8.0.0.1 起,bfagent 開始支援 TLS 1.2 版及 TLS 1.1 版
- z/OS 1.13 版是支援 TLS 1.2 版的最低版本。若您無法滿足基本版本需求,必須在不含 SSL 系統的 z/OS 上編譯 bfagent。
pax -rf src-bfagent-<version>.tar -ofrom=ISO8859-1,to=IBM-1047
cd bfagent-<version>/src
tcsh
./configure-zos [--with-system-ssl=<path>]
- 完成 ./configure-zos Script 之後,請執行下列指令:
./build-zos
- 在 z/OS 系統上,將 bfagent.conf 檔放在 /etc 中。
如果 bfagent.conf 不在 /etc 中,代理程式必須以 -f 選項啟動。請參閱bfagent 參照。
- 在 z/OS 系統上,將 bfagent 執行檔放在適當的位置,例如:/usr/bin or /usr/local/bin。
- 在 z/OS 系統上,以 root 身分執行下列指令:
# extattr +p -s bfagent
- 如果您要使用系統 SSL,請將系統 SSL 程式庫新增至 PROGRAM CONTROL。請使用下列指令。
ralter program * addmem('SYS1.SIEALNKE'//nopadchk) uacc(read)
- 在 z/OS 系統上,以 root 身分登入,然後使用 -s 選項手動啟動代理程式:
bfagent -s
如果安全原則不允許以 root 身分登入,請參閱 bfagent.conf 參照,查看 bfagent.conf 中之 magic_login 設定的指示。
代理程式會當成獨立式常駐程式來執行,並使用預設代理程式埠 5555。如果要變更預設埠,請使用 bfagent.conf 中的埠設定。請參閱bfagent 參照。
註: 如果已安裝 UNIX TCP/IP 常駐程式(inetd 或 xinetd)且在 z/OS 系統上作用中,您可以將 Build Forge 代理程式設定當成服務來執行並自動啟動。請參閱
在 UNIX 及 Linux 上執行代理程式。
- 在 z/OS 系統上,使用 telnet 指令測試連線。請參閱測試連線。