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 的程序類似於升級至 Rational Team Concert 2.0。 這個程序所涉及的主要步驟如下:
您可以利用若干方式來升級至 Rational Team Concert for System z 2.0,其中包括下列實務:
在您更新成 2.0 之後,如果您是在選取修改來新增或移除語言之前,就啟動 Jazz™ Team Server for System z,則必須按如下所示來重設伺服器:
之後,您可以在 Installation Manager 中選取修改來新增或移除語言。
如果您有 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 安裝。
從 2.0 試用版開始,您可以購買和安裝您的版本所適用的「伺服器啟動套件」,將伺服器設置成永久版本;「伺服器啟動套件」供應位置如下:http://www.ibm.com/software/awdtools/rtcz/。 啟動套件由一個含有永久伺服器金鑰的 JAR 檔組成。 您可以使用伺服器管理 Web 介面的「授權金鑰管理」頁面來安裝它。
您可以從舊版 Rational Team Concert 或 Rational Team Concert for System z 升級至 Rational Team Concert for System z 的 2.0 版。 需要移轉資料庫。
如果您是從 .zip 檔來安裝先前的版本(例如,在 Linux for System z 上),就不會有與前版安裝的交集。 您可以從 zip 將 2.0 版安裝在新位置,或使用 IBM Installation Manager 來安裝一個 2.0 實例。
如果當初您使用 IBM Installation Manager 來安裝舊版,則可以將 2.0 安裝成個別的實例,或者將舊有實例更新成 2.0。 如果您想針對 2.0 版安裝個別的伺服器實例,請在安裝精靈的安裝套件頁面上,選取建立新套件群組。
如需完成升級,請參閱複製先前伺服器安裝中的必要配置檔和安裝 2.0 啟動鍵。
在 2.0 版中,儲存資料庫有了結構性變更,會防止您重複使用 z/OS 上 Rational Team Concert for System z 1.0.1 的資料庫。 從 Rational Team Concert for System z 1.0.1 版升級至 2.0 的程序,由下列三個步驟組成:
請遵循範例 JCL 中的指示來配置 BLZEXPOR。 提交已修改的 JCL,並檢查工作日誌。只有在結束時回覆碼為 300 時,才表示工作已順利執行。
匯出檔會放在 @jazzExport@ 所指定的 HFS 位置中。 檔案名稱將是 @dbexport@.tar,如 BLZEXPOR 所定義。
提交已修改的 JCL,檢查日誌檔來確認 repotools 已順利完成。
提交已修改的 JCL,檢查日誌檔來確認 repotools 已順利完成。
如果要完成升級,請參閱複製先前伺服器安裝中的必要配置檔。
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 版本,您必須先升級至所需要的版本,然後載入您的版本適用的永久「伺服器啟動套件」和「用戶端存取授權」。
必須執行下列步驟,以便在 Rational Team Concert for System z 2.0 中,適當配置 WebSphere Application Server。
file:///<JazzInstallDir>/server/conf(z/OS 以外的系統),或設為:
file:///@confPath@(z/OS),其中 @confPath@ 是 BLZCPDIR 中所設的配置路徑。
將下列檔案從來源伺服器複製至目標伺服器。首先,將已升級伺服器中的原始檔案重新命名,以建立備份。如果您是用 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 的「開發人員用戶端啟動套件」,如此便能使用這些用戶端授權。您的「開發人員」授權指派仍舊有效,但「開發人員」授權將會停用,直到您安裝正確的啟動套件為止。
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 之後,您可以手動更新專案以設定專案時間表。
資料倉儲的「來源控制管理 (SCM)」Snapshot 會收集串流的資料,其中包括串流大小與其中之活動(變更集與檔案/資料夾變更)的相關資訊。 在 1.0.1 版中,這個 Snapshot 會自動收集所有串流的相關資訊。這樣的作業頗耗成本,因此 2.0 版中的 SCM Snapshot 多了可配置選項,可讓使用者決定應收集哪些串流的資料。這項變革的立即影響是除非您配置它,否則並不會收集資料。
如果要配置「來源控制」Snapshot,請執行下列動作:
這樣就會在後續所有的 Snapshot 中,收集所選串流的資料。
如果您已使用 BIRT 報告設計程式來建立自己的報告範本,當您嘗試在 2.0 版中使用這些報告時,可能會遇到一些問題。 您應注意下列問題:
如果不注意,這些問題可能會很嚴重,因為報告所收集的資料可能不正確。在第一次使用 BIRT 2.3.2 報告設計程式來編輯報告時,最好能夠檢查每一個資料集與每一個報告參數。如果是以 BIRT 2.3.2 工具來建立的新報告,就不會發生這些問題。
上述的變更都是針對所有 Rational Team Concert for System z 2.0 現成報告。 您這邊不需要執行任何動作。 不過,如果您已使用我們的現成報告,在您的專案區域中手動建立報告範本,且尚未指定適當的 ID(與我們的用法一致),則您的報告範本在移轉時並不會重新整理。亦即,其內容不會是最新的,且將無法運作。在該情況下,您應使用適當的現行 .rptdesign 檔,上傳受影響範本的新內容。
在 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.0.1 升級至 2.0 時,會保留您對工作項目類型、屬性、工作流程、角色與事件處理程式的變更。如果您曾自訂預先定義的程序範本(例如 Scrum),要注意的是,如果您重新部署預先定義的範本(在「程序範本」視圖中),將會改寫您的自訂內容。如果您需要重新部署預先定義的範本,應先變更您已自訂之預先定義範本的名稱與 ID,這樣就不會遭到改寫。
本資訊有助您瞭解安裝成功的需求條件。
請完成下列作業,來安裝在 z/OS 以外的所有平台上:
所有可以安裝在 z/OS 中的 Rational Team Concert for System z 元件,都會包含在 SMP/E 套件中。套件含有「程式目錄」與四個 FMID,而您可以根據您安裝所需的元件,選擇性地安裝它們。這些元件如下:
請遵循安裝之元件的自訂指示。 請參閱程式目錄和在 z/OS 上安裝 Rational Team Concert for System z,以取得在 z/OS 上安裝的詳細指示。
此資訊有助您規劃安裝。
在您規劃安裝時,請考量下列事項。
這份工作表可協助您規劃成功的安裝,並選擇您自訂的配置選項。
下表列出安裝和設定程序期間您可能需要提供的選項和資訊。這份表格有助您在安裝和設定伺服器期間填寫表單。
| 判斷您的需求和配置的詳細資料 | 安裝考量和部分回答範例 |
|---|---|
|
選擇版本。 |
|
|
您需要多少「用戶端存取授權」? |
|
|
驗證是否支援您的伺服器環境。 |
記錄伺服器資訊
|
|
選擇一個應用程式伺服器。
|
選擇一個應用程式伺服器:
如果您將 Jazz Team Server for System z 安裝成搭配 IBM WebSphere Application Server 使用,請記錄下列資訊:
如果預設埠和已在使用的埠衝突,則會改列您使用的埠。
|
|
選擇一種資料庫和連線類型。
註: 雖然預設配置已包含
Derby 資料庫而不需安裝,但這個資料庫無法支援超過 10 位使用者。如果您想支援超過 10 位的使用者,但又無現有 DB2 或 Oracle 資料庫的存取權,請安裝 DB2 Express。 |
資料庫資訊:
資料庫連線類型:
資料庫位置:
|
|
您想如何管理使用者? |
身分管理選項:
|
|
選用:您想啟用電子郵件通知嗎? |
SMTP 伺服器的詳細資料
您想啟用電子郵件白名單,來限制電子郵件通知的範圍嗎? 例如 *@example.com 只容許傳送電子郵件至您公司的電子郵件位址。 |
|
選用:您想啟用 Jabber 會談伺服器嗎? |
Jabber 伺服器的詳細資料
|
|
驗證是否支援您的用戶端環境。 |
|
|
您想使用 ClearCase Connector 或 ClearQuest Connector 嗎? |
這項資訊討論選擇應用程式伺服器的若干考量。
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:
這項資訊討論選擇資料庫的若干考量。
Jazz Team Server for System z 含有 Derby 作為預設資料庫。
Rational Team Concert for System z 包含一個 DB2 Workgroup Server Edition 版本。
如果您的環境已在使用 DB2 或 Oracle,Jazz Team Server for System z 可以配置成搭配現有的資料庫軟體來執行。
如果您使用 DB2 資料庫,請檢閱下列資訊。
檢閱 DB2 文件,驗證您的系統符合需求條件且配置正確。
如果要充分利用狀態選擇提取最佳化(可在大型資料庫上提升效能),DB2 使用者必須設定 DB2_OPTPROFILE。請執行下列指令,來設定 DB2_OPTPROFILE。
db2set DB2_OPTPROFILE=YES db2stop db2start
請確定已接連執行上述指令。如果要查看是否已設定,請執行下列指令:
db2set DB2_OPTPROFILE
請從以下挑選一個使用者管理選項。
預設的使用者管理可讓您不需藉助任何外部使用者管理系統,即能管理使用者。只有在已安裝 Apache Tomcat 時,才能使用 Apache Tomcat 使用者資料庫來管理使用者。
使用者名稱和加密密碼儲存在 tomcat-users.xml 檔中。所做的更新(例如:建立新使用者、變更使用者密碼或儲存庫許可權角色) 會自動寫到 xml 檔中。不需編輯檔案。
這項資訊可以協助您配置 LDAP 登錄來管理使用者。
如果您計劃搭配 Jazz Team Server for System z 來使用 LDAP 登錄,您必須將您的 Apache Tomcat 或 WebSphere Application Server 配置成利用 LDAP 登錄來鑑別使用者。
如果要配置 LDAP 來搭配 Jazz Team Server for System z 運作,請遵循下列作業:
| 參數 | 值說明 |
|---|---|
| LDAP 登錄位置 | 參照 LDAP 伺服器的 URL。ldap://ldap.example.com:389 |
| 使用者名稱 | 登入這部 LDAP 伺服器的使用者名稱。 某些 LDAP 伺服器接受匿名登入與密碼。在這個情況下,這個參數空白。 |
| 密碼 | 關聯於使用者名稱的密碼。 |
| 基本使用者 DN | 搜尋基準指出從階層中的哪裡開始搜尋使用者。 例如 "o=company,l=your city,c=your country" |
| 使用者內容名稱對映 | Jazz 使用者內容名稱至 LDAP 登錄項目屬性名稱的對映。您必須定義下列對映:
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 個要對映的群組:
|
| 群組名稱內容 | 代表 LDAP 登錄中之 Jazz 群組名稱的 LDAP 內容。 例如,cn。此項在查詢中用來擷取 LDAP 群組。在擷取 LDAP 群組時,查詢會採用「基本群組 DN」與「群組名稱內容」組合。 |
| 群組成員內容 | 代表 LDAP 登錄中之群組成員的 LDAP 內容。 例如,uniquemember。 |
如果要配置 LDAP 連線,並匯入使用者,請遵循下列步驟:
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"
digest="SHA-1"
digestEncoding="UTF-8"/>如需配置 Apache Tomcat 使用 LDAP 的其他資訊,請參閱以下的相關鏈結。如果要在 Apache Tomcat 中配置 LDAP 的 Web 儲存器,請遵循下列步驟:
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"
digest="SHA-1"
digestEncoding="UTF-8"/><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"/><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>
詳細系統需求
Apache Tomcat 網域範圍配置:配置 Apache Tomcat,以透過 JNDI 查閱來使用 LDAP
將 Websphere 配置成使用「輕量型目錄存取通訊協定 (LDAP)」使用者登錄
將使用者對映至角色 (Websphere)配置 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 無法匯入使用者或顯示其角色,但這些角色會作為鑑別和授權用。
您可以利用 IBM Installation Manager,以無聲自動模式來安裝 Rational Team Concert for System z。
進行無聲自動模式安裝的基本步驟如下:
如需利用 Installation Manager 進行無聲自動安裝的詳細資訊,請參閱 IBM Installation Manager 資訊中心,位置如下:http://publib.boulder.ibm.com/infocenter/install/v1r2/index.jsp。
某些伺服器環境有特殊的配置考量。
如果您的配置包含以下所列的一或多個應用程式伺服器或作業系統,在開始安裝之前,請先檢閱資訊。
當 Jazz Team Server for System z 是安裝在 Linux® 或 Linux for System z 上,請檢閱下列特殊指示。
tomcat_user hard nofile 5000 tomcat_user soft nofile 5000
若有啟用「安全加強型 Linux (SELinux)」,您必須停用它,或者變更安裝和執行 Rational Team Concert for System z 時所用的 Java™ 執行時期環境 (JRE) 的安全環境定義,以容許重新定位文字。
如果您設定機器的目的只在於評估 Rational Team Concert for System z,且 SELinux 特性對您來說不重要,則繼續進行的最簡單方法是停用 SELinux。
chcon -R -t textrel_shlib_t /tmp/rtc/linux/jre_5.0.2.sr5_20070511/jre
Jazz Team Server for System z 提供一份和 Apache Tomcat 伺服器之間進行 SSL 時用的自簽憑證。
某些瀏覽器和用戶端在存取您的 Jazz 儲存庫時,可能會顯示警告。如果要停止警告,請執行下列之一:
以隸屬於您公司的憑證取代自簽憑證。
在 JazzInstallDir/server/tomcat/conf/server.xml 檔中,Apache Tomcat 是配置成從 JazzInstallDir/server/tomcat/ibm-team-ssl.keystore 讀取伺服器的憑證。預設金鑰儲存庫密碼是設定為 ibm-team。這個金鑰儲存庫含有用來將伺服器識別為 "localhost" 的自簽憑證。
Jazz Team Server for System z 隨附的 IBM JRE 含有一個 IBM 工具,有助於管理伺服器上的金鑰。這個 iKeyman 工具位於 JazzInstallDir/server/jre/bin/ 目錄(在 Windows® 上則是 ikeyman.exe)。
iKeyman 工具可協助您建立自己的自簽憑證,以便使用主機的適當網路名稱來識別該主機,或者您也可以申請一份由授信憑證管理中心 (CA) 簽署的憑證。自簽憑證需經過 Team Concert 用戶端或 Web 瀏覽器的認可。
如需詳細資訊,請參閱 Secure Sockets Layer 簡介和 iKeyman 使用手冊。
如需相關資訊,請參閱:
如果您不需要安全連線,可停用安全設定。
<Connector port="9080" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8"/>
這個主題提供在 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 管理者來執行。
請確定內含 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 程序處於作用中。
當 Jazz Team Server for System z 搭配 DB2 for z/OS 執行時,您必須建立一個 DB2 儲存體群組與 DB2 資料庫。您也必須授權 Jazz Team Server for System z 使用者使用該儲存體群組與資料庫。
在您執行儲存庫工具資料庫建置器公用程式,以便在資料庫實例中建立 Jazz 儲存庫表格之前,必須先執行下列步驟。 Jazz Team Server 資料庫建置器公用程式不會執行任何這些步驟。
CREATE STOGROUP JAZZSTG VOLUMES ('*') VCAT yourHlq ;
CREATE DATABASE JAZZDB STOGROUP JAZZSTG BUFFERPOOL bp8kx ;
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 ;
依預設,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):
編輯下列字行,以符合您在先前步驟中建立的資料庫配置,以及符合您的 DB2 配置。根據您的配置,來編輯 location、user、password、dbname、bufferpool 與 stogroup 內容。更明確地說,就是編輯下列字行:
com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
location:user=jazzDBuser;password={password};取代:
com.ibm.team.repository.db.jdbc.password=jazzDBpswd以您 DB2 使用者的密碼取代 jazzDBpswd。
com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB以您建立的資料庫名稱取代 JAZZDB。
com.ibm.team.repository.db.db2.dsn.bufferpool=bpx以您在建立資料庫時所選的緩衝池取代 bpx。請確定它支援 8K 分頁。請使用 BP8K0 等之類的緩衝池。
com.ibm.team.repository.db.db2.dsn.stogroup=JAZZSTG以您建立的儲存體群組取代 JAZZSTG。
com.ibm.team.repository.db.schemaPrefix=xx請以您選擇的字首取代 xx。這是選用的。它可讓您在一個 DB2 子系統中,擁有多個 Jazz 儲存庫。
使用儲存庫工具來建立資料庫表格。
如果要建立資料庫表格,請執行下列動作:
執行 repotools.sh -createTables 指令,為
Jazz 儲存庫建立資料庫表格。
repotools.sh Script 位於
JazzInstallDir/server 目錄。
這個指令在連線和大小設定方面,會使用 teamserver.properties 中的配置內容。
./repotools.sh -createTables
這個指令會為 Jazz Team Server 儲存庫建立表格空間,以及所有必要的表格與索引。
您可以利用具有 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)」來管理使用者。
如下所示,將 LDAP(輕量型目錄存取通訊協定)配置成 SDBM 後端。 範例顯示配置給 SDBM 的 LDAP 配置檔 slapd.conf。
listen ldap://:3399 maxConnections 2000 adminDN 『profiletype=user』 database sdbm GLDSDBM suffix 『sysplex=yourSysplexName,o=yourOrganization』 sizeLimit 2000 timeLimit 3600
如需關鍵字的完整說明,請參閱 z/OS Integrated Security Services LDAP Server Administration and Use。
必須在管理主控台中,將 BDN 指定在安全 -> 安全管理、應用程式和基礎架構下的 LDAP 使用者登錄內容中。
凡是來自 WebSphere 的安全要求都會傳輸至「連結識別名稱」之「LDAP 管理者 DN」下的 RACF®(在啟動廣域安全之後)。BDNracid 必須是 RACF 定義的使用者,並且具備有效的 OMVS 區段。這個 RACF 使用者 ID 必須具備系統層面的 AUDITOR 屬性。
在 WebSphere 中,必須設定某些廣域安全設定,才能使用 LDAP SDBM 作為使用者登錄。
| 內容 | 值(說明,實際) |
|---|---|
| 主要管理使用者名稱 | 主要管理者的 RACF 使用者 ID |
| 類型 | 自訂 |
| 主機 | 用來接聽 LDAP 的 LPAR IP 位址或 URL |
| 埠 | 指定在 slapd.conf 中的 LDAP 接聽埠 |
| 基本識別名稱 (DN) | slapd.conf 中指定的字尾(沒有引號) |
| 連結識別名稱 (DN) | racfid=BDNracid,profiletype=user,suffix |
| 連結密碼 | BDNracid 的密碼 |
| 內容 | 值 |
|---|---|
| 使用者過濾器 | racfid=%v |
| 群組過濾器 | racfid=%v |
| 使用者 ID 對映 | *:racfid |
| 群組 ID 對映 | *:racfid |
| 群組成員 ID 對映 | racfconnectgroupname:racfgroupuserids |
BDN 使用者 ID 應使用尚未到期的密碼,以免 WebSphere Cell 因內部鑑別與授權失效而中止。
如果您組織的原則要求讓這個使用者 ID 種類到期,請確定您已備妥一項程序,在 BDN 密碼到期之前就加以變更。
安裝套件涵蓋您開始進行所需的一切。
預設配置包含的項目如下:
在安裝伺服器之前,請驗證是否符合特殊考量。
當 Jazz Team Server for System z 是安裝在 Linux 或 Linux for System z 上,請檢閱下列特殊指示。
tomcat_user hard nofile 5000 tomcat_user soft nofile 5000
如果要開始進行,請取得安裝檔案。
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。
在取得安裝檔案後,請啟動安裝。
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。
如果 Installation Manager 不在執行中,請啟動它。
launchpad.exe
sh launchpad.sh
當使用 IBM Installation Manager 時,請在安裝程序期間記下「位置」頁面上的安裝目錄。該目錄稱為 JazzInstallDir。
如果您安裝 DB2 Workgroup Server,請記下使用者 ID、密碼和埠號。之後需用到這項資訊。在安裝期間接受預設值,可簡化 Jazz Team Server for System z 的配置。
在取得安裝檔案後,請解壓縮內容。
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。
如果您安裝 DB2 Workgroup Server,請記下使用者 ID、密碼和埠號。之後需用到這項資訊。在安裝期間接受預設值,可簡化 Jazz Team Server for System z 的配置。
在安裝資料庫後,需要進行配置工作。
設定資料庫的步驟概述如下:
如果您使用任何支援的 DB2 版本,請繼續進行RTCz:設定 DB2 資料庫。
如果您使用 Oracle,請繼續進行RTCz:設定 Oracle 資料庫。
如果您使用 SQL Server,請繼續進行RTCz:設定 SQL Server 資料庫。
設定支援的 DB2 或搭售的 DB2 Workgroup Server 資料庫,以搭配 Jazz Team Server for System z 運作。
本程序假設已符合下列必備條件。相關說明請參閱您的 DB2 文件,或向您的 DB2 資料庫管理者 (DBA) 查詢。
如果要設定 DB2 資料庫,請執行下列動作:
db2 create database JAZZ on c: using codeset UTF-8 territory en PAGESIZE 8192
db2 create database JAZZ using codeset UTF-8 territory en PAGESIZE 8192
預設連線規格是連接在 localhost 埠 50000 上執行的 DB2 資料庫。在 Windows 中,資料庫名稱為 JAZZ,而使用者名稱與密碼皆為 db2admin。如果您在設定資料庫時使用預設值,可能已正確配置 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 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格。
設定 Oracle 資料庫以搭配 Jazz Team Server for System z 運作。
在此假設已符合下列的必備條件。相關說明請參閱您的 Oracle 文件,或向 Oracle 資料庫管理者 (DBA) 查詢。
當在 Oracle 中執行 Jazz Team Server for System z 時,請建立 Oracle 表格空間以提升效能。您必須建立一個鏈結至該表格空間的使用者。
如果要設定 Oracle 資料庫,請執行下列動作:
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
在建立表格空間後,必須為 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;
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 資料庫的使用者密碼。
如果您使用 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您已完成資料庫的設定,而可繼續進行在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格。
設定 SQL Server 資料庫,以搭配 Jazz Team Server for System z 運作。
本程序假設您已符合下列的必備條件:
本節說明如何使用 SQL Server 安裝提供的指令行工具 sqlcmd,來設定 SQL Server 資料庫。您也可以使用視覺化工具,以 SQL Server Studio Management 為例,就可以當成 SQL Server Studio Management Express 在 Express™ 版中使用。如需相關資訊,請參閱 SQL Server 文件或詢問 SQL Server 資料庫管理者 (DBA)。
如果要使用 指令工具 sqlcmd 來設定 SQL Server 資料庫,請執行下列動作:
CREATE DATABASE jazz GO
CREATE LOGIN jazzDBuser WITH PASSWORD = 'jazzDBpswd'; USE jazz; exec sp_changedbowner 'jazzDBuser' GO
ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS GO
如果要配置伺服器,請執行下列動作:
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
如果要指定 JDBC 的 JAR 檔位置,請執行下列動作:
您已完成資料庫的設定。現在,請建立 Jazz Team Server for System z 資料庫表格。如需相關資訊,請參閱在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格。
如果 repotools 指令沒有成功,請檢查 JazzInstallDir/server 目錄中名為 repotools_createTables.log 的日誌檔。
此外,請驗證下列:
依照設計,伺服器可服務大量的同步要求。在某些異常的情況中,儲存資料庫中可能發生死鎖,這是因為要求的相關聯交易中同時更新了類似或同等的物件。這類事件罕見但仍屬正常。 依照設計,系統會有相對的防禦措施,並維護資料完整性;資料不會遺失。建置引擎執行等之類的作業偶爾會記載死鎖。一般來說,偵測到狀況時,會重試作業。死鎖可能導致建置失敗。在某些相當罕見的情況中,可能是使用工作項目或原始碼等之類的使用者動作,而這可藉由中斷來解決死鎖。在該情況下,使用者動作將會失敗,並顯示內含死鎖詳細資料的錯誤給使用者。 之後使用者可重試該動作。
所遇到的所有死鎖都會記載在伺服器上,以提供發生死鎖時的相關現象資訊。日誌項目中的文字類似如下:com.ibm.team.repository.common.RetryableDatabaseException: 序列化失敗。
如果您的系統遇到死鎖,請參閱位於下列位置的錯誤日誌:https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog。
如果您常常遇到死鎖異常狀況,請聯絡您的產品支援人員,或檢查 jazz.net 論壇中的最新資訊、更新項目或移轉技術。
使用儲存庫工具來建立資料庫表格。
如果要建立資料庫表格,請執行下列動作:
repotools 檔位於 JazzInstallDir/server。
這個指令在連線和大小設定方面,會使用 teamserver.properties 中的配置內容。依預設,指令會查看現行目錄。teamserver.properties 參數可用來參照不同的內容檔。
repotools -createTables
./repotools.sh -createTables
您已完成資料庫的設定,而可繼續進行RTCz:啟動伺服器。
-createTables這個主題說明執行伺服器啟動 Script 時所用的各種選項。
如果您打算使用隨附的 Apache Tomcat 應用程式伺服器,可準備啟動 Jazz Team Server for System z。
如果您打算使用 WebSphere Application Server,請按照RTCz:設定 WebSphere Application Server中的說明來設定您的伺服器環境。
現在,您可以準備啟動 Apache Tomcat 伺服器。
Apache Tomcat 已安裝在 JazzInstallDir/server/tomcat 目錄。Web 應用程式 (jazz.war) 已安裝在 Apache Tomcat 目錄 webapps。在指令視窗中,將您的現行目錄設定為 JazzInstallDir/server。伺服器的啟動和關閉 Script 位於這個目錄中。
請執行啟動檔,以便在 Windows 上啟動您的伺服器。
server.startup.bat
server.shutdown.bat
在啟動伺服器之後,請繼續進行RTCz:執行設定精靈。
請執行啟動檔,以便在 Linux 或 Linux for System z 上啟動伺服器。
./server.startup如果您的使用者 ID 具備管理者存取權,請執行以下指令:
sudo ./server.startup
並不會顯現個別的 Apache Tomcat 主控台視窗。您可以檢視 JazzInstallDir/server/logs/jazz.log 中的日誌檔,以檢查伺服器啟動進度。
./server.shutdown如果您的使用者 ID 具備管理者存取權,請執行以下指令:
sudo ./server.shutdown
在啟動伺服器之後,請繼續進行RTCz:執行設定精靈。
Apache Tomcat 能夠當成 Windows 服務來執行。如果您希望不必登入就能在 Windows 型機器上執行 Jazz Team Server,這種作法就可以派上用場。
這個主題假設您的 Jazz Team Server for System z 部署位於 C:\jazz 根目錄;請根據您的實際根目錄來調整路徑。
C:\jazz\server\tomcat\bin\service.bat install
C:\jazz\server\jre\bin\j9vm\jvm.dll
-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 的路徑]
這個主題說明如何設定 Jazz Team Server for System z,以使用現有的 Apache Tomcat 伺服器。
如果要將 jazz.war 檔部署至現有的 Apache 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
這個主題說明如何設定 Jazz Team Server for System z 以搭配 WebSphere Application Server 運作。這項設定會假設您是將 Jazz Team Server for System z 安裝在和 Websphere Application Server 相同的機器上。
在開始進行這些步驟前,應先完成下列:
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
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/ 下載這些檔案。
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 安裝目錄:
在下列的指令行範例中,WASInstallDir 代表 WebSphere Application Server 在您伺服器上的安裝位置。
C:\Program Files\IBM\WebSphere\AppServer
您可以在 Windows 上,使用下列指令來重新啟動伺服器:
cd WASInstallDir\bin
stopServer.bat server1 [若為安全伺服器,請包含:-username {LDAP_User} -password {LDAP_Password}]
startServer.bat server1/opt/IBM/WebSphere/AppServer
您可以在 Linux 上,使用下列指令來重新啟動伺服器:
cd WASInstallDir/bin
./stopServer.sh server1 [若為安全伺服器,請包含:-username {LDAP_User} -password {LDAP_Password}]
./startServer.sh server1JazzInstallDir/server/jazz.war
此時應會出現綠色箭頭,指出已順利啟動應用程式。
在啟動伺服器之後,請繼續進行RTCz:執行設定精靈。
如需這個主題的相關資訊,請造訪下列鏈結:
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ
藉由執行設定精靈,可驗證伺服器的運作是否適當,並可引導您完成伺服器的配置步驟。
如果要驗證 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 使用者介面來配置其他的選項。
如果伺服器設定精靈沒有載入,請檢查下列項目:
在安裝伺服器後,您必須考量某些配置選項,再繼續進行。
在安裝之後,需額外執行少許動作。
在儲存內容檔時,應用程式一律會在相同目錄中建立前一版的備份副本。如果您想移除所有內含明碼密碼的檔案,請在第一次配置伺服器之後,移除備份內容檔。
預設配置包含的項目如下:
在安裝伺服器之前,請驗證是否符合特殊考量。
當 Jazz Team Server for System z 是安裝在 Linux 或 Linux for System z 上,請檢閱下列特殊指示。
tomcat_user hard nofile 5000 tomcat_user soft nofile 5000
如果要開始進行,必須先取得安裝檔案。
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。
在取得安裝檔案後,請啟動安裝。
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。
使用 IBM Installation Manager 來安裝 Rational Team Concert for System z Standard Edition 或 Enterprise Edition 時,您有兩種方法可選。
如果 Installation Manager 不在執行中,請啟動它。
launchpad.exe
sh launchpad.sh
當使用 IBM Installation Manager 時,請在安裝程序期間記下「位置」頁面上的安裝目錄。該目錄稱為 JazzInstallDir。
如果您安裝 DB2 Workgroup Server,請記下使用者 ID、密碼和埠號。之後需用到這項資訊。在安裝期間接受預設值,可簡化 Jazz Team Server for System z 的配置。
在取得安裝檔案後,請解壓縮內容。
如果您安裝 DB2 Workgroup Server,請記下使用者 ID、密碼和埠號。之後需用到這項資訊。在安裝期間接受預設值,可簡化 Jazz Team Server for System z 的配置。
在安裝資料庫後,需要進行配置工作。
設定資料庫的步驟概述如下:
如果您使用任何支援的 DB2 版本,請繼續進行RTCz:設定 DB2 資料庫。
如果您使用 Oracle,請繼續進行RTCz:設定 Oracle 資料庫。
如果您使用 SQL Server,請繼續進行RTCz:設定 SQL Server 資料庫。
設定支援的 DB2 或搭售的 DB2 Workgroup Server 資料庫,以搭配 Jazz Team Server for System z 運作。
本程序假設已符合下列必備條件。相關說明請參閱您的 DB2 文件,或向您的 DB2 資料庫管理者 (DBA) 查詢。
如果要設定 DB2 資料庫,請執行下列動作:
db2 create database JAZZ on c: using codeset UTF-8 territory en PAGESIZE 8192
db2 create database JAZZ using codeset UTF-8 territory en PAGESIZE 8192
預設連線規格是連接在 localhost 埠 50000 上執行的 DB2 資料庫。資料庫名稱為 JAZZ,而使用者名稱與密碼皆為 db2admin。如果您在設定資料庫時使用預設值,可能已正確配置 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 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格。
設定 Oracle 資料庫以搭配 Jazz Team Server for System z 運作。
在此假設已符合下列的必備條件。相關說明請參閱您的 Oracle 文件,或向 Oracle 資料庫管理者 (DBA) 查詢。
當在 Oracle 中執行 Jazz Team Server for System z 時,請建立 Oracle 表格空間以提升效能。您必須建立一個鏈結至該表格空間的使用者。
如果要設定 Oracle 資料庫,請執行下列動作:
CREATE BIGFILE TABLESPACE oracle_tbs DATAFILE 'D:\oracle_tbs\oracle_tbs.dbf' SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE
在建立表格空間後,必須為 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;
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 資料庫的使用者密碼。
如果您使用 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您已完成資料庫的設定,而可繼續進行在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格。
設定 SQL Server 資料庫,以搭配 Jazz Team Server for System z 運作。
本程序假設您已符合下列的必備條件:
本節說明如何使用 SQL Server 安裝提供的指令行工具 sqlcmd,來設定 SQL Server 資料庫。您也可以使用視覺化工具,以 SQL Server Studio Management 為例,就可以當成 SQL Server Studio Management Express 在 Express 版中使用。如需相關資訊,請參閱 SQL Server 文件或詢問 SQL Server 資料庫管理者 (DBA)。
如果要使用 指令工具 sqlcmd 來設定 SQL Server 資料庫,請執行下列動作:
CREATE DATABASE jazz GO
CREATE LOGIN jazzDBuser WITH PASSWORD = 'jazzDBpswd'; USE jazz; exec sp_changedbowner 'jazzDBuser' GO
ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS GO
如果要配置伺服器,請執行下列動作:
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
如果要指定 JDBC 的 JAR 檔位置,請執行下列動作:
您已完成資料庫的設定。現在,請建立 Jazz Team Server for System z 資料庫表格。如需相關資訊,請參閱在 DB2 與 Oracle 上建立 Jazz Team Server for System z 資料庫表格。
如果 repotools 指令沒有成功,請檢查 JazzInstallDir/server 目錄中名為 repotools_createTables.log 的日誌檔。
此外,請驗證下列:
依照設計,伺服器可服務大量的同步要求。在某些異常的情況中,儲存資料庫中可能發生死鎖,這是因為要求的相關聯交易中同時更新了類似或同等的物件。這類事件罕見但仍屬正常。 依照設計,系統會有相對的防禦措施,並維護資料完整性;資料不會遺失。建置引擎執行等之類的作業偶爾會記載死鎖。一般來說,偵測到狀況時,會重試作業。死鎖可能導致建置失敗。在某些相當罕見的情況中,可能是使用工作項目或原始碼等之類的使用者動作,而這可藉由中斷來解決死鎖。在該情況下,使用者動作將會失敗,並顯示內含死鎖詳細資料的錯誤給使用者。 之後使用者可重試該動作。
所遇到的所有死鎖都會記載在伺服器上,以提供發生死鎖時的相關現象資訊。日誌項目中的文字類似如下:com.ibm.team.repository.common.RetryableDatabaseException: 序列化失敗。
如果您的系統遇到死鎖,請參閱位於下列位置的錯誤日誌:https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog。
如果您常常遇到死鎖異常狀況,請聯絡您的產品支援人員,或檢查 jazz.net 論壇中的最新資訊、更新項目或移轉技術。
使用儲存庫工具來建立資料庫表格。
如果要建立資料庫表格,請執行下列動作:
repotools 檔位於 JazzInstallDir/server。
這個指令在連線和大小設定方面,會使用 teamserver.properties 中的配置內容。依預設,指令會查看現行目錄。teamserver.properties 參數可用來參照不同的內容檔。
repotools -createTables
./repotools.sh -createTables
您已完成資料庫的設定,而可繼續進行RTCz:啟動伺服器。
-createTables這個主題說明執行伺服器啟動 Script 時所用的各種選項。
如果您打算使用隨附的 Apache Tomcat 應用程式伺服器,可準備啟動 Jazz Team Server for System z。
如果您打算使用 WebSphere Application Server,請按照RTCz:設定 WebSphere Application Server中的說明來設定您的伺服器環境。
現在,您可以準備啟動 Apache Tomcat 伺服器。
Apache Tomcat 已安裝在 JazzInstallDir/server/tomcat 目錄。Web 應用程式 (jazz.war) 已安裝在 Apache Tomcat 目錄 webapps。在指令視窗中,將您的現行目錄設定為 JazzInstallDir/server。伺服器的啟動和關閉 Script 位於這個目錄中。
請執行啟動檔,以便在 Windows 上啟動您的伺服器。
server.startup.bat
server.shutdown.bat
在啟動伺服器之後,請繼續進行RTCz:執行設定精靈。
請執行啟動檔,以便在 Linux 或 Linux for System z 上啟動伺服器。
./server.startup如果您的使用者 ID 具備管理者存取權,請執行以下指令:
sudo ./server.startup
並不會顯現個別的 Apache Tomcat 主控台視窗。您可以檢視 JazzInstallDir/server/logs/jazz.log 中的日誌檔,以檢查伺服器啟動進度。
./server.shutdown如果您的使用者 ID 具備管理者存取權,請執行以下指令:
sudo ./server.shutdown
在啟動伺服器之後,請繼續進行RTCz:執行設定精靈。
Apache Tomcat 能夠當成 Windows 服務來執行。如果您希望不必登入就能在 Windows 型機器上執行 Jazz Team Server,這種作法就可以派上用場。
這個主題假設您的 Jazz Team Server for System z 部署位於 C:\jazz 根目錄;請根據您的實際根目錄來調整路徑。
C:\jazz\server\tomcat\bin\service.bat install
C:\jazz\server\jre\bin\j9vm\jvm.dll
-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 的路徑]
這個主題說明如何設定 Jazz Team Server for System z,以使用現有的 Apache Tomcat 伺服器。
如果要將 jazz.war 檔部署至現有的 Apache 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
這個主題說明如何設定 Jazz Team Server for System z 以搭配 WebSphere Application Server 運作。這項設定會假設您是將 Jazz Team Server for System z 安裝在和 Websphere Application Server 相同的機器上。
在開始進行這些步驟前,應先完成下列:
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
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/ 下載這些檔案。
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 安裝目錄:
在下列的指令行範例中,WASInstallDir 代表 WebSphere Application Server 在您伺服器上的安裝位置。
C:\Program Files\IBM\WebSphere\AppServer
您可以在 Windows 上,使用下列指令來重新啟動伺服器:
cd WASInstallDir\bin
stopServer.bat server1 [若為安全伺服器,請包含:-username {LDAP_User} -password {LDAP_Password}]
startServer.bat server1/opt/IBM/WebSphere/AppServer
您可以在 Linux 上,使用下列指令來重新啟動伺服器:
cd WASInstallDir/bin
./stopServer.sh server1 [若為安全伺服器,請包含:-username {LDAP_User} -password {LDAP_Password}]
./startServer.sh server1JazzInstallDir/server/jazz.war
此時應會出現綠色箭頭,指出已順利啟動應用程式。
在啟動伺服器之後,請繼續進行RTCz:執行設定精靈。
如需這個主題的相關資訊,請造訪下列鏈結:
https://jazz.net/wiki/bin/view/Main/WASSetupFAQ
藉由執行設定精靈,可驗證伺服器的運作是否適當,並可引導您完成伺服器的配置步驟。
如果要驗證 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 使用者介面來配置其他的選項。
如果伺服器設定精靈沒有載入,請檢查下列項目:
在安裝伺服器後,您必須考量某些配置選項,再繼續進行。
在安裝之後,需額外執行少許動作。
在儲存內容檔時,應用程式一律會在相同目錄中建立前一版的備份副本。如果您想移除所有內含明碼密碼的檔案,請在第一次配置伺服器之後,移除備份內容檔。
這項資訊提供在 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。 請遵循安裝之元件的自訂指示。 這些元件如下:
如需使用 Build System Toolkit for System z 的其他資訊,請參閱下列主題:
如需「工作監視器」的詳細資訊,請參閱下列主題:
如需 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
請利用 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.SBLZSAMP 與 hlq.SBLZAUTH,其中 hlq 是您在安裝 SMP/E 期間選擇的高階限定元。 如同「程式目錄」中的附註,hlq.SBLZAUTH 應已獲得 APF 授權。 而在 hlq.SBLZSAMP 資料集中,可找到一些涉及編輯與提交 JCL 的許多其他配置步驟。
SMP/E 安裝作業也會安裝一個 z/OS UNIX® 系統服務檔案目錄 /@pathPrefix@/usr/lpp/jazz/v2.0。
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 系統參數。 受影響的參數如下:
除了 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 目錄應具備以下的配置:
利用成員所包含的指示,在 hlq.SBLZSAMP 中配置 BLZCPDIR 成員。 利用 SUBMIT 指令來提交已修改的 JCL 及檢查工作日誌。 如果您已正確設定所有項目,所有步驟結束時,回覆碼都是 0。
有些 Jazz Team Server for System z 配置檔,必須根據您選給 @pathPrefix@、@workPath@ 與 @confPath@ 的目錄,來加以修改。本節中的主題提供修改配置檔的指示。
Jazz Team Server for z/OS 內容檔為 ASCII 檔案。您可以使用下列其中一項技術,在z/OS UNIX 下編輯 ASCII 檔案:
這個主題說明您必須在供應設定檔中變更哪些項目,以便自訂它們。
如果您使用 @pathPrefix@,應該編輯下列檔案:
比方說,如果 @pathPrefix@ 設為 myroot,這項設定便解析為 url=file:/myroot/usr/lpp/jazz/v2.0/server/update-site。
比方說,如果 @pathPrefix@ 設為 myroot,這項設定便解析為 url=file:/myroot/usr/lpp/jazz/v2.0/server/license-update-site。
比方說,如果 @pathPrefix@ 設為 myroot,這項設定便解析為 url=file:/myroot/usr/lpp/jazz/v2.0/server/nl1-update-site。
比方說,如果 @pathPrefix@ 設為 myroot,這項設定便解析為 url=file:/myroot/usr/lpp/jazz/v2.0/server/nl2-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 管理者來執行。
請確定內含 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 程序處於作用中。
當 Jazz Team Server for System z 搭配 DB2 for z/OS 執行時,您必須建立一個 DB2 儲存體群組與 DB2 資料庫。您也必須授權 Jazz Team Server for System z 使用者使用該儲存體群組與資料庫。
在您執行儲存庫工具資料庫建置器公用程式,以便在資料庫實例中建立 Jazz 儲存庫表格之前,必須先執行下列步驟。 Jazz Team Server 資料庫建置器公用程式不會執行任何這些步驟。
CREATE STOGROUP JAZZSTG VOLUMES ('*') VCAT yourHlq ;
CREATE DATABASE JAZZDB STOGROUP JAZZSTG BUFFERPOOL bp8kx ;
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 ;
這一節說明如何編輯及配置 teamserver.properties 檔,以便 z/OS 連接到 DB2。
在 @confPath@/jazz 中,尋找配置目錄。 依預設,這個目錄中的 teamserver.properties 檔配置成使用 Derby 資料庫。
針對您的 DB2 for z/OS 子系統使用 -DIS DDF 指令,以顯示您需要提供的某些值。例如,您可以從以下的顯示畫面擷取 location、ipaddr 與 port (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 內容。
更明確地說,就是編輯下列字行:
com.ibm.team.repository.db.jdbc.location=//ipAddress:ipPort/
location:user=jazzDBuser;password={password}; 取代:
com.ibm.team.repository.db.jdbc.password=jazzDBpswd以您 DB2 使用者的密碼取代 jazzDBpswd。
com.ibm.team.repository.db.db2.dsn.dbname=JAZZDB以您建立的資料庫名稱取代 JAZZDB。
#com.ibm.team.repository.db.schemaPrefix=xx您可以移除 #,並以您選擇的字首取代 xx。這是選用的。它可讓您在一個 DB2 子系統中,擁有多個 Jazz 儲存庫。
此外,以您針對 @workPath@ 而選取的路徑來取代 @workPath@ 的所有實例;例如,這些內容:
在您使用 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 檔已配置無誤。然後您必須:
當 Jazz Team Server for System z 搭配 Tomcat 與 Derby 執行時,會涉及一些範例 JCL 成員與配置內容檔。
這些指示假設您使用範例 teamserver_derby.properties 檔。如果您使用不同的內容檔名稱,請變更範例 JCL 成員,而指向您的內容檔。
為了避免埠衝突,請檢閱 Tomcat 應用程式伺服器的預設埠設定,確定它們與您已安裝的其他應用程式伺服器實例不同。
依預設,Tomcat 應用程式伺服器使用非安全埠 9080 與安全埠 9443,以及 9005、9009 與 8082 埠。 這些預設埠可能與您已安裝的預設 WebSphere Application Server 實例相衝突。請檢閱定義這些埠的 Tomcat server.xml 檔,它位於 @workPath@/catalina_base/conf/server.xml。
請根據您使用的應用程式伺服器與資料庫,選擇下列其中一個選項:
現在,您可以準備啟動使用預設 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 執行時,會涉及一些範例 JCL 成員與配置內容檔。
這些指示假設您使用範例 teamserver_db2z.properties 檔。如果您使用不同的內容檔名稱,請變更範例 JCL 成員,而指向您的內容檔。
當在 z/OS 上使用 DB2 資料庫時,需要其他的配置步驟。
為了避免埠衝突,請檢閱 Tomcat 應用程式伺服器的預設埠設定,確定它們與您已安裝的其他應用程式伺服器實例不同。
依預設,Tomcat 應用程式伺服器使用非安全埠 9080 與安全埠 9443,以及 9005、9009 與 8082 埠。 這些預設埠可能與您已安裝的預設 WebSphere Application Server 實例相衝突。請檢閱定義這些埠的 Tomcat server.xml 檔,它位於 @workPath@/catalina_base/conf/server.xml。
請根據您使用的應用程式伺服器與資料庫,選擇下列其中一個選項:
現在,您可以準備啟動使用 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 時,會包含
RACF 作業應該由您的系統安全管理者來執行。
Jazz Team Server for System z 使用四個角色,您必須將它們定義為 RACF EJBROLE 設定檔,以進行安全控制。 請在 EJBROLE 類別中定義四個 Jazz Team Server 角色。
範例 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)
範例 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)
在 RACF RDEFINE 和 PERMIT 指令之後,您必須發出下列指令將它們列入考量:
SETROPTS RACLIST(EJBROLE) REFRESH
這個主題說明如何設定 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 Team Server for System z 部署在 WebSphere Application Server 上。 以下詳細說明各個步驟本身的作業。
啟動伺服器之後,請檢閱這個主題:RTCz:執行設定精靈
如需配置 WebSphere Application Server 的詳細資訊,請造訪下列網站:
執行設定精靈,來驗證伺服器是否適當運作。設定精靈也會引導您完成伺服器的配置。
如果要驗證 Jazz Team Server 是否連接資料庫,請查看伺服器日誌或主控台輸出。連線和資料庫資訊會在其第一次存取時回應。 本程序假設使用主機名稱 localhost 和預設埠 9443,即可使用您的伺服器。必要的話,請以您的伺服器主機名稱來取代 localhost,另外也取代埠號。
請完成下列步驟,以執行設定精靈:
當起始設定完成時,您可以利用「Jazz Team Server 管理 Web 使用者介面」來配置其他選項,URL 如下:https://ipaddress:port/jazz/admin,其中 ipaddress 是您啟動 Tomcat 的 IP 位址,port 是啟動 Tomcat 時所指定的安全埠。
完成安裝所需的作業應該由您的 Jazz Team Server 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。
o RTCz:利用 Jazz 建置您可以利用 IBM Installation Manager,將 Build System Toolkit for System z 安裝在建置系統上。
如果 Installation Manager 不在執行中,請啟動它。
launchpad.exe
sh launchpad.sh
您可以使用下載的 .zip 檔,將 Build System Toolkit for System z 安裝在建置機器上。
如果要從 .zip 檔來安裝 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 可以在 z/OS、Linux、Linux for System z、UNIX 與 Windows 上執行。 在 z/OS 上進行安裝時,所需的程序與安裝在其他平台上的程序不同。
o RTCz:利用 Jazz 建置本節說明如何在 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。
RTCz:利用 Jazz 建置建置代理程式執行檔已在 SMP/E 安裝期間安裝到 yourPathPrefix/usr/lpp/jazz/bfagent 中。
請完成這些步驟,來完成安裝和啟動 Rational Build Agent:
bfagent -s -f /etc/jazz/bfagent.conf代理程式會以獨立式常駐程式形式執行,並使用預設代理程式埠 5555。如果要變更預設埠,請在 bfagent.conf 中使用埠設定。請參閱 bfagent 參照。另請參閱以下的 inetd 提示。
如果 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 的完整配置已超出本文件的說明範圍。在簡式範例中,您可以:
bfagent stream tcp nowait userID /usr/lpp/jazz/v2.0/bfagent/bfagent -f /etc/jazz/bfagent.conf
bfagent 5555/tcp #BUILD FORGE AGENT
port 5555
本節說明如何在安裝之後配置代理程式。
如果伺服器上的埠 5555 已被佔用,您可以在伺服器上安裝代理程式之後變更代理程式埠。
如果要變更埠,請執行下列動作:
您可以編輯 bfagent.conf 檔中的參數,將代理程式配置成使用非預設的 Shell。
例如,如果要使用 tcsh Shell,可將 Shell 參數設定成如下:
shell /bin/tcsh
如需 bfagent.conf 檔的詳細資訊,請參閱bfagent.conf 參照。
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 區段。
您可以在這個畫面上設定下列兩個值:
這一節說明如何在 Linux、Linux for System z、UNIX 和 Windows 上,進行代理程式的安裝、執行、配置和疑難排解。
代理程式是一種會接收要求來執行專案和步驟的服務。請將代理程式安裝在您要作為伺服器資源的每一個主機上。
這一節說明如何安裝代理程式。
這個主題說明如何在 Windows 上安裝「Rational Build Forge 代理程式」。
這個主題說明如何在 Linux、Linux for System z 和 UNIX 作業系統上,安裝「Rational Build Forge 代理程式」。
尋找及啟動安裝套件所隨附的代理程式安裝程式。 安裝程式的檔名是 <os>-bfagent-<version>.exe,其中 <os> 是您的作業系統,<version> 是您的「Rational Build Forge 代理程式」版本號碼。
如果尚未設定 PATH 值,請設定。 雖然沒有 PATH 值,HP-UX 也能夠執行,但在代理程式試圖新增到路徑中,而您尚未設定其值時,您可能會遇到一些問題。 您可以編輯您的系統 /etc/PATH 檔,或利用 Shell 的標準 PATH set 或 append 作業來設定值。
如果您必須在另一個平台上執行 Rational Build Forge 代理程式,請利用 src-bfagent-<version>.tar.gz 檔,從原始檔開始編譯代理程式。
本節說明如何設定要執行的代理程式。它通常是以自動啟動的服務或常駐程式形式執行。
一般而言,代理程式會安裝成服務,並且設定為「自動」,如此就會在您開啟電腦時啟動。您必須登入安裝該代理程式的電腦,才能啟動和停止它。
如果要啟動和停止代理程式,您可以使用開始功能表:
您也可以在命令提示字元下使用下列指令:
代理程式主要是以服務形式執行,當系統重新啟動時需要自動重新啟動。
依適當情況而定,請新增 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 -f /opt/bfagent.conf
如果伺服器上的埠 5555 已被佔用,您可以在伺服器上安裝代理程式之後變更代理程式埠。
如果要在 Windows 作業系統上變更埠,請執行下列動作:
若為 UNIX、Linux 與 Macintosh 作業系統,請執行下列動作:
您可以編輯 BFAgent.conf 檔中的參數,將代理程式配置成使用非預設的 Shell。
例如,如果要將 Windows 系統變更為使用 MKSTools 所提供的 Korn Shell,您可以使用下列指令來變更 Shell 參數:
shell C:\MKSTools\mksnt\ksh.exe -L -c \"%s\"
在系統傳送指令給伺服器時,會用逐步指令取代這個指令中的 %。在本例中,請使用反斜線跳出字元,將引號當成文字包含在指令中。
Rational Build Agent 在初次啟動時,使用的是 Windows 系統帳戶認證。為了執行指令,代理程式之後就會使用 Rational Build Agent 伺服器鑑別認證向 Windows 鑑別。
本端指令可接受伺服器鑑別認證,但如果是代理程式必須在外部的網路共用磁碟機上執行的一些指令,就可能導致失敗。例如,如果要在 ClearCase 動態視圖中修改檔案,代理程式必須存取網路共用磁碟機中的 ClearCase 檔案。
由於外部檔案系統會忽略代理程式的伺服器鑑別認證,因而導致指令失敗;它只能辨識代理程式的起始系統帳戶認證。
如果您在網路共用磁碟機上執行指令時遭遇問題,請嘗試下列動作:
如果您想使用 Rational Build Agent 伺服器鑑別認證來建立網路共用區的存取權,新增這項設定就成了必要條件。
win_reexec_after_auth 設定會使得代理程式在向 Windows 鑑別之後,啟動新程序。新程序會強制共用檔案系統辨識出代理程式已變更使用者認證。
當設定 win_reexec_after_auth 時,代理程式會以服務形式執行,且不會識別哪些指令會存取網路共用磁碟機,哪些指令不會,因此您可能需注意效能衝擊問題。
如果指定的使用者是「管理者」群組中的成員,則必須使用伺服器鑑別認證來指定使用者的認證。
如果使用者不是管理者,請在 BFagent.conf 中使用 magic_login 設定,以防出現未獲授權存取代理程式的情況。
代理程式會以您提供的使用者名稱啟動和執行,而這會使用該使用者的認證,立即授權存取網路共用磁碟機。
如果要使用專用使用者帳戶,以服務形式來執行代理程式,請執行下列動作:
bfagent 執行檔會啟動 Rational Build Agent。它會從相同目錄中的 bfagent.conf 檔讀取它的配置。
指令的語法是:
bfagent [-f configfile | -s]
bfagent.conf 檔儲存有關如何執行 Rational Build Agent 的設定。檔案所在的目錄和 bfagent 執行檔相同。
檔案會列出所有的設定與內部預設值。非作用中設定則會註銷。
只有在下列情況下才使用這項設定:
這項設定會限制連接至代理程式的連線。只容許來自符合 IP-address-or-range 的 IP 位址的連線。依預設,可容許來自所有位址的連線。
請指定下列這兩個選項或其中之一:
最小值:2048。如果設定小於 2048,就會在內部使用 2048。
這項設定僅適用於 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時,這項設定僅適用於 Windows 上的代理程式。
這項設定指定當執行步驟時要使用的 #! 行。預設值是 #!/bin/bash。
對代理程式來說,某些內建處理程序的額外負荷,與處理程序和正確處理 Telnet 控制順序相關聯。
您可以使用這項設定,讓代理程式無法處理特殊 Telnet 字元碼,而這樣可微幅改善效能。在產品環境中,使用這項設定,可因效能改善而受惠。
如果作業系統並非使用 UTF-8 編碼,代理程式必須將資料轉換成作業系統語言環境設定的正確編碼。
如果您的作業不是使用 UTF-8,請使用這項設定,取得代理程式的最佳結果並改善效能。
在剖析期間,會以逐步指令中的第一個記號作為函數名稱。第二個記號是字串,第三個是整數逾時值(以秒為單位)。
需求:作業系統中的動態載入器支援。例如,在 UNIX 或 Linux 中,您需要 /usr/include/dlfcn.h。這些預設值供內部使用。
如果您使用這項設定,代理程式會忽略未適當配置位址的介面。它只會接聽已適當配置位址的介面。
這項設定指定代理程式在撰寫訊息和指令輸出時所用的語言。
內部預設值是 en,這是視同它明確設定成如下:
lang en
這項設定只在您要疑難排解時使用。
這項設定會保留用來保存逐步指令的暫存檔,而不會在執行指令之後將它刪除。
這項設定僅適用於 UNIX 和 Linux 作業系統。Windows 處理語言環境的作法不同。
這項設定指定以本地化的方式使用應用程式時,所用的語言和多位元組字集。如果要讓這項設定生效,請設定代理程式環境定義的 LANG 環境變數。
如果要設定代理程式,使其將指令輸出視為美式英文 UTF-8,請讓您的作業系統採用 UTF-8 語言環境。例如,在 Linux 中使用下列的表示法。
locale en_US.UTF-8
如果要判斷您作業系統的 UTF-8 語言環境表示法是否正確,請執行 locale -a 指令。
如果沒有指定這項設定,代理程式會使用作業系統的語言環境。這項設定相當便利好用。尤其是如果作業系統的預設語言環境,不是您希望代理程式使用的語言環境,這項設定就可派上用場。再者,如果變更系統語言環境只為了符合代理程式需求,而非務實作法,更可善用這項設定。
一般而言,代理程式使用 root 或 admin 等管理專用權來登入作業系統。magic_login 設定可作為標準系統鑑別的替代方案。透過這項設定,系統可以使用單一使用者名稱與密碼來鑑別您的登入。
如果代理程式是以 root 或 admin 使用者身分執行,會忽略這項設定,並嘗試採取一般鑑別方式。
代理程式執行所有的指令時,所用的是啟動代理程式之使用者的許可權,而非使用登入時所用的使用者名稱。
只有在下列情況,才會使用這項設定:
如果要為代理程式配置登入,請執行下列動作:
如下所示,這會傳回以 SMD5 雜湊編碼的密碼:
bfagent -P "MySecretPassword" eca0b7f2f4fbf110f7df570c70df844e1658744a4871934a
magic_login build:eca0b7f2f4fbf110f7df570c70df844e1658744a4871934a
map X:=//host1/share;Z:=//host2/share(username,password)
這項設定僅適用於在 UNIX 或 Linux 系統上執行的代理程式。
在 Shell 與代理程式的虛擬終端機互動時,這項設定有助於避免鎖定系統 Shell。一般而言,這項設定是搭配 HP-UX 與 z/OS 使用。您也可以使用其他兩種方法,協助避免發生這樣的鎖定:
no_pty 設定會停用虛擬終端機的配置。
這項設定僅適用於在 UNIX 或 Linux 上執行的代理程式。
這項設定會使得代理程式所要執行的 Shell,變成一般 Shell 而非登入 Shell。這項設定通常用於下列情況:
當設定此項時,會採用標準方法,要求 Shell 必須是一般 Shell 而非登入 Shell。這不見得適用於所有平台,若有這類情況,可使用 shellflag 設定傳遞旗標給 Shell,以修改其行為。
代理程式並不需要那些行為,因為它是以使用者身分而非互動使用者身分執行。
另請參閱 shellflag 設定。可以使用旗標來變更登入 Script 行為。
只有當您在啟動時發出 -s 選項,讓代理程式在 UNIX 或 Linux 中以獨立模式執行時,才會使用這項設定。
這項設定指定代理程式透過「管理主控台」來接聽連線時,所要使用的埠。
指定代理程式透過「管理主控台」來接聽連線時,所要使用的埠。
您可以從步驟來置換這項設定。以含有 #! 的字行為開頭的步驟會置換 Shell 設定,而 nologonshell 設定用來執行逐步指令。
這項設定僅適用於在 UNIX 或 Linux 上執行的代理程式。
如果指令看起來很雜亂,請使用這項設定。Red Hat Linux Enterprise 中的某些 Shell 需要這項設定。
這項設定會變更將指令 Script 傳遞給 Shell 的方式。一般而言,Script 是透過標準輸入來傳遞:
/bin/sh < /tmp/bfshellscript.sh
這項設定會將 Script 當成參數傳遞來執行它們:
/bin/sh /tmp/bfshellscript.sh
這項設定僅適用於在 UNIX 或 Linux 上執行的代理程式。
這項設定會在 Shell 執行時新增旗標。只能指定一個旗標。一般而言,它用來停用 rc Script 處理程序,以減少輸出或不必要的處理。
範例:這項設定識別 Build Forge 代理程式執行檔的完整路徑。在安裝期間會自動建立設定。目錄是作業系統的預設目錄,或是您指定的安裝目錄。
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 來測試代理程式連線。
如果要從指令行來測試連線,請執行下列動作:
telnet hostname 5555這項回應指出連線成功:
200 HELLO - BuildForge Agent v7.0.1.buildnumber
telnet localhost 5555 username user name password password cmd ping go
下列訊息指出成功:
鑑別:將使用者帳戶設定為 <user name>如果上述測試可以運作,但工作卻失敗,而您的伺服器測試顯示使用者鑑別錯誤,請檢查可外掛的鑑別模組 (PAM) 配置。如果您看到類似如下的訊息,請繼續進行下一步驟。
鑑別:無法將使用者帳戶設定為 <user name>:不明帳戶 (1)
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 上疑難排解代理程式,請執行下列動作:
如果要疑難排解 UNIX 或 Linux 上的代理程式,請嘗試執行下列程序:
200 HELLO - Build Forge Agent v7.0.1.122如果您收到類似範例的訊息,並且發生共用程式庫問題,您就會收到關於這些問題的訊息。只要路徑設定正確,就可以解決大部分的共用程式庫問題。
telnet localhost 5555200 HELLO 回應指出代理程式正在接聽。如果您未取得這項回應,請檢查您的系統網路配置。請驗證 inetd 配置是否正確,或是向您的 Linux 或 UNIX 系統管理者查詢。
telnet localhost 5555 username <user name> password <password> cmd ping go這時會出現類似以下的訊息,指出鑑別運作正常:
鑑別:將使用者帳戶設定為 <user name>如果先前的測試可以運作,但卻建置失敗,而您的伺服器測試顯示使用者鑑別錯誤,請檢查可外掛的鑑別模組 (PAM) 配置。如果您看到類似如下的訊息,請繼續進行下一項程序。
鑑別:無法將使用者帳戶設定為 user name:不明帳戶 (1)
[application] [when] [mode] [module]欄位說明如下:
bfagent auth requisite pam_authtok_get.so.1 bfagent auth required pam_dhkeys.so.1 bfagent auth required pam_unix_cred.so.1 bfagent auth required pam_unix_auth.so.1
[when] [mode] [module]
安裝 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。
請選擇下列一種安裝方法:
用戶端是透過 IBM Installation Manager 以可下載的檔案方式配送。
Rational Team Concert for System z 用戶端有三種安裝方法。
如果 Installation Manager 已不在執行中,請完成下列步驟來啟動它。
launchpad.exe
sh launchpad.sh
launchpad.exe
sh launchpad.sh
疑難排解:建議採用以下的問題管理技術。
用戶端是以可下載的 .zip 檔來配送。
您應下載 Rational Team Concert for System z 用戶端 .zip 檔。
疑難排解:建議採用以下的問題管理技術。
如果您計劃整合 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。
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 本端說明系統更新程式」網站下載它。
在安裝期間,會選取說明存取選項下載說明並在本端存取內容。
在使用產品的說明之前,您必須先將說明下載到您的本端系統中。
如果要從「本端說明系統更新程式」網站下載說明內容,請完成下列步驟:
您選取的說明會安裝在您的系統上。 當網際網路連線可用時,會自動更新這些檔案。
如果您不要用遠端說明來存取 Web 中的說明內容,您必須將說明內容安裝在本端環境中。 這個主題說明如何利用「本端說明系統更新程式」和安裝映像檔提供的 RTCz2.0_updateSite.zip 檔,來安裝說明內容。
在安裝期間,會選取說明存取選項下載說明並在本端存取內容。
在使用產品說明之前,您必須先將說明安裝到本端系統中。
如果要利用「本端說明系統更新程式」,將說明內容安裝在工作站上,請完成下列步驟:
您選取的說明會安裝在您的系統上。
利用「本端說明系統」更新程式,來確保您有最新的說明內容。
您已從「本端說明系統更新程式」網站安裝說明特性。
您每次啟動產品時,如果有網際網路連線,都會自動安裝更新項目。
如果要更新說明,而不重新啟動產品,請完成下列步驟:
您可以利用「本端說明系統更新程式」來移除已安裝的說明內容。
您已利用「本端說明系統更新程式」來下載說明特性。
如果要移除已安裝的說明內容,請完成下列步驟:
您可以在防火牆後面設定一部企業內部網路伺服器,以向使用者提供說明內容。 當使用這個方法時,使用者不需要將說明內容下載及儲存到他們的電腦中。
您有一個可用的伺服器,防火牆後面的使用者可以存取這個伺服器。
請參閱 Installation Manager 資訊中心,以取得針對說明內容來設定企業內部網路伺服器的指示。 在 Installation Manager 資訊中心中,選取企業安裝文章 -> 從企業內部網路伺服器遞送說明內容。
您可以變更您存取說明內容的方式。 可選擇的方法如下:從 Web 存取說明;下載說明並在本端存取內容;或從企業內部網路的伺服器存取說明。
在變更您存取說明內容的方式之前,請先關閉說明瀏覽器。
在安裝程序期間,您選取下列其中一個方法來存取說明內容:
如果要變更您存取說明內容的方式,請完成下列步驟:
如果您在使用線上說明時,收到記憶體不足或 Script 錯誤,您可能需要使用另一個瀏覽器。
如果您利用 Internet Explorer 來開啟線上說明,您可能會收到類似下列錯誤訊息:
這個頁面上的 Script 會使 Internet Explorer 執行速度變慢。 如果它繼續執行,您的電腦可能變成沒有反應。 記憶體不足,行號:number
這是一個 Internet Explorer 的已知問題,暫行解決方法是使用另一個瀏覽器。 您可以依照下列方式來選擇另一個瀏覽器:
如果要安裝 ClearCase Connector 和 ClearQuest Connector 等連接器,請執行下列動作:
如果要安裝 ClearCase Connector ,請執行下列動作:
您可以使用 IBM Installation Manager,將 ClearCase Connector 安裝在建置機器上。
如果 Installation Manager 不在執行中,請啟動它。
launchpad.exe
sh launchpad.sh
您可以使用下載的 .zip 檔,將 ClearCase Connector 安裝在建置機器上。
如果要安裝 ClearQuest Connector ,請執行下列動作:
您可以使用 IBM Installation Manager,將 ClearQuest Connector 安裝在建置機器上。
如果 Installation Manager 不在執行中,請啟動它。
launchpad.exe
sh launchpad.sh
您可以使用下載的 .zip 檔,將 ClearQuest Connector 安裝在建置機器上。
如果要從 .zip 檔來安裝 ClearQuest Connector,請執行下列動作:
上下文搜尋與工作顧問特性可讓您透過任意文字搜尋來尋找程式碼,並對於工作項目的相關程式碼位置提供建議。這項特性是以技術預覽形式提供。
如需安裝和使用上下文搜尋與工作顧問預覽的相關資訊,請參閱 http://ibm.com/support/docview.wss?rs=3641&uid=swg27016785。
本文件含有 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 版支援以下的整合環境。
如需逐步安裝指示,請參閱資訊中心中的下列主題:
已知問題會以個別的 TechNotes 形式記載在「支援」知識庫中。一旦發現與解決問題,「IBM 支援中心」團隊就會更新知識庫。透過搜尋知識庫,您可以迅速找到問題的暫行解決方法或徹底解決方案。
下列鏈結會啟動自訂的即時「支援知識庫」查詢:
IBM、IBM 標誌與 ibm.com® 是 International Business Machines Corp. 在全球眾多適用範圍中的商標或註冊商標。其他產品與服務名稱可能是 IBM 或其他公司的商標。IBM 現行商標清單可在網路上的 "Copyright and trademark information" 中取得,其網址是 www.ibm.com/legal/copytrade.shtml