您可以手動將 IBM® Rational® Asset Manager 安裝在現有的 Apache Tomcat 安裝架構上。
開始之前
您必須有已安裝且在執行中之 Tomcat 伺服器的管理和檔案存取權。
您必須具備 Tomcat 伺服器的安全憑證。
Rational Team Concert 的內含版本需要安全連線。
您必須知道 db2jcc_license_cu.jar 和 db2jcc.jar 檔的位置,這些檔案可讓 Tomcat 與 IBM DB2 資料庫伺服器通訊。您的資料庫伺服器提供者應該會提供這些檔案。
執行這項作業的原因和時機
如果您要改善 Rational Asset Manager 的效能和穩定性,
您可以在個別的 Tomcat 伺服器上安裝 Rational Asset Manager 的 Web 應用程式,以及內含 Rational Team Concert 的應用程式檔案。在這整份文件中,Rational Asset Manager 的 Tomcat 伺服器安裝目錄稱為 <tomcat_install_directory>,而 Rational Team Concert 的 Tomcat 伺服器安裝目錄則稱為 <tomcat_for_rtc_install_directory>。
如果您在同一部伺服器上安裝所有 Web 應用程式,
這些目錄會相同。
註: 如果您打算將
Rational Asset Manager 與隨附的
Rational Team Concert 部署在相同機器中的不同 Tomcat 伺服器應用程式上,請確定您已配置不同的 Tomcat 伺服器來使用不同的安全與非安全埠,以免發生衝突。如需 Tomcat 5.5 中的埠資訊,請參閱 Apache Tomcat 文件。
- 驗證所有的儲存庫伺服器皆設定成相同的現行日期、時間與時區。
- 在適合 Tomcat 和您作業系統的保存檔上,擷取 Rational Asset Manager 伺服器檔案。
這些應用程式檔案會位於 /apps/tomcat/ 資料夾中。
- 將共用程式庫解壓縮到 <tomcat_install_directory>\shared\lib 資料夾:
- 找出並解壓縮 <archive_extract_location>\apps\tomcat\sharedLib.zip 檔。
- 將解壓縮後之 sharedLib.zip 檔的完整內文,
複製到 <tomcat_install_directory>\shared\lib 目錄。
- 如果您要在不同的 Tomcat 伺服器上安裝 Rational Team Concert,
請將 sharedLib.zip 檔解壓縮的內容重複複製到其他 Tomcat 伺服器的 <tomcat_for_rtc_install_directory>\shared\lib 目錄。
- 從 <archive_extract_location>/apps/tomcat/ 目錄,
將下列檔案複製到 <tomcat_install_directory>/webapps/ 目錄:
- com.ibm.ram.repository.web.tomcat_runtime.war
- com.ibm.ram.repository.web.ws.tomcat_runtime.war
- iehs.war
- rmcabdgovernprocess.war
- 如果要變更應用程式的環境定義路徑,
請重新命名 WAR 應用程式檔案。 建議的名稱如下:
表 1. 建議的 Rational Asset Manager Web 應用程式檔案環境定義路徑| 原始檔案名稱 |
建議檔案名稱 |
產生的環境定義路徑 |
這是什麼? |
| com.ibm.ram.repository.web.tomcat_runtime.war |
ram.war |
ram |
Tomcat 的 Rational Asset Manager 主要 Web 應用程式 |
| com.ibm.ram.repository.web.ws.tomcat_runtime.war |
ram.ws.war |
ram.ws |
Tomcat 的 Rational Asset Manager Web 服務應用程式 |
| iehs.war |
ram.help.war |
ram.help |
Rational Asset Manager 說明和使用者輔助應用程式 |
| rmcabdgovernprocess.war |
ram.process.war |
ram.process |
資產型開發和控管程序的文件應用程式 |
- 對 Rational Asset Manager 配置 Tomcat 伺服器來存取 DB2。
- 在文字編輯器中,開啟 <tomcat_install_directory>\conf\server.xml 檔。
- 在 server.xml 中找出開頭為
<Connector,以及包含 port="8080" 或 port="8009" 的任何字行。將這些字行的開頭全變更為 <Connector URIEncoding="UTF-8"。
- 在 server.xml 中,於廣域 JNDI 資源 <GlobalNamingResources> 和
</GlobalNamingResources> 的開頭和結尾標籤之間,針對您的 Tomcat 版本輸入下列文字。
註: 針對
<your_username> 和
<your_password> 值,
請使用對資料庫有完整管理權的使用者 ID 和密碼。此處顯示的
"maxWait" 、"maxActive" 和 "maxIdle" 等值為範例值,可根據您的效能需求加以調整。例如,"url" 屬性可能看起來像
jdbc:db2://localhost:50000/RAMDB
輸入下列文字:
<Resource name="jdbc/RAM_Con"
type="javax.sql.DataSource"
driverClassName="com.ibm.db2.jcc.DB2Driver"
username="<your_username>"
password="<your_password>"
url="jdbc:db2://<fully_qualified_server_name>:<db2_port_number>/<Rational_Asset_Manager_database_name>"
poolPreparedStatements="true"
maxWait="5000"
maxActive="4"
maxIdle="2"/>
- 將下列 JAR 檔從 DB2 安裝架構的 <DB2_installaton_location>\java 資料夾複製到 <tomcat_install_directory>\common\lib 資料夾:
- db2jcc_license_cu.jar
- db2jcc.jar
- 在安裝媒體中找出 <archive_extract_location>/apps/tomcat/RTC-server.zip 檔。
- 將 RTC-server.zip 解壓縮至您硬碟上的一個位置,在這些指示中,將稱它為 <rtc_install_dir>。
- 找出 <rtc_install_dir>/jazz/server/jazz_war.ear 檔並解壓縮。您可以使用免費的公用程式 7-Zip 來解壓縮 .ear 檔。
從已解壓縮的 jazz_war.ear 套件中,將 jazz.war 檔複製到 <tomcat_for_rtc_install_directory>/webapps/ 目錄。
- 在 Tomcat 伺服器上配置 Rational Team Concert 的安全埠:
- 您必須建立安全憑證來識別 Rational Team Concert 的 Tomcat 伺服器,以建立 SSL 連線。您可以利用 Java JDK keytool 指令來建立自簽憑證,
也可以要求由授信的憑證管理中心所簽發的憑證。
如需以 keytool 指令來建立自簽憑證的相關資訊,
請參閱 Sun Java 文件。利用 keytool 指令,您可以利用下列範例指令來建立自簽憑證:keytool -genkey -alias tomcat -keystore <tomcat_for_rtc_install_directory>/.keystore
如果您是使用 IBM JRE,許多版本在 <IBM_Java_JRE_install_location>/jre/bin/ 目錄中都包括 IBM 工具 ikeyman。
您可以使用這個工具來建立及管理伺服器上的安全憑證。如需使用 iKeyman 工具的相關資訊,
請參閱 iKeyman 使用手冊。
- 在 <tomcat_for_rtc_install_directory>\conf\server.xml 檔中,
找出含有 scheme="https" 屬性的 <Connector> 標籤。
預設檔案包括埠 8443 的範例 <Connector> 標籤(已註銷)。
- 複製並貼上下列文字:
<Connector port="8443"
maxHttpHeaderSize="8192"
maxThreads="150"
minSpareThreads="25"
maxSpareThreads="75"
enableLookups="false"
disableUploadTimeout="true"
acceptCount="100"
scheme="https"
secure="true"
clientAuth="false"
keystoreFile="<keystore_file>"
keystorePass="<keystore_password>"
sslProtocol="<keystore_protocol>"
algorithm="<keystore_algorithm>"
URIEncoding="UTF-8" />
其中:
- <keystore_file> 是金鑰儲存庫檔的檔名。其可以是絕對路徑,或是 Tomcat 伺服器根目錄 (<tomcat_for_rtc_install_directory>) 的相對路徑;
- <keystore_password> 是金鑰儲存庫檔的密碼;
- <keystore_protocol> 是金鑰儲存庫的通訊協定。其很可能是 TLS 或 SSL_TLS;
- <keystore_algorithm> 是金鑰儲存庫的 X509 演算法。其很可能是 SunX509 或 IbmX509(視憑證的來源而定)。
- 如果您變更 port 值以使用 8443 以外的埠,
針對非 SSL 連接器(依預設為埠 8080),請變更 redirectPort 屬性的值,
以符合 SSL 連接器的埠號。
如需對 Tomcat 配置 SSL 的相關資訊,
請參閱 Apache Tomcat 5.5 SSL 配置方式以及 Apache Tomcat 配置參考手冊。
- 配置 Tomcat 啟動內容設定:
- 尋找 Tomcat 啟動檔,並在文字編輯器中開啟它。在 Windows® 上,這是 <tomcat_for_rtc_install_directory>\bin\startup.bat。在 Linux®、AIX® 或 Linux for zSeries® 上,這是 <tomcat_for_rtc_install_directory>/bin/startup.sh。
- 在啟動檔中,輸入下列文字;其中
<rtc_install_dir> 是您在步驟 9 所解壓縮的目錄:
Windows(請以 %20 取代 <rtc_install_dir> 中的空格字元):set JAZZ_INSTALL_DIR=<rtc_install_dir>
set JAVA_OPTS=-Djava.awt.headless=true -DSQLSERVER_JDBC="%SQLSERVER_JDBC%" -DORACLE_JDBC="%ORACLE_JDBC%" -DDB2I_JDBC="%DB2I_JDBC%" -DDB2Z_JDBC="%DB2Z_JDBC%" -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file:///%JAZZ_INSTALL_DIR%\jazz\server\conf -Dcom.ibm.team.repository.tempDir=%TEMP% -Xmx700M


Linux、AIX 或
Linux for zSeries:JAZZ_INSTALL_DIR=<rtc_install_dir>
export JAVA_OPTS="-Djava.awt.headless=true -DSQLSERVER_JDBC=$SQLSERVER_JDBC -DORACLE_JDBC=$ORACLE_JDBC -DDB2I_JDBC=$DB2I_JDBC -DDB2Z_JDBC=$DB2Z_JDBC -Dorg.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin=true -DJAZZ_HOME=file://"$JAZZ_INSTALL_DIR"/jazz/server/conf -Dcom.ibm.team.repository.tempDir=$TEMP_DIR -Xmx700M"
- 編輯 Jazz™ 伺服器內容檔:
- 在 <rtc_install_dir>/jazz/server/conf/jazz/ 目錄中尋找
teamserver.properties 檔,並重新命名為
teamserver.derby.properties。
- 在 <rtc_install_dir>/jazz/server/conf/jazz/ 目錄中尋找 teamserver.db2.win32.properties 檔
(若為 Windows)或 teamserver.db2.linux.properties 檔(若為
Linux、AIX 或 zLinux),並將檔案重新命名為 teamserver.properties。
- 在 teamserver.properties 檔中,指定資料庫與連線內容:
- 在文字編輯器中開啟 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 伺服器位置的 com.ibm.team.repository.db.jdbc.location 值,以及生命週期的資料庫名稱:
- 以 DB2 資料庫的位置與埠,取代 localhost:50000。
提示: 在「DB2 指令視窗」中,執行 db2 get dbm cfg 指令,然後尋找內含
SVCENAME 的字行,此行指出 DB2 的埠名或埠號。如果這個指令顯示號碼,請用來作為埠號(以取代上述範例中的 50000)。如果指令傳回非數值的名稱,請判斷指派給這個名稱的埠號,然後使用該埠號。在 Linux 中,/etc/services 檔含有埠名與埠號之間的對映;在 Windows 中,C:\windows\system32\drivers\etc\services 檔含有這項對映。如需相關資訊,請詢問您的資料庫管理者,或參閱資料庫文件。
- 以生命週期的資料庫名稱,取代 JAZZ。
- 以 DB2 資料庫的使用者名稱,取代 db2admin。
註: DB2 使用者對於建立表格、表格空間與修改資料庫配置,必須具備許可權。DB2 使用者由作業系統所建立。
- 在 com.ibm.team.repository.db.jdbc.password 內容中指定使用者密碼。
註: 請勿變更
com.ibm.team.repository.db.jdbc.location 內容中的 password={password} 文字。
- 在 teamserver.properties 檔中新增下列內容,其中 <unsecure_port> 是
Tomcat 伺服器的非安全埠(預設值為 8080),<secure_port> 是 Tomcat 伺服器的安全埠號
(預設值為 8443),<team_temp_dir> 是用來儲存暫存檔的目錄絕對路徑。
com.ibm.team.scm.tmpdir=<team_temp_dir>
com.ibm.team.repository.server.repourl.port.http=<unsecure_port>
com.ibm.team.repository.user.registry.type=UNSUPPORTED
com.ibm.team.repository.ws.allow.admin.access=false
com.ibm.team.repository.server.repourl.port.https=<secure_port>
- 建立 Rational Team Concert 的表格:
- 開啟指令行視窗,然後導覽至 <rtc_install_dir>/jazz/server/ 目錄。
- 執行下列指令:
- 配置 Tomcat 伺服器的使用者安全。如果您打算使用 LDAP 安全,請先使用檔案型安全來配置應用程式,
然後在配置好應用程式之後,切換至 LDAP 鑑別(如需相關資訊,請參閱配置 Tomcat 的 LDAP 鑑別):
- 在文字編輯器中,開啟 <tomcat_install_directory>\conf\tomcat-users.xml 檔(針對 Rational Asset Manager 的伺服器)。
- 新增名稱為 admin 的使用者,然後指派其 admin 和 manager 的角色。
您可以在 <tomcat-users> 標籤之間複製並貼上下列內容:
<user username="admin" password="" roles="admin,manager" />
這個使用者的名稱必須是 admin。
- 在文字編輯器中,開啟 <tomcat_for_rtc_install_directory>\conf\tomcat-users.xml 檔(針對 Rational Team Concert 的伺服器)。 同樣地,
如果您要將應用程式安裝到同一部 Tomcat 伺服器,這會是與步驟 15a 相同的檔案。
- 在 <tomcat-users> 標籤之間貼入下列文字:
<role rolename="JazzUsers"/>
<role rolename="JazzAdmins"/>
<role rolename="JazzDWAdmins"/>
<role rolename="JazzGuests"/>
- 新增名稱為 admin 的使用者,然後指派其 admin、manager 和 JazzAdmins 的角色。您可以在 <tomcat-users> 標籤之間複製並貼上下列內容:
<user username="admin" password="" roles="admin,manager,JazzAdmins" />
如果您要在同一部伺服器上安裝應用程式,您可以新增 JazzAdmins 角色給您在步驟 13b 建立的使用者。
- 重新啟動 Tomcat 伺服器。
- 配置 Rational Team Concert 的管理使用者:
- 在 Web 瀏覽器中,啟動位於
https://<machine_name>:<secure_port>/jazz/admin/ 的 Rational Team Concert 管理 Web 使用者介面。 請注意 https;其必須是安全連線。
- 使用應用程式伺服器管理者的使用者 ID 與密碼登入。 如果您看到關於「提取伺服器狀態資訊」的錯誤,
請關閉再重新啟動資料庫伺服器和 Tomcat 伺服器,然後再重新登入。
- 按一下使用者管理。 請忽略關於未配置外部登錄的任何錯誤。
- 按一下建立使用者。
- 輸入下列詳細資料:
- 使用者名稱:Tomcat 伺服器管理者的使用者 ID
- 使用者 ID:Tomcat 伺服器管理者的使用者 ID
- 電子郵件位址:Tomcat 伺服器管理者的有效電子郵件位址
- 在「用戶端存取授權」區段中,選取 Rational
Team Concert - 開發人員,將開發人員授權指派給該使用者。
- 按一下儲存。
- 登出,然後以應用程式伺服器的管理者身分,登入回「管理 Web 使用者介面」。
- 將生命週期程序範本匯入至
Rational Team Concert:
- 在 Rational Team Concert 管理 Web 使用者介面中,按一下程序範本管理。 如果您未看到程序範本管理鏈結,
請登出,然後再登入回「管理 Web 使用者介面」。
- 按一下匯入範本,並瀏覽至 <archive_extract_location>/DatabaseScripts/ 資料夾中的
com.ibm.ram.lifecycle.zip 檔。然後按一下確定。 這時會顯示 RAM 生命週期範本。
- 在 Rational Team Concert 中建立新的專案區域:
- 在 Rational Team Concert 管理 Web 使用者介面,按一下專案區域管理。 如果您未看到專案區域管理鏈結,
請登出,然後再登入回「管理 Web 使用者介面」。
- 按一下建立專案區域。
- 輸入下列有關專案區域的詳細資料:
- 專案名稱:RAM 生命週期
- 摘要:「Rational Asset Manager 生命週期」控制專案區域
- 說明:這個區域用來管理
Rational Asset Manager 的生命週期
- 按一下儲存。
- 為專案區域指派適當的成員資格與程序角色:
- 在「專案區域管理」頁面中,按一下 RAM 生命週期專案區域。
- 在「管理者」區段中,按一下新增;然後搜尋並選取您所建立的管理者。
- 在「成員」區段中,按一下新增;然後搜尋並選取您所建立的管理者。
- 在您新增管理者之後,請按一下管理者名稱旁的程序角色圖示。
- 從「編輯程序角色」對話框的可用角色清單中,選取管理,並按一下新增。
- 按一下完成。
- 按一下儲存。
- 停止,然後重新啟動 Tomcat 伺服器。
- 在 Web 瀏覽器中開啟 Rational Asset Manager。如果應用程式檔案使用了建議的名稱,
則 URL 會是 http://localhost:8080/ram/home.faces;
如果是透過 Web 伺服器,則 URL 會是 http://<Web_server_address>:<port>/ram/home.faces。 這時會開啟 Rational Asset Manager Web
用戶端。
下一步
接著,請配置 Rational Asset Manager Web 應用程式。如需相關資訊,請參閱配置 Rational Asset Manager 伺服器應用程式。