System z Jazz Gateway 概觀

透過 Jazz™ Gateway,您可以用程式設計方式,從 Rational Team Concert™ for System z® 儲存庫,擷取工作項目號碼與狀態。

Jazz Gateway 是以伺服器常駐程式形式在 z/OS®、Windows®、Linux®,以及其他平台上執行,以便向 Jazz 儲存庫進行 SSL 鑑別。它會在 REST URI 中傳遞一個工作項目號碼給 Jazz 儲存庫,以取得工作項目 XML,然後將工作項目狀態或完整的工作項目 XML 傳回給用戶端。

Jazz Gateway 如何與 Jazz 儲存庫通訊

Jazz Gateway 伺服器常駐程式會與特定埠通訊,來擷取用戶端要求。在 z/OS 中,是藉由提交 System z Jazz Gateway 伺服器工作,來提出這些要求。您可以修改 REXX 用戶端來指定特定埠,以便讓用戶端與 System z Jazz Gateway 伺服器常駐程式可以透過 Socket 連線彼此通訊。

  1. 如果要呼叫 REXX 用戶端,請使用 REXXEXEC(例如:獨立式 EXEC 或 SCLM 使用者結束程式),來設定類似如下的必要參數:
    • 使用者 ID
    • 密碼
    • Jazz 儲存庫 URL
    • 埠號
    • 工作項目號碼
  2. REXX 用戶端會將這項資訊傳遞給 System z Jazz Gateway 伺服器常駐程式,並等待回應。
  3. System z Jazz Gateway 常駐程式向 Jazz 儲存庫鑑別,並透過 REST URI 傳遞工作項目要求。
  4. Jazz Gateway 伺服器以 XML 格式傳回工作項目資訊,而伺服器常駐程式執行下列其中一項:
    • 擷取 XML 中的工作項目狀態。
    • 將完整 XML 傳回給 REXX 用戶端,再由該用戶端傳回給發出呼叫的 EXEC。

安裝 Jazz Gateway

Jazz Gateway 是透過 SMP/E 安裝在 z/OS 上,並成為 Build System Toolkit for System z 元件的一部分。如果您想將閘道安裝在支援的分散式平台上,必須從 Jazz.net 的 Rational Team Concert for System z All Downloads 區段,下載 Jazz Gateway .zip 檔。

將 Jazz Gateway 安裝在 UNIX 與 Windows 上的必要條件
  • 必須安裝 IBM Java 軟體開發套件 (SDK) 1.5
  • 必須將 JAVA_HOME 環境變數設定成包含 Java 1.5 SDK 的目錄
  • 必須將 java.exe 新增至 PATH
如需相關資訊,請參閱 Rational Team Concert for System z 2.0 伺服器環境的詳細系統需求

將 Jazz Gateway 安裝在 UNIX 上

請完成下列步驟,將 Jazz Gateway 安裝在 UNIX 上:
  1. 在 Jazz.net 上,從 Rational Team Concert for System z 的 All Downloads 區段,下載 RTCz-JazzRestGateway-2.0.0.2.ziphttps://jazz.net/downloads/rational-team-concert-z/releases/2.0.0.2
  2. 將下列 .jar 檔解壓縮至 Jazz Gateway 安裝目錄:
    • RTCz-JazzGateway-<buildID>.jar
    • log4j-1.2.12.jar
    • com.ibm.team.repository.common_1.0.1.I200909060153.jar
    • org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar
    • commons-httpclient-3.0.jar

在 UNIX 上使用 Java 來呼叫 Jazz Gateway

請完成下列步驟,在 UNIX 上呼叫 Jazz Gateway:
  1. 開啟 Shell 終端機。
  2. 切換至安裝閘道檔的目錄。
  3. 輸入下列指令:
    java -cp .\RTCz-JazzGateway-<buildID>.jar;.\log4j-1.2.12.jar;
    .\com.ibm.team.repository.common_0.6.1.I200810072228.jar;.\org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.\commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway 6666 
    註: 以本例來說,6666 是閘道使用的埠號。
  4. 輸入 CTRL+C 來停止閘道。

UNIX Shell Script 範例

以下的 Shell Script 範例會停止並啟動 Jazz Gateway。您可以根據環境變更 JAVA_HOMEGTW_DIR 的值,來自訂範例。
#! /bin/sh
#
# RTCzGateway-daemon:       Starts/stops the Jazz Gateway
#
#              
name="IBM Jazz Gateway"
export JAVA_HOME=<Java_sdk_directory>
export GTW_DIR=<Jazz_gateway_directory>

port=${2:-3456}
PID=GtwPid.$port
cmd="$JAVA_HOME/bin/java -classpath $GTW_DIR/RTCz-JazzGateway-I20090929-1150.jar:$GTW_DIR/log4j-1.2.12.jar:$GTW_DIR/com.ibm.team.repository.common_1.0.1.I200909060153.jar:$GTW_DIR/org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar:$GTW_DIR/commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway $port"

Start() {

   if [ -f $PID ] 
   then
      echo "$name $port already started"
   else
      echo "Starting $name $port daemon... "
       $cmd >$PID.log 2>&1& 
      echo $! >$PID
   fi
}


Stop() {
   if [ -f $PID ] 
   then
           echo "Shutting down $name $port daemon: "
      kill -9 `cat $PID`
      rm $PID
   else
           echo "$name $port daemon not started "
   fi
}

Restart() {
   Stop
   Start
}

# See how we were called.
case "$1" in
  start)
   Start
   ;;
  stop)
   Stop
   ;;
  restart)
   Restart
   ;;
  *)
   echo $"Usage: $0 {start|stop|restart} <port_number>"
   exit 1
esac

exit $?
這個 Script 可以作為系統起始設定 Script。這種 Shell Script 類型的管理方式,在支援 Jazz Gateway 的每一個 UNIX 或 Linux 平台上並不相同。下表列出各系統的系統起始設定 Script 位置:
系統 位置
AIX /etc/rc.d
Red Hat /etc/rc.d/init.d
SUSE /etc/init.d
Solaris /etc/init.d

將 Jazz Gateway 安裝在 Windows 上

請完成下列步驟,將 Jazz Gateway 安裝在 Windows 上:
  1. 在 Jazz.net 上,從 Rational Team Concert for System z 的 All Downloads 區段,下載 RTCz-JazzRestGateway-2.0.0.2.ziphttps://jazz.net/downloads/rational-team-concert-z/releases/2.0.0.2
  2. 將下列 .jar 檔解壓縮至 Jazz Gateway 安裝目錄:
    • RTCz-JazzGateway-<buildID>.jar
    • log4j-1.2.12.jar
    • com.ibm.team.repository.common_1.0.1.I200909060153.jar
    • org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar
    • commons-httpclient-3.0.jar

在 Windows 上使用 Java 來呼叫 Jazz Gateway

請完成下列步驟,在 Windows 上呼叫 Jazz Gateway:
  1. 開啟命令提示視窗。
  2. 切換至安裝閘道檔的目錄。
  3. 輸入下列指令:
    java -cp .\RTCz-JazzGateway-<buildID>.jar;.\log4j-1.2.12.jar;.\com.ibm.team.repository.common_0.6.1.I200810072228.jar;.\org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.\commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway 6666 
    註: 以本例來說,6666 是閘道使用的埠號。
您可以使用 startgw.cmd 指令檔,來啟動閘道。在啟動閘道之前,請更新 Script 中的 JAVA_HOME 變數。

Windows 服務設定範例

Jazz Gateway 是一種 Java 應用程式;因此,不直接支援以 Windows 服務形式來執行。不過,它提供數個可用的服務封套。本範例使用 Java Service Launcher,它是個別的公用程式,雖不是 Rational Team Concert for System z 的一部分,但可從線上取得。您可以針對您所用的服務封套,來修改這個範例。

配置 Java Service Launcher

請完成下列步驟,為 Jazz Gateway 配置 Java Service Launcher (JSL):
  1. 開啟一個命令提示字元,並將目錄切換至含有 jsl.ini 檔的 bin 目錄。
  2. 編輯 bin 目錄中的 jsl.ini 檔:
    • [define] 區段中定義一個變數,以儲存閘道所用的埠號。
      • PORT= gateway_port_number
    • [define] 區段中定義一個變數,以儲存閘道安裝目錄的路徑。
      • GTW_DIR= gateway_directory
    • appnameservicenamedisplaynameservicedescription 變更成您所選的名稱和說明,例如 IBM Jazz Gateway (%PORT%)
    • jrepath 設定設為 %JAVA_HOME%
      註: 請確定 jrepath 是設定在 .ini 檔的 [java] 區段,而非具有類似註解的 [service] 區段中。
    • useconsolehandler 設定設為 true,確定登出之後,建置引擎仍繼續執行。
    • systemout 設定設為類似於 %GTW_DIR%\gtw%PORT%.out.log 的值。
    • systemerr 設定設為類似於 %GTW_DIR%\lgtw%PORT%.err.log 的值。
    • [java] 區段中,新增下列參數以傳遞給 Java:
      • params = 4
      • param00 = -cp
      • param01 = %GTW_DIR%\RTCz-JazzGateway-I20090929-1150.jar;%GTW_DIR%\log4j-1.2.12.jar;%GTW_DIR%\com.ibm.team.repository.common_0.6.1.I200810072228.jar;%GTW_DIR%\org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.\commons-httpclient-3.0.jar
      • param02 = com.ibm.teamz.jazz.gateway.JazzGateway
      • param03 = %PORT%
  3. 從命令提示字元,執行 jsl -debug 來測試您的配置。這會執行 Jazz Gateway。您應該會看到類似如下的訊息:
    Debugging IBM Jazz Gateway (gateway_port_number)
    Now starting JVM
    ControlHandler registered after JVM start
  4. 繼續進行前,請先解決其他任何的錯誤。
  5. 檢查您設在 systemout 設定中的日誌檔,判斷閘道是否正在接聽 PORT 變數指定的埠號。
  6. 輸入 CTRL+C,結束除錯測試。

安裝 Windows 服務,並啟動 Jazz Gateway

請完成下列步驟,安裝 JSL Windows 服務,並啟動 Jazz Gateway:
  1. 從命令提示字元,將目錄切換至 jsl bin 目錄。
  2. 執行 jsl -install
  3. 開啟 Windows 服務控制台(開始 > 執行 > services.msc)。
  4. 尋找 IBM Jazz Gateway 服務(或您在 .ini 檔中命名的服務)。
  5. 按一下滑鼠右鍵選取啟動
  6. 要求建置,以確定您的建置引擎能順利處理建置要求。
  7. 起始設定之後,由於 ini 檔中的 starttype=auto 設定,服務就會在系統開機時自動啟動。
註: 如果您需要變更 .ini 檔中的設定,必須先停止並解除安裝服務(請參閱以下的指示)。然後對 .ini 檔進行變更,並重新安裝服務。

停止 Jazz Gateway 服務

請完成下列步驟,來停止 Jazz Gateway 服務:
  1. 開啟 Windows 服務控制台(開始 > 執行 > services.msc)。
  2. 尋找 IBM Jazz Gateway 服務(或您在 .ini 檔中命名的服務)。
  3. 按一下滑鼠右鍵選取停止

解除安裝 Windows 服務

請完成下列步驟,來解除安裝 JSL Windows 服務:
  1. 開啟 Windows 服務控制台(開始 > 執行 > services.msc)。
  2. 尋找 IBM Jazz Gateway 服務(或您在 .ini 檔中命名的服務)。
  3. 按一下滑鼠右鍵選取停止
  4. 從命令提示字元,將目錄切換至 jsl bin 目錄。
  5. 執行 jsl -remove

意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤