安裝 Rational Team Concert for System z


目錄

安裝 Rational Team Concert for System z
升級至 Rational Team Concert for System z 2.0
RTCz:安裝概觀
RTCz:安裝規劃
RTCz:安裝規劃概觀
RTCz:安裝規劃工作表
RTCz:利用 Installation Manager 進行無聲自動模式安裝
RTCz:特殊的伺服器指示
安裝 Rational Team Concert for System z Starter Edition
RTCz:Starter Edition 安裝概觀
RTCz:準備安裝 Starter Edition
RTCz:安裝 Starter Edition
RTCz:設定資料庫
RTCz:啟動伺服器
RTCz:執行設定精靈
RTCz:完成安裝
安裝 Rational Team Concert for System z Standard Edition 與 Enterprise Edition
安裝 Rational Team Concert for System z Standard Edition 與 Enterprise Edition
RTCz:準備安裝 Standard Edition 或 Enterprise Edition
RTCz:安裝 Standard Edition 或 Enterprise Edition
RTCz:設定資料庫
RTCz:啟動伺服器
RTCz:執行設定精靈
RTCz:完成安裝
在 z/OS 上安裝 Rational Team Concert for System z
軟體需求
SMP/E 安裝
配置安裝
設定資料庫
Jazz Team Server for System z 搭配 Tomcat 與 Derby 執行
Jazz Team Server for System z 搭配 Tomcat 與 DB2 for z/OS 執行
搭配 WebSphere Application Server 執行 Jazz Team Server for System z
執行設定精靈
完成安裝
安裝 Build System Toolkit for System z
從 IBM Installation Manager 來安裝 Build System Toolkit for System z
從 .zip 檔來安裝 Build System Toolkit for System z
在 z/OS 上安裝 Build System Toolkit for System z
安裝 Rational Build Agent
在 z/OS 上安裝及配置 Rational Build Agent
在 Linux、Linux for System z、UNIX 和 Windows 上安裝和配置 Rational Build Agent
安裝 Rational Team Concert for System z 用戶端
RTCz:用戶端安裝概觀
RTCz:使用 IBM Installation Manager 來安裝用戶端
RTCz:使用 .zip 檔來安裝用戶端
安裝共用 Rational Developer for System z 與 Rational Team Concert for System z 用戶端
存取 Rational Team Concert for System z 的 Web 型說明
利用「本端說明系統更新程式」網站來下載說明內容
利用「本端說明系統更新程式」和 RTCz2.0_updateSite.zip 檔,將說明內容安裝在本端環境中
更新說明內容
移除說明內容
設定企業內部網路伺服器的說明內容
變更存取說明內容的方式
在 Internet Explorer 中發生記憶體不足或 Script 錯誤
安裝 Rational Team Concert for System z 連接器
安裝 Rational Team Concert for System z ClearCase Connector
安裝 Rational Team Concert for System zClearQuest Connector
技術預覽:上下文搜尋與工作顧問特性
版本注意事項 - Rational Team Concert for System z 2.0 版
索引

安裝 Rational Team Concert for System z

IBM Rational Team Concert for System z 是一項建置在能夠延伸的可調式平台上的團隊協同作業工具,這個平台可以在整個軟體生命週期中完整地整合各項作業。它是專門設計給涉及跨平台軟體之軟體生命週期活動的團隊使用。它整合了軟體開發生命週期中的諸多層面,包括:疊代規劃、程序定義、來源控制、問題報告追蹤、建置管理,以及產生報告。Rational Team Concert for System z 提供在 System z 上專門用來進行開發的特性與功能,從而延伸了核心 Rational Team Concert 產品。 除了核心 Rational Team Concert 產品支援的 Linux、UNIX 與 Windows 平台之外,您也可以在 z/OS 與 Linux for System z 上執行 Rational Team Concert for System z。

升級至 Rational Team Concert for System z 2.0

您可以遵循若干實務,將舊版升級到 Rational Team Concert for System z 2.0。

升級至 Rational Team Concert for System z 的程序類似於升級至 Rational Team Concert 2.0。 這個程序所涉及的主要步驟如下:

  1. 利用現行版本的儲存庫工具,來匯出現有的 Rational Team Concert 或 Rational Team Concert for System z 儲存庫。
  2. 安裝和配置 Rational Team Concert for System z 2.0,其中包括建立新的資料庫。
  3. 利用 Rational Team Concert for System z 儲存庫工具來匯入儲存庫。
  4. 從舊版伺服器安裝架構中,複製必要的安裝檔案。
  5. 安裝 Rational Team Concert for System z 2.0 啟動鍵

您可以利用若干方式來升級至 Rational Team Concert for System z 2.0,其中包括下列實務:

在 Windows 和 Linux 上,利用 Installation Manager 來安裝的注意事項: 如果您使用 IBM® Installation Manager 將 Rational® Team Concert for System z 2.0 安裝在 目前未安裝 Rational Team Concert for System z 的電腦上,Installation Manager 會提示您選取要安裝的語言。不過,如果您從舊版更新至 Rational Team Concert for System z 2.0,Installation Manager 會假設您想使用現行語言,不會提示您選取語言。 如果要選取其他的語言,在更新至 2.0 之後,請從 Installation Manager 的主畫面選取修改,然後選取供應項目。 下個畫面會顯示支援的語言清單。請選取您需要的語言。

在您更新成 2.0 之後,如果您是在選取修改來新增或移除語言之前,就啟動 Jazz™ Team Server for System z,則必須按如下所示來重設伺服器:

  1. 在 Web 瀏覽器中,導覽至 https://server-host:9443/jazz/admin.action=com.ibm.team.repository.admin.serverReset。
  2. 按一下要求伺服器重設
  3. 關閉伺服器。

之後,您可以在 Installation Manager 中選取修改來新增或移除語言。

升級 Rational Team Concert for System z Client for Eclipse IDE

如果您有 Client for Eclipse IDE 1.0、1.0.1 或 1.0.1.1 版,您必須取得 Rational Team Concert for System z 2.0 用戶端,才能連接新的 Rational Team Concert for System z 2.0 伺服器。 您可以使用 .zip 檔來安裝這項,或更新您先前的 IBM Installation Manager 安裝。

註: Rational Team Concert 2.0 用戶端可以連接到 Rational Team Concert for System z 2.0 伺服器;不過,Rational Team Concert 用戶端將會無法使用 Rational Team Concert for System z 專屬功能。

將伺服器從試用版升級至永久版

從 2.0 試用版開始,您可以購買和安裝您的版本所適用的「伺服器啟動套件」,將伺服器設置成永久版本;「伺服器啟動套件」供應位置如下:http://www.ibm.com/software/awdtools/rtcz/。 啟動套件由一個含有永久伺服器金鑰的 JAR 檔組成。 您可以使用伺服器管理 Web 介面的「授權金鑰管理」頁面來安裝它。

從 Rational Team Concert 或 Rational Team Concert for System z 1.0.1 升級伺服器

您可以從舊版 Rational Team Concert 或 Rational Team Concert for System z 升級至 Rational Team Concert for System z 的 2.0 版。 需要移轉資料庫。

註: 在您開始升級 WebSphere® Application Server 之前,請導覽至 https://servername:9443/jazz/admin#action=com.ibm.team.repository.admin.serverReset,並按一下要求伺服器重設,以重設伺服器。

如果您是從 .zip 檔來安裝先前的版本(例如,在 Linux for System z 上),就不會有與前版安裝的交集。 您可以從 zip 將 2.0 版安裝在新位置,或使用 IBM Installation Manager 來安裝一個 2.0 實例。

如果當初您使用 IBM Installation Manager 來安裝舊版,則可以將 2.0 安裝成個別的實例,或者將舊有實例更新成 2.0。 如果您想針對 2.0 版安裝個別的伺服器實例,請在安裝精靈的安裝套件頁面上,選取建立新套件群組

註: 如果要升級 Jazz Team Server for System z 的 WebSphere Application Server 部署,請移除舊有的 jazz.war 檔,並部署 2.0 jazz.war 檔。

如需完成升級,請參閱複製先前伺服器安裝中的必要配置檔安裝 2.0 啟動鍵

在 z/OS 上從 Rational Team Concert for System z 1.0.1 升級

在 2.0 版中,儲存資料庫有了結構性變更,會防止您重複使用 z/OS 上 Rational Team Concert for System z 1.0.1 的資料庫。 從 Rational Team Concert for System z 1.0.1 版升級至 2.0 的程序,由下列三個步驟組成:

  1. 利用 repotools 匯出 1.0.1 版資料庫。
  2. 在所需要的目標平台上,安裝和配置 Jazz Team Server for System z 2.0 版。 在這個步驟期間,會建立一個新資料庫。 請參閱在 z/OS 上安裝 Rational Team Concert for System z,以取得在目標平台上安裝 Jazz Team Server for System z 的詳細資料。
  3. 利用 repotools,將第 1 步驟所建立的 .tar 檔匯入 2.0 版儲存資料庫中。
匯出 Rational Team Concert for System z 1.0.1 儲存資料庫
利用 hlq101.SBLZSAMP 中的 BLZEXPOR 成員來匯出儲存資料庫的內容。 這個成員中的範例 JCL 利用 repotools 匯出指令,來建立含有儲存庫內容的 .tar 檔。

請遵循範例 JCL 中的指示來配置 BLZEXPOR。 提交已修改的 JCL,並檢查工作日誌。只有在結束時回覆碼為 300 時,才表示工作已順利執行。

匯出檔會放在 @jazzExport@ 所指定的 HFS 位置中。 檔案名稱將是 @dbexport@.tar,如 BLZEXPOR 所定義。

在 z/OS 上,將已匯出的資料庫匯入 Jazz Team Server for System z 2.0 版中
在 z/OS 上,匯入 Derby 資料庫中
利用 hlq200.SBLZSAMP 中的 BLZIMPO2 成員,將 1.0.1 版 .tar 檔匯入 Jazz Team Server for System z 2.0 版 Derby 資料庫中。 依照 JCL 註解所說明,指定從 1.0.1 版資料庫匯出的 .tar 檔來配置 BLZIMPO2。

提交已修改的 JCL,檢查日誌檔來確認 repotools 已順利完成。

在 z/OS 上,匯入 DB2 資料庫中
利用 hlq200.SBLZSAMP 中的 BLZIMPOR 成員,將 1.0.1 版 .tar 檔匯入 Jazz Team Server for System z 2.0 版 DB2 資料庫中。 依照 JCL 註解所說明,指定從 1.0.1 版資料庫匯出的 .tar 檔來配置 BLZIMPOR。

提交已修改的 JCL,檢查日誌檔來確認 repotools 已順利完成。

如果要完成升級,請參閱複製先前伺服器安裝中的必要配置檔

將伺服器從 Rational Team Concert for System z 某種版本升級成另一種

Rational Team Concert for System z 版本(Starter、Standard 和 Enterprise)都是以試用模式出貨。 如果要從某版本升級至另一版本,您必須載入一組目標版本的組合試用版啟動鍵。 您可以下載這些組合的試用版啟動鍵,位置如下:https://jazz.net/downloads/rational-team-concert-z/

組合的試用版啟動鍵併在目標版本的 .zip 檔中。 這個組合的 .zip 利用伺服器管理 Web 介面的「授權金鑰管理」頁面來安裝。

只有針對 z/OS 上的安裝架構,才將 Rational Team Concert for System z 出貨為 Starter Edition 試用模式。 如果需要升級至 z/OS 上另一個 Rational Team Concert for System z 版本,您必須先升級至所需要的版本,然後載入您的版本適用的永久「伺服器啟動套件」和「用戶端存取授權」。

WebSphere Application Server 配置更新項目

必須執行下列步驟,以便在 Rational Team Concert for System z 2.0 中,適當配置 WebSphere Application Server。

  1. 確定已安裝 WebSphere Application Server 及相關的 Java SDK 的最新修正套件。 如果是部署在 WebSphere Application Server 7.0 中,至少必須安裝 WebSphere Application Server 7.0.0.3。 至於 WebSphere Application Server 6.1,至少必須安裝 WebSphere Application Server 6.1.0.25。
  2. 移除舊的自訂 JVM 內容:
    1. com.ibm.team.repository.provision.profile
    2. com.ibm.team.server.configURL
    3. log4j.configuration
  3. 新增自訂 JVM 內容 JAZZ_HOME,並將值設為:
    file:///<JazzInstallDir>/server/conf
    (z/OS 以外的系統),或設為:
    file:///@confPath@
    (z/OS),其中 @confPath@ 是 BLZCPDIR 中所設的配置路徑。
  4. 確定已勾選「當存取不受保護的 URI 時,使用可用的鑑別資料」這項 WAS 安全設定。如果您使用 WAS Integrated Solutions Console,則可以採行下列作法:
    1. 導覽至「安全 > 安全管理、應用程式和基礎架構 > Web 安全 - 一般設定」。
    2. 選取「當存取不受保護的 URI 時,使用可用的鑑別資料」勾選框。
  5. 確定已部署 Rational Team Concert for System z jazz.war。

複製先前伺服器安裝中的必要配置檔

將下列檔案從來源伺服器複製至目標伺服器。首先,將已升級伺服器中的原始檔案重新命名,以建立備份。如果您是用 IBM Installation Manager,將 Rational Team Concert 1.0.1 升級至 Rational Team Concert for System z 2.0,在安裝位置的 server 子目錄中,會以 backup-config-timestamp 之類的名稱來建立一個備份目錄,其中含有您的 1.0.1 配置檔。

如果您正在升級至 Standard Edition 或 Enterprise Edition,且已購買 Starter Edition 的「開發人員用戶端啟動套件」,請購買並安裝 Standard Edition 或 Enterprise Edition 的「開發人員用戶端啟動套件」,如此便能使用這些用戶端授權。您的「開發人員」授權指派仍舊有效,但「開發人員」授權將會停用,直到您安裝正確的啟動套件為止。

安裝 2.0 啟動鍵

Rational Team Concert for System z 2.0 版使用 Rational Team Concert for System z 2.0 啟動鍵。 如果伺服器是從 1.0.1 升級至 2.0,或從 Rational Team Concert 升級至 Rational Team Concert for System z,在升級之後,它會回復成試用軟體授權,您必須從 Passport Advantage® 取得 Rational Team Concert for System z 2.0 啟動金鑰。 以下是各套件的適當金鑰名稱:

設定專案時間表

在 Rational Team Concert 1.0.1 或 Rational Team Concert for System z 1.0.1 中,專案可以有多份時間表(舊稱「開發線」),且所有的這些時間表都視為相等。

在 Rational Team Concert for System z 2.0 中,專案仍可以有多份時間表,但是可將其中一個標示為「專案時間表」。當將資料庫移轉至 2.0 時,並不會知道專案的主要時間表,因此,您的專案將不會設定一個專案時間表。在升級至 2.0 之後,您可以手動更新專案以設定專案時間表。

配置來源控制管理 Snapshot

資料倉儲的「來源控制管理 (SCM)」Snapshot 會收集串流的資料,其中包括串流大小與其中之活動(變更集與檔案/資料夾變更)的相關資訊。 在 1.0.1 版中,這個 Snapshot 會自動收集所有串流的相關資訊。這樣的作業頗耗成本,因此 2.0 版中的 SCM Snapshot 多了可配置選項,可讓使用者決定應收集哪些串流的資料。這項變革的立即影響是除非您配置它,否則並不會收集資料。

如果要配置「來源控制」Snapshot,請執行下列動作:

  1. 對於您要收集其資料的串流,您必須具備寫入權。
  2. 移至 Web 使用者介面中的報告頁面。
  3. 在左導覽畫面中,選取管理 SCM Snapshot。這時會顯示一份串流清單。
  4. 選取一或多個串流的勾選框,然後選取儲存變更

這樣就會在後續所有的 Snapshot 中,收集所選串流的資料。

不相容的 BIRT 報告變更

如果您已使用 BIRT 報告設計程式來建立自己的報告範本,當您嘗試在 2.0 版中使用這些報告時,可能會遇到一些問題。 您應注意下列問題:

匯入資料倉儲中的工作項目資料

在 Rational Team Concert for System z 2.0,資料倉儲中的工作項目表格做了一些綱目變更。因此,當從 1.0.1 移轉至 2.0 時,匯入器會忽略倉儲中的任何工作項目資料。如此一來,在您第一次啟動 2.0 伺服器時,您的工作項目報告可能無法正確運作。 暫行解決方法是等待第一次執行工作項目 Snapshot,或者在您啟動伺服器之後,手動讓它執行。在移轉之後的第一次執行時,工作項目 Snapshot 會重新建構資料倉儲中的整個歷程工作項目資訊。這也意味著移轉之後第一次執行 Snapshot 時,耗費的時間比夜間執行的平均時間來得久。

探索新報告

在 Rational Team Concert for System z 2.0 中,新增了一些報告。儘管這些報告會出現在產品隨附的新程序範本中,但在移轉時,並不會自動將它們新增至現有的專案區域。我們新增了一個動作,來協助您在移轉之後於現有的專案區域中,探索與部署這些新的報告範本。如果要部署新報告範本,請執行下列動作:

  1. 在 Eclipse 用戶端中,開啟團隊構件視圖。
  2. 展開您的專案區域,然後展開報告
  3. 用滑鼠右鍵按一下報告範本,並選取部署新範本

對話框會協助您探索任何可用但尚未部署至您專案區域的報告範本。您可以從中選取一或多個,以便建立它們。在建立之後,您可以使用可用的功能表動作,從這些範本來建立新報告。

自訂

當您從 1.0.1 升級至 2.0 時,會保留您對工作項目類型、屬性、工作流程、角色與事件處理程式的變更。如果您曾自訂預先定義的程序範本(例如 Scrum),要注意的是,如果您重新部署預先定義的範本(在「程序範本」視圖中),將會改寫您的自訂內容。如果您需要重新部署預先定義的範本,應先變更您已自訂之預先定義範本的名稱與 ID,這樣就不會遭到改寫。

RTCz:安裝概觀

本資訊有助您瞭解安裝成功的需求條件。

Linux、UNIX、Windows 的安裝概觀

請完成下列作業,來安裝在 z/OS 以外的所有平台上:

  1. 選擇一種 Rational Team Concert for System z 版本。
  2. 規劃您的安裝,並填妥選用的安裝規劃工作表。
  3. 安裝 Jazz Team Server for System z。
  4. 選用:設定應用程式伺服器、LDAP 伺服器和資料庫。
  5. 配置 Jazz Team Server for System z。
  6. 安裝 Rational Team Concert for System z 用戶端。
  7. 選用:安裝 ClearCase® Connector 和 ClearQuest® Connector。
  8. 選用:安裝 Build System Toolkit for System z。

z/OS 的安裝概觀

所有可以安裝在 z/OS 中的 Rational Team Concert for System z 元件,都會包含在 SMP/E 套件中。套件含有「程式目錄」與四個 FMID,而您可以根據您安裝所需的元件,選擇性地安裝它們。這些元件如下:

FMID HAHA200
Jazz Team Server for System z。在 z/OS 上執行 Jazz Team Server for System z 時所需要。
FMID HAHB200
Build System Toolkit for System z。Jazz 閘道、Jazz Build Engine、Antz 建置、大量匯入、SCM 指令行所需要。
FMID HAHC200
工作監視器。監視 JCL 型建置時所需要。
FMID HAHD200
Rational Build Agent。搭配 HAHB200 和 HAHC200 來使用 z/OS Antz、JCL 或指令行建置支援時所需要。

請遵循安裝之元件的自訂指示。 請參閱程式目錄在 z/OS 上安裝 Rational Team Concert for System z,以取得在 z/OS 上安裝的詳細指示。

RTCz:安裝規劃

此資訊有助您規劃安裝。

RTCz:安裝規劃概觀

在您規劃安裝時,請考量下列事項。

RTCz:安裝規劃工作表

這份工作表可協助您規劃成功的安裝,並選擇您自訂的配置選項。

下表列出安裝和設定程序期間您可能需要提供的選項和資訊。這份表格有助您在安裝和設定伺服器期間填寫表單。

表 1. 安裝規劃工作表
判斷您的需求和配置的詳細資料 安裝考量和部分回答範例

選擇版本。

  • Rational Team Concert for System z Starter Edition
  • Rational Team Concert for System z Standard Edition
  • Rational Team Concert for System z Enterprise Edition

您需要多少「用戶端存取授權」?

註: 每一個使用者都需獲指派一個「用戶端存取授權」,才能執行 Rational Team Concert 中的某些功能。請參閱用戶端存取授權,以取得每個「用戶端存取授權」類型所能執行的動作清單。 如果要配置每一個使用者的 CAL,請參閱管理用戶端存取授權
  • 貢獻者
  • 開發人員
  • 建置系統
  • ClearCase Connector
  • ClearQuest Connector

驗證是否支援您的伺服器環境。

記錄伺服器資訊

  • 主機名稱jazzserver.example.com
  • IP 位址192.168.1.1
  • 平台Linux RHEL 5

選擇一個應用程式伺服器。

選擇一個應用程式伺服器:

  • Apache Tomcat(隨附)
  • IBM WebSphere Application Server

如果您將 Jazz Team Server for System z 安裝成搭配 IBM WebSphere Application Server 使用,請記錄下列資訊:

  • Web 應用程式目錄
    • Windows:Program Files\IBM\JazzTeamServer\server (預設)
    • Linux:/opt/IBM/JazzTeamServer/server(預設)

如果預設埠和已在使用的埠衝突,則會改列您使用的埠。

  • HTTP 埠9080(預設)
  • HTTPS 埠9443(預設)

選擇一種資料庫和連線類型。

註: 雖然預設配置已包含 Derby 資料庫而不需安裝,但這個資料庫無法支援超過 10 位使用者。如果您想支援超過 10 位的使用者,但又無現有 DB2 或 Oracle 資料庫的存取權,請安裝 DB2 Express。

資料庫資訊:

  • Derby(預設)
  • DB2® Workgroup Server(隨附)
  • DB2
  • Oracle

資料庫連線類型:

  • JDBC
    • JDBC 密碼db2admin
    • JDBC 位置//localhost:50000/JAZZ:fullyMaterializeLobData=false(預設)
    • 使用者名稱db2admin
  • J2EE
    • J2EE 資料來源:jdbc/mydatasource

資料庫位置:

  • 資料庫埠50000
    提示: 在「DB2 指令視窗」中,執行 db2 get dbm cfg 指令,並找出內含 SVCENAME 的字行,其中會指出 DB2 埠名或埠號。如果這個指令顯示號碼,請用來作為埠號(以取代上述範例中的 50000)。如果指令傳回非數值的名稱,請判斷指派給這個名稱的埠號,然後使用該埠號。在 Linux 中,/etc/services 檔含有埠名和埠號之間的對映,而在 Windows 中,C:\windows\system32\drivers\etc\services 檔含有這項對映。如需相關資訊,請詢問您的資料庫管理者或查閱資料庫文件。
    提示: 如果您是安裝 DB2 Workgroup Server,在安裝期間接受預設值,可簡化 Jazz Team Server for System z 的配置。

您想如何管理使用者?

身分管理選項:

  • Apache Tomcat 使用者資料庫領域
    • 使用者 IDusername
    • 名稱Full Name
    • 電子郵件位址username@example.com
  • LDAP
    • LDAP 登錄位置ldap://ldap.example.com:389
    • 使用者名稱username
    • 密碼SecretPassword
    • 基本使用者 DNo=[company],l=[your city],c=[your country]
    • 使用者內容名稱對映userId=mail,name=cn,emailAddress=mail
    • 基本群組 DNou=memberlist,ou=yourgroups, o=example.com
    • Jazz 至 LDAP 群組的對映JazzAdmins= YourGroupA, JazzUsers= YourGroupB, JazzDWAdmins= YourGroupC, JazzGuests= YourGroupD
    • 群組名稱內容cn
    • 群組成員內容uniquemember
  • 非 LDAP 自訂領域
    • 使用者 IDusername
    • 名稱Full Name
    • 使用者角色JazzAdmins, JazzUsers, JazzDWAdmins, JazzGuests
      註: 您必須設定可對映至 Jazz J2EE 安全角色的群組。

選用:您想啟用電子郵件通知嗎?

SMTP 伺服器的詳細資料

  • SMTP 伺服器smtp.example.com
  • SMTP 使用者名稱EmailUserName
  • SMTP 密碼SecretPassword
  • 寄件端位址you@example.com
  • 寄件端名稱Your Mail Name
  • SMTP 回覆位址from@example.com
  • SMTP 伺服器埠25
  • 使用 STARTTLSTrue 或 False

您想啟用電子郵件白名單,來限制電子郵件通知的範圍嗎? 例如 *@example.com 只容許傳送電子郵件至您公司的電子郵件位址。

選用:您想啟用 Jabber 會談伺服器嗎?

Jabber 伺服器的詳細資料

  • 伺服器 URLjabberserver.example.com
  • 5222 或 5223

驗證是否支援您的用戶端環境。

您想使用 ClearCase Connector 或 ClearQuest Connector 嗎?

RTCz:選擇應用程式伺服器

這項資訊討論選擇應用程式伺服器的若干考量。

Jazz Team Server for System z 含有 Apache Tomcat 作為預設應用程式伺服器。

如果已安裝 Apache Tomcat,您可以將 Jazz Team Server for System z 配置成在現有環境中執行。

另外,Jazz Team Server for System z 也可以配置成搭配 WebSphere Application Server 來執行。

Apache Tomcat:

WebSphere Application Server:

RTCz:選擇資料庫

這項資訊討論選擇資料庫的若干考量。

Jazz Team Server for System z 含有 Derby 作為預設資料庫。

註: 雖然預設配置已包含 Derby 資料庫而不需安裝,但這個資料庫無法支援超過 10 位使用者。如果您想支援超過 10 位的使用者,但又無現有 DB2 或 Oracle 資料庫的存取權,請安裝 DB2 Express

Rational Team Concert for System z 包含一個 DB2 Workgroup Server Edition 版本。

如果您的環境已在使用 DB2 或 Oracle,Jazz Team Server for System z 可以配置成搭配現有的資料庫軟體來執行。

RTCz:特殊 DB2 指示

如果您使用 DB2 資料庫,請檢閱下列資訊。

註: 這個主題所列出的指令純為範例。如需詳細資料,請參閱您的產品文件。
註: 當在 DB2 中建立資料庫時,需要 8 KB 分頁大小。

檢閱 DB2 文件,驗證您的系統符合需求條件且配置正確。

如果要充分利用狀態選擇提取最佳化(可在大型資料庫上提升效能),DB2 使用者必須設定 DB2_OPTPROFILE。請執行下列指令,來設定 DB2_OPTPROFILE。

db2set DB2_OPTPROFILE=YES
db2stop
db2start
註: 在執行指令後,請停止並重新啟動資料庫。安裝程序中的某個後續步驟會要求您停止再啟動資料庫。如果您剛開始安裝,接下來,可重新啟動資料庫。

請確定已接連執行上述指令。如果要查看是否已設定,請執行下列指令:

db2set DB2_OPTPROFILE

RTCz:選擇使用者管理方法

請從以下挑選一個使用者管理選項。

RTCz:使用 Apache Tomcat 使用者資料庫來管理使用者

預設的使用者管理可讓您不需藉助任何外部使用者管理系統,即能管理使用者。只有在已安裝 Apache Tomcat 時,才能使用 Apache Tomcat 使用者資料庫來管理使用者。

使用者名稱和加密密碼儲存在 tomcat-users.xml 檔中。所做的更新(例如:建立新使用者、變更使用者密碼或儲存庫許可權角色) 會自動寫到 xml 檔中。不需編輯檔案。

註: 該檔案位於 JazzInstallDir/server/tomcat/conf
RTCz:使用「輕量型目錄存取通訊協定 (LDAP)」來管理使用者

這項資訊可以協助您配置 LDAP 登錄來管理使用者。

如果您計劃搭配 Jazz Team Server for System z 來使用 LDAP 登錄,您必須將您的 Apache Tomcat 或 WebSphere Application Server 配置成利用 LDAP 登錄來鑑別使用者。

如果要配置 LDAP 來搭配 Jazz Team Server for System z 運作,請遵循下列作業:

  1. 瞭解 LDAP 配置參數.
  2. LDAP 配置設定程序.
  3. 在 Apache Tomcat 中配置 LDAP 的 Web 儲存器.
    註: Jazz Team Server for System z 使用者身分會區分大小寫。 當利用 LDAP 來管理使用者時,請關閉不區分大小寫選項。 請洽詢伺服器管理者或參閱產品文件,以確保設定會區分大小寫。
  4. 配置 WebSphere Application Server 以使用 LDAP 網域範圍
  5. 建立起始使用者。這位使用者是最初的 Jazz Team Server for System z 管理者。
  6. 使用 LDAP 同步化作業
  7. 使用設定精靈,將 Jazz Team Server for System z 配置成使用 LDAP。
  8. 匯入使用者

瞭解 LDAP 配置參數

表 2. LDAP 參數和說明
參數 值說明
LDAP 登錄位置 參照 LDAP 伺服器的 URL。ldap://ldap.example.com:389
使用者名稱 登入這部 LDAP 伺服器的使用者名稱。 某些 LDAP 伺服器接受匿名登入與密碼。在這個情況下,這個參數空白。
密碼 關聯於使用者名稱的密碼。
基本使用者 DN 搜尋基準指出從階層中的哪裡開始搜尋使用者。 例如 "o=company,l=your city,c=your country"
使用者內容名稱對映 Jazz 使用者內容名稱至 LDAP 登錄項目屬性名稱的對映。您必須定義下列對映:
  • userId =[LDAP user ID]
  • name =[LDAP user name]
  • emailAddress =[LDAP user e-mail]

userid 內容識別使用者登入系統時所用的使用者 ID。name 內容用來將名稱呈現在使用者介面中。

例如,userId=mail,name=cn,emailAddress=mail

基本群組 DN 這個搜尋基準指出從階層中的哪裡開始搜尋群組名稱,例如 ou=memberlist,ou=yourgroups,o=example.com
Jazz 至 LDAP 群組對映 Jazz 群組和 LDAP 群組之間的對映。 一個 Jazz 群組可以對映至多個 LDAP 群組。 各個 LDAP 群組必須用分號區隔。 例如,JazzAdmins=LDAPAdmins1;LDAPAdmins2 會將 JazzAdmins 群組對映至 LDAPAdmins1 和 LDAPAdmins2。 Jazz Team Server for System z 定義 4 個要對映的群組:
  • JazzAdmins =[LDAP Group for Jazz admins]
  • JazzUsers =[LDAP Group for Jazz users]
  • JazzDWAdmins =[LDAP Group for Jazz Data Warehouse Admin]
  • JazzGuests =[LDAP Group for Jazz guest]
例如,JazzAdmins= YourGroupA、JazzUsers= YourGroupB、JazzDWAdmins= YourGroupC、JazzGuests= YourGroupD。
群組名稱內容 代表 LDAP 登錄中之 Jazz 群組名稱的 LDAP 內容。 例如,cn。此項在查詢中用來擷取 LDAP 群組。在擷取 LDAP 群組時,查詢會採用「基本群組 DN」與「群組名稱內容」組合。
群組成員內容 代表 LDAP 登錄中之群組成員的 LDAP 內容。 例如,uniquemember。

LDAP 配置設定程序

如果要配置 LDAP 連線,並匯入使用者,請遵循下列步驟:

  1. 停止伺服器。
  2. 如果您先前曾試著安裝 LDAP 伺服器,請備份 JazzInstallDir/jazz/server/tomcat/conf/server.xml 檔。
  3. 開啟 JazzInstallDir/jazz/server/tomcat/conf/server.xml 檔,以編輯和解除註解下列的網域範圍標籤:
    <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                 	resourceName="UserDatabase"
                 	digest="SHA-1"
                 	digestEncoding="UTF-8"/>
  4. 儲存檔案,並重新啟動伺服器。
  5. 開啟 Web 瀏覽器視窗,並移至 https://localhost:9443/jazz/setup。
  6. 以 ADMIN/ADMIN 登入(使用者名稱與密碼皆區分大小寫)。
  7. 按一下自訂設定按鈕。
  8. 下一步,直到抵達第 5 頁,設定使用者登錄
  9. 在「步驟 1」區段的類型底下,選取 Tomcat 使用者資料庫圓鈕。
  10. 在「步驟 3」底下,選取停用預設 ADMIN 存取權勾選框。
  11. 在「步驟 4」底下,選取 Rational Team Concert - 開發人員授權勾選框。
  12. 下一步,建立這第一位使用者。
  13. 上一步,回到第 5 頁,設定使用者登錄
  14. 在「步驟 1」底下,選取 LDAP 圓鈕。
  15. 填寫「區段 2」中的欄位。如需相關資訊,請參閱瞭解 LDAP 配置參數
  16. 關閉伺服器。
  17. 在 Apache Tomcat 中配置 LDAP 的 Web 儲存器.
  18. 重新啟動伺服器。
  19. 開啟 Web 瀏覽器視窗,並移至 https://localhost:9443/jazz/admin。
  20. 以您建立用來測試連線的使用者 ID 登入。

在 Apache Tomcat 中配置 LDAP 的 Web 儲存器

如需配置 Apache Tomcat 使用 LDAP 的其他資訊,請參閱以下的相關鏈結。如果要在 Apache Tomcat 中配置 LDAP 的 Web 儲存器,請遵循下列步驟:

  1. 開啟 JazzInstallDir/jazz/server/tomcat/conf/server.xml 檔,以編輯和註解下列標籤:
    <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                 	resourceName="UserDatabase"
                 	digest="SHA-1"
                 	digestEncoding="UTF-8"/>
  2. 若為「Oracle 網際網路目錄 (OID)」,請新增下列標籤:
    <Realm className="org.apache.catalina.realm.JNDIRealm" 
     debug="99"
     connectionURL="ldap://ldap.company.com:389"
     roleBase="cn=Groups,dc=company,dc=com"
     roleSearch="(uniquemember={0})" 
     roleName="cn"
     userBase="cn=Users,dc=company,dc=com"
     userSearch="(uid={0})"/>
    若為 Microsoft Active Directory,請新增下列標籤:
    <Realm className="org.apache.catalina.realm.JNDIRealm" 
     debug="99"
     connectionURL="ldap://ldap.company.com:3268"
     authentication="simple"
     referrals="follow"
     connectionName="cn=LDAPUser,ou=Service Accounts,dc=company,dc=com"
     connectionPassword="VerySecretPassword" 
     userSearch="(sAMAccountName={0})"
     userBase="dc=company,dc=com" 
     userSubtree="true"
     roleSearch="(member={0})" 
     roleName="cn" 
     roleSubtree="true"
     roleBase="dc=company,dc=com"/>
  3. 開啟 JazzInstallDir/jazz/server/tomcat/webapps/jazz/WEB-INF/web.xml 檔進行編輯,將安全角色參照鏈結並對映至安全角色:
    <web-app id="WebApp">
    <servlet id="bridge">
    <servlet-name>equinoxbridgeservlet</servlet-name>
    <display-name>Equinox Bridge Servlet</display-name>
    <description>Equinox Bridge Servlet</description>
    <servlet-class>org.eclipse.equinox.servletbridge.BridgeServlet</servlet-class>
    <init-param><!-- ... --></init-param>
    <!-- ... -->
    <load-on-startup>1</load-on-startup>
    
    <!-- Addendum
    If the names of your LDAP Groups are the same as the default Jazz roles
    you don't need to add the following tags
    -->
    <security-role-ref>
    <role-name>JazzAdmins</role-name>
    <role-link>[LDAP Group for Jazz admins]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzDWAdmins</role-name>
    <role-link>[LDAP Group for Jazz admins]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzGuests</role-name>
    <role-link>[LDAP Group for Jazz admins]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzUsers</role-name>
    <role-link>[LDAP Group for Jazz admins]</role-link>
    </security-role-ref>
    
    </servlet>
    <!-- ... -->
    </web-app>
    使用下列標籤,將 LDAP 群組宣告為安全角色:
    <web-app id="WebApp">
    <servlet id="bridge">
    <!-- ... -->
    <security-role>
    <role-name>JazzAdmins</role-name>
    <role-name>JazzDWAdmins</role-name>
    <role-name>JazzGuests</role-name>
    <role-name>JazzUsers</role-name>
    
    <!-- Addendum
    If the names of your LDAP Groups are the same as the default Jazz roles
    you don't need to add the following tags
    -->
    <role-name>[LDAP Group for Jazz Admins]</role-name>
    <role-name>[LDAP Group for Jazz Data Warehouse Admins]</role-name>
    <role-name>[LDAP Group for Jazz Guests]</role-name>
    <role-name>[LDAP Group for Jazz Users]</role-name>
    <!-- End Addendum -->
    </security-role>
    <!-- ... -->
    </web-app>
    使用下列標籤,來更新 security-constraint 區段:
    <web-app id="WebApp">
    <!-- ... -->
    <security-constraint>
    <web-resource-collection>
    <web-resource-name>secure</web-resource-name>
    <url-pattern>/*</url-pattern>
    </web-resource-collection>
    
    <auth-constraint>
    <role-name>JazzUsers</role-name>
    <role-name>JazzAdmins</role-name>
    <role-name>JazzGuests</role-name>
    <role-name>JazzDWAdmins</role-name>
    
    <!-- Addendum
    If the names of your LDAP Groups are the same as the default Jazz roles
    you don't need to add the following tags
    -->
    
    <role-name>[LDAP Group for Jazz Admins]</role-name>
    <role-name>[LDAP Group for Jazz Data Warehouse Admins]</role-name>
    <role-name>[LDAP Group for Jazz Guests]</role-name>
    <role-name>[LDAP Group for Jazz Users]</role-name>
    <!-- End Addendum -->
    
    </auth-constraint>
    
    <user-data-constarint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
    </security-constraint>
    <!-- ... -->
    </web-app>
    針對參照 Jazz 群組的每一個 security-constraint,重複相同的附錄:
    <web-app id="WebApp">
    <!-- ... -->
    <security-constraint>
    <web-resource-collection>
    <web-resource-name>adminsecure</web-resource-name>
    <url-pattern>/admin/cmd/*</url-pattern>
    </web-resource-collection>
    <auth-constraint>
    <role-name>JazzAdmins</role-name>
    <!-- Addendum -->
    <role-name>[LDAP Group for Jazz Admins]</role-name>
    <!-- End addendum -->
    </auth-constraint>
    <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
    </security-constraint>
    <!-- ... -->
    </web-app>

RTCz:利用自訂領域來管理使用者

配置 IBM WebSphere Application Server 或 Apache Tomcat 中的鑑別和群組成員資格。

Jazz Team Server for System z 使用 J2EE 安全角色來作為鑑別、存取受保護的資源,以及某些儲存庫作業的授權。這些角色對映至配置在應用程式伺服器中某個網域範圍內的使用者和群組。當將伺服器配置成使用 Apache Tomcat 使用者資料庫網域範圍或 LDAP 網域範圍時,Jazz Team Server for System z 可將網域範圍中的使用者匯入至儲存庫,並顯示該使用者所具備的角色(群組)。您也能在 IBM WebSphere Application Server 或 Apache Tomcat 中配置自己的網域範圍,以作為鑑別和群組成員資格。當您使用該選項時,Jazz Team Server for System z 無法匯入使用者或顯示其角色,但這些角色會作為鑑別和授權用。

RTCz:利用 Installation Manager 進行無聲自動模式安裝

您可以利用 IBM Installation Manager,以無聲自動模式來安裝 Rational Team Concert for System z。

進行無聲自動模式安裝的基本步驟如下:

  1. 安裝 IBM Installation Manager
  2. 建立一個回應檔,這是一個 XML 檔,含有以無聲自動模式來執行安裝作業時所需要的資料。
  3. 新增 Rational Team Concert for System z 儲存庫到 Installation Manager 喜好設定中。 您可以在 <rtcz_launchpad_dir>/rtcz/im-repo 中找到儲存庫。

如需利用 Installation Manager 進行無聲自動安裝的詳細資訊,請參閱 IBM Installation Manager 資訊中心,位置如下:http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp

RTCz:特殊的伺服器指示

某些伺服器環境有特殊的配置考量。

如果您的配置包含以下所列的一或多個應用程式伺服器或作業系統,在開始安裝之前,請先檢閱資訊。

RTCz:Linux 和 Linux for System z 的特殊指示

當 Jazz Team Server for System z 是安裝在 Linux® 或 Linux for System z 上,請檢閱下列特殊指示。

在安全加強型 Linux 中安裝 Rational Team Concert for System z

若有啟用「安全加強型 Linux (SELinux)」,您必須停用它,或者變更安裝和執行 Rational Team Concert for System z 時所用的 Java™ 執行時期環境 (JRE) 的安全環境定義,以容許重新定位文字。

執行這項作業的原因和時機

如果您設定機器的目的只在於評估 Rational Team Concert for System z,且 SELinux 特性對您來說不重要,則繼續進行的最簡單方法是停用 SELinux。

註:

RTCz:安全憑證

Jazz Team Server for System z 提供一份和 Apache Tomcat 伺服器之間進行 SSL 時用的自簽憑證。

某些瀏覽器和用戶端在存取您的 Jazz 儲存庫時,可能會顯示警告。如果要停止警告,請執行下列之一:

RTCz:安裝安全憑證

以隸屬於您公司的憑證取代自簽憑證。

RTCz:停用安全憑證設定

如果您不需要安全連線,可停用安全設定。

執行這項作業的原因和時機

重要: 下列資訊說明如何停用 SSL 憑證。遵循這些步驟時,將容許建立不加密的伺服器連線(包括使用者登入認證)。如果您需要安全連線,請建立您自己的自簽憑證,以便使用主機的適當網路名稱來識別該主機,或申請一份由授信憑證管理中心 (CA) 簽署的憑證。
修改 Apache Tomcat 的設定

  1. 請確定您至少已啟動過一次 Apache Tomcat。
  2. 移至 JazzInstallDir/server/tomcat/webapps/jazz/WEB-INF 目錄。
  3. 編輯這個目錄中的 web.xml 檔,將每一個出現的 "CONFIDENTIAL" 全改為 "NONE"。
  4. 移至 JazzInstallDir/server/tomcat/conf 目錄,並編輯 server.xml。
  5. 將 redirectPort 屬性從 9080 Connector 元素中移除,使該元素的內容類似如下:
    <Connector port="9080" maxHttpHeaderSize="8192" 
      maxThreads="150" minSpareThreads="25" maxSpareThreads="75" 
      enableLookups="false" acceptCount="100" 
      connectionTimeout="20000" disableUploadTimeout="true" 
      URIEncoding="UTF-8"/>
  6. 重新啟動 Apache Tomcat。
  7. 驗證您可以使用 http://localhost:9080/jazz/admin 登入,且不會重新導向至 https://localhost:9443/jazz/admin
修改 WebSphere Application Server 的設定

  1. 修改 jazz .war 檔(安裝至 WebSphere Application Server)中的 web.xml。您可能需要先將 jazz .war 檔解壓縮至一個暫時區域,以取得該檔案。
  2. 將每一個出現的 "CONFIDENTIAL" 全改為 "NONE"(應有 3 個)。
  3. 請確定 WebSphere Application Server 正在執行,並移至 https://localhost:9043/ibm/console/logon.jsp
  4. 移至應用程式 -> 企業應用程式頁面。
  5. 選取 jazz_war 應用程式,並按一下更新按鈕。
  6. 選取取代或新增單一檔案選項。
  7. 指定要取代或新增的檔案路徑,並以所安裝的應用程式保存檔為開頭欄位中,輸入 "jazz.war/WEB-INF/web.xml"。
  8. 按一下瀏覽按鈕,並選取您在先前步驟中修改的相同 web.xml。
  9. 按「下一步」,並按照指示執行,直到儲存應用程式為止。
  10. 回到應用程式->企業應用程式頁面,然後停止再啟動 jazz_war 應用程式。
  11. 驗證您可以使用 http://localhost:9080/jazz/admin 登入,且不會重新導向至 https://localhost:9443/jazz/admin

配置 Jazz Team Server 來使用不在 z/OS 上的 DB2 儲存庫

這個主題提供在 Jazz Team Server for System z 未安裝於 z/OS 時,必須存取在 z/OS 上的 DB2 儲存庫之 Jazz Team Server for System z 的配置資訊。

開始之前

如果您在 z/OS 上使用 DB2 資料庫,Jazz Team Server for System z 與 Jazz Team Server for System z 儲存庫工具,必須具備 DB2 for z/OS 隨附之 JDBC 授權 .jar 檔的存取權。如果要設定授權檔的存取權,請完成下列步驟:

執行這項作業的原因和時機

這些指示說明如何連接到 z/OS 上的 DB2。 這些指示適用於所有平台。 DB2 設定作業應該由 DB2 管理者來執行。

DB2 必要條件

請確定內含 Universal JDBC 驅動程式的 DB2 for z/OS® 9.1 版,已安裝在要作為資料庫伺服器的 z/OS 系統上,並且正在執行。這可能不是執行 Jazz Team Server 的相同系統。

Jazz Team Server for System z 要求 DB2 的 SYSPROC.DSNUTILS 與 SYSIBM.SQLxxx 儲存程序的相關聯 WLM 程序處於作用中。必要的話,請將 DB2 WLM 環境變數的名稱與作用中 WLM 程序相比較,以驗證儲存程序是否為作用中。請使用 SQL SELECT 指令,透過 DB2 SPUFI 或您偏好的技術來擷取 WLM 程序名稱。

SELECT DISTINCT WLM_ENVIRONMENT FROM SYSIBM.SYSROUTINES WHERE  
  (NAME='DSNUTILS' OR (SCHEMA='SYSIBM' AND NAME LIKE 'SQL%'));  

這個指令會產生類似如下的結果:

---------+---------+---------+---------+---------+---------+---
WLM_ENVIRONMENT                                                
---------+---------+---------+---------+---------+---------+---
DSN9WLM1  

請從 z/OS 主控台,使用下列指令來顯示 WLM 作用中程序:D WLM,APPLENV=*。這個指令會產生類似如下的結果:

SDSF SYSLOG   2493.101 2094 2094 07/10/2008 0W   14886  COMMAND ISSUED
 RESPONSE=RALNS32                                                      
  IWM029I  16.31.12  WLM DISPLAY 465                                   
    APPLICATION ENVIRONMENT NAME     STATE     STATE DATA              
    BBOASR1                          AVAILABLE                         
    BBOASR2                          AVAILABLE                         
    BBOC001                          AVAILABLE                         
    CBINTFRP                         AVAILABLE                         
    CBNAMING                         AVAILABLE                         
    CBSYSMGT                         AVAILABLE                         
    DSN9WLM1                         AVAILABLE                         
    DSN9WLM2                         AVAILABLE                         
    DSN9WLM3                         AVAILABLE          

在本例中,您可以看到 DSN9WLM1 程序處於作用中。

設定 DB2 for z/OS,以搭配 Jazz Team Server for System z 使用

當 Jazz Team Server for System z 搭配 DB2 for z/OS 執行時,您必須建立一個 DB2 儲存體群組與 DB2 資料庫。您也必須授權 Jazz Team Server for System z 使用者使用該儲存體群組與資料庫。

執行這項作業的原因和時機

在您執行儲存庫工具資料庫建置器公用程式,以便在資料庫實例中建立 Jazz 儲存庫表格之前,必須先執行下列步驟。 Jazz Team Server 資料庫建置器公用程式不會執行任何這些步驟。

建立儲存體群組
儲存體群組必須適合該機器。下列範例顯示 DB2 SQL create 陳述式:
CREATE STOGROUP JAZZSTG VOLUMES ('*') VCAT yourHlq ;
附註:
  1. 儲存體群組可以是 JAZZSTG 以外的名稱。
  2. yourHlq 是您 DB2 檔案的高階限定元。它必須存在於系統上,且 Jazz Team Server for System z 使用者對它必須具備完整的存取權。
建立資料庫
資料庫必須適合該系統。下列範例顯示 DB2 SQL create 陳述式:
CREATE DATABASE JAZZDB STOGROUP JAZZSTG BUFFERPOOL bp8kx ; 
附註:
  1. 您可以在 CREATE DATABASE 陳述式中,用不同名稱取代 JAZZDB 名稱。
  2. 之後會將該資料庫名稱用於 Jazz Team Server for System z teamserver_db2z.properties com.ibm.team.repository.db.db2.dsn.dbname 內容。
  3. bp8kx 是緩衝池名稱,例如 BP8K0(Jazz Team Server for System z 需要 8K 分頁大小)。
  4. 您可以在 DB2 子系統中定義多個 Jazz DB2 資料庫,來包含個別的 Jazz 儲存庫。其作法是按照自訂適用於 DB2 for z/OS 的 Jazz Team Server for System z 內容檔中的討論,與 Jazz Server teamserver_db2z.properties 檔中的 com.ibm.team.repository.db.schemaPrefix 指引一起使用。
授權給 Jazz Team Server for System z 使用者

Jazz Team Server for System z 需要使用者 ID 與密碼,才能存取 Jazz Team Server for System z DB2 儲存庫。使用者 ID 與密碼稍後會在 teamserver_db2z.properties 檔中指定。 這個使用者 ID 不是用來登入 Jazz Team Server for System z。它只用來提供權限給 Jazz Team Server for System z,以存取 DB2 for z/OS 資料庫。更明確地說,就是這個使用者 ID 需要這裡顯示的許可權。在下列範例中,使用者的名稱是 jazz

GRANT DBADM ON DATABASE jazzdb TO jazz ; 
GRANT USE OF STOGROUP jazzstg TO jazz ;  
GRANT USE OF BUFFERPOOL bpx TO jazz ;  
COMMIT ;  
此外,在 DB2 安裝期間,如果在 DSNTIPP 畫面上將 DBADM CREATE AUTH 欄位的值設為 NO,您必須授與 SYSADM 權限給 Jazz Team Server for System z 使用者。
GRANT SYSADM TO jazz ;
COMMIT ;  

自訂適用於 DB2 for z/OS 的 Jazz Team Server for System z 內容檔

依預設,Jazz Team Server for System z 使用 JazzInstallDir/server/conf/jazz 中的配置檔,來取得資料庫連線的配置資訊。

請編輯 teamserver.properties 檔。將下列字行變更成註解,如此便不會使用預設 Derby 資料庫。更明確地說,就是變更下列字行:

# JDBC 資料庫位置,指定這個內容時,會停用「根據系統來選取
# 預設位置」
com.ibm.team.repository.db.vendor = DERBY
com.ibm.team.repository.db.jdbc.location = repositoryDB

以符合下列字行:

# JDBC 資料庫位置,指定這個內容時,會停用「根據系統來選取
# 預設位置」
#com.ibm.team.repository.db.vendor = DERBY
#com.ibm.team.repository.db.jdbc.location = repositoryDB

移除 #,來解除註解下列以 #com.ibm 開頭的內容。然後遵循本節中稍後的指示來設定內容值。

#
# DB2z 配置
#

# 註銷上述字行,然後解除註解下列字行,並自訂
# 範例位置以使用 DB2z
#com.ibm.team.repository.db.vendor = db2z

# DB2z 子系統的位置名稱。
# ipAddress、ipPort 與 location 是藉由執行 DISPLAY DDF 這個 DB2 指令取得
#com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
#location:fullyMaterializeLobData=false;user=jazzDBuser;password={password};
#com.ibm.team.repository.db.jdbc.password=jazzDBpswd

# DB2z 資料庫名稱
#com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB

# DB2z 緩衝池名稱
#com.ibm.team.repository.db.db2.dsn.bufferpool=bpx

# DB2z 儲存體群組名稱
#com.ibm.team.repository.db.db2.dsn.stogroup=JAZZSTG

針對您的 DB2 for z/OS 子系統使用 -DIS DDF 指令,以顯示您需要提供的某些值。例如,您可以從以下的顯示畫面擷取位置、IP 位址 (ipaddr) 與埠 (tcpport):

-DSN9 DIS DDF
DSNL080I -DSN9 DSNLTDDF DISPLAY DDF REPORT FOLLOWS: 548
DSNL081I STATUS=STARTD
DSNL082I LOCATION LUNAME GENERICLU
DSNL083I NS32DB NETA.NS32DB -NONE
DSNL084I TCPPORT=3500 SECPORT=3510 RESPORT=3501 IPNAME=-NONE
DSNL085I IPADDR=9.42.81.74
DSNL086I SQL DOMAIN=RALNS32.rtp.raleigh.ibm.com
DSNL086I RESYNC DOMAIN=RALNS32.rtp.raleigh.ibm.com
DSNL099I DSNLTDDF DISPLAY DDF REPORT COMPLETE

編輯下列字行,以符合您在先前步驟中建立的資料庫配置,以及符合您的 DB2 配置。根據您的配置,來編輯 location、user、password、dbname、bufferpool 與 stogroup 內容。更明確地說,就是編輯下列字行:

  1. 在下列字行中:
    com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
    location:user=jazzDBuser;password={password};
    取代:
    重要: 請勿修改 password={password}
  2. 在下列字行中:
    com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    以您 DB2 使用者的密碼取代 jazzDBpswd
  3. 在下列字行中:
    com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
    以您建立的資料庫名稱取代 JAZZDB
  4. 在下列字行中:
    com.ibm.team.repository.db.db2.dsn.bufferpool=bpx
    以您在建立資料庫時所選的緩衝池取代 bpx。請確定它支援 8K 分頁。請使用 BP8K0 等之類的緩衝池。
  5. 在下列字行中:
    com.ibm.team.repository.db.db2.dsn.stogroup=JAZZSTG
    以您建立的儲存體群組取代 JAZZSTG
  6. 您也可以選擇插入下列字行:
    com.ibm.team.repository.db.schemaPrefix=xx
    請以您選擇的字首取代 xx。這是選用的。它可讓您在一個 DB2 子系統中,擁有多個 Jazz 儲存庫。
    註: 如果您想在相同 DB2 子系統中建立數個 Jazz 資料庫,必須區分 Jazz 表格的表格擁有者。為了達到此目的,Jazz Team Server for System z 採用 com.ibm.team.repository.db.schemaPrefix 指引,在 Jazz DB2 物件中加入字首,讓它們在 DB2 子系統中都是唯一的。擁有者將包含 com.ibm.team.repository.db.schemaPrefix 中所設定的字首並加上底線。例如,當 com.ibm.team.repository.db.schemaPrefix=X1 時,則會在給定的資料庫中,將 WORKITEMS_SNAPSHOT.WORKITEM_CHNGS 表格建立成 X1_WORKITEMS_SNAPSHOT.WORKITEM_CHNGS
建立 Jazz Team Server 資料庫表格

使用儲存庫工具來建立資料庫表格。

執行這項作業的原因和時機

如果要建立資料庫表格,請執行下列動作:

執行 repotools.sh -createTables 指令,為 Jazz 儲存庫建立資料庫表格。
repotools.sh Script 位於 JazzInstallDir/server 目錄。

註: 在 Windows 上,您可以使用 repotools.bat


這個指令在連線和大小設定方面,會使用 teamserver.properties 中的配置內容。

這個指令會為 Jazz Team Server 儲存庫建立表格空間,以及所有必要的表格與索引。

選用項目:設定具有 SDBM 後端 (RACF) 的 z/OS LDAP 伺服器

您可以利用具有 SDBM 後端的 z/OS LDAP 伺服器,搭配 WebSphere Application Server 進行 Rational Team Concert for System z 的用戶端鑑別。 SDBM 利用 RACF,在 z/OS 上提供原生鑑別。 這項作業是選用的,應交由 z/OS 安全管理者來執行。

執行這項作業的原因和時機

這個主題說明要用在這個配置中的特定 LDAP 設定。 這項資訊補充使用 LDAP 的 Rational Team Concert for System z 配置指示。 如需相關資訊,請參閱RTCz:使用「輕量型目錄存取通訊協定 (LDAP)」來管理使用者

範例

註: 「連結識別名稱」應該是一個具備 AUDITOR 屬性、有效 OMVS 區段(特定或是透過預設區段隱含),且沒有 TSO 區段的 RACF 使用者 ID。這不是必要的,透過這個簡單的步驟可避免誤用 BDN 帳戶。

BDN 使用者 ID 應使用尚未到期的密碼,以免 WebSphere Cell 因內部鑑別與授權失效而中止。

如果您組織的原則要求讓這個使用者 ID 種類到期,請確定您已備妥一項程序,在 BDN 密碼到期之前就加以變更。

RTCz:特殊安裝考量

安裝 Rational Team Concert for System z Starter Edition

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

RTCz:Starter Edition 安裝概觀

安裝套件涵蓋您開始進行所需的一切。

預設配置包含的項目如下:

註: 線上說明中所提供的選用規劃工作表,有助您選擇配置以及記錄您的決策。

RTCz:準備安裝 Starter Edition

在安裝伺服器之前,請驗證是否符合特殊考量。

RTCz:Linux 和 Linux for System z 的特殊指示

當 Jazz Team Server for System z 是安裝在 Linux 或 Linux for System z 上,請檢閱下列特殊指示。

RTCz:安裝 Starter Edition

如果要開始進行,請取得安裝檔案。

執行這項作業的原因和時機

Jazz Team Server for System z、Rational Team Concert for System z 用戶端、Build System Toolkit for System z、ClearCase Connector、ClearQuest Connector 以及其他的孵化程式檔案,皆可從 http://jazz.net 下載。如果要購買 Rational Team Concert for System z,請移至 http://www.ibm.com/software/awdtools/rtcz/,其中您可以下載可安裝映像檔,或訂購 DVD。

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

RTCz:從 IBM Installation Manager 來安裝 Starter Edition

在取得安裝檔案後,請啟動安裝。

執行這項作業的原因和時機

Jazz Team Server for System z、Rational Team Concert for System z 用戶端、Build System Toolkit for System z、ClearCase Connector、ClearQuest Connector 以及其他的孵化程式檔案,皆可從 http://jazz.net 下載。如果要購買 Rational Team Concert,請移至 http://www.ibm.com/software/awdtools/rtcz/,其中您可以下載可安裝映像檔,或訂購 DVD。

  1. 下載下列 .zip 檔,然後解壓縮它的內容,利用 IBM Installation Manager 來安裝 Rational Team Concert for System z Starter Edition。
  2. 啟動啟動程式。

    如果 Installation Manager 不在執行中,請啟動它。

    註: 您必須具備管理者專用權,才能執行啟動程式。
  3. 當啟動程式啟動時,您會看到要安裝的項目清單。請按照所列出的順序,來安裝您想使用的每一個套件。
    1. 安裝 Jazz Team Server for System z。

      當使用 IBM Installation Manager 時,請在安裝程序期間記下「位置」頁面上的安裝目錄。該目錄稱為 JazzInstallDir

      註: 如果您打算使用現有的應用程式伺服器,而不使用隨附的 Apache Tomcat 伺服器,請清除 Apache Tomcat 套件勾選框。如此做只會安裝搭配現有應用程式伺服器使用時所需的檔案。Installation Manager 會提示您選擇這些檔案的安裝位置。
    2. 選用:安裝 DB2 Workgroup Server。
      註: 雖然預設配置已包含 Derby 資料庫而不需安裝,但這個資料庫無法支援超過 10 位使用者。如果您想支援超過 10 位的使用者,但又無現有 DB2 或 Oracle 資料庫的存取權,請安裝搭售的 DB2 Workgroup Server 版本。

      如果您安裝 DB2 Workgroup Server,請記下使用者 ID、密碼和埠號。之後需用到這項資訊。在安裝期間接受預設值,可簡化 Jazz Team Server for System z 的配置。

    3. 安裝 Rational Team Concert for System z 用戶端。
    4. 選用:安裝 Build System Toolkit for System z。

RTCz:從 .zip 檔來安裝 Starter Edition

在取得安裝檔案後,請解壓縮內容。

執行這項作業的原因和時機

Jazz Team Server for System z、Rational Team Concert for System z 用戶端、Build System Toolkit for System z、 ClearCase Connector、ClearQuest Connector 和其他的 Incubator 檔案皆可從 http://jazz.net 下載。如果要購買 Rational Team Concert for System z,請移至 http://www.ibm.com/software/awdtools/rtcz/,其中您可以下載可安裝映像檔,或訂購 DVD。

註: 當使用壓縮的保存檔來完成安裝時,請記錄解壓縮檔案時的所在目錄。該目錄稱為 JazzInstallDir

  1. 將 Rational Team Concert for System z Starter Edition 伺服器的 .zip 檔下載至您的電腦中。
  2. 將套件內容解壓縮至檔案系統。
  3. 選用:安裝 DB2 Workgroup Server。
    註: 儘管預設配置已包含 Derby 資料庫而不需安裝,但是這個資料庫限制只能有 10 位使用者。如果您需要支援超過 10 位使用者,但又無現有 DB2 或 Oracle 資料庫的存取權,則應該安裝搭售的 DB2 Workgroup Server。

    如果您安裝 DB2 Workgroup Server,請記下使用者 ID、密碼和埠號。之後需用到這項資訊。在安裝期間接受預設值,可簡化 Jazz Team Server for System z 的配置。

RTCz:設定資料庫

在安裝資料庫後,需要進行配置工作。

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z
捷徑: 如果您使用內含的 Derby 資料庫,則不需額外的設定。請繼續進行RTCz:啟動伺服器

設定資料庫的步驟概述如下:

  1. 建立資料庫。
  2. 配置內容檔。
  3. 建立資料庫表格。

如果您使用任何支援的 DB2 版本,請繼續進行RTCz:設定 DB2 資料庫

如果您使用 Oracle,請繼續進行RTCz:設定 Oracle 資料庫

如果您使用 SQL Server,請繼續進行RTCz:設定 SQL Server 資料庫

RTCz:設定 DB2 資料庫

設定支援的 DB2 或搭售的 DB2 Workgroup Server 資料庫,以搭配 Jazz Team Server for System z 運作。

開始之前

本程序假設已符合下列必備條件。相關說明請參閱您的 DB2 文件,或向您的 DB2 資料庫管理者 (DBA) 查詢。

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

執行這項作業的原因和時機

如果要設定 DB2 資料庫,請執行下列動作:

  1. 在「DB2 指令視窗」中建立資料庫。 範例指令會建立一個名為 JAZZ 的新資料庫。這些指令是在「DB2 指令視窗」中執行。「指令視窗」可透過應用程式「啟動」功能表下的 「DB2 指令行工具」功能表來開啟。
    註: 為了確保能適當處理 Unicode 內容,資料庫字集必須採 UTF-8 編碼。在 Windows 中,由於預設的 4K 分頁大小放不下 AUDITABLE_LINKS 表格,請將分頁大小至少設為 8K。
    提示: 如果資料庫不在執行中,db2start 指令會啟動 DB2。
  2. JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.properties 檔,並重新命名為 teamserver.derby.properties
  3. JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.db2.properties 檔,並重新命名為 teamserver.properties
  4. teamserver.properties 檔中指定資料庫和連線的詳細資料。

    預設連線規格是連接在 localhost 埠 50000 上執行的 DB2 資料庫。在 Windows 中,資料庫名稱為 JAZZ,而使用者名稱與密碼皆為 db2admin。如果您在設定資料庫時使用預設值,可能已正確配置 teamserver.properties 檔。如果不是,請變更這項資訊,以符合您的配置。

    1. 以文字編輯器開啟 teamserver.properties 檔。
    2. 找出下列字行:
      com.ibm.team.repository.db.vendor = DB2
      com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
      com.ibm.team.repository.db.jdbc.password=db2admin
    3. com.ibm.team.repository.db.jdbc.location 中,編輯您的 DB2 伺服器和資料庫值。
      提示: 在「DB2 指令視窗」中,執行 db2 get dbm cfg 指令,並找出內含 SVCENAME 的字行,其中會指出 DB2 埠名或埠號。如果這個指令顯示號碼,請用來作為埠號(以取代上述範例中的 50000)。如果指令傳回非數值的名稱,請判斷指派給這個名稱的埠號,然後使用該埠號。在 Linux 中,/etc/services 檔含有埠名和埠號之間的對映,而在 Windows 中,C:\windows\system32\drivers\etc\services 檔含有這項對映。如需相關資訊,請詢問您的資料庫管理者或查閱資料庫文件。
    4. com.ibm.team.repository.db.jdbc.location 中,編輯您的 DB2 使用者名稱值。
      註: DB2 使用者必須具備建立表格、表格空間以及修改資料庫配置的許可權。DB2 使用者由作業系統建立。
    5. com.ibm.team.repository.db.jdbc.password 內容中指定使用者密碼。
      註: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 password={password} 文字。
    6. 必要的話,請將 com.ibm.team.repository.db.db2.content.tablespace.location 內容變更為 Jazz Team Server for System z 中一個可建立主要表格空間的路徑。
      註: 如果沒有變更預設值 (content_tablespace),會將表格空間建立在資料庫儲存區位置下。在 Windows 中,如果要指定新路徑,必須使用雙反斜線來指定,例如 com.ibm.team.repository.db.db2.content.tablespace.location=c:\\db2\\jazz\\content_tablespace。

結果

您已完成資料庫的設定。請繼續進行在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格

RTCz:設定 Oracle 資料庫

設定 Oracle 資料庫以搭配 Jazz Team Server for System z 運作。

開始之前

在此假設已符合下列的必備條件。相關說明請參閱您的 Oracle 文件,或向 Oracle 資料庫管理者 (DBA) 查詢。

當在 Oracle 中執行 Jazz Team Server for System z 時,請建立 Oracle 表格空間以提升效能。您必須建立一個鏈結至該表格空間的使用者。

記住: 這些步驟皆不是由資料庫建置者使用儲存庫工具來執行。

執行這項作業的原因和時機

如果要設定 Oracle 資料庫,請執行下列動作:

  1. 建立表格空間。 表格空間位置必須適合機器和磁碟機。
    註: 表格空間可以具備下列任何內容:
    • oracle_tbs 以外的名稱
    • 另一個目錄中的位置
    • 大小超過 1GB。如果是大型安裝,必須配置更多的空間。
    下列範例顯示在 Windows 機器上執行的 create 陳述式:
    CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    重要: 目錄路徑(以本例來說是 D:\oracle_tbs)必須存在。不需建立個別的特殊表格空間。您可以使用 Oracle 預設 USERS 表格空間,不過,如果能在它所管理的磁碟上預先配置一個空間,Oracle 的效能會更好。
  2. 建立 Oracle 使用者。

    在建立表格空間後,必須為 Jazz 建立一個特殊的 Oracle 使用者,以使用 Oracle 資料庫。

    在本例中,使用者的名稱為 jazzDBuser,密碼(以 Oracle 詞彙來說是 IDENTIFIED BY)為 jazzDBpswd,且其存在於您在1中所建立的表格空間中。
    CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs
    在建立使用者之後,應授與使用者在起始設定 Jazz 資料庫時所需的必要許可權。以下的 SQL 指令可用來授與適當的許可權:
    GRANT CREATE SESSION TO jazzDBuser;
    GRANT CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX TO jazzDBuser;
    GRANT INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE TO jazzDBuser;
    GRANT CREATE PROCEDURE TO jazzDBuser;
    GRANT CREATE VIEW TO jazzDBuser;
  3. JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.properties 檔,並重新命名為 teamserver.OtherDBProvider.properties
  4. JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.oracle.properties 檔,並重新命名為 teamserver.properties
    提示: 重新命名原始 teamserver.properties 檔可讓您將檔案還原成先前的工作版本。依預設,「資料庫提供者」為 derby
  5. 配置伺服器
    1. 如果您使用不同的使用者名稱、密碼或資料庫名稱、將 Oracle 伺服器安裝在 Jazz Team Server for System z 以外的機器上,或者使用非預設埠,請編輯伺服器配置檔。開啟 JazzInstallDir/server/conf/jazz 目錄中的 teamserver.properties 檔,並變更下列資訊以符合您的設定。

      com.ibm.team.repository.db.vendor = ORACLE

      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL

      將 jazzDBuser 變更為建立給 Jazz 以使用 Oracle 資料庫的使用者。如果您使用本端主機,請移除位於字行開頭的 #,以解除註解該字行,並且註解下一個位置行。本端主機連線字串不應包含前導的 //。請將 1521 改成您的 Oracle 伺服器機器的 TCPIP 埠。 將 ORCL 變更為您的 Oracle 資料庫名稱。

      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL

      如果您使用非本端主機連線,請移除位於字行開頭的 #,以解除註解該字行,並且註解下一個位置行。非本端主機連線字串必須包含前導的 //。

      com.ibm.team.repository.db.jdbc.password=jazzDBpswd

      將 jazzDBpswd 變更為建立給 Jazz 以使用 Oracle 資料庫的使用者密碼。

      重要: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 {password} 文字。com.ibm.team.repository.db.jdbc.password 內容中必須指定使用者密碼。

      如果您使用 Oracle Express,請使用 1521 作為 TCPIP 埠,以及使用 XE 作為 Oracle 資料庫名稱:

      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    2. 在和伺服器 Script 相同的目錄中 (JazzInstallDir/server),建立一個名為 oracle 的目錄。
    3. 找出 Oracle JDBC 驅動程式 JAR 檔 ojdbc14.jar。位置可能因 Oracle 產品和作業系統而有不同。將這個檔案複製至 oracle 目錄。
      註: 如果您使用 WebSphere Application Server,請配置一個名為 "ORACLE_JDBC" 的內容;然後將它設定為 Oracle JDBC 驅動程式的絕對檔案路徑(非 URL)。這項作業會在 WebSphere Application Server 設定指示中說明。記下檔案路徑,以便之後在這些指示中使用。

結果

您已完成資料庫的設定,而可繼續進行在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格

RTCz:設定 SQL Server 資料庫

設定 SQL Server 資料庫,以搭配 Jazz Team Server for System z 運作。

本程序假設您已符合下列的必備條件:

記住: JazzInstallDir/server/teamserver.properties 檔中,所定義的 SQL Server 資料庫預設登入名稱是 jazzDBuser,預設密碼是 jazzDBpswd。在建立資料庫時,會在以下的步驟中使用這些值。您可以將這些值換成您資料庫的使用者名稱與密碼。

設定資料庫

本節說明如何使用 SQL Server 安裝提供的指令行工具 sqlcmd,來設定 SQL Server 資料庫。您也可以使用視覺化工具,以 SQL Server Studio Management 為例,就可以當成 SQL Server Studio Management Express 在 Express™ 版中使用。如需相關資訊,請參閱 SQL Server 文件或詢問 SQL Server 資料庫管理者 (DBA)。

如果要使用 指令工具 sqlcmd 來設定 SQL Server 資料庫,請執行下列動作:

  1. 建立 Jazz Team Server for System z 資料庫。請從指令行工具鍵入:
    CREATE DATABASE jazz
    GO 
  2. 建立使用者和密碼,並變更 Jazz Team Server for System z 資料庫的所有權。請從指令行工具鍵入:
    CREATE LOGIN jazzDBuser
    WITH PASSWORD = 'jazzDBpswd';
    USE jazz;
    exec sp_changedbowner 'jazzDBuser'
    GO 
  3. 建立 Jazz Team Server for System z 資料庫對照。請從指令行工具鍵入:
    ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS
    GO

配置伺服器

記住: 依預設,JazzInstallDir/server/conf/jazz 目錄中的 teamserver.properties 檔不是設定成連接 SQL Server 資料庫。所有的預設值以及 SQL Server 特定的設定全包含在同一目錄的 teamserver.sqlserver.properties 檔中。

如果要配置伺服器,請執行下列動作:

  1. 重新命名下列檔案:
    提示: 重新命名原始 teamserver.properties 檔可讓您將檔案還原成先前的工作版本。依預設,「資料庫提供者」為 derby
  2. 如果您使用不同的使用者名稱、密碼或資料庫名稱、將 SQL Server 安裝在 Jazz Team Server for System z 以外的機器上,或者使用非預設埠,請編輯伺服器配置檔。開啟 JazzInstallDir/server/conf/jazz 目錄中的 teamserver.properties 檔,並變更下列資訊以符合您的設定。
    com.ibm.team.repository.db.vendor = SQLSERVER
    com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
    com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
    重要: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 password={password} 文字。com.ibm.team.repository.db.jdbc.password 內容中必須指定使用者密碼。

如果要指定 JDBC 的 JAR 檔位置,請執行下列動作:

  1. 在和伺服器 Script 相同的目錄 (JazzInstallDir/server) 中,建立名為 sqlserver 的目錄。
  2. 找出名為 sqljdbc.jar 的 SQL Server JDBC 驅動程式 JAR 檔。如「必備條件」小節中所述,位置可能因驅動程式安裝所在而異。將檔案複製至新建的 sqlserver 目錄。
  3. 完成下列作業,以指定 JDBC 的 JDBC JAR 檔位置:

您已完成資料庫的設定。現在,請建立 Jazz Team Server for System z 資料庫表格。如需相關資訊,請參閱在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格

疑難排解

如果 repotools 指令沒有成功,請檢查 JazzInstallDir/server 目錄中名為 repotools_createTables.log 的日誌檔。

此外,請驗證下列:

註: 為了能在多種資料庫平台上執行,Jazz Team Server for System z 的資料庫碼為通用和標準設計;不過,各企業資料庫供應商在語法、最佳化策略和鎖定語意方面仍有差異。在 SQL Server 上,已使用各種自動測試組合,並模擬正常的工作量和壓力測試,來測試伺服器。模擬正常工作量的結果,顯示效能是可接受的。在某些實例中,在自動化並行測試中觀察到資料庫死鎖;不過這些並未同樣重現上不同的伺服器硬體上。

依照設計,伺服器可服務大量的同步要求。在某些異常的情況中,儲存資料庫中可能發生死鎖,這是因為要求的相關聯交易中同時更新了類似或同等的物件。這類事件罕見但仍屬正常。 依照設計,系統會有相對的防禦措施,並維護資料完整性;資料不會遺失。建置引擎執行等之類的作業偶爾會記載死鎖。一般來說,偵測到狀況時,會重試作業。死鎖可能導致建置失敗。在某些相當罕見的情況中,可能是使用工作項目或原始碼等之類的使用者動作,而這可藉由中斷來解決死鎖。在該情況下,使用者動作將會失敗,並顯示內含死鎖詳細資料的錯誤給使用者。 之後使用者可重試該動作。

所遇到的所有死鎖都會記載在伺服器上,以提供發生死鎖時的相關現象資訊。日誌項目中的文字類似如下:com.ibm.team.repository.common.RetryableDatabaseException: 序列化失敗

如果您的系統遇到死鎖,請參閱位於下列位置的錯誤日誌:https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog

如果您常常遇到死鎖異常狀況,請聯絡您的產品支援人員,或檢查 jazz.net 論壇中的最新資訊、更新項目或移轉技術。

在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格

使用儲存庫工具來建立資料庫表格。

執行這項作業的原因和時機

如果要建立資料庫表格,請執行下列動作:

  1. 執行 repotools -createTables 指令,為 Jazz 儲存庫建立資料庫表格。

    repotools 檔位於 JazzInstallDir/server。

    這個指令在連線和大小設定方面,會使用 teamserver.properties 中的配置內容。依預設,指令會查看現行目錄。teamserver.properties 參數可用來參照不同的內容檔。

    這個指令會為 Jazz Team Server for System z 儲存庫建立表格空間,以及所有必要的表格與索引。
  2. 在建立資料庫表格後,您必須停止並重新啟動資料庫,以確保所有的變更都會生效。
    提示: 僅適用於 DB2。停止並啟動 DB2 的範例指令為 db2stop 和 db2start。這些指令是在 「DB2 指令視窗」中執行。「指令視窗」可透過應用程式「啟動」功能表下的 「DB2 指令行工具」階層式功能表來開啟。

結果

您已完成資料庫的設定,而可繼續進行RTCz:啟動伺服器

RTCz:啟動伺服器

這個主題說明執行伺服器啟動 Script 時所用的各種選項。

執行這項作業的原因和時機

如果您打算使用隨附的 Apache Tomcat 應用程式伺服器,可準備啟動 Jazz Team Server for System z。

如果您打算使用 WebSphere Application Server,請按照RTCz:設定 WebSphere Application Server中的說明來設定您的伺服器環境。

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

RTCz:啟動 Apache Tomcat 伺服器

現在,您可以準備啟動 Apache Tomcat 伺服器。

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

Apache Tomcat 已安裝在 JazzInstallDir/server/tomcat 目錄。Web 應用程式 (jazz.war) 已安裝在 Apache Tomcat 目錄 webapps。在指令視窗中,將您的現行目錄設定為 JazzInstallDir/server。伺服器的啟動和關閉 Script 位於這個目錄中。

在 Windows 上啟動伺服器

請執行啟動檔,以便在 Windows 上啟動您的伺服器。

執行這項作業的原因和時機

  1. 如果要啟動伺服器,請從 JazzInstallDir/server 目錄執行下列指令:
    server.startup.bat
    註: 這時會開啟個別的 Apache Tomcat 主控台視窗。請勿關閉此視窗,否則伺服器將停止運作。此外,會啟動數則參考訊息,包含有關 Apache Tomcat 原生程式庫的訊息。這些參考訊息不會影響 Jazz Team Server for System z 的功能。
  2. 如果要停止伺服器,請從 JazzInstallDir/server 目錄執行下列指令:
    server.shutdown.bat

下一步

註: 上述範例是直接從 JazzInstallDir/server 目錄執行啟動和停止 Script。如果您是使用 IBM Installation Manager 來安裝 Jazz Team Server for System z,也可以從 Jazz Team Server for System z Windows 開始功能表來執行指令。

在啟動伺服器之後,請繼續進行RTCz:執行設定精靈

在 Linux 或 Linux for System z 上啟動伺服器

請執行啟動檔,以便在 Linux 或 Linux for System z 上啟動伺服器。

執行這項作業的原因和時機

  1. 如果要啟動伺服器,請以 root 使用者身分從 JazzInstallDir/server 目錄執行下列指令:
    ./server.startup
    如果您的使用者 ID 具備管理者存取權,請執行以下指令:
    sudo ./server.startup

    並不會顯現個別的 Apache Tomcat 主控台視窗。您可以檢視 JazzInstallDir/server/logs/jazz.log 中的日誌檔,以檢查伺服器啟動進度。

  2. 如果要停止伺服器,請以 root 使用者身分從 JazzInstallDir/server 目錄執行下列指令:
    ./server.shutdown
    如果您的使用者 ID 具備管理者存取權,請執行以下指令:
    sudo ./server.shutdown

下一步

註: 這個範例是直接從 JazzInstallDir/server 目錄執行啟動和停止 Script。如果您是使用 IBM Installation Manager 來安裝 Jazz Team Server for System z,也可以從 Jazz Team Server for System z 應用程式啟動功能表來執行指令。

在啟動伺服器之後,請繼續進行RTCz:執行設定精靈

在當成 Windows 服務的 Apache Tomcat 中執行 Jazz Team Server for System z

Apache Tomcat 能夠當成 Windows 服務來執行。如果您希望不必登入就能在 Windows 型機器上執行 Jazz Team Server,這種作法就可以派上用場。

開始之前

這個主題假設您的 Jazz Team Server for System z 部署位於 C:\jazz 根目錄;請根據您的實際根目錄來調整路徑。

  1. 開啟命令提示字元,並執行下列指令,以安裝 Tomcat 服務。
    C:\jazz\server\tomcat\bin\service.bat install
  2. 如果您使用 Derby 作為 Jazz 儲存庫的資料庫,請編輯 C:\jazz\server\conf\jazz\teamserver.properties,讓資料庫位置是一個絕對路徑。例如,將 db.jdbc.location 的值改為 C:\jazz\server\repositoryDB
  3. 執行 C:\jazz\server\tomcat\bin\tomcat5w.exe,以配置服務。
  4. 按一下 Java 標籤,並取消勾選使用預設值勾選框。
  5. 將下列路徑新增至 Java 虛擬機器。您也可以按一下省略符號圖示,瀏覽並找出 jvm.dll 檔。
    C:\jazz\server\jre\bin\j9vm\jvm.dll
  6. 將下列字行新增至 Java 選項文字欄位底端。
    -DJAZZ_HOME=file:///c:/jazz/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=%TEMP%
    如果您使用 Oracle 資料庫,請新增下列字行:
    -DORACLE_JDBC=[Oracle JDBC 驅動程式 JAR 的路徑]
    如果您使用 SQL Server 資料庫,另請新增下列字行:
    -DSQLSERVER_JDBC=[SQL Server JDBC 驅動程式 JAR 的路徑]
  7. 記憶體儲存區上限大小變更為 700。
  8. 啟動關閉標籤中,確定已在模式設定中選取 jvm
  9. 如果您希望服務會隨 Windows 自動啟動,請按一下一般標籤,並將啟動類型變更為自動
  10. 啟動服務,以測試伺服器。

將 Jazz Team Server for System z 部署至現有的 Apache Tomcat

這個主題說明如何設定 Jazz Team Server for System z,以使用現有的 Apache Tomcat 伺服器。

執行這項作業的原因和時機

如果要將 jazz.war 檔部署至現有的 Apache Tomcat 伺服器,請遵循下列步驟:

  1. 將 jazz.war 檔從 JazzInstallDir 複製至 tomcat\webapps 目錄。
  2. 開啟要編輯的 Tomcat 啟動檔,並新增以下的系統內容設定:
    set CATALINA_OPTS=-Dcom.ibm.team.server.configURL=file:///"%cd%"/teamserver.properties -Dlog4j.configuration=file:///"%cd%"/log4j.properties
    set JAVA_OPTS=-Djava.awt.headless=true -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Dcom.ibm.team.repository.provision.profile="%cd%"\provision_profiles -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M
  3. 儲存並關閉啟動檔。
  4. 開啟並編輯 teamserver.properties 檔,以指向您的資料庫。
  5. 儲存並關閉 teamserver.properties。

RTCz:設定 WebSphere Application Server

這個主題說明如何設定 Jazz Team Server for System z 以搭配 WebSphere Application Server 運作。這項設定會假設您是將 Jazz Team Server for System z 安裝在和 Websphere Application Server 相同的機器上。

開始之前

在開始進行這些步驟前,應先完成下列:

執行這項作業的原因和時機

註: 本文件不提及較複雜的 WebSphere 鑑別或 SSL 配置主題。有關 WebSphere 各種鑑別和加密選項的詳細資訊,可在「WebSphere 資訊中心」找到。如需相關資訊,請跳至 WebSphere 資訊中心,並搜尋維護應用程式和其環境的安全 (Securing applications and their environment)。Jazz Web 使用者介面需要配置鑑別,才能執行鑑別並將應用程式個人化。

  1. 檢閱並更新 teamserver.properties 檔中的資料庫位置
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    註: 這是 DB2 配置範例。在更新 teamserver.properties 時,應視資料庫供應商 (Oracle/MS-SQL) 而定。
  2. 驗證或更新 WebSphere Application Server 層次。

    Jazz Team Server for System z 要求必須已安裝套用了 IBM Java SDK 1.5 SR5(或更新版本)累加修正程式的 WebSphere Application Server 6.1 版,或是 WebSphere Application Server 7.0 版(且至少必須是 7.0.0.3)。IBM Java SDK 1.5 SR6 SDK 的更新可從 http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 取得。如果使用 WebSphere 6.1 和 GA IBM Java SDK,Jazz 在執行一些作業後就會開始回報 "Proxy 錯誤"。

    您必須取得 IBM Java SDK 1.5 SR9 或 IBM Java SDK 1.6 SR4 修正程式的對應 WebSphere Application Server 臨時修正程式,Rational Team Concert for System z 2.0 才能正確執行。否則,伺服器中的某些服務可能無法正確啟動。臨時修正程式可以在其對應的 WebSphere Application Server APAR 中取得。如果是 IBM Java SDK 1.5/WebSphere Application Server 6.1,APAR 為 PK85942,而您可以從 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/ 下載這些檔案。在安裝 JRE 臨時修正程式之前,請至少先安裝 WebSphere Application Server 6.1 Fixpack 19。如果是 IBM Java SDK 1.6/WebSphere Application Server 7.0,APAR 是 PK 86771,而您可以從 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/ 下載這些檔案。

  3. 更新 JVM 引數。

    Jazz Team Server for System z 需要在其執行所在的 Java 虛擬機器上進行一些特定的設定。

    首先,它需要知道某些配置檔的位置。作法是設定 JAZZ_HOME 系統內容。這個內容使用 URL 而非簡式路徑,因此應將值指定為 file://-style URL。

    Jazz JVM 所需的第二個內容是使用 -Xmx 設定,為它提供比預設最大記憶體配置還多的記憶體。這應根據伺服器支援的團隊大小以及 Jazz Team Server for System z 執行所在的伺服器記憶體容量來設定。一般中等大小的團隊可使用值 -Xmx1000M,這是提供 1000 MB 的資料堆記憶體給 Jazz Team Server for System z 程序。

    如果您連接 Oracle 或 SQL Server 資料庫,還需新增一個名為 "ORACLE_JDBC" 或 "SQLSERVER_JDBC" 的內容。請將這個內容設定為 JDBC 驅動程式的絕對檔案路徑 (非 URL)。

    您還需要設定另外兩個系統內容,以控制伺服器的某些行為;請見以下的說明。以下是在 WebSphere 管理主控台中設定這些 JVM 內容的細節說明,藉以將 JazzInstallDir 換成您的 Jazz Team Server for System z 安裝目錄:

    1. 按一下伺服器 -> 應用程式伺服器.
    2. 按一下 server1
    3. 按一下 Java 和程序管理 -> 程序定義
    4. 按一下 Java 虛擬機器
    5. 起始資料堆中,新增值 100。
    6. 資料堆大小上限中,新增值 1000。
    7. 按一下套用
    8. 按一下記載和追蹤。按一下變更日誌的詳細程度。Jazz Team Server for System z 採用 BIRT 報告引擎。如果要防止將 BIRT 參考項目寫入至 WebSphere 日誌檔,請將 org.eclipse.birt.* 套件的日誌記載層次設定為嚴重。按一下套用
    9. 按一下自訂內容
    10. 新增下列內容: 按一下新建;輸入名稱;然後按一下「確定」。
      • 名稱:java.awt.headless :true
      • 名稱:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin : true
      • 名稱:JAZZ_HOME :file:///JazzInstallDir/server/conf
    11. 按一下儲存,以直接儲存至主要配置。
  4. 重新啟動 WebSphere,以安裝 Jazz 應用程式

    在下列的指令行範例中,WASInstallDir 代表 WebSphere Application Server 在您伺服器上的安裝位置。

    1. 開啟您 WebSphere Application Server 的管理主控台。
    2. 按一下應用程式 -> 安裝新應用程式
    3. 新應用程式的路徑下,按一下本端檔案系統。
    4. 完整路徑下輸入:
      JazzInstallDir/server/jazz.war
    5. 環境定義根目錄設定為 /jazz。
    6. 下一步,並繼續進行其餘的安裝新應用程式步驟。
    7. 按一下完成
    8. 按一下儲存,以直接儲存至主要配置。
    9. 按一下應用程式 -> 企業應用程式
    10. 選取 jazz_war 旁的方框;按一下啟動

      此時應會出現綠色箭頭,指出已順利啟動應用程式。

下一步

在啟動伺服器之後,請繼續進行RTCz:執行設定精靈

如需這個主題的相關資訊,請造訪下列鏈結:

https://jazz.net/learn/LearnItem.jsp?href=content/tech-notes/jazz-team-server-1_0-was-setup/index.html

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ

RTCz:執行設定精靈

藉由執行設定精靈,可驗證伺服器的運作是否適當,並可引導您完成伺服器的配置步驟。

執行這項作業的原因和時機

如果要驗證 Jazz Team Server for System z 是否連接資料庫,請查看伺服器日誌或主控台輸出。連線和資料庫資訊會在其第一次存取時回應。 JazzInstallDir/server/logs 目錄是供伺服器日誌檔使用。

本程序假設使用 localhost 主機名稱和預設埠 9443,即可使用您的伺服器。必要的話,請以 您的伺服器主機名稱取代 localhost,並取代埠 9443。

啟動設定精靈,以配置您的伺服器。請使用 URL https://localhost:9443/jazz/setup
預設使用者名稱和密碼有區分大小寫:

如果您有配置 LDAP 目錄 Web 儲存器,請使用定義在您 LDAP 目錄中的 JazzAdmin 使用者身分登入。

選擇設定路徑。設定精靈有兩條主要路徑。



當完成起始設定時,您可以使用 URL https://localhost:9443/jazz/admin,從 Jazz Team Server for System z 管理 Web 使用者介面來配置其他的選項。

下一步

如果伺服器設定精靈沒有載入,請檢查下列項目:

RTCz:完成安裝

在安裝伺服器後,您必須考量某些配置選項,再繼續進行。

執行這項作業的原因和時機

在安裝之後,需額外執行少許動作。

安裝 Rational Team Concert for System z Standard Edition 與 Enterprise Edition

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

安裝 Rational Team Concert for System z Standard Edition 與 Enterprise Edition

預設配置包含的項目如下:

註: 線上說明中所提供的選用規劃工作表,有助您選擇配置以及記錄您的決策。

RTCz:準備安裝 Standard Edition 或 Enterprise Edition

在安裝伺服器之前,請驗證是否符合特殊考量。

RTCz:Linux 和 Linux for System z 的特殊指示

當 Jazz Team Server for System z 是安裝在 Linux 或 Linux for System z 上,請檢閱下列特殊指示。

RTCz:安裝 Standard Edition 或 Enterprise Edition

如果要開始進行,必須先取得安裝檔案。

執行這項作業的原因和時機

Jazz Team Server for System z、Rational Team Concert for System z 用戶端、Build System Toolkit for System z、 ClearCase Connector、ClearQuest Connector 和其他的 Incubator 檔案皆可從 http://jazz.net 下載。如果要購買 Rational Team Concert for System z,請移至 http://www.ibm.com/software/awdtools/rtcz/,其中您可以下載可安裝映像檔,或訂購 DVD。

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

RTCz:從 IBM Installation Manager 來安裝 Standard Edition 或 Enterprise Edition

在取得安裝檔案後,請啟動安裝。

執行這項作業的原因和時機

Jazz Team Server for System z、Rational Team Concert for System z 用戶端、Build System Toolkit for System z、 ClearCase Connector、ClearQuest Connector 和其他的 Incubator 檔案皆可從 http://jazz.net 下載。如果要購買 Rational Team Concert for System z,請移至 http://www.ibm.com/software/awdtools/rtcz/,其中您可以下載可安裝映像檔,或訂購 DVD。

  1. 下載下列其中一個安裝套件。請選擇目標安裝平台。

    使用 IBM Installation Manager 來安裝 Rational Team Concert for System z Standard Edition 或 Enterprise Edition 時,您有兩種方法可選。

  2. 啟動啟動程式。

    如果 Installation Manager 不在執行中,請啟動它。

    註: 您必須具備管理者專用權,才能執行啟動程式。
  3. 當啟動程式啟動時,您會看到要安裝的項目清單。請按照所列出的順序,來安裝您想使用的每一個套件。
    1. 安裝 Jazz Team Server for System z。

      當使用 IBM Installation Manager 時,請在安裝程序期間記下「位置」頁面上的安裝目錄。該目錄稱為 JazzInstallDir

      註: 如果您打算使用現有的應用程式伺服器,而不使用隨附的 Apache Tomcat 伺服器,請清除 Apache Tomcat 套件勾選框。如此做只會安裝搭配現有應用程式伺服器使用時所需的檔案。Installation Manager 會提示您選擇這些檔案的安裝位置。
    2. 選用:安裝 DB2 Workgroup Server。
      註: 雖然預設配置已包含 Derby 資料庫而不需安裝,但這個資料庫無法支援超過 10 位使用者。如果您想支援超過 10 位的使用者,但又無現有 DB2 或 Oracle 資料庫的存取權,請安裝搭售的 DB2 Workgroup Server 版本。

      如果您安裝 DB2 Workgroup Server,請記下使用者 ID、密碼和埠號。之後需用到這項資訊。在安裝期間接受預設值,可簡化 Jazz Team Server for System z 的配置。

    3. 安裝 Rational Team Concert for System z 用戶端。
    4. 選用:安裝 Build System Toolkit for System z。
    5. 選用:安裝 ClearCase Connector。
    6. 選用:安裝 ClearQuest Connector。

RTCz:從 .zip 檔來安裝 Standard Edition 或 Enterprise Edition

在取得安裝檔案後,請解壓縮內容。

執行這項作業的原因和時機

註: 當使用壓縮的保存檔來完成安裝時,請記錄解壓縮檔案時的所在目錄。該目錄稱為 JazzInstallDir

  1. 將 Rational Team Concert for System z Standard Edition 或 Enterprise Edition 伺服器的 .zip 檔下載至您的電腦中。
  2. 將套件內容解壓縮至檔案系統。
  3. 選用:安裝 DB2 Workgroup Server。
    註: 儘管預設配置已包含 Derby 資料庫而不需安裝,但是這個資料庫限制只能有 10 位使用者。如果您需要支援超過 10 位使用者,但又無現有 DB2 或 Oracle 資料庫的存取權,則應該安裝搭售的 DB2 Workgroup Server。

    如果您安裝 DB2 Workgroup Server,請記下使用者 ID、密碼和埠號。之後需用到這項資訊。在安裝期間接受預設值,可簡化 Jazz Team Server for System z 的配置。

RTCz:設定資料庫

在安裝資料庫後,需要進行配置工作。

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z
捷徑: 如果您使用內含的 Derby 資料庫,則不需額外的設定。請繼續進行RTCz:啟動伺服器

設定資料庫的步驟概述如下:

  1. 建立資料庫。
  2. 配置內容檔。
  3. 建立資料庫表格。

如果您使用任何支援的 DB2 版本,請繼續進行RTCz:設定 DB2 資料庫

如果您使用 Oracle,請繼續進行RTCz:設定 Oracle 資料庫

如果您使用 SQL Server,請繼續進行RTCz:設定 SQL Server 資料庫

RTCz:設定 DB2 資料庫

設定支援的 DB2 或搭售的 DB2 Workgroup Server 資料庫,以搭配 Jazz Team Server for System z 運作。

開始之前

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

本程序假設已符合下列必備條件。相關說明請參閱您的 DB2 文件,或向您的 DB2 資料庫管理者 (DBA) 查詢。

執行這項作業的原因和時機

如果要設定 DB2 資料庫,請執行下列動作:

  1. 在「DB2 指令視窗」中建立資料庫。 範例指令會建立一個名為 JAZZ 的新資料庫。這些指令在「DB2 指令視窗」中執行。「指令視窗」可透過應用程式「啟動」功能表下的 「DB2 指令行工具」功能表來開啟。
    註: 為了確保能適當處理 Unicode 內容,資料庫字集必須採 UTF-8 編碼。在 Windows 中,由於預設的 4K 分頁大小放不下 AUDITABLE_LINKS 表格,請將分頁大小至少設為 8K。
    提示: 如果資料庫不在執行中,db2start 指令會啟動 DB2。
  2. JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.properties 檔,並重新命名為 teamserver.derby.properties
  3. JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.db2.properties 檔,並重新命名為 teamserver.properties
  4. teamserver.properties 檔中指定資料庫和連線的詳細資料。

    預設連線規格是連接在 localhost 埠 50000 上執行的 DB2 資料庫。資料庫名稱為 JAZZ,而使用者名稱與密碼皆為 db2admin。如果您在設定資料庫時使用預設值,可能已正確配置 teamserver.properties 檔。如果不是,請變更這項資訊,以符合您的配置。

    1. 以文字編輯器開啟 teamserver.properties 檔。
    2. 找出下列字行:
      com.ibm.team.repository.db.vendor = DB2
      com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
      com.ibm.team.repository.db.jdbc.password=db2admin
    3. com.ibm.team.repository.db.jdbc.location 中,編輯您的 DB2 伺服器和資料庫值。
      提示: 在「DB2 指令視窗」中,執行 db2 get dbm cfg 指令,並找出內含 SVCENAME 的字行,其中會指出 DB2 埠名或埠號。如果這個指令顯示號碼,請用來作為埠號(以取代上述範例中的 50000)。如果指令傳回非數值的名稱,請判斷指派給這個名稱的埠號,然後使用該埠號。在 Linux 中,/etc/services 檔含有埠名和埠號之間的對映,而在 Windows 中,C:\windows\system32\drivers\etc\services 檔含有這項對映。如需相關資訊,請詢問您的資料庫管理者或查閱資料庫文件。
    4. com.ibm.team.repository.db.jdbc.location 中,編輯您的 DB2 使用者名稱值。
      註: DB2 使用者必須具備建立表格、表格空間以及修改資料庫配置的許可權。DB2 使用者由作業系統建立。
    5. com.ibm.team.repository.db.jdbc.password 內容中指定使用者密碼。
      註: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 password={password} 文字。
    6. 必要的話,請將 com.ibm.team.repository.db.db2.content.tablespace.location 內容變更為 Jazz Team Server for System z 中一個可建立主要表格空間的路徑。
      註: 如果沒有變更預設值 (content_tablespace),會將表格空間建立在資料庫儲存區位置下。在 Windows 中,如果要指定新路徑,必須使用雙反斜線來指定,例如 com.ibm.team.repository.db.db2.content.tablespace.location=c:\\db2\\jazz\\content_tablespace。

結果

您已完成資料庫的設定。請繼續進行在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格

RTCz:設定 Oracle 資料庫

設定 Oracle 資料庫以搭配 Jazz Team Server for System z 運作。

開始之前

在此假設已符合下列的必備條件。相關說明請參閱您的 Oracle 文件,或向 Oracle 資料庫管理者 (DBA) 查詢。

當在 Oracle 中執行 Jazz Team Server for System z 時,請建立 Oracle 表格空間以提升效能。您必須建立一個鏈結至該表格空間的使用者。

記住: 這些步驟皆不是由資料庫建置者使用儲存庫工具來執行。

執行這項作業的原因和時機

如果要設定 Oracle 資料庫,請執行下列動作:

  1. 建立表格空間。 表格空間位置必須適合機器和磁碟機。
    註: 表格空間可以具備下列任何內容:
    • oracle_tbs 以外的名稱
    • 另一個目錄中的位置
    • 大小超過 1GB。如果是大型安裝,必須配置更多的空間。
    下列範例顯示在 Windows 機器上執行的 create 陳述式:
    CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
    重要: 目錄路徑(以本例來說是 D:\oracle_tbs)必須存在。不需建立個別的特殊表格空間。您可以使用 Oracle 預設 USERS 表格空間,不過,如果能在它所管理的磁碟上預先配置一個空間,Oracle 的效能會更好。
  2. 建立 Oracle 使用者。

    在建立表格空間後,必須為 Jazz 建立一個特殊的 Oracle 使用者,以使用 Oracle 資料庫。

    在本例中,使用者的名稱為 jazzDBuser,密碼(以 Oracle 詞彙來說是 IDENTIFIED BY)為 jazzDBpswd,且其存在於您在1中所建立的表格空間中。
    CREATE USER jazzDBuser IDENTIFIED BY jazzDBpswd DEFAULT TABLESPACE oracle_tbs
    在建立使用者之後,應授與使用者在起始設定 Jazz 資料庫時所需的必要許可權。以下的 SQL 指令可用來授與適當的許可權:
    GRANT CREATE SESSION TO jazzDBuser;
    GRANT CREATE TABLE, ALTER ANY TABLE, DROP ANY TABLE, CREATE ANY INDEX, ALTER ANY INDEX, DROP ANY INDEX TO jazzDBuser;
    GRANT INSERT ANY TABLE, UPDATE ANY TABLE, DELETE ANY TABLE TO jazzDBuser;
    GRANT CREATE PROCEDURE TO jazzDBuser;
    GRANT CREATE VIEW TO jazzDBuser;
  3. JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.properties 檔,並重新命名為 teamserver.OtherDBProvider.properties
  4. JazzInstallDir/server/conf/jazz 目錄中找出 teamserver.oracle.properties 檔,並重新命名為 teamserver.properties
    提示: 重新命名原始 teamserver.properties 檔可讓您將檔案還原成先前的工作版本。依預設,「資料庫提供者」為 derby
  5. 配置伺服器
    1. 如果您使用不同的使用者名稱、密碼或資料庫名稱、將 Oracle 伺服器安裝在 Jazz Team Server for System z 以外的機器上,或者使用非預設埠,請編輯伺服器配置檔。開啟 JazzInstallDir/server/conf/jazz 目錄中的 teamserver.properties 檔,並變更下列資訊以符合您的設定。

      com.ibm.team.repository.db.vendor = ORACLE

      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/ORCL

      將 jazzDBuser 變更為建立給 Jazz 以使用 Oracle 資料庫的使用者。如果您使用本端主機,請移除位於字行開頭的 #,以解除註解該字行,並且註解下一個位置行。本端主機連線字串不應包含前導的 //。請將 1521 變更成您 Oracle 伺服器機器的 TCIP 埠。將 ORCL 變更為您的 Oracle 資料庫名稱。

      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@//oracleserver.example.com:1521/ORCL

      如果您使用非本端主機連線,請移除位於字行開頭的 #,以解除註解該字行,並且註解下一個位置行。非本端主機連線字串必須包含前導的 //。

      com.ibm.team.repository.db.jdbc.password=jazzDBpswd

      將 jazzDBpswd 變更為建立給 Jazz 以使用 Oracle 資料庫的使用者密碼。

      重要: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 {password} 文字。com.ibm.team.repository.db.jdbc.password 內容中必須指定使用者密碼。

      如果您使用 Oracle Express,請使用 1521 作為 TCIP 埠,以及使用 XE 作為 Oracle 資料庫名稱:

      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:jazzDBuser/{password}@localhost:1521/XE
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    2. 在和伺服器 Script 相同的目錄中 (JazzInstallDir/server),建立一個名為 oracle 的目錄。
    3. 找出 Oracle JDBC 驅動程式 JAR 檔 ojdbc14.jar。位置可能因 Oracle 產品和作業系統而有不同。將這個檔案複製至 oracle 目錄。
      註: 如果您使用 WebSphere Application Server,請配置一個名為 "ORACLE_JDBC" 的內容;然後將它設定為 Oracle JDBC 驅動程式的絕對檔案路徑(非 URL)。這項作業會在 WebSphere Application Server 設定指示中說明。記下檔案路徑,以便之後在這些指示中使用。

結果

您已完成資料庫的設定,而可繼續進行在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格

RTCz:設定 SQL Server 資料庫

設定 SQL Server 資料庫,以搭配 Jazz Team Server for System z 運作。

本程序假設您已符合下列的必備條件:

記住: JazzInstallDir/server/teamserver.properties 檔中,所定義的 SQL Server 資料庫預設登入名稱是 jazzDBuser,預設密碼是 jazzDBpswd。在建立資料庫時,會在以下的步驟中使用這些值。您可以將這些值換成您資料庫的使用者名稱與密碼。

設定資料庫

本節說明如何使用 SQL Server 安裝提供的指令行工具 sqlcmd,來設定 SQL Server 資料庫。您也可以使用視覺化工具,以 SQL Server Studio Management 為例,就可以當成 SQL Server Studio Management Express 在 Express 版中使用。如需相關資訊,請參閱 SQL Server 文件或詢問 SQL Server 資料庫管理者 (DBA)。

如果要使用 指令工具 sqlcmd 來設定 SQL Server 資料庫,請執行下列動作:

  1. 建立 Jazz Team Server for System z 資料庫。請從指令行工具鍵入:
    CREATE DATABASE jazz
    GO 
  2. 建立使用者和密碼,並變更 Jazz Team Server for System z 資料庫的所有權。請從指令行工具鍵入:
    CREATE LOGIN jazzDBuser
    WITH PASSWORD = 'jazzDBpswd';
    USE jazz;
    exec sp_changedbowner 'jazzDBuser'
    GO 
  3. 建立 Jazz Team Server for System z 資料庫對照。請從指令行工具鍵入:
    ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS
    GO

配置伺服器

記住: 依預設,JazzInstallDir/server 目錄中的 teamserver.properties 檔不是設定成連接 SQL Server 資料庫。所有的預設值以及 SQL Server 特定的設定全包含在同一目錄的 teamserver.sqlserver.properties 檔中。

如果要配置伺服器,請執行下列動作:

  1. 重新命名下列檔案:
    提示: 重新命名原始 teamserver.properties 檔可讓您將檔案還原成先前的工作版本。依預設,「資料庫提供者」為 derby
  2. 如果您使用不同的使用者名稱、密碼或資料庫名稱、將 SQL Server 安裝在 Jazz Team Server for System z 以外的機器上,或者使用非預設埠,請編輯伺服器配置檔。開啟 JazzInstallDir/server/conf/jazz 目錄中的 teamserver.properties 檔,並變更下列資訊以符合您的設定。
    com.ibm.team.repository.db.vendor = SQLSERVER
    com.ibm.team.repository.db.jdbc.location=//SQL SERVER MACHINE IP:SQL SERVER TCIP PORT;databaseName=JAZZ DATABASE NAME;user=JAZZ USERNAME;password={password}
    com.ibm.team.repository.db.jdbc.password=JAZZ LOGIN PASSWORD
    重要: 請勿變更 com.ibm.team.repository.db.jdbc.location 內容中的 password={password} 文字。com.ibm.team.repository.db.jdbc.password 內容中必須指定使用者密碼。

如果要指定 JDBC 的 JAR 檔位置,請執行下列動作:

  1. 在和伺服器 Script 相同的目錄 (JazzInstallDir/server) 中,建立名為 sqlserver 的目錄。
  2. 找出名為 sqljdbc.jar 的 SQL Server JDBC 驅動程式 JAR 檔。如「必備條件」小節中所述,位置可能因驅動程式安裝所在而異。將檔案複製至新建的 sqlserver 目錄。
  3. 完成下列作業,以指定 JDBC 的 JDBC JAR 檔位置:

您已完成資料庫的設定。現在,請建立 Jazz Team Server for System z 資料庫表格。如需相關資訊,請參閱在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格

疑難排解

如果 repotools 指令沒有成功,請檢查 JazzInstallDir/server 目錄中名為 repotools_createTables.log 的日誌檔。

此外,請驗證下列:

註: 為了能在多種資料庫平台上執行,Jazz Team Server for System z 的資料庫碼為通用和標準設計;不過,各企業資料庫供應商在語法、最佳化策略和鎖定語意方面仍有差異。在 SQL Server 上,已使用各種自動測試組合,並模擬正常的工作量和壓力測試,來測試伺服器。模擬正常工作量的結果,顯示效能是可接受的。在某些實例中,在自動化並行測試中觀察到資料庫死鎖;不過這些並未同樣重現上不同的伺服器硬體上。

依照設計,伺服器可服務大量的同步要求。在某些異常的情況中,儲存資料庫中可能發生死鎖,這是因為要求的相關聯交易中同時更新了類似或同等的物件。這類事件罕見但仍屬正常。 依照設計,系統會有相對的防禦措施,並維護資料完整性;資料不會遺失。建置引擎執行等之類的作業偶爾會記載死鎖。一般來說,偵測到狀況時,會重試作業。死鎖可能導致建置失敗。在某些相當罕見的情況中,可能是使用工作項目或原始碼等之類的使用者動作,而這可藉由中斷來解決死鎖。在該情況下,使用者動作將會失敗,並顯示內含死鎖詳細資料的錯誤給使用者。 之後使用者可重試該動作。

所遇到的所有死鎖都會記載在伺服器上,以提供發生死鎖時的相關現象資訊。日誌項目中的文字類似如下:com.ibm.team.repository.common.RetryableDatabaseException: 序列化失敗

如果您的系統遇到死鎖,請參閱位於下列位置的錯誤日誌:https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog

如果您常常遇到死鎖異常狀況,請聯絡您的產品支援人員,或檢查 jazz.net 論壇中的最新資訊、更新項目或移轉技術。

在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格

使用儲存庫工具來建立資料庫表格。

執行這項作業的原因和時機

如果要建立資料庫表格,請執行下列動作:

  1. 執行 repotools -createTables 指令,為 Jazz 儲存庫建立資料庫表格。

    repotools 檔位於 JazzInstallDir/server。

    這個指令在連線和大小設定方面,會使用 teamserver.properties 中的配置內容。依預設,指令會查看現行目錄。teamserver.properties 參數可用來參照不同的內容檔。

    這個指令會為 Jazz Team Server for System z 儲存庫建立表格空間,以及所有必要的表格與索引。
  2. 在建立資料庫表格後,您必須停止並重新啟動資料庫,以確保所有的變更都會生效。
    提示: 僅適用於 DB2。停止並啟動 DB2 的範例指令為 db2stop 和 db2start。這些指令是在 「DB2 指令視窗」中執行。「指令視窗」可透過應用程式「啟動」功能表下的 「DB2 指令行工具」階層式功能表來開啟。

結果

您已完成資料庫的設定,而可繼續進行RTCz:啟動伺服器

RTCz:啟動伺服器

這個主題說明執行伺服器啟動 Script 時所用的各種選項。

執行這項作業的原因和時機

如果您打算使用隨附的 Apache Tomcat 應用程式伺服器,可準備啟動 Jazz Team Server for System z。

如果您打算使用 WebSphere Application Server,請按照RTCz:設定 WebSphere Application Server中的說明來設定您的伺服器環境。

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

RTCz:啟動 Apache Tomcat 伺服器

現在,您可以準備啟動 Apache Tomcat 伺服器。

註: 這些指示不適用於 z/OS 上所安裝或配置的組件。 關於在 z/OS 上安裝和配置,請參閱在 z/OS 上安裝 Rational Team Concert for System z

Apache Tomcat 已安裝在 JazzInstallDir/server/tomcat 目錄。Web 應用程式 (jazz.war) 已安裝在 Apache Tomcat 目錄 webapps。在指令視窗中,將您的現行目錄設定為 JazzInstallDir/server。伺服器的啟動和關閉 Script 位於這個目錄中。

在 Windows 上啟動伺服器

請執行啟動檔,以便在 Windows 上啟動您的伺服器。

執行這項作業的原因和時機

  1. 如果要啟動伺服器,請從 JazzInstallDir/server 目錄執行下列指令:
    server.startup.bat
    註: 這時會開啟個別的 Apache Tomcat 主控台視窗。請勿關閉此視窗,否則伺服器將停止運作。此外,會啟動數則參考訊息,包含有關 Apache Tomcat 原生程式庫的訊息。這些參考訊息不會影響 Jazz Team Server for System z 的功能。
  2. 如果要停止伺服器,請從 JazzInstallDir/server 目錄執行下列指令:
    server.shutdown.bat

下一步

註: 上述範例是直接從 JazzInstallDir/server 目錄執行啟動和停止 Script。如果您是使用 IBM Installation Manager 來安裝 Jazz Team Server for System z,也可以從 Jazz Team Server for System z Windows 開始功能表來執行指令。

在啟動伺服器之後,請繼續進行RTCz:執行設定精靈

在 Linux 或 Linux for System z 上啟動伺服器

請執行啟動檔,以便在 Linux 或 Linux for System z 上啟動伺服器。

執行這項作業的原因和時機

  1. 如果要啟動伺服器,請以 root 使用者身分從 JazzInstallDir/server 目錄執行下列指令:
    ./server.startup
    如果您的使用者 ID 具備管理者存取權,請執行以下指令:
    sudo ./server.startup

    並不會顯現個別的 Apache Tomcat 主控台視窗。您可以檢視 JazzInstallDir/server/logs/jazz.log 中的日誌檔,以檢查伺服器啟動進度。

  2. 如果要停止伺服器,請以 root 使用者身分從 JazzInstallDir/server 目錄執行下列指令:
    ./server.shutdown
    如果您的使用者 ID 具備管理者存取權,請執行以下指令:
    sudo ./server.shutdown

下一步

註: 這個範例是直接從 JazzInstallDir/server 目錄執行啟動和停止 Script。如果您是使用 IBM Installation Manager 來安裝 Jazz Team Server for System z,也可以從 Jazz Team Server for System z 應用程式啟動功能表來執行指令。

在啟動伺服器之後,請繼續進行RTCz:執行設定精靈

在當成 Windows 服務的 Apache Tomcat 中執行 Jazz Team Server for System z

Apache Tomcat 能夠當成 Windows 服務來執行。如果您希望不必登入就能在 Windows 型機器上執行 Jazz Team Server,這種作法就可以派上用場。

開始之前

這個主題假設您的 Jazz Team Server for System z 部署位於 C:\jazz 根目錄;請根據您的實際根目錄來調整路徑。

  1. 開啟命令提示字元,並執行下列指令,以安裝 Tomcat 服務。
    C:\jazz\server\tomcat\bin\service.bat install
  2. 如果您使用 Derby 作為 Jazz 儲存庫的資料庫,請編輯 C:\jazz\server\conf\jazz\teamserver.properties,讓資料庫位置是一個絕對路徑。例如,將 db.jdbc.location 的值改為 C:\jazz\server\repositoryDB
  3. 執行 C:\jazz\server\tomcat\bin\tomcat5w.exe,以配置服務。
  4. 按一下 Java 標籤,並取消勾選使用預設值勾選框。
  5. 將下列路徑新增至 Java 虛擬機器。您也可以按一下省略符號圖示,瀏覽並找出 jvm.dll 檔。
    C:\jazz\server\jre\bin\j9vm\jvm.dll
  6. 將下列字行新增至 Java 選項文字欄位底端。
    -DJAZZ_HOME=file:///c:/jazz/server/conf
    -Djava.awt.headless=true 
    -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true 
    -Dcom.ibm.team.repository.tempDir=%TEMP%
    如果您使用 Oracle 資料庫,請新增下列字行:
    -DORACLE_JDBC=[Oracle JDBC 驅動程式 JAR 的路徑]
    如果您使用 SQL Server 資料庫,另請新增下列字行:
    -DSQLSERVER_JDBC=[SQL Server JDBC 驅動程式 JAR 的路徑]
  7. 記憶體儲存區上限大小變更為 700。
  8. 啟動關閉標籤中,確定已在模式設定中選取 jvm
  9. 如果您希望服務會隨 Windows 自動啟動,請按一下一般標籤,並將啟動類型變更為自動
  10. 啟動服務,以測試伺服器。

將 Jazz Team Server for System z 部署至現有的 Apache Tomcat

這個主題說明如何設定 Jazz Team Server for System z,以使用現有的 Apache Tomcat 伺服器。

執行這項作業的原因和時機

如果要將 jazz.war 檔部署至現有的 Apache Tomcat 伺服器,請遵循下列步驟:

  1. 將 jazz.war 檔從 JazzInstallDir 複製至 tomcat\webapps 目錄。
  2. 開啟要編輯的 Tomcat 啟動檔,並新增以下的系統內容設定:
    set CATALINA_OPTS=-Dcom.ibm.team.server.configURL=file:///"%cd%"/teamserver.properties -Dlog4j.configuration=file:///"%cd%"/log4j.properties
    set JAVA_OPTS=-Djava.awt.headless=true -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -Dcom.ibm.team.repository.provision.profile="%cd%"\provision_profiles -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M
  3. 儲存並關閉啟動檔。
  4. 開啟並編輯 teamserver.properties 檔,以指向您的資料庫。
  5. 儲存並關閉 teamserver.properties。

RTCz:設定 WebSphere Application Server

這個主題說明如何設定 Jazz Team Server for System z 以搭配 WebSphere Application Server 運作。這項設定會假設您是將 Jazz Team Server for System z 安裝在和 Websphere Application Server 相同的機器上。

開始之前

在開始進行這些步驟前,應先完成下列:

執行這項作業的原因和時機

註: 本文件不提及較複雜的 WebSphere 鑑別或 SSL 配置主題。有關 WebSphere 各種鑑別和加密選項的詳細資訊,可在「WebSphere 資訊中心」找到。如需相關資訊,請跳至 WebSphere 資訊中心,並搜尋維護應用程式和其環境的安全 (Securing applications and their environment)。Jazz Web 使用者介面需要配置鑑別,才能執行鑑別並將應用程式個人化。

  1. 檢閱並更新 teamserver.properties 檔中的資料庫位置
    com.ibm.team.repository.db.vendor = DB2
    com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:user=db2admin;password={password};
    com.ibm.team.repository.db.jdbc.password=db2admin
    註: 這是 DB2 配置範例。在更新 teamserver.properties 時,應視資料庫供應商 (Oracle/MS-SQL) 而定。
  2. 驗證或更新 WebSphere Application Server 層次。

    Jazz Team Server for System z 要求必須已安裝套用了 IBM Java SDK 1.5 SR5(或更新版本)累加修正程式的 WebSphere Application Server 6.1 版,或是 WebSphere Application Server 7.0 版(且至少必須是 7.0.0.3)。IBM Java SDK 1.5 SR6 SDK 的更新可從 http://www-1.ibm.com/support/docview.wss?rs=180&uid=swg24017492 取得。如果使用 WebSphere 6.1 和 GA IBM Java SDK,Jazz 在執行一些作業後就會開始回報 "Proxy 錯誤"。

    您必須取得 IBM Java SDK 1.5 SR9 或 IBM Java SDK 1.6 SR4 修正程式的對應 WebSphere Application Server 臨時修正程式,Rational Team Concert for System z 2.0 才能正確執行。否則,伺服器中的某些服務可能無法正確啟動。臨時修正程式可以在其對應的 WebSphere Application Server APAR 中取得。如果是 IBM Java SDK 1.5/WebSphere Application Server 6.1,APAR 為 PK85942,而您可以從 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK85942/ 下載這些檔案。在安裝 JRE 臨時修正程式之前,請至少先安裝 WebSphere Application Server 6.1 Fixpack 19。如果是 IBM Java SDK 1.6/WebSphere Application Server 7.0,APAR 是 PK 86771,而您可以從 ftp://ftp.software.ibm.com/software/websphere/appserv/support/fixes/PK86771/ 下載這些檔案。

  3. 更新 JVM 引數。

    Jazz Team Server for System z 需要在其執行所在的 Java 虛擬機器上進行一些特定的設定。

    首先,它需要知道某些配置檔的位置。作法是設定 JAZZ_HOME 系統內容。這個內容使用 URL 而非簡式路徑,因此應將值指定為 file://-style URL。

    Jazz JVM 所需的第二個內容是使用 -Xmx 設定,為它提供比預設最大記憶體配置還多的記憶體。這應根據伺服器支援的團隊大小以及 Jazz Team Server for System z 執行所在的伺服器記憶體容量來設定。一般中等大小的團隊可使用值 -Xmx1000M,這是提供 1000 MB 的資料堆記憶體給 Jazz Team Server for System z 程序。

    如果您連接 Oracle 或 SQL Server 資料庫,還需新增一個名為 "ORACLE_JDBC" 或 "SQLSERVER_JDBC" 的內容。請將這個內容設定為 JDBC 驅動程式的絕對檔案路徑 (非 URL)。

    您還需要設定另外兩個系統內容,以控制伺服器的某些行為;請見以下的說明。以下是在 WebSphere 管理主控台中設定這些 JVM 內容的細節說明,藉以將 JazzInstallDir 換成您的 Jazz Team Server for System z 安裝目錄:

    1. 按一下伺服器 -> 應用程式伺服器.
    2. 按一下 server1
    3. 按一下 Java 和程序管理 -> 程序定義
    4. 按一下 Java 虛擬機器
    5. 起始資料堆中,新增值 100。
    6. 資料堆大小上限中,新增值 1000。
    7. 按一下套用
    8. 按一下記載和追蹤。按一下變更日誌的詳細程度。Jazz Team Server for System z 採用 BIRT 報告引擎。如果要防止將 BIRT 參考項目寫入至 WebSphere 日誌檔,請將 org.eclipse.birt.* 套件的日誌記載層次設定為嚴重。按一下套用
    9. 按一下自訂內容
    10. 新增下列內容: 按一下新建;輸入名稱;然後按一下「確定」。
      • 名稱:java.awt.headless :true
      • 名稱:org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin : true
      • 名稱:JAZZ_HOME :file:///JazzInstallDir/server/conf
    11. 按一下儲存,以直接儲存至主要配置。
  4. 重新啟動 WebSphere,以安裝 Jazz 應用程式

    在下列的指令行範例中,WASInstallDir 代表 WebSphere Application Server 在您伺服器上的安裝位置。

    1. 開啟您 WebSphere Application Server 的管理主控台。
    2. 按一下應用程式 -> 安裝新應用程式
    3. 新應用程式的路徑下,按一下本端檔案系統。
    4. 完整路徑下輸入:
      JazzInstallDir/server/jazz.war
    5. 環境定義根目錄設定為 /jazz。
    6. 下一步,並繼續進行其餘的安裝新應用程式步驟。
    7. 按一下完成
    8. 按一下儲存,以直接儲存至主要配置。
    9. 按一下應用程式 -> 企業應用程式
    10. 選取 jazz_war 旁的方框;按一下啟動

      此時應會出現綠色箭頭,指出已順利啟動應用程式。

下一步

在啟動伺服器之後,請繼續進行RTCz:執行設定精靈

如需這個主題的相關資訊,請造訪下列鏈結:

https://jazz.net/learn/LearnItem.jsp?href=content/tech-notes/jazz-team-server-1_0-was-setup/index.html

https://jazz.net/wiki/bin/view/Main/WASSetupFAQ

RTCz:執行設定精靈

藉由執行設定精靈,可驗證伺服器的運作是否適當,並可引導您完成伺服器的配置步驟。

執行這項作業的原因和時機

如果要驗證 Jazz Team Server for System z 是否連接資料庫,請查看伺服器日誌或主控台輸出。連線和資料庫資訊會在其第一次存取時回應。 JazzInstallDir/server/logs 目錄是供伺服器日誌檔使用。

本程序假設使用 localhost 主機名稱和預設埠 9443,即可使用您的伺服器。必要的話,請以 您的伺服器主機名稱取代 localhost,並取代埠 9443。

啟動設定精靈,以配置您的伺服器。請使用 URL https://localhost:9443/jazz/setup
預設使用者名稱和密碼有區分大小寫:

如果您有配置 LDAP 目錄 Web 儲存器,請使用定義在您 LDAP 目錄中的 JazzAdmin 使用者身分登入。

選擇設定路徑。設定精靈有兩條主要路徑。



當完成起始設定時,您可以使用 URL https://localhost:9443/jazz/admin,從 Jazz Team Server for System z 管理 Web 使用者介面來配置其他的選項。

下一步

如果伺服器設定精靈沒有載入,請檢查下列項目:

RTCz:完成安裝

在安裝伺服器後,您必須考量某些配置選項,再繼續進行。

執行這項作業的原因和時機

在安裝之後,需額外執行少許動作。

在 z/OS 上安裝 Rational Team Concert for System z

這項資訊提供在 z/OS 上配置 Jazz Team Server for System z® 的逐步指示。

這些指示適用於負責在 z/OS 上安裝與維護 Jazz Team Server for System z 的系統管理者。為了瞭解這些指示,您應該熟悉 Windows 與 z/OS 作業系統。如果您使用 Tomcat 和 Derby,您可以跳到Jazz Team Server for System z 搭配 Tomcat 與 Derby 執行

在 z/OS 上,是利用 SMP/E 來執行 Rational Team Concert for System z 的安裝作業。 總共有四個 FMID。 您可以根據您的伺服器配置,選擇只安裝您需要的 FMID。 請遵循安裝之元件的自訂指示。 這些元件如下:

FMID HAHA200
Jazz Team Server for System z。在 z/OS 上執行 Jazz Team Server for System z 時所需要。
FMID HAHB200
Build System Toolkit for System z。Jazz 閘道、Jazz Build Engine、Antz 建置、大量匯入、SCM 指令行所需要。

如需使用 Build System Toolkit for System z 的其他資訊,請參閱下列主題:

FMID HAHC200
工作監視器。監視 JCL 型建置時所需要。

如需「工作監視器」的詳細資訊,請參閱下列主題:

FMID HAHD200
Rational Build Agent。搭配 HAHB200 和 HAHC200 來使用 z/OS Antz、JCL 或指令行建置支援時所需要。

如需 Rational Build Agent 的詳細資訊,請參閱下列主題:

如需如何配置 Rational Team Concert for System z 來使用 Rational Developer for System z 的指示,請參閱「Rational Team Concert for System z 資訊中心」 的安裝和配置整合,位置如下:http://publib.boulder.ibm.com/infocenter/rtczhelp/v2r0m0/index.jsp。

軟體需求

您必須先確定必備應用程式已安裝並且可以運作,才能在 z/OS 上安裝 Rational Team Concert for System z。請注意選用的軟體需求。就 Jazz Team Server for System z 來說,您必須配置一個應用程式伺服器與資料庫,才能使用 Jazz Team Server for System z。

關於詳細系統需求,請參閱詳細系統需求

提示: 這些指示會根據您選擇的應用程式伺服器與資料庫組合,指出特定步驟為必要或選用的。

如果您的資料庫使用 DB2,您必須利用 DB2 for z/OS 9.1 版,且配置 Universal JDBC 驅動程式,以確保資料庫與 z/OS 之間的交互作業能力。2

附註:
  1. 如需內含「JZOS Java 啟動程式與工具箱」 之 IBM 31 位元 SDK for z/OS Java 2 Technology Edition 第 5 版的相關資訊,請參閱 IBM 31-bit SDK for z/OS Java 2 產品頁面,其網址是 http://www.ibm.com/servers/eserver/zseries/software/java/j5pcont31.html。需具備「JZOS Java 啟動程式」才能執行 Jazz Team Server 儲存庫工具。如需「JZOS 批次啟動程式」的相關資訊,請參閱安裝和使用手冊,網址為 http://www.ibm.com/servers/eserver/zseries/software/java/pdf/jzosinstal.pdf。
  2. 請參閱使用 DB2 Universal JDBC 驅動程式來存取 DB2 for z/OS

SMP/E 安裝

請利用 IBM System Modification Program/Extended(或 SMP/E),將軟體及軟體變更安裝在 z/OS 系統上。

這個主題的相關指示假設您已安裝 the Rational Team Concert for System z System Modification Program/Extended (SMP/E)。 SMP/E 指示位於隨附於產品下載套件的「程式目錄」中,或在 Web 上,位置如下:http://www.ibm.com/support/docview.wss?&uid=swg27016631

註: 「程式目錄」會參照特定的路徑名稱。 如果您將檔案解壓縮至不同的位置,就必須更新路徑名稱,以符合您的位置。

SMP/E 安裝作業會安裝兩個 MVS™ 資料集:分別是 hlq.SBLZSAMPhlq.SBLZAUTH,其中 hlq 是您在安裝 SMP/E 期間選擇的高階限定元。 如同「程式目錄」中的附註,hlq.SBLZAUTH 應已獲得 APF 授權。 而在 hlq.SBLZSAMP 資料集中,可找到一些涉及編輯與提交 JCL 的許多其他配置步驟。

SMP/E 安裝作業也會安裝一個 z/OS UNIX® 系統服務檔案目錄 /@pathPrefix@/usr/lpp/jazz/v2.0

註: /@pathPrefix@ 是您在安裝 SMP/E 期間指定的路徑字首。

SMP/E 安裝作業也會安裝下列 Rational Team Concert for System z 元件:

在完成 SMP/E 安裝之後,請執行下列作業:

配置安裝

您必須先確定 SMP/E 安裝作業已順利結束,才能在 z/OS 上配置 Rational Team Concert for System z。

執行這項作業的原因和時機

如果您使用 Java 5 或 Java 6 的 64 位元版本,您必須增加會影響 JVM 所能使用之共用記憶體頁數的設定。 您可以利用 D OMVS,L 指令來尋找 USS 系統參數。 受影響的參數如下:

註: 如果您同時執行多部伺服器,請將這些參數所設的值乘以執行的伺服器數目。

建立其他的 Jazz Team Server 目錄(必要)

除了 SMP/E 安裝作業所建立的 USS 目錄外,z/OS 上的 Jazz Team Server 還需要兩個目錄。一個是用來儲存 Jazz Team Server for System z 配置檔的目錄,另一個是工作目錄。hlq.SBLZSAMP 中的範例成員 BLZCPDIR 用來建立這些目錄,並從 SMP/E 安裝目錄移入必要的檔案。

以下的三個符號參照廣泛用於這本手冊中,以參照這些特定的目錄:

符號名稱 用途 在 BLZCPDIR 中的變數 預設目錄
@pathPrefix@ 安裝 SMP/E 期間指定的路徑字首。 HOME
@confPath@ Jazz Team Server for System z 配置檔目錄。 CONF /etc/jazz
@workPath@ Jazz Team Server for System z 工作目錄。 WORK /u/jazz

空間建議:

Jazz Team Server for System z 目錄應具備以下的配置:

@workPath@
700 個磁柱 3390,用來在 z/OS 上執行 Jazz Team Server for System z
@confPath@
2 個磁柱 3390
RACF 檔案存取需求: Jazz Team Server for System z 目錄需要以下的 RACF 檔案存取權:
  1. @confPath@ 必須可供執行 Tomcat 伺服器或 WebSphere Application Server 時所用的使用者 ID 讀取和寫入。
  2. @workPath@ 必須可供執行 Tomcat 伺服器或 WebSphere Application Server 時所用的使用者 ID 讀取和寫入。
  3. @workPath@ 必須可供執行 Jazz Team Server for System z 儲存庫工具時所用的使用者 ID 讀取和寫入。

利用成員所包含的指示,在 hlq.SBLZSAMP 中配置 BLZCPDIR 成員。 利用 SUBMIT 指令來提交已修改的 JCL 及檢查工作日誌。 如果您已正確設定所有項目,所有步驟結束時,回覆碼都是 0。

小心: BLZCPDIR 成員包含 @jazzgrp@ 變數,您應該將它設為 SAF 群組,其中含有所有需要配置和工作目錄之寫入權的使用者 ID。 另外,您也必須將群組 ID (GID) 關聯於這個 SAF 群組。

自訂配置檔

有些 Jazz Team Server for System z 配置檔,必須根據您選給 @pathPrefix@@workPath@@confPath@ 的目錄,來加以修改。本節中的主題提供修改配置檔的指示。

Jazz Team Server for z/OS 內容檔為 ASCII 檔案。您可以使用下列其中一項技術,在z/OS UNIX 下編輯 ASCII 檔案:

自訂供應設定檔

這個主題說明您必須在供應設定檔中變更哪些項目,以便自訂它們。

執行這項作業的原因和時機

如果您使用 @pathPrefix@,應該編輯下列檔案:

@confPath@/jazz/provision_profiles/profile.ini
url=file:/usr/lpp/jazz/v2.0/server/update-site 變更

url=file:/@pathPrefix@/usr/lpp/jazz/v2.0/server/update-site

比方說,如果 @pathPrefix@ 設為 myroot,這項設定便解析為 url=file:/myroot/usr/lpp/jazz/v2.0/server/update-site

@confPath@/jazz/provision_profiles/rtcz-license-profile.ini
url=file:/usr/lpp/jazz/v2.0/server/license-update-site 變更

url=file:/@pathPrefix@/usr/lpp/jazz/v2.0/server/license-update-site
.

比方說,如果 @pathPrefix@ 設為 myroot,這項設定便解析為 url=file:/myroot/usr/lpp/jazz/v2.0/server/license-update-site

@confPath@/jazz/provision_profiles/nl1profile.ini
url=file:/usr/lpp/jazz/v2.0/server/nl1-update-site 變更

url=file:/@pathPrefix@/usr/lpp/jazz/v2.0/server/nl1-update-site

比方說,如果 @pathPrefix@ 設為 myroot,這項設定便解析為 url=file:/myroot/usr/lpp/jazz/v2.0/server/nl1-update-site

@confPath@/jazz/provision_profiles/nl2profile.ini
url=file:/usr/lpp/jazz/v2.0/server/nl2-update-site 變更

url=file:/@pathPrefix@/usr/lpp/jazz/v2.0/server/nl2-update-site

比方說,如果 @pathPrefix@ 設為 myroot,這項設定便解析為 url=file:/myroot/usr/lpp/jazz/v2.0/server/nl2-update-site

@confPath@/jazz/provision_profiles/rtcz-profile.ini
url=file:/usr/lpp/jazz/v2.0/server/update-site 變更

url=file:/@pathPrefix@/usr/lpp/jazz/v2.0/server/update-site

比方說,如果 @pathPrefix@ 設為 myroot,這項設定便解析為 url=file:/myroot/usr/lpp/jazz/v2.0/server/update-site

自訂記載公用程式檔案

@confPath@/jazz/log4j.properties 檔會配置 Jazz Team Server for System z 所用的記載架構。

依預設,log4j.properties 檔會將 Jazz Team Server 訊息寫到 Tomcat 應用程式伺服器 stdout 檔(通常是應用程式伺服器工作日誌),以及寫到 log4j.properties 檔中指定的個別檔案內。請編輯 @confPath@/jazz/log4j.properties 檔,找出下列字行:

log4j.appender.file.File=@workPath@/logs/jazz.log 

此行應該更新以反映 Jazz Team Server for System z@workPath@ 目錄中您正在使用的值,例如:

log4j.appender.file.File=/u/jazz/logs/jazz.log

當您配置安裝架構時,應該將 log4j.properties 檔的位置新增到 Java 選項中。 如需詳細資訊,請參閱「Rational Team Concert for System z 資訊中心」的 Antz 建置疑難排解,位置如下:http://publib.boulder.ibm.com/infocenter/rtczhelp/v2r0m0/index.jsp。

設定資料庫

這個主題提供在 z/OS 上設定 DB2 資料庫的相關資訊。

開始之前

如果您在 z/OS 上使用 Derby 資料庫,而不是 DB2,您可以跳到Jazz Team Server for System z 搭配 Tomcat 與 Derby 執行

執行這項作業的原因和時機

這些指示說明如何連接到 z/OS 上的 DB2。 DB2 設定作業應該由 DB2 管理者來執行。

DB2 必要條件

請確定內含 Universal JDBC 驅動程式的 DB2 for z/OS 9.1 版,已安裝在要作為資料庫伺服器的 z/OS 系統上,並且正在執行。這可能不是執行 Jazz Team Server 的相同系統。

Jazz Team Server for System z 要求 DB2 的 SYSPROC.DSNUTILS 與 SYSIBM.SQLxxx 儲存程序的相關聯 WLM 程序處於作用中。必要的話,請將 DB2 WLM 環境變數的名稱與作用中 WLM 程序相比較,以驗證儲存程序是否為作用中。請使用 SQL SELECT 指令,透過 DB2 SPUFI 或您偏好的技術來擷取 WLM 程序名稱。

SELECT DISTINCT WLM_ENVIRONMENT FROM SYSIBM.SYSROUTINES WHERE  
  (NAME='DSNUTILS' OR (SCHEMA='SYSIBM' AND NAME LIKE 'SQL%'));  

這個指令會產生類似如下的結果:

---------+---------+---------+---------+---------+---------+---
WLM_ENVIRONMENT                                                
---------+---------+---------+---------+---------+---------+---
DSN9WLM1  

請從 z/OS 主控台,使用下列指令來顯示 WLM 作用中程序:D WLM,APPLENV=*。這個指令會產生類似如下的結果:

SDSF SYSLOG   2493.101 2094 2094 07/10/2008 0W   14886  COMMAND ISSUED
 RESPONSE=RALNS32                                                      
  IWM029I  16.31.12  WLM DISPLAY 465                                   
    APPLICATION ENVIRONMENT NAME     STATE     STATE DATA              
    BBOASR1                          AVAILABLE                         
    BBOASR2                          AVAILABLE                         
    BBOC001                          AVAILABLE                         
    CBINTFRP                         AVAILABLE                         
    CBNAMING                         AVAILABLE                         
    CBSYSMGT                         AVAILABLE                         
    DSN9WLM1                         AVAILABLE                         
    DSN9WLM2                         AVAILABLE                         
    DSN9WLM3                         AVAILABLE          

在本例中,您可以看到 DSN9WLM1 程序處於作用中。

設定 DB2 for z/OS,以搭配 Jazz Team Server for System z 使用

當 Jazz Team Server for System z 搭配 DB2 for z/OS 執行時,您必須建立一個 DB2 儲存體群組與 DB2 資料庫。您也必須授權 Jazz Team Server for System z 使用者使用該儲存體群組與資料庫。

執行這項作業的原因和時機

在您執行儲存庫工具資料庫建置器公用程式,以便在資料庫實例中建立 Jazz 儲存庫表格之前,必須先執行下列步驟。 Jazz Team Server 資料庫建置器公用程式不會執行任何這些步驟。

建立儲存體群組
儲存體群組必須適合該機器。下列範例顯示 DB2 SQL create 陳述式:
CREATE STOGROUP JAZZSTG VOLUMES ('*') VCAT yourHlq ;
附註:
  1. 儲存體群組可以是 JAZZSTG 以外的名稱。
  2. yourHlq 是您 DB2 檔案的高階限定元。它必須存在於系統上,且 Jazz Team Server for System z 使用者對它必須具備完整的存取權。
建立資料庫
資料庫必須適合該系統。下列範例顯示 DB2 SQL create 陳述式:
CREATE DATABASE JAZZDB STOGROUP JAZZSTG BUFFERPOOL bp8kx ; 
附註:
  1. 您可以在 CREATE DATABASE 陳述式中,用不同名稱取代 JAZZDB 名稱。
  2. 之後會將該資料庫名稱用於 Jazz Team Server for System z teamserver_db2z.properties com.ibm.team.repository.db.db2.dsn.dbname 內容。
  3. bp8kx 是緩衝池名稱,例如 BP8K0(Jazz Team Server for System z 需要 8K 分頁大小)。
  4. 您可以在 DB2 子系統中定義多個 Jazz DB2 資料庫,來包含個別的 Jazz 儲存庫。其作法是按照自訂適用於 DB2 for z/OS 的 Jazz Team Server for System z 內容檔中的討論,與 Jazz Server teamserver_db2z.properties 檔中的 com.ibm.team.repository.db.schemaPrefix 指引一起使用。
授權給 Jazz Team Server for System z 使用者

Jazz Team Server for System z 需要使用者 ID 與密碼,才能存取 Jazz Team Server for System z DB2 儲存庫。使用者 ID 與密碼稍後會在 teamserver_db2z.properties 檔中指定。 這個使用者 ID 不是用來登入 Jazz Team Server for System z。它只用來提供權限給 Jazz Team Server for System z,以存取 DB2 for z/OS 資料庫。更明確地說,就是這個使用者 ID 需要這裡顯示的許可權。在下列範例中,使用者的名稱是 jazz

GRANT DBADM ON DATABASE jazzdb TO jazz ; 
GRANT USE OF STOGROUP jazzstg TO jazz ;  
GRANT USE OF BUFFERPOOL bpx TO jazz ;  
COMMIT ;  
此外,在 DB2 安裝期間,如果在 DSNTIPP 畫面上將 DBADM CREATE AUTH 欄位的值設為 NO,您必須授與 SYSADM 權限給 Jazz Team Server for System z 使用者。
GRANT SYSADM TO jazz ;
COMMIT ;  

自訂適用於 DB2 for z/OS 的 Jazz Team Server for System z 內容檔

這一節說明如何編輯及配置 teamserver.properties 檔,以便 z/OS 連接到 DB2。

執行這項作業的原因和時機

@confPath@/jazz 中,尋找配置目錄。 依預設,這個目錄中的 teamserver.properties 檔配置成使用 Derby 資料庫。

  1. 重新命名 teamserver.propertiesteamserver_derby.properties
  2. 重新命名 teamserver_db2z.propertiesteamserver.properties
  3. 根據這個主題中的指示,將 teamserver.properties 檔編輯完成。

針對您的 DB2 for z/OS 子系統使用 -DIS DDF 指令,以顯示您需要提供的某些值。例如,您可以從以下的顯示畫面擷取 locationipaddrport (tcpport):

-DSN9 DIS DDF                                                   
 DSNL080I  -DSN9 DSNLTDDF DISPLAY DDF REPORT FOLLOWS: 548        
 DSNL081I STATUS=STARTD                                          
 DSNL082I LOCATION           LUNAME            GENERICLU         
 DSNL083I NS32DB             NETA.NS32DB       -NONE             
 DSNL084I TCPPORT=3500  SECPORT=3510  RESPORT=3501  IPNAME=-NONE 
 DSNL085I IPADDR=9.42.81.74                                    
 DSNL086I SQL    DOMAIN=RALNS32.rtp.raleigh.ibm.com              
 DSNL086I RESYNC DOMAIN=RALNS32.rtp.raleigh.ibm.com              
 DSNL099I DSNLTDDF DISPLAY DDF REPORT COMPLETE                   

如果要配置伺服器,請編輯 @confPath@/jazz/teamserver.properties 檔,並找出下列字行:

com.ibm.team.repository.db.vendor = db2z
com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort
/location:user=jazzDBuser;password={password};
com.ibm.team.repository.db.jdbc.password=jazzDBpswd
com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
#com.ibm.team.repository.db.schemaPrefix=xx

編輯下列字行,以符合您在先前步驟中建立的資料庫配置,以及符合您的 DB2 配置。根據您的配置來編輯 location、user、password 和 dbname 內容。

更明確地說,就是編輯下列字行:

  1. 在下列字行中:
    com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
    location:user=jazzDBuser;password={password};
    取代:
  2. 在下列字行中:
    com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    以您 DB2 使用者的密碼取代 jazzDBpswd
  3. 在下列字行中:
    com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB
    以您建立的資料庫名稱取代 JAZZDB
  4. 在下列字行中:
    #com.ibm.team.repository.db.schemaPrefix=xx
    您可以移除 #,並以您選擇的字首取代 xx。這是選用的。它可讓您在一個 DB2 子系統中,擁有多個 Jazz 儲存庫。
    註: 如果要在相同 DB2 子系統中建立數個 Jazz 資料庫,必須區分 Jazz 表格的表格擁有者。為了達到此目的,Jazz Team Server for System z 採用 com.ibm.team.repository.db.schemaPrefix 指引,在 Jazz DB2 物件中加入字首,讓它們在 DB2 子系統中都是唯一的。擁有者中將新增 com.ibm.team.repository.db.schemaPrefix 內所設定的字首並加上底線。例如,當 com.ibm.team.repository.db.schemaPrefix=X1 時,則會在給定的資料庫中,將 WORKITEMS_SNAPSHOT.WORKITEM_CHNGS 表格建立成X1_WORKITEMS_SNAPSHOT.WORKITEM_CHNGS。

此外,以您針對 @workPath@ 而選取的路徑來取代 @workPath@ 的所有實例;例如,這些內容:

註: Jazz Team Server for System z 將會建立這些目錄。

提示: Jazz 資料庫的表格包含 LOB(大型物件)直欄。 表格建立期間,LOB 直欄會與 DB2 所建立的某個緩衝池相關聯。 LOB 表格空間的預設緩衝池定義在 zparm TBSBPLOB 中。 如果您不想要 4K 頁面大小,您可以將這個值設為 8K 緩衝池。 如需其他資訊,請參閱 IBM 紅皮書 LOBs with DB2 for z/OS: Stronger and Faster 中的 "Alternatives in defining LOBs",位置如下:http://www.redbooks.ibm.com/redbooks/pdfs/sg247270.pdf

使用 Jazz Team Server for System z 儲存庫工具來建立資料庫表格

在您使用 DB2 for z/OS 時,一開始您必須先使用 Jazz Team Server for System z 儲存庫工具,為 Jazz Team Server for System z 建立必要的資料庫表格與索引。

執行這項作業的原因和時機

請按照自訂適用於 DB2 for z/OS 的 Jazz Team Server for System z 內容檔中的說明,確定 teamserver.properties 檔已配置無誤。然後您必須:

  1. 遵循範例 JCL 中的指示,在 hlq.SBLZSAMP 中配置成員 BLZCREDB
  2. 提交已修改的 JCL,並檢查工作日誌。此 STDOUT 必須以下列訊息作為結束:已順利建立資料庫表格。請參閱 JCL 範例,以取得詳細資料。

Jazz Team Server for System z 搭配 Tomcat 與 Derby 執行

當 Jazz Team Server for System z 搭配 Tomcat 與 Derby 執行時,會涉及一些範例 JCL 成員與配置內容檔。

開始之前

這些指示假設您使用範例 teamserver_derby.properties 檔。如果您使用不同的內容檔名稱,請變更範例 JCL 成員,而指向您的內容檔。

  1. 編輯 @confPath@/jazz 目錄中的 teamserver.properties 檔。
  2. com.ibm.team.repository.db.jdbc.location = @workPath@/repositoryDB 變更為您的路徑,例如 com.ibm.team.repository.db.jdbc.location = /u/jazz/repositoryDB
  3. 將所有出現的 @workPath@ 變更為您的路徑。 下列內容便是範例:
    1. com.ibm.team.fulltext.indexLocation=@workPath@/workitemindex
    2. com.ibm.team.repository.tmpdir=@workPath@/contentservice
    3. com.ibm.team.scm.tmpdir=@workPath@/contentservice
    4. com.ibm.team.scm.vcs.tmpdir=@workPath@/versionedcontentservice

檢閱 Tomcat 埠配置(建議)

為了避免埠衝突,請檢閱 Tomcat 應用程式伺服器的預設埠設定,確定它們與您已安裝的其他應用程式伺服器實例不同。

執行這項作業的原因和時機

依預設,Tomcat 應用程式伺服器使用非安全埠 9080 與安全埠 9443,以及 9005、9009 與 8082 埠。 這些預設埠可能與您已安裝的預設 WebSphere Application Server 實例相衝突。請檢閱定義這些埠的 Tomcat server.xml 檔,它位於 @workPath@/catalina_base/conf/server.xml

提示: 如果您在 server.xml 檔中修改預設埠,請記錄這些變更,以便讓您能在完成指導教學作業時使用這些埠。

請根據您使用的應用程式伺服器與資料庫,選擇下列其中一個選項:

啟動使用 Derby 資料庫的 Tomcat

現在,您可以準備啟動使用預設 Derby 資料庫的 Tomcat。如果您需要執行其他的 Jazz Team Server for System z 儲存庫工具功能,例如,匯入或匯出移轉資料,或是建立新的資料庫,請參閱 使用 Jazz Team Server for System z 儲存庫工具來建立資料庫表格

利用範例中的指示,在 hlq.SBLZSAMP 中配置成員 BLZSRV2。使用 SUBMIT 指令來提交已修改的 JCL,並仔細檢查工作日誌中,是否存在錯誤以及指出完成伺服器啟動的訊息。您可以調整 BLZSRV2 工作的「WLM 服務類別」,以符合您的系統需求。

您可以停止這項工作,來停止 Jazz Team Server for System z。

Jazz Team Server for System z 搭配 Tomcat 與 DB2 for z/OS 執行

當 Jazz Team Server for System z 搭配 Tomcat 與 DB2 for z/OS 執行時,會涉及一些範例 JCL 成員與配置內容檔。

開始之前

這些指示假設您使用範例 teamserver_db2z.properties 檔。如果您使用不同的內容檔名稱,請變更範例 JCL 成員,而指向您的內容檔。

執行這項作業的原因和時機

當在 z/OS 上使用 DB2 資料庫時,需要其他的配置步驟。

檢閱 Tomcat 埠配置(建議)

為了避免埠衝突,請檢閱 Tomcat 應用程式伺服器的預設埠設定,確定它們與您已安裝的其他應用程式伺服器實例不同。

執行這項作業的原因和時機

依預設,Tomcat 應用程式伺服器使用非安全埠 9080 與安全埠 9443,以及 9005、9009 與 8082 埠。 這些預設埠可能與您已安裝的預設 WebSphere Application Server 實例相衝突。請檢閱定義這些埠的 Tomcat server.xml 檔,它位於 @workPath@/catalina_base/conf/server.xml

提示: 如果您在 server.xml 檔中修改預設埠,請記錄這些變更,以便讓您能在完成指導教學作業時使用這些埠。

請根據您使用的應用程式伺服器與資料庫,選擇下列其中一個選項:

啟動使用 DB2 for z/OS 資料庫的 Tomcat

現在,您可以準備啟動使用 DB2 for z/OS 資料庫的 Tomcat。如果您需要執行其他的 Jazz Team Server for System z 儲存庫工具功能,例如,匯入或匯出移轉資料,或是重建新的資料庫,請參閱 使用 Jazz Team Server for System z 儲存庫工具來建立資料庫表格

利用範例中的指示,在 hlq.SBLZSAMP 中配置成員 BLZSRV1。使用 SUBMIT 指令來提交已修改的 JCL,並仔細檢查工作日誌中,是否存在錯誤以及指出完成伺服器啟動的訊息。您可以調整 BLZSRV1 工作的「WLM 服務類別」,以符合您的系統需求。

您可以停止這項工作,來停止 Jazz Team Server for System z。

搭配 WebSphere Application Server 執行 Jazz Team Server for System z

搭配 WebSphere Application Server 執行 Jazz Team Server for System z 時,會包含

RTCz:利用 RACF 設定安全

RACF 作業應該由您的系統安全管理者來執行。

執行這項作業的原因和時機

Jazz Team Server for System z 使用四個角色,您必須將它們定義為 RACF EJBROLE 設定檔,以進行安全控制。 請在 EJBROLE 類別中定義四個 Jazz Team Server 角色。

  1. 定義 EJBROLE 設定檔:
    JazzAdmins
    具有完整讀寫存取權的 Jazz 儲存庫管理者。
    JazzDWAdmins
    具有特定許可權可在 Jazz Team Server 上控制資料倉儲的 Jazz 儲存庫管理者。
    JazzProjectAdmins
    具有特定許可權可操作專案區域、團隊區域及程序範本的 Jazz 儲存庫管理者。
    JazzGuests
    具有 Jazz 儲存庫之唯讀存取權的使用者。
    JazzUsers
    具有 Jazz 儲存庫之一般讀寫存取權的使用者。

    範例 RACF 指令:

    RDEFINE EJBROLE JazzAdmins UACC(NONE)
    RDEFINE EJBROLE JazzDWAdmins UACC(NONE)
    RDEFINE EJBROLE JazzProjectAdmins UACC (NONE)
    RDEFINE EJBROLE JazzGuests UACC(READ)
    RDEFINE EJBROLE JazzUsers UACC(NONE)
  2. 允許使用者或群組的適當存取權。

    範例 RACF 指令:

    Permit JazzAdmins CLASS(EJBROLE) ID(jazAdmns) ACCESS(READ)
    Permit JazzDWAdmins CLASS(EJBROLE) ID(jDwadmns) ACCESS(READ)
    Permit JazzProjectAdmins CLASS(EJBROLE) ID(jPradmns) ACCESS (READ)
    Permit JazzUsers CLASS(EJBROLE) ID(jazzgrp) ACCESS(READ)
  3. 啟動新的定義:

    在 RACF RDEFINE 和 PERMIT 指令之後,您必須發出下列指令將它們列入考量:

    SETROPTS RACLIST(EJBROLE) REFRESH 
  4. 完成配置 Jazz Team Server 的其餘步驟之後,您必須以 Jazz Team Server 管理者身分登入,以驗證這個配置。 在嘗試驗證這個配置之前,請提供至少一個具備讀取權限的使用者 ID 或群組到 EJBROLE 類別的 JazzAdmins 設定檔中。
    註: 當您新增使用者 ID 到 Jazz Team Server 儲存庫時,您也必須提供他們 EJBROLE 類別中適當的 RACF 設定檔的讀取權限(JazzAdmins、JazzDWAdmins、JazzProjectAdmins、JazzGuests、JazzUsers)。
    小心: 當您的密碼到期時,您將無法連接到 Jazz,但不會有錯誤訊息通知您這個情況。 如果您無法連接到 Jazz 且認為您的密碼過期,您必須登入 TSO 或 Rational Developer for System z 來變更它。

配置 WebSphere Application Server

這個主題說明如何設定 Jazz Team Server for System z,以便在 z/OS 上使用 WebSphere Application Server。

開始之前

在執行這項作業之前,請確定您已完成下列動作:

執行這項作業的原因和時機

這個配置假設您將 Jazz Team Server for System z 安裝在 WebSphere Application Server 相同的機器上。 另外,這個主題並未列出針對 SSL 配置 WebSphere 鑑別的步驟。 如需 WebSphere 的各種鑑別和加密選項的詳細資料,請造訪位於 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp 的「WebSphere 資訊中心」,搜尋維護應用程式和其環境的安全 (Securing applications and their environment)

註: 您必須先登錄為 Jazz.net 使用者,才能造訪「WebSphere 資訊中心」。 請移至 http://jazz.net

請執行下列步驟,將 Jazz Team Server for System z 部署在 WebSphere Application Server 上。 以下詳細說明各個步驟本身的作業。

  1. 定義應用程式伺服器 JVM 自訂內容。
  2. 部署 jazz.war 檔,再重新啟動應用程式伺服器。
定義應用程式伺服器 JVM 自訂內容

執行這項作業的原因和時機

註:

  1. 選取伺服器 -> 應用程式伺服器
  2. 選取 server1
  3. 選取 Java 和程序管理 -> 程序定義 -> 服務者
  4. 選取 Java 虛擬機器
  5. 在「起始資料堆」中,新增值 100。
  6. 在「資料堆大小上限」中,新增值 1000。
  7. 按一下套用
  8. 按一下記載和追蹤
  9. 按一下變更日誌的詳細程度。 Jazz Team Server for System z 使用 BIRT 報告引擎。 如果要防止將 BIRT 參考項目寫入至 WebSphere 日誌檔,請將 org.eclipse.birt.* 套件的日誌記載層次設為嚴重
  10. 按一下套用
  11. 選取自訂內容
  12. 按一下新建來新增下列內容。 新增每一項之後,便按一下確定
    名稱
    java.awt.headless;值 = true
    名稱
    org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin;值 = true
    名稱
    JAZZ_HOME ;值:file:///@confPath@
    名稱
    DB2Z_JDBC;值:/@db2PathPrefix@/db2910_jdbc/classes
    註: 以系統上的 DB2 V9 JDBC 授權和 JDBC jar 檔的路徑來取代 @db2PathPrefix@。 這些檔案的名稱是 db2jcc_license_cisuz.jardb2jcc.jar,依預設,它們位於 /usr/lpp/db2910_jdbc/classes
  13. 選取直接儲存到主要配置
部署 jazz.war 檔,然後重新啟動 WebSphere Application Server

  1. 從 WebSphere Application Server 管理主控台中,選取應用程式 -> 安裝新應用程式
  2. 新應用程式的路徑之下,選取遠端檔案系統
  3. 完整路徑之下,瀏覽到 @pathPrefix@/usr/lpp/jazz/v2.0/server/tomcat/webapps/jazz.war,其中 @pathPrefix@ 是您安裝 SMP/E 時所指定的任何字首。
  4. 將環境定義根目錄設為 /jazz
  5. 下一步,然後依照該編輯器的提示,繼續其餘安裝新的應用程式步驟。
  6. 按一下完成
  7. 選取直接儲存到主要配置
  8. 重新啟動應用程式伺服器。
  9. 檢查服務者日誌來找出錯誤。

下一步

啟動伺服器之後,請檢閱這個主題:RTCz:執行設定精靈

如需配置 WebSphere Application Server 的詳細資訊,請造訪下列網站:

執行設定精靈

執行設定精靈,來驗證伺服器是否適當運作。設定精靈也會引導您完成伺服器的配置。

開始之前

如果要驗證 Jazz Team Server 是否連接資料庫,請查看伺服器日誌或主控台輸出。連線和資料庫資訊會在其第一次存取時回應。 本程序假設使用主機名稱 localhost 和預設埠 9443,即可使用您的伺服器。必要的話,請以您的伺服器主機名稱來取代 localhost,另外也取代埠號。

執行這項作業的原因和時機

請完成下列步驟,以執行設定精靈:

  1. 啟動設定精靈,以配置您的伺服器。使用 URL:https://ipaddress:port/jazz/setup,其中 ipaddress 是您用來啟動 Tomcat 的 IP 位址,port 是您在啟動 Tomcat 時指定的安全埠。
  2. 輸入預設使用者名稱與密碼:
    註: 使用者名稱與密碼有區分大小寫。
  3. 從設定精靈提供的兩條設定路徑中選擇一條:

下一步

當起始設定完成時,您可以利用「Jazz Team Server 管理 Web 使用者介面」來配置其他選項,URL 如下:https://ipaddress:port/jazz/admin,其中 ipaddress 是您啟動 Tomcat 的 IP 位址,port 是啟動 Tomcat 時所指定的安全埠。

完成安裝

完成安裝所需的作業應該由您的 Jazz Team Server for System z 管理者來執行。在安裝伺服器後,您必須考量某些配置選項,再繼續進行。

執行這項作業的原因和時機

某些檔案含有密碼。這些檔案應受到保護,而只供有權知道帳戶密碼的使用者讀取。

安裝 Build System Toolkit for System z

對於 z/OS 以外的作業系統,您可以利用 .zip 檔或 IBM Installation Manager,將 Build System Toolkit for System z 安裝在您的建置系統上。 如果是 z/OS,便利用 SMP/E 來安裝 Build System Toolkit for System z。

執行這項作業的原因和時機

Build System Toolkit for System z 包含兩個元件:Ant 建置工具箱及 Jazz Build Engine。 對於使用 Antz 建置定義範本的原生 z/OS 建置,以及 Java 建置之類的非 z/OS 建置而言,這些都是必要的元件。 如果是使用 Antz 建置定義範本的原生 z/OS 建置,您也必須安裝 Rational Build Agent。

註: 如果您將 Rational Build Agent 建置定義範本用於原生 z/OS 建置,例如,利用 z/OS UNIX Shell Script 或 JCL 來建置,您就不需要安裝 Build System Toolkit for System z。

從 IBM Installation Manager 來安裝 Build System Toolkit for System z

您可以利用 IBM Installation Manager,將 Build System Toolkit for System z 安裝在建置系統上。

執行這項作業的原因和時機

  1. 啟動啟動程式。

    如果 Installation Manager 不在執行中,請啟動它。

    註: 您必須具備管理者專用權,才能執行啟動程式。
  2. 當出現啟動程式時,請按一下 Build System Toolkit for System z,以啟動安裝程序。
  3. 在安裝完成之後,即可配置建置。

從 .zip 檔來安裝 Build System Toolkit for System z

您可以使用下載的 .zip 檔,將 Build System Toolkit for System z 安裝在建置機器上。

執行這項作業的原因和時機

如果要從 .zip 檔來安裝 Build System Toolkit for System z,請執行下列動作:

  1. 下載 Build System Toolkit for System z .zip 檔。
  2. 將 .zip 檔解壓縮至 JazzInstallDir 目錄。
  3. 在安裝完成之後,即可配置建置。

在 z/OS 上安裝 Build System Toolkit for System z

您可以利用 SMP/E 安裝程序,將 Build System Toolkit for System z 安裝在 z/OS 上。

依預設,SMP/E 安裝程序會將 Build System Toolkit for System z 放在下列目錄中:@pathPrefix@/usr/lpp/jazz/v2.0/buildsystem。 如需詳細資訊,請參閱SMP/E 安裝

安裝 Rational Build Agent

Rational Build Agent 可以在 z/OS、Linux、Linux for System z、UNIX 與 Windows 上執行。 在 z/OS 上進行安裝時,所需的程序與安裝在其他平台上的程序不同。

在 z/OS 上安裝及配置 Rational Build Agent

本節說明如何在 z/OS 上完成 Rational Build Agent 的安裝。在完成這些步驟之前,您必須已在安裝 Rational Team Concert for System z 的 SMP/E 套件過程中,安裝 FMID HAHD200。

請參閱在 z/OS 上安裝 Rational Team Concert for System z,以取得可分別單獨安裝之 FMID 的相關資訊。 SMP/E 套件包含在下載檔案 RTCz-SMPE-2.0.zip 以及「程式目錄」中。 「程式目錄」也可以在 Web 上取得,網址如下:http://www.ibm.com/support/docview.wss?&uid=swg27016631

在 z/OS 上安裝和執行代理程式

建置代理程式執行檔已在 SMP/E 安裝期間安裝到 yourPathPrefix/usr/lpp/jazz/bfagent 中。

請完成這些步驟,來完成安裝和啟動 Rational Build Agent:

  1. 如果不用 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 提示。
  2. 如果您計劃使用 Antz 建置延伸,就必須從設定了其他環境變數的 Shell Script 中啟動 Rational Build Agent。 Build System Toolkit for System z 包含一個範例 Shell Script,它會配置這些環境變數及啟動代理程式。 如需詳細資訊,請參閱「Rational Team Concert for System z 資訊中心」的配置 Rational Build Agent Shell Script,位置如下:http://publib.boulder.ibm.com/infocenter/rtczhelp/v2r0m0/index.jsp。
  3. 如果要測試在 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 的完整配置已超出本文件的說明範圍。在簡式範例中,您可以:

  1. 加入下列字行來修改 /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/)中,以免在套用維護時改寫它們。 這裡所定義的工作目錄必須反映這項變更。
  2. 將下列內容新增至 /etc/services:
    bfagent 5555/tcp #BUILD FORGE AGENT
  3. 更新 bfagent.conf 中的埠,以對映至您的服務項目:
    port 5555
  4. 重新啟動 inetd。

配置代理程式

本節說明如何在安裝之後配置代理程式。

變更代理程式埠

如果伺服器上的埠 5555 已被佔用,您可以在伺服器上安裝代理程式之後變更代理程式埠。

如果要變更埠,請執行下列動作:

  1. 修改 bfagent.conf 檔中的埠值。
  2. 如果您執行獨立式伺服器(亦即,您以 bfagent -s 啟動),則可以使用 kill 指令來停止現行 bfagent 程序,並使用您第一次啟動代理程式時所用的指令來重新啟動。
  3. 如果您透過 inetd 來執行,還必須修改 /etc/services 檔中的埠設定,並且重新啟動 inetd。
配置不同的 Shell

您可以編輯 bfagent.conf 檔中的參數,將代理程式配置成使用非預設的 Shell。

例如,如果要使用 tcsh Shell,可將 Shell 參數設定成如下:

shell /bin/tcsh

如需 bfagent.conf 檔的詳細資訊,請參閱bfagent.conf 參照

Build Agent 查閱服務

Rational Build Agent 服務外掛程式會針對使用 Rational Build Agent 作為建置引擎的建置要求,提供查閱功能。在 Rational Team Concert for System z 用戶端中,您可以建立以 Rational Build Agent 作為建置引擎的建置定義。「Build Agent 查閱服務」會定期檢查儲存庫中的建置要求,找出以 Rational Build Agent 作為建置引擎的要求。當找到建置要求時,就會交由內部服務處理,並傳送指令行給 Rational Build Agent。

「Build Agent 查閱服務」會在每一個查閱期間處理多個建置要求。 但是如果定義了多項建置定義來使用同一個 Rational Build Agent,且使用者同時使用這些建置定義來要求建置,則「Build Agent 查閱服務」在查閱期間只會處理一項建置要求。單一 Rational Build Agent 應該一次只會收到一項建置要求。

查閱服務設定

您可以在「Jazz 管理」Web 介面中設定 BuildAgentLookupTask(亦稱為 BuildAgentLookupService)。請移至 Jazz 管理 >「伺服器」標籤 > 進階內容 > Build Agent 區段。

您可以在這個畫面上設定下列兩個值:

Build Agent 迴圈作業貢獻者 ID
這是在伺服器端中執行建置代理程式迴圈作業服務的使用者。預設使用者 ID 是 ADMIN。
註: 請確定執行 BuildAgentLookupTask 的使用者具備執行建置動作的許可權。使用者在指定團隊區域中需要具備建置動作的完整許可權。請遵循這些步驟,以提供必要的許可權給使用者。
  1. 使用者必須是指定「專案區域」與「團隊區域」的成員。
  2. 已將使用者設定為「專案區域」與「團隊區域」中的特定角色。如果沒有設定任何角色,則預設值是 everyone
  3. 使用者角色在「專案區域」與「團隊區域」中,必須具備建置活動的完整許可權。您可以在專案區域 >「程序配置」標籤 > 團隊配置 > 許可權中定義許可權。
  4. 使用者必須被指派 Rational Team Concert for System z 的「z 開發人員」或「z 建置系統用戶端存取授權 (CAL)」。
Build Agent 迴圈作業間隔時間
此值是定義 BuildAgentLookupTask 的間隔執行時間(以秒為單位)。預設值是 60 秒。

在 Linux、Linux for System z、UNIX 和 Windows 上安裝和配置 Rational Build Agent

這一節說明如何在 Linux、Linux for System z、UNIX 和 Windows 上,進行代理程式的安裝、執行、配置和疑難排解。

代理程式是一種會接收要求來執行專案和步驟的服務。請將代理程式安裝在您要作為伺服器資源的每一個主機上。

安裝代理程式

這一節說明如何安裝代理程式。

在 Windows 上安裝代理程式

這個主題說明如何在 Windows 上安裝「Rational Build Forge 代理程式」。

  1. 尋找及啟動安裝套件所隨附的代理程式安裝程式。 安裝程式的檔名是 win-bfagent-<version>.exe,其中 <version> 是您的「Rational Build Forge 代理程式」版本號碼。
    註: 如果安裝程式偵測到您的系統已安裝了某版本的代理程式,便會提示您確認是否要改寫第一個版本。 按一下確定
  2. 在出現「歡迎使用」訊息之後,按下一步
  3. 如果您同意授權合約條款,請按一下我同意
  4. 在「選擇安裝位置」視窗中,指出目的地資料夾,然後按下一步
    提示: 使用預設位置 C:\Program Files\IBM\Build Forge\Agent,以便輕易找到檔案。
  5. 在「配置」視窗中,選擇您想要的「代理程式選項」,然後按一下安裝
  6. 選取下列安裝方法之一:
  7. 選用:如果您使用 Cygwin Linux 模擬環境,當您安裝代理程式時,您可以選擇安裝 Cygwin 支援。 如果您安裝 Cygwin 支援,請執行下列步驟:
    1. 按一下啟用 Cygwin 支援
    2. 在 Cygwin 安裝期間,選擇 DOS/字行結尾
    3. 在「專案」中,使用 UNIX 樣式的指令語法。
      限制: Cygwin 只用 US ASCII。 它不支援 UTF-8,因此,無法與任何其他系統一起使用。
  8. 指定代理程式應該用來與系統通訊的埠。 預設埠是 5555。
  9. 在「安裝完成」畫面中,按一下完成
    小心: 請勿關閉代理程式安裝期間所開啟的任何蹦現視窗。 在安裝執行時,請讓它們自行開啟和關閉。
在 Linux、Linux for System z 和 UNIX 上安裝代理程式

這個主題說明如何在 Linux、Linux for System z 和 UNIX 作業系統上,安裝「Rational Build Forge 代理程式」。

開始之前

尋找及啟動安裝套件所隨附的代理程式安裝程式。 安裝程式的檔名是 <os>-bfagent-<version>.exe,其中 <os> 是您的作業系統,<version> 是您的「Rational Build Forge 代理程式」版本號碼。

AIX

  1. 使用 aix5-bfagent-<version>.tar.gz 檔或 aix5np-bfagent-<version>.tar.gz 檔。
    註: aix5np 檔不支援可外掛的鑑別模組 (PAM) 鑑別。
    重要: 如果您將 aixnp 代理程式安裝成以 root 身分來執行,在執行時期,這個代理程式會利用 AIX,以先前的步驟所指定的伺服器鑑別認證來進行鑑別。 如果您未將這個代理程式安裝成以 root 身分來執行,您必須利用 bfagent.conf 檔中的 magic_login 設定來限制它的存取。
  2. 輸入這個指令來解壓縮檔案:gzip -d gzipfilename.gz。
  3. 輸入這個指令來解壓縮檔案:tar xvf tarfilname.tar。
  4. 輸入這個指令來安裝代理程式:cd extracted-agent-directory ./install.sh。

下一步

重要: 如果您利用配置選項 --without-pam 來編譯 AIX 的代理程式,便會關閉代理程式的鑑別。 如果您以 root 專用權來安裝它,人們不論指定任何密碼,都能夠以有效使用者的身分連線。 如果您必須編譯代理程式,讓它執行於使用 PAM 的 AIX 系統上,請務必使用專用的代理程式帳號,將它安裝成以這個使用者身分來執行,然後利用 bfagent.conf 檔中的 magic_login 設定來限制它的存取。
HP-UX

開始之前

如果尚未設定 PATH 值,請設定。 雖然沒有 PATH 值,HP-UX 也能夠執行,但在代理程式試圖新增到路徑中,而您尚未設定其值時,您可能會遇到一些問題。 您可以編輯您的系統 /etc/PATH 檔,或利用 Shell 的標準 PATH set 或 append 作業來設定值。

  1. 從安裝套件中取得 hpux11-bfagent-<version>.tar.gz 檔。 請將它儲存在您想要安裝代理程式的位置。
  2. gzip -d gzipfilename.gz 檔解壓縮。
  3. xvf tarfilename.tar 檔解壓縮。
  4. 輸入這個指令來安裝代理程式:cd extracted-agent-directory ./install.sh。
Red Hat Linux

  1. 從安裝套件取得 rh9-bfagent-<version>.rpm(Red Hat Enterprise Linux 第 4 版)或 rhel5-bfagent-<version>.rpm 檔(Red Hat Enterprise Linux 第 5 版)。
  2. 輸入這個指令:rpm -iUvh rh9-bfagent-<version>.rpm。
Solaris

  1. 在 Solaris 第 9 或 10 版的 SPARC 上,使用 sol9-bfagent-<version>-sparc-opt.gz 檔。
  2. gzip -d solN-bfagent-<version>-platform-opt.gz 檔解壓縮。
  3. 輸入這個指令:pkgadd -d ./unzipped-package。
將代理程式安裝在其他平台上,從原始檔開始編譯

如果您必須在另一個平台上執行 Rational Build Forge 代理程式,請利用 src-bfagent-<version>.tar.gz 檔,從原始檔開始編譯代理程式。

  1. 解壓縮 .tar 檔。
  2. src 目錄中,執行 configure Script。
  3. src 目錄中,執行 make 指令。 原始檔套件要求您的系統有 GNU C 編譯器或 C 編譯器。

下一步

註: 不含本端電腦安裝程式的原始檔套件及預先建置的代理程式,在主機 inetd/xinetd 配置檔中,隨附了代理程式的安裝程式。

執行代理程式

本節說明如何設定要執行的代理程式。它通常是以自動啟動的服務或常駐程式形式執行。

在 Windows 上執行代理程式

一般而言,代理程式會安裝成服務,並且設定為「自動」,如此就會在您開啟電腦時啟動。您必須登入安裝該代理程式的電腦,才能啟動和停止它。

如果要啟動和停止代理程式,您可以使用開始功能表:

您也可以在命令提示字元下使用下列指令:

在 Linux、Linux for System z 和 UNIX 上執行代理程式

代理程式主要是以服務形式執行,當系統重新啟動時需要自動重新啟動。

依適當情況而定,請新增 bfagent 項目至 inetd 或 xinetd 的配置中。下列範例是 Linux 系統上 xinetd.d 中的 bfagent 項目,其中代理程式安裝在 /usr/local/bin 中:

# 說明:IBM Rational Build Agent 處理
#    來自 IBM Rational Build Forge 管理主控台的建置要求。
service bfagent
{
        disable         = no
        flags           = REUSE
        socket_type     = stream
        wait            = no
        user            = root
        server          = /usr/local/bin/bfagent
        log_on_failure  += USERID
}

必要時,代理程式可以在 inetd/xinetd 環境外執行。如果要讓它以獨立式常駐程式形式執行,請使用 -s 選項。

bfagent -s

在您使用這個選項時,代理程式會移至背景,並開始接聽連線。請將這個指令放在啟動 Script 中,以便在啟動電腦時,代理程式會自動啟動。

配置代理程式

本節說明如何在安裝之後配置代理程式。

找出代理程式配置檔

代理程式配置檔 BFAgent.conf 提供代理程式作業的執行時期配置。它所含的註解會解釋所有可能的選項。該檔案位於代理程式安裝目錄:

重要: 如果您對安裝目錄中的 BFAgent.conf 檔進行變更,在後續重新安裝或升級代理程式之後,必須重複這些變更動作。在每次安裝期間就會改寫配置檔。

您可以指定替代的配置檔:

變更代理程式埠

如果伺服器上的埠 5555 已被佔用,您可以在伺服器上安裝代理程式之後變更代理程式埠。

如果要在 Windows 作業系統上變更埠,請執行下列動作:

  1. 開啟登錄編輯程式:按一下開始 -> 執行,然後輸入 regedit
  2. 移至 HKEY_LOCAL_MACHINE\SOFTWARE\BuildForge 代理程式。
  3. 將 AgentPort 的值變更為您要的埠號。

若為 UNIX、Linux 與 Macintosh 作業系統,請執行下列動作:

  1. 開啟 /etc/services 檔。
  2. 將 BuildForge 代理程式埠的值變更為您要的埠號。
配置不同的 Shell

您可以編輯 BFAgent.conf 檔中的參數,將代理程式配置成使用非預設的 Shell。

例如,如果要將 Windows 系統變更為使用 MKSTools 所提供的 Korn Shell,您可以使用下列指令來變更 Shell 參數:

shell C:\MKSTools\mksnt\ksh.exe -L -c \"%s\"

在系統傳送指令給伺服器時,會用逐步指令取代這個指令中的 %。在本例中,請使用反斜線跳出字元,將引號當成文字包含在指令中。

在「網路共用檔案系統 (Windows)」上執行代理程式指令

Rational Build Agent 在初次啟動時,使用的是 Windows 系統帳戶認證。為了執行指令,代理程式之後就會使用 Rational Build Agent 伺服器鑑別認證向 Windows 鑑別。

本端指令可接受伺服器鑑別認證,但如果是代理程式必須在外部的網路共用磁碟機上執行的一些指令,就可能導致失敗。例如,如果要在 ClearCase 動態視圖中修改檔案,代理程式必須存取網路共用磁碟機中的 ClearCase 檔案。

由於外部檔案系統會忽略代理程式的伺服器鑑別認證,因而導致指令失敗;它只能辨識代理程式的起始系統帳戶認證。

如果您在網路共用磁碟機上執行指令時遭遇問題,請嘗試下列動作:

使用伺服器鑑別認證來執行指令。
如果要使用具備網路共用磁碟機存取權的 Rational Build Agent 伺服器鑑別認證來執行指令,請在 BFagent.conf 檔中新增 win_reexec_after_auth 設定。

如果您想使用 Rational Build Agent 伺服器鑑別認證來建立網路共用區的存取權,新增這項設定就成了必要條件。

win_reexec_after_auth 設定會使得代理程式在向 Windows 鑑別之後,啟動新程序。新程序會強制共用檔案系統辨識出代理程式已變更使用者認證。

當設定 win_reexec_after_auth 時,代理程式會以服務形式執行,且不會識別哪些指令會存取網路共用磁碟機,哪些指令不會,因此您可能需注意效能衝擊問題。

在單一使用者模式下執行代理程式
在代理程式安裝期間,將代理程式設定成在單一使用者模式下執行指令,而不需要 Rational Build Agent 伺服器鑑別認證。請選取安裝使用者模式代理程式選項。

如果指定的使用者是「管理者」群組中的成員,則必須使用伺服器鑑別認證來指定使用者的認證。

如果使用者不是管理者,請在 BFagent.conf 中使用 magic_login 設定,以防出現未獲授權存取代理程式的情況。

代理程式會以您提供的使用者名稱啟動和執行,而這會使用該使用者的認證,立即授權存取網路共用磁碟機。

使用專用使用者帳戶,以服務形式來執行代理程式
將代理程式設定成使用專用使用者帳戶,以 Windows 服務形式來執行。這個選項會限制您以單一使用者帳戶身分執行代理程式,但是不會要求代理程式啟動新程序來重新鑑別,因此效能不受影響。

如果要使用專用使用者帳戶,以服務形式來執行代理程式,請執行下列動作:

  1. 在 Rational Build Agent 伺服器上,按一下管理工具 -> 服務,開啟「Windows 控制台」。這時會開啟服務清單。
  2. 開啟 Rational Build Agent 服務。
  3. 提供您要執行代理程式指令之使用者的使用者帳戶資訊。例如,提供 ClearCase admin 使用者的資訊,或是具備 ClearCase 動態視圖與 VOB 存取權的其他使用者資訊。
bfagent 參照

bfagent 執行檔會啟動 Rational Build Agent。它會從相同目錄中的 bfagent.conf 檔讀取它的配置。

指令的語法是:

bfagent [-f configfile | -s]
選項
-f configfile
利用 configfile 中的配置檔來執行,而非使用 bfagent.conf。這是 UNIX 或 Linux 上的一個執行時期選項。當您在 Windows 上手動執行代理程式時,它就成了除錯選項。它在 Windows 上無法用來啟動服務。
-s
以獨立式服務形式啟動。只能在 UNIX 或 Linux 中使用。這個選項只能用在 UNIX 或 Linux 中。這種作法可作為您以 inetdxinetd 啟動 bfagent 時的替代方案。
bfagent.conf 參照

bfagent.conf 檔儲存有關如何執行 Rational Build Agent 的設定。檔案所在的目錄和 bfagent 執行檔相同。

檔案會列出所有的設定與內部預設值。非作用中設定則會註銷。

設定
activity_log path
開啟活動記載。資訊會附加至 path 指定的檔案中。路徑必須存在,且代理程式使用者必須具備它的寫入權。
註: 如果路徑不存在,或者無法寫入檔案,代理程式並不會報告錯誤。
重要: 檔案大小沒有限制。檔案必須手動刪除。這項設定是暫用的,主要用來除錯代理程式。它不是作為工作中代理程式的永久日誌。
allow IP-address-or-range [...]

只有在下列情況下才使用這項設定:

這項設定會限制連接至代理程式的連線。只容許來自符合 IP-address-or-range 的 IP 位址的連線。依預設,可容許來自所有位址的連線。

請指定下列這兩個選項或其中之一:

註: 如果您是在 inetd 或 xinetd 等超級伺服器上執行代理程式,請使用另一種方法來控制存取。您可以使用防火牆、TCP 封套(hosts.allow 與 hosts.deny),或 xinetd 的內建過濾功能。
bind
這項設定容許使用者為代理程式指定明確的連結位址。如果代理程式是以 -s 指令行選項啟動,當此項與 "port" 設定一起使用時,將決定代理程式要如何接聽連線。在 bfagent.conf 檔中提供的值,會強制代理程式連結至 IPv4 本端主機位址;因此,代理程式只會接收來自位於相同機器上之主控台的連線。範例:bind 255.192.192.003
註: 對於由系統的服務架構(例如 inetd、xinetd 或 launchd)所啟動的 Windows 或 UNIX 代理程式,則不受影響。
ccviewroot root-path
這項設定是指定這個主機的預設視圖根路徑。如需相關資訊,請參閱有關 init 的 ClearCase 文件。內部預設值如下:
command_output_cache size
這項設定會使得代理程式快取輸出,直到抵達指定的大小(以位元組為單位)為止。內部預設值是不快取。使用快取可以大幅改善代理程式的效能,並減少網路額外負荷。快取大小取決於指令所產生的輸出量而定。

最小值:2048。如果設定小於 2048,就會在內部使用 2048。

cygwin

這項設定僅適用於 Windows 上的代理程式。

這項設定可讓代理程式在使用 Cygwin(一種類似 Linux 的環境)的 Windows 主機上運作。當使用 Cygwin 時,代理程式即能使用一些 Linux 工具。

在您使用這項設定時,您可能還需要設定 cygwin_script_magic 與 Shell 設定。下列範例顯示一種用來配置這些設定的方式:

cygwin
shell C:\cygwin\bin\bash.exe --login -c "%s"
cygwin_script_magic #!/bin/bash

Shell 設定必須符合您所安裝的 Cygwin。

cygwin_script_magic

當設定 cygwin時,這項設定僅適用於 Windows 上的代理程式。

這項設定指定當執行步驟時要使用的 #! 行。預設值是 #!/bin/bash

default_logon_domain
指定當鑑別要求沒有包含網域時,所要使用的網域。如果沒有指定,就會使用代理程式機器的網域。
disable_telnet
如果要取得最佳結果,請使用 Telnet 來測試代理程式連線。

對代理程式來說,某些內建處理程序的額外負荷,與處理程序和正確處理 Telnet 控制順序相關聯。

您可以使用這項設定,讓代理程式無法處理特殊 Telnet 字元碼,而這樣可微幅改善效能。在產品環境中,使用這項設定,可因效能改善而受惠。

disable_transcode
關閉代理程式為了轉換國際資料(因為作業系統不是使用 UTF-8 編碼)而執行的處理程序。為了避免混合編碼與資料毀損,請讓代理程式的作業系統採用 UTF-8。

如果作業系統並非使用 UTF-8 編碼,代理程式必須將資料轉換成作業系統語言環境設定的正確編碼。

如果您的作業不是使用 UTF-8,請使用這項設定,取得代理程式的最佳結果並改善效能。

enable_agent_dll
這項設定會啟用「DLL 程序追蹤」這項除錯工具。
env_recursion_limit number-of-recursions
設定預先剖析的變數取代遞迴限制。若未設定,則限制是 32。
extensions
這項設定是指定函數外部程式庫的路徑。函數可作為步驟中的點指令。如果沒有指定這項設定,就不會載入外部程式庫。

在剖析期間,會以逐步指令中的第一個記號作為函數名稱。第二個記號是字串,第三個是整數逾時值(以秒為單位)。

需求:作業系統中的動態載入器支援。例如,在 UNIX 或 Linux 中,您需要 /usr/include/dlfcn.h。這些預設值供內部使用。

getaddrinfo_using_addrconfig
只有在代理程式以獨立式服務形式執行於 UNIX 或 Linux 作業系統 (bfagent -s) 時,才會使用這項設定。當呼叫 getaddrinfo() 來選取接聽介面時,這項設定會使得代理程式使用 AI_ADDRCONFIG。依預設,不會使用 AI_ADDRCONFIG。

如果您使用這項設定,代理程式會忽略未適當配置位址的介面。它只會接聽已適當配置位址的介面。

lang lang-code

這項設定指定代理程式在撰寫訊息和指令輸出時所用的語言。

內部預設值是 en,這是視同它明確設定成如下:

lang en
leave_tmp_file

這項設定只在您要疑難排解時使用。

這項設定會保留用來保存逐步指令的暫存檔,而不會在執行指令之後將它刪除。

註: 請勿將這項設定用於一般作業。
locale locale-code.charset-code

這項設定僅適用於 UNIX 和 Linux 作業系統。Windows 處理語言環境的作法不同。

這項設定指定以本地化的方式使用應用程式時,所用的語言和多位元組字集。如果要讓這項設定生效,請設定代理程式環境定義的 LANG 環境變數。

如果要設定代理程式,使其將指令輸出視為美式英文 UTF-8,請讓您的作業系統採用 UTF-8 語言環境。例如,在 Linux 中使用下列的表示法。

locale en_US.UTF-8

如果要判斷您作業系統的 UTF-8 語言環境表示法是否正確,請執行 locale -a 指令。

如果沒有指定這項設定,代理程式會使用作業系統的語言環境。這項設定相當便利好用。尤其是如果作業系統的預設語言環境,不是您希望代理程式使用的語言環境,這項設定就可派上用場。再者,如果變更系統語言環境只為了符合代理程式需求,而非務實作法,更可善用這項設定。

magic_login user:encoded-password

一般而言,代理程式使用 root 或 admin 等管理專用權來登入作業系統。magic_login 設定可作為標準系統鑑別的替代方案。透過這項設定,系統可以使用單一使用者名稱與密碼來鑑別您的登入。

如果代理程式是以 root 或 admin 使用者身分執行,會忽略這項設定,並嘗試採取一般鑑別方式。

代理程式執行所有的指令時,所用的是啟動代理程式之使用者的許可權,而非使用登入時所用的使用者名稱。

只有在下列情況,才會使用這項設定:

如果要為代理程式配置登入,請執行下列動作:

  1. 建立一項採用使用者名稱與密碼的伺服器鑑別。
  2. 就本例來說,使用者名稱是 build,密碼是 MySecretPassword。
  3. 建立使用代理程式的伺服器。在鑑別欄位中,讓伺服器鑑別與這個伺服器產生關聯。
  4. 為代理程式產生一個編碼密碼。在代理程式的安裝目錄中,使用您選擇的密碼來執行 bfagent -P

    如下所示,這會傳回以 SMD5 雜湊編碼的密碼:

    bfagent -P "MySecretPassword"
    eca0b7f2f4fbf110f7df570c70df844e1658744a4871934a
  5. BFAgent.conf 中,將 magic_login 設定為使用所要的使用者名稱與編碼密碼。
    magic_login build:eca0b7f2f4fbf110f7df570c70df844e1658744a4871934a
  6. 啟動代理程式。
  7. 測試伺服器連線。在伺服器中,選取伺服器,然後按一下測試伺服器
map drive-and-user-spec[; ...]
這項設定指定對應磁碟機。某些系統可能需要磁碟機對應。例如,因為 Shell 從共用磁碟機執行,而可能需要磁碟機對應。代理程式中指定的對應,會比「管理主控台」中 _MAP 環境變數所指定的對應先執行。這個範例說明兩個磁碟機對應:
map X:=//host1/share;Z:=//host2/share(username,password)
map_drive_is_failure
當指定此項時,只要發現指定了非對應磁碟機,這項設定就會在步驟執行之前讓步驟失敗。如果沒有指定這項設定,步驟就會忽略磁碟機失敗,並試圖執行步驟。在該情況下,請確定失敗會產生有意義的錯誤訊息。
no_preparse_command
這項設定會停用變數擴充剖析;一般而言,代理程式在將指令傳遞給 Shell 之前,會對指令執行這項剖析。另請參閱可用於單一專案或步驟的 _NO_PREPARSE_COMMAND 環境變數。
no_pty

這項設定僅適用於在 UNIX 或 Linux 系統上執行的代理程式。

在 Shell 與代理程式的虛擬終端機互動時,這項設定有助於避免鎖定系統 Shell。一般而言,這項設定是搭配 HP-UX 與 z/OS 使用。您也可以使用其他兩種方法,協助避免發生這樣的鎖定:

no_pty 設定會停用虛擬終端機的配置。

註: 使用 no_pty 會影響某些指令。例如,ls 指令會以單一直欄而非三個直欄來傳回輸出。如果您使用這項設定,在您將工作部署至正式作業環境之前,必須先經過徹底測試。
nologonshell

這項設定僅適用於在 UNIX 或 Linux 上執行的代理程式。

這項設定會使得代理程式所要執行的 Shell,變成一般 Shell 而非登入 Shell。這項設定通常用於下列情況:

當設定此項時,會採用標準方法,要求 Shell 必須是一般 Shell 而非登入 Shell。這不見得適用於所有平台,若有這類情況,可使用 shellflag 設定傳遞旗標給 Shell,以修改其行為。

代理程式並不需要那些行為,因為它是以使用者身分而非互動使用者身分執行。

註: Mac OS X 10.5 系統使用 /bin/bash,而這不會對 nologonshell 做出回應。請使用 shellflag -l
註: 不論是登入 Shell 或非登入 Shell,z/OS 作業系統一律都是使用 /etc/profile Script。如果其行為無法與代理程式之間搭配良好,您可能需要變更 Script 的內容,或使用另一個 Shell。

另請參閱 shellflag 設定。可以使用旗標來變更登入 Script 行為。

password_encrypt_module dll_path;conf_path
需要在代理程式中啟用 SSL。它指定 DLL 與配置檔的路徑。
port port-number-or-range [...]

只有當您在啟動時發出 -s 選項,讓代理程式在 UNIX 或 Linux 中以獨立模式執行時,才會使用這項設定。

這項設定指定代理程式透過「管理主控台」來接聽連線時,所要使用的埠。

指定代理程式透過「管理主控台」來接聽連線時,所要使用的埠。

註: 依預設,會將埠設為 5555。若為 UNIX 或 Linux,這項設定位於 /etc/services 中。
shell shell_name [options]
這項設定指定預設 Shell。內部預設值如下:

您可以從步驟來置換這項設定。以含有 #! 的字行為開頭的步驟會置換 Shell 設定,而 nologonshell 設定用來執行逐步指令。

shell_compatible_undef_vars
這項設定會強制用空字串來表示未定義的變數。如果沒有設定,就會用變數名稱來表示 $VAR、${VAR} 或 %VAR% 格式的變數,用空字串來表示 $[VAR]。
shellarg

這項設定僅適用於在 UNIX 或 Linux 上執行的代理程式。

如果指令看起來很雜亂,請使用這項設定。Red Hat Linux Enterprise 中的某些 Shell 需要這項設定。

這項設定會變更將指令 Script 傳遞給 Shell 的方式。一般而言,Script 是透過標準輸入來傳遞:

   /bin/sh < /tmp/bfshellscript.sh

這項設定會將 Script 當成參數傳遞來執行它們:

/bin/sh /tmp/bfshellscript.sh
shellflag flag

這項設定僅適用於在 UNIX 或 Linux 上執行的代理程式。

這項設定會在 Shell 執行時新增旗標。只能指定一個旗標。一般而言,它用來停用 rc Script 處理程序,以減少輸出或不必要的處理。

範例:
ssl_ca_location path
指定內含憑證管理中心的金鑰儲存庫檔。如果代理程式是以服務形式執行,請使用絕對路徑。
ssl_cert_location path
指定內含私密憑證的金鑰儲存庫。如果代理程式是以服務形式執行,請使用絕對路徑。
ssl_client_authentication [true | false]
當設為 true,則在建立與代理程式的連線時,會要求進行用戶端鑑別。若為 true,必須將 Build Forge 引擎的憑證新增至代理程式的憑證管理中心金鑰儲存庫中。
ssl_cipher_group [grouplist | ALL]
指定要使用的個別密碼群組。可設為 ALL。
ssl_cipher_override cyphers
置換密碼群組。請指定要使用的密碼。
ssl_key_location path
指定內含金鑰的金鑰儲存庫檔。如果代理程式是以服務形式執行,請使用絕對路徑。
ssl_key_password password
金鑰的密碼。依預設,會以明碼形式來儲存這項內容。您可以讓代理程式使用自己的金鑰或 Build Forge 伺服器的金鑰,來加密這個密碼。
ssl_protocol protocol
要使用的 SSL 信號交換通訊協定,可以是下列之一:SSL、SSLv2、SSLv3、SSL_TLS、TLS、TLSv1。通訊協定必須符合 Build Forge 伺服器使用的通訊協定。
update_path path

這項設定識別 Build Forge 代理程式執行檔的完整路徑。在安裝期間會自動建立設定。目錄是作業系統的預設目錄,或是您指定的安裝目錄。

註: 在 Windows 代理程式中,會忽略這項設定。更新路徑取自登錄機碼。機碼是在安裝代理程式期間設定。
win_reexec_after_auth
如果您需要使用 Build Forge 伺服器鑑別認證,在網路共用檔案系統中執行代理程式指令,請新增這項設定。例如,如果要在 ClearCase 動態視圖中修改檔案,代理程式必須存取網路共用檔案系統中的 ClearCase 檔案。

Build Forge 代理程式在初次啟動時,使用的是 Windows 系統帳戶認證。為了執行指令,代理程式之後就會使用 Build Forge 伺服器鑑別認證向 Windows 鑑別。

如果沒有指定這項設定,網路共用磁碟機只能辨識起始的 Windows 系統帳戶認證,而會忽略後續這些需要存取並寫入至網路共用檔案系統中之檔案的伺服器鑑別認證。

在使用伺服器鑑別認證向 Windows 重新鑑別之後,win_reexec_after_auth 會啟動新程序,並強制共用檔案系統辨識已變更的認證。

當您使用 win_reexec_after_auth 設定時,代理程式會以服務形式執行,且不會識別哪些指令會存取網路共用檔案,哪些指令不會,因此您可能需注意效能衝擊問題。

疑難排解代理程式

本節說明的程序可供您用來疑難排解未能正確運作的代理程式。請依序逐一完成各項程序。如果透過這些程序仍無法讓代理程式運作,請聯絡「支援中心」。

測試主機名稱解析

驗證可以呼叫到代理程式主機。請使用 ping 公用程式來測試代理程式主機:

ping hostname

這個範例階段作業是在安裝代理程式的 Windows 上執行。

C:\> ping localhost

Pinging somehost.city.company.com [127.0.0.1] with 32 bytes of data:

Reply from 127.0.0.1: bytes=32 time<1ms TTL=128
Reply from 127.0.0.1: bytes=32 time<1ms TTL=128
Reply from 127.0.0.1: bytes=32 time<1ms TTL=128
Reply from 127.0.0.1: bytes=32 time<1ms TTL=128

Ping statistics for 127.0.0.1:
    Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 0ms, Maximum = 0ms, Average = 0ms

類似如下的訊息指出有問題:

不明主機

此問題出現在網路配置中。請聯絡您的網路管理者。

測試連線

您可以使用 Telnet 來測試代理程式連線。

如果要從指令行來測試連線,請執行下列動作:

  1. 使用 Telnet 指令來連接代理程式。如果您已登入正在執行代理程式的主機,則可以使用 localhost 作為主機名稱。
    telnet hostname 5555
    這項回應指出連線成功:
    200 HELLO - BuildForge Agent v7.0.1.buildnumber
  2. 使用您的登入認證發出下列指令,以檢查鑑別:
    telnet localhost 5555
    username user name
    password  password
    cmd ping
    go

    下列訊息指出成功:

    鑑別:將使用者帳戶設定為 <user name>
    如果上述測試可以運作,但工作卻失敗,而您的伺服器測試顯示使用者鑑別錯誤,請檢查可外掛的鑑別模組 (PAM) 配置。如果您看到類似如下的訊息,請繼續進行下一步驟。
    鑑別:無法將使用者帳戶設定為 <user name>:不明帳戶 (1)
  3. 輸入下列指令:
    cmd ping go

    以下是一般的 Telnet 階段作業輸出。尤其是看看輸出尾端的 RESULT 0 是否指出成功。這項測試是針對在 Windows 上執行的代理程式所執行。

    300 DATA s 67
    鑑別:執行身分:[SYSTEM] 位於網域 [NT AUTHORITY] SID 類型 [User]
    300 DATA s 52
    鑑別:正在使用專用權來執行:[鎖定記憶體分頁]
    300 DATA s 66
    鑑別:正在使用專用權來執行:[調整程序的記憶體配額]
    300 DATA s 63
    鑑別:正在使用專用權來執行:[建立永久共用物件]
    300 DATA s 46
    鑑別:正在使用專用權來執行:[程式除錯]
    300 DATA s 56
    鑑別:正在使用專用權來執行:[略過遍訪檢查]
    300 DATA s 61
    鑑別:正在使用專用權來執行:[備份檔案與目錄]
    300 DATA s 54
    鑑別:正在使用專用權來執行:[變更系統時間]
    300 DATA s 68
    鑑別:正在使用專用權來執行:[將電腦從接駁站抽離]
    300 DATA s 73
    鑑別:正在使用專用權來執行:[鑑別之後假冒用戶端]
    300 HEARTBEAT 1
    300 DATA s 16
    PLAT:Windows XP
    250 RESULT 0
    PING:內部迴圈測試完成
    260 EOR
在 Windows 上疑難排解代理程式

如果要在 Windows 上疑難排解代理程式,請執行下列動作:

  1. 檢查是否已安裝執行檔。請驗證下列檔案是否已存在於代理程式安裝目錄中:
    註: 在繼續之前,請判斷您是否使用自訂配置。如果您使用自訂配置,請將 BFAgent.conf 儲存在安裝目錄外,然後在安裝之後將它還原。
  2. 重新安裝代理程式。重新安裝代理程式就能夠解決大部分的 Windows 代理程式問題。它會更新執行檔,並還原登錄機碼。
疑難排解 UNIX 或 Linux 上的代理程式

如果要疑難排解 UNIX 或 Linux 上的代理程式,請嘗試執行下列程序:

安裝 Rational Team Concert for System z 用戶端

RTCz:用戶端安裝概觀

安裝 Rational Team Concert for System z 用戶端的方式有兩種。

您可以從 http://jazz.net 下載 Jazz Team Server for System z、Rational Team Concert for System z 用戶端、Build System Toolkit for System z、ClearCase® Connector、ClearQuest® Connector 及其他 Incubator 檔案。 如果要購買 Rational Team Concert for System z,請移至 http://www.ibm.com/software/awdtools/rtcz/,您可以在這裡下載可安裝映像檔或訂購 DVD。

請選擇下列一種安裝方法:

註: 如果啟用「安全加強型 Linux (SELinux)」,您必須將它停用,或變更 Java 執行時期環境 (JRE) 的安全環境定義來允許文字重新定位,才能安裝和執行 Rational Team Concert for System z。 如需詳細資訊,請參閱在安全加強型 Linux 中安裝 Rational Team Concert for System z
註: 如果您打算將 Rational Team Concert for System z 安裝在現有的 Eclipse 型產品上(有時稱為 Shell 共用),您應該使用 Installation Manager 安裝方法。 Installation Manager 可讓您選擇要安裝用戶端的現有 Eclipse 實例,從而簡化了 Shell 共用。

RTCz:使用 IBM Installation Manager 來安裝用戶端

用戶端是透過 IBM Installation Manager 以可下載的檔案方式配送。

執行這項作業的原因和時機

註: 如果您想將用戶端安裝至現有的 Eclipse 工作台,請使用 IBM Installation Manager。IBM Installation Manager 安裝會提示您提供您想擴充的工作台,並顧及未來工作台更新、回復和修改等的管理。

  1. 下載下列其中一個安裝套件。

    Rational Team Concert for System z 用戶端有三種安裝方法。

  2. 啟動啟動程式。

    如果 Installation Manager 已不在執行中,請完成下列步驟來啟動它。

    註: 您必須具備管理者專用權,才能執行啟動程式。
    註: 用來啟動啟動程式的 Linux 指令僅適用於 Rational Team Concert for System z for Eclipse IDE。
  3. 您可以安裝下列用戶端: 這時會顯示 Installation Manager 精靈。精靈會引導您完成用戶端的安裝。
  4. 按一下安裝所建立的 Rational Team Concert for System z 捷徑,來啟動用戶端。
  5. 連接伺服器。 連接伺服器最簡單的方式是使用「團隊邀請」。如果您未獲邀請,可手動連接。
    1. 按一下檔案 -> 接受團隊邀請。精靈會引導您完成程序。
      註: 如果您未獲邀請,必須向您的伺服器管理者取得 URI 或 URL。(例如,格式可以是 https://example.com:9443/jazz)。按一下位於接受團隊邀請視窗右下角的連接現有的專案區域超鏈結。
    2. 遵循精靈中的指示,來設定您的連線。

範例

疑難排解:建議採用以下的問題管理技術。

RTCz:使用 .zip 檔來安裝用戶端

用戶端是以可下載的 .zip 檔來配送。

執行這項作業的原因和時機

  1. 下載用戶端套件檔。

    您應下載 Rational Team Concert for System z 用戶端 .zip 檔。

    註: 如果您想將用戶端安裝至現有的 Eclipse 工作台,請使用 IBM Installation Manager。IBM Installation Manager 安裝會提示您提供您想擴充的工作台,並顧及未來工作台更新、回復和修改等的管理。
  2. 安裝用戶端發行套件。將 .zip 檔解壓縮至您所選的安裝目錄中 (例如,Linux 上的 /opt/IBM/,或 Windows 上的 c:\IBM)。用戶端路徑是 JazzInstallDir/client,這是您所選安裝目錄的相對目錄。
  3. 啟動用戶端。在 JazzInstallDir/client/eclipse 目錄中按兩下 eclipse.exe 應用程式。
  4. 連接伺服器。 連接伺服器最簡單的方式是使用「團隊邀請」。如果您未獲邀請,可手動連接。
    1. 按一下檔案 -> 接受團隊邀請。精靈會引導您完成程序。
      註: 如果您未獲邀請,必須向您的伺服器管理者取得 URI 或 URL。(例如,格式可以是 https://example.com:9443/jazz)。按一下位於接受團隊邀請視窗右下角的連接現有的專案區域超鏈結。
    2. 遵循精靈中的指示,來設定您的連線。

範例

疑難排解:建議採用以下的問題管理技術。

安裝共用 Rational Developer for System z 與 Rational Team Concert for System z 用戶端

如果您計劃整合 Rational Team Concert for System z 與 Rational Developer for System z,則必須使用 IBM Installation Manager,將 Rational Team Concert for System z 用戶端安裝至 Rational Developer for System z 套件群組中。

如需安裝和使用 Rational Team Concert for System z 與 Rational Developer for System z 整合產品的相關資訊,請參閱 Rational Team Concert for System z 資訊中心的安裝和配置整合,位置如下:http://publib.boulder.ibm.com/infocenter/rtczhelp/v2r0m0/index.jsp。

存取 Rational Team Concert for System z 的 Web 型說明

IBM Rational Team Concert for System z 說明系統配置成使用 Web 型說明,會從網際網路動態取得內容。 當使用 Web 型說明時,您一律會有 Rational Team Concert for System z 的最新內容。 部分說明系統並未配置來存取在 Web 上的說明內容;在這種情況下,會隨著安裝而併入說明內容。

您可以用三種方法來取得說明。 在這些選項中,依您的需求和狀況而定,會有一個最適合您的選項:

您隨時可以變更存取決策。 如果將多個產品安裝在一起,每個產品的說明可以分別使用不同的位置,這會隨著安裝覆蓋區、使用頻率及網際網路原則而不同。 如果網際網路速度有問題,較長的單次下載及本端存取可能比較好。 稍後說明更新項目只含有差異部分。 請參閱下列主題,以取得設定及變更說明存取方法的詳細資訊:

如果您是管理者,且想要使用者從企業內部網路伺服器存取說明內容,請參閱 Installation Manager 資訊中心,以取得如何安裝伺服器上的說明 WAR 檔的指示。 在 Installation Manager 資訊中心中,選取企業安裝文章 -> 從企業內部網路伺服器遞送說明內容

利用「本端說明系統更新程式」網站來下載說明內容

這個主題說明如何從「本端說明系統更新程式」網站來下載、移除和更新說明內容。 當您啟用 Web 交付來安裝 Rational Team Concert for System z 時,大部分說明內容都不會安裝。 如果要在本端存取所有說明內容,您必須從「IBM 本端說明系統更新程式」網站下載它。

開始之前

在安裝期間,會選取說明存取選項下載說明並在本端存取內容

執行這項作業的原因和時機

在使用產品的說明之前,您必須先將說明下載到您的本端系統中。

如果要從「本端說明系統更新程式」網站下載說明內容,請完成下列步驟:

  1. 在開啟 Rational Team Concert for System z 之後,按一下說明 -> 本端說明更新程式。 這時會開啟「更新程式」網站。
  2. 在窗格中,選取要下載之說明的位置。 請選取 Rational Team Concert for System z。 如果 Rational Team Concert for System z 不在清單中,您必須新增位置。
    1. 選取內部網站標籤。
    2. 選取 + 圖示來新增位置。
    3. 選取遠端
    4. 輸入網站的名稱。
    5. 在 URL 中,輸入 http://publib.boulder.ibm.com/infocenter/rtczhelp/v2r0m0/site/site.xml。
  3. 這時會將可供下載的說明清單移入「可用的特性」清單中。 依您的網路連線速度而定,這項作業可能需要幾分鐘。 請選取您需要的說明內容。
  4. 按一下安裝。 下載及安裝說明內容。 這時會開啟進度列來追蹤下載狀態。
  5. 下載完成時,請選取說明 -> 說明內容來開啟產品中的說明。

結果

您選取的說明會安裝在您的系統上。 當網際網路連線可用時,會自動更新這些檔案。

利用「本端說明系統更新程式」和 RTCz2.0_updateSite.zip 檔,將說明內容安裝在本端環境中

如果您不要用遠端說明來存取 Web 中的說明內容,您必須將說明內容安裝在本端環境中。 這個主題說明如何利用「本端說明系統更新程式」和安裝映像檔提供的 RTCz2.0_updateSite.zip 檔,來安裝說明內容。

開始之前

在安裝期間,會選取說明存取選項下載說明並在本端存取內容

執行這項作業的原因和時機

在使用產品說明之前,您必須先將說明安裝到本端系統中。

如果要利用「本端說明系統更新程式」,將說明內容安裝在工作站上,請完成下列步驟:

  1. RTCz2.0_updateSite.zip 檔的內容解壓縮至系統上的暫存位置。
  2. 利用 Windows Internet Explorer 作為您的預設瀏覽器,開啟 Rational Team Concert for System z,按一下說明 -> 本端說明更新程式。 這時會開啟「本端說明更新程式」。
  3. 指定解壓縮之 RTCz2.0_updateSite.zip 檔的位置。
    1. 選取內部網站標籤。
    2. 選取 + 圖示來新增位置。
    3. 選取本端
    4. 輸入網站的名稱。
    5. 按一下瀏覽,瀏覽到 RTCz2.0_updateSite.zip 內容的解壓縮位置。
    6. 按一下確定。 當「本端說明更新程式」搜尋併入 RTCz2.0_updateSite.zip 檔的可用特性時,會開啟一個進度列來追蹤狀態。
  4. 這時會將可供下載的說明清單移入可用的特性清單中。 選取 Rational Team Concert for System z 文件
  5. 按一下安裝。 這時會開啟進度列來追蹤安裝狀態。
  6. 安裝完成之後,請選取說明 -> 說明內容來開啟產品中的說明。

結果

您選取的說明會安裝在您的系統上。

更新說明內容

利用「本端說明系統」更新程式,來確保您有最新的說明內容。

開始之前

您已從「本端說明系統更新程式」網站安裝說明特性。

執行這項作業的原因和時機

您每次啟動產品時,如果有網際網路連線,都會自動安裝更新項目。

如果要更新說明,而不重新啟動產品,請完成下列步驟:

  1. 關閉產品說明系統視窗。
  2. 選取說明 -> 本端說明更新程式來開啟「本端說明系統更新程式」。 這時會開啟「更新程式」網站。
  3. 按一下已安裝的特性標籤。
  4. 按一下搜尋更新項目。 如果已安裝的內容有更新項目,它們會安裝到您的系統上。 進度列會指示要求的狀態。
  5. 更新完成之後,請選取說明 -> 說明內容來開啟產品中的說明。

移除說明內容

您可以利用「本端說明系統更新程式」來移除已安裝的說明內容。

開始之前

您已利用「本端說明系統更新程式」來下載說明特性。

執行這項作業的原因和時機

如果要移除已安裝的說明內容,請完成下列步驟:

  1. 關閉產品說明系統視窗。
  2. 按一下說明 -> 本端說明更新程式來開啟「本端說明系統更新程式」。 這時會開啟「更新程式」網站。
  3. 按一下已安裝的特性標籤。
  4. 選取您要移除的特性,然後按一下移除。 您選取的說明特性會從您的系統中移除。 進度列會指示要求的狀態。
  5. 移除完成之後,請選取說明 -> 說明內容來開啟產品中的說明。

設定企業內部網路伺服器的說明內容

您可以在防火牆後面設定一部企業內部網路伺服器,以向使用者提供說明內容。 當使用這個方法時,使用者不需要將說明內容下載及儲存到他們的電腦中。

開始之前

您有一個可用的伺服器,防火牆後面的使用者可以存取這個伺服器。

執行這項作業的原因和時機

請參閱 Installation Manager 資訊中心,以取得針對說明內容來設定企業內部網路伺服器的指示。 在 Installation Manager 資訊中心中,選取企業安裝文章 -> 從企業內部網路伺服器遞送說明內容

變更存取說明內容的方式

您可以變更您存取說明內容的方式。 可選擇的方法如下:從 Web 存取說明;下載說明並在本端存取內容;或從企業內部網路的伺服器存取說明。

在變更您存取說明內容的方式之前,請先關閉說明瀏覽器。

在安裝程序期間,您選取下列其中一個方法來存取說明內容:

如果要變更您存取說明內容的方式,請完成下列步驟:

  1. 按一下視窗 -> 喜好設定。 這時會開啟喜好設定視窗。
  2. 展開說明項目,然後按一下內容。 這時會開啟一份清單,其中會顯示目前配置的一或多個資訊中心。 依所選的存取方法而定,請完成下列程序之一。

在 Internet Explorer 中發生記憶體不足或 Script 錯誤

如果您在使用線上說明時,收到記憶體不足或 Script 錯誤,您可能需要使用另一個瀏覽器。

執行這項作業的原因和時機

如果您利用 Internet Explorer 來開啟線上說明,您可能會收到類似下列錯誤訊息:

這個頁面上的 Script 會使 Internet Explorer 執行速度變慢。
如果它繼續執行,您的電腦可能變成沒有反應。

記憶體不足,行號:number

這是一個 Internet Explorer 的已知問題,暫行解決方法是使用另一個瀏覽器。 您可以依照下列方式來選擇另一個瀏覽器:

  1. 按一下視窗 > 喜好設定,然後從喜好設定頁面清單中選取說明
  2. 按一下使用外部瀏覽器勾選框,然後按一下套用
  3. 一般之下,展開喜好設定頁面清單,然後按一下 Web 瀏覽器。 這個頁面會顯示一份清單,列出工作站所安裝的瀏覽器。
  4. 按一下要用的瀏覽器旁的勾選框,然後按一下套用

安裝 Rational Team Concert for System z 連接器

如果要安裝 ClearCase Connector 和 ClearQuest Connector 等連接器,請執行下列動作:

安裝 Rational Team Concert for System z ClearCase Connector

如果要安裝 ClearCase Connector ,請執行下列動作:

使用 IBM Installation Manager 來安裝 Rational Team Concert for System z ClearCase Connector

您可以使用 IBM Installation Manager,將 ClearCase Connector 安裝在建置機器上。

執行這項作業的原因和時機

  1. 啟動啟動程式。

    如果 Installation Manager 不在執行中,請啟動它。

    註: 您必須具備管理者專用權,才能執行啟動程式。
  2. 當出現啟動程式時,請按一下 ClearCase Connector,以啟動安裝程序。
  3. 在安裝完成後,請配置 ClearCase Connector。

從 .zip 檔來安裝 Rational Team Concert for System z ClearCase Connector

您可以使用下載的 .zip 檔,將 ClearCase Connector 安裝在建置機器上。

執行這項作業的原因和時機

  1. 下載 ClearCase Connector .zip 檔。
  2. 將 .zip 檔解壓縮至 JazzInstallDir 目錄。
  3. 在安裝完成後,請配置 ClearCase Connector。

安裝 Rational Team Concert for System zClearQuest Connector

如果要安裝 ClearQuest Connector ,請執行下列動作:

使用 IBM Installation Manager 來安裝 Rational Team Concert for System zClearQuest Connector

您可以使用 IBM Installation Manager,將 ClearQuest Connector 安裝在建置機器上。

執行這項作業的原因和時機

  1. 啟動啟動程式。

    如果 Installation Manager 不在執行中,請啟動它。

    註: 您必須具備管理者專用權,才能執行啟動程式。
  2. 當出現啟動程式時,請按一下 ClearQuest Connector,以啟動安裝程序。
  3. 在安裝完成後,請配置 ClearQuest Connector。

從 .zip 檔來安裝 Rational Team Concert for System zClearQuest Connector

您可以使用下載的 .zip 檔,將 ClearQuest Connector 安裝在建置機器上。

執行這項作業的原因和時機

如果要從 .zip 檔來安裝 ClearQuest Connector,請執行下列動作:

  1. 下載 ClearQuest Connector .zip 檔。
  2. 將 .zip 檔解壓縮至 JazzInstallDir 目錄。
  3. 安裝完成之後,請配置 ClearQuest Connector。

技術預覽:上下文搜尋與工作顧問特性

上下文搜尋與工作顧問特性可讓您透過任意文字搜尋來尋找程式碼,並對於工作項目的相關程式碼位置提供建議。這項特性是以技術預覽形式提供。

如需安裝和使用上下文搜尋與工作顧問預覽的相關資訊,請參閱 http://ibm.com/support/docview.wss?rs=3641&uid=swg27016785

版本注意事項 - Rational Team Concert for System z 2.0 版

本文件含有 IBM Rational Team Concert for System z 2.0 版的系統需求、安裝與已知問題等相關資訊。此外亦提供 「IBM Rational 軟體支援中心」的聯絡資訊。

內容

說明

IBM Rational Team Concert for System z 2.0 版是一項建置在能夠延伸的可調式平台上的團隊協同作業工具,這個平台可以在整個軟體生命週期中整合各項作業。此外還提供以下的特性:

系統需求

如需軟硬體相容性的相關資訊,請參閱下列鏈結:

支援的整合

IBM Rational Team Concert for System z 2.0 版支援以下的整合環境。

安裝 Rational Team Concert for System z 2.0 版

如需逐步安裝指示,請參閱資訊中心中的下列主題:

已知問題

已知問題會以個別的 TechNotes 形式記載在「支援」知識庫中。一旦發現與解決問題,「IBM 支援中心」團隊就會更新知識庫。透過搜尋知識庫,您可以迅速找到問題的暫行解決方法或徹底解決方案。

下列鏈結會啟動自訂的即時「支援知識庫」查詢:

IBM、IBM 標誌與 ibm.com® 是 International Business Machines Corp. 在全球眾多適用範圍中的商標或註冊商標。其他產品與服務名稱可能是 IBM 或其他公司的商標。IBM 現行商標清單可在網路上的 "Copyright and trademark information" 中取得,其網址是 www.ibm.com/legal/copytrade.shtml

索引

 三劃   四劃   五劃   六劃   七劃   八劃   九劃   十劃   十一劃   十二劃   十三劃   十四劃   十六劃   十七劃   A   B   D   E   I   L   O   R   S   T   W   Z   特殊字元 
三劃 四劃 五劃 六劃 七劃 八劃 九劃 十劃 十一劃 十二劃 十三劃 十四劃 十六劃 十七劃 A B D E I L O R S T W Z 特殊字元