設定 Oracle 資料庫以用於 Rational Engineering Lifecycle Manager 和 Lifecycle Query Engine

設定 Oracle 資料庫來使用 Rational® Engineering Lifecycle Manager Jazz™ Team ServerRational Engineering Lifecycle Manager 以及「配置管理」應用程式。

開始之前

為了建立及設定 Oracle 資料庫,我們假設正在準備資料庫的使用者必須有資料庫的資料庫管理權限,且資料庫、表格空間儲存體,以及適當的儲存體配置,都是具備系統管理權限的使用者所建立。 另外,也必須在用來作為資料庫伺服器的一部電腦上,安裝下列支援的 Oracle 版本之一。這部電腦可以不是執行 Jazz Team Server 的電腦:
註: Oracle 10g 和 11g 兩者所需要的「Java™ 資料庫連線功能 (JDBC)」驅動程式,都是 ojdbc6.jar 11.2.0.3 或更新的版本。 同時一律將資料庫更新為最新資料庫版本。 比方說,如果資料庫伺服器是 11.2,您應該執行 11.2.0.3 或更新的版本。
重要: 下列配置參數和表格空間選項是範例,不一定完全適用於您的環境。 例如,如果您無法使用 AUTOEXTEND 設定,檔案必須夠大,以便繼續成長。 或者,如果您無法將 UNLIMITED 大小配額用於 Jazz Team Server 資料庫使用者,請務必留下足夠的空間來應付快速成長。
重要: 如果您將 Rational Engineering Lifecycle Manager 應用程式安裝在同一部電腦或分散式平台上,您可以分別建立每個應用程式的個別資料庫,也可以針對所有的應用程式都使用相同的資料庫。 不過,您必須針對每個應用程式來建立個別的表格空間,以及關聯於這個表格空間的資料庫使用者。

這個主題的範例適用於各應用程式分別有專用的資料庫使用者的 Oracle 資料庫。

註: 您針對 Jazz Team Server 及所有 Rational Engineering Lifecycle Manager 應用程式而建立的資料庫都必須格式化成為使用 UTF-8 字集。依預設,Oracle 不會建立使用 UTF-8 字集的資料庫。 當您建立新的資料庫時,請務必在 Oracle DB 設定中選取 AL32UTF8

程序

  1. 作為系統管理者,請針對 Jazz Team Server 和所有應用程式,建立一個使用 UTF-8 編碼的資料庫。
  2. 開啟 SQL *Plus 視窗,然後建立資料庫表格空間:
    CREATE TABLESPACE <relmjts user tablespace>
    DATAFILE '<path and name of .dbf file>' 
    SIZE 1G AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
    CREATE TEMPORARY TABLESPACE <relmjts user temp tablespace>
    TEMPFILE '<path and name of the temp .dbf file>' 
    SIZE 20M AUTOEXTEND ON EXTENT MANAGEMENT LOCAL UNIFORM SIZE 1M;
  3. 如果您在安裝所有 Rational Engineering Lifecycle Manager 應用程式,您必須重複上述步驟 2 次,來分別建立 Rational Engineering Lifecycle Manager JTS (relmjts)、Rational Engineering Lifecycle Manager (relm) 和「配置管理」應用程式 (vvc) 的表格空間。在「Oracle Enterprise 管理程式資料庫控制」中,確認顯示了您建立的表格空間,且可以存取。
  4. 建立每個新表格空間的 Oracle 資料庫使用者。

    建立表格空間之後,必須為每一項產品各建立一個特殊的 Oracle 使用者,來使用 Oracle 資料庫。如果有多部 Jazz 伺服器執行於單一 Oracle 資料庫,每個應用程式都必須建立一個 Oracle 資料庫使用者。 Oracle 資料庫使用者必須能夠以建立階段作業、表格、程序及視圖的專用權,在其表格空間(無限制或有空間配額)中建立資料庫物件。

    在這些範例中,請取代角括弧中的詞組。
    CREATE USER <relmjts db user> IDENTIFIED BY <password> DEFAULT TABLESPACE <relmjts user tablespace> QUOTA UNLIMITED ON <relmjts user tablespace> TEMPORARY TABLESPACE <relmjts user temp tablespace>;
    在建立使用者之後,請授與使用者在起始設定 Jazz 資料庫時所需的必要許可權。 以下的 SQL 指令可用來授與適當的許可權:
    GRANT CREATE PROCEDURE, CREATE SESSION, CREATE TABLE, CREATE VIEW TO <relmjts db user>;
    註: 相較於其他資料庫,在 Oracle 上建立倉儲需要更多許可權。 當您在資料倉儲的連線規格中指定資料庫使用者時,請確定資料庫使用者有 DBA 許可權。 如需相關資訊,請參閱完成安裝。 另外也假設名為 "USERS" 的表格空間已存在。這是預設的 Oracle 表格空間。如果您的 Oracle 資料庫中沒有此表格空間,請使用下列指令來建立它。
    CREATE TABLESPACE USERS 
    DATAFILE '<path and name of .dbf file>' 
    SIZE <tablespace size> AUTOEXTEND ON EXTENT MANAGEMENT LOCAL AUTOALLOCATE;
  5. 建立名為 ORACLE_JDBC_DRIVER_FILE 的環境變數並指向 ojdbc6.jar JDBC 驅動程式。位置可能因 Oracle 產品和作業系統而有不同。您可以從 www.oracle.com 下載支援的 Oracle JDBC 驅動程式 (ojdbc6.jar 11.2.0.3)。
    1. 按一下開始 > 控制台 > 系統
    2. 按一下進階標籤,然後按一下環境變數
    3. 系統變數清單中,按一下新建
    4. 變數名稱中,輸入 ORACLE_JDBC_DRIVER_FILE,在變數值中,輸入 C:\Path_to_JDBC_dirver\ojdbc6.jar
    1. 在 Linux 系統上,新增下列環境變數宣告:
      ORACLE_JDBC_DRIVER_FILE =.;Path_to_JDBC_dirver/ojdbc6.jar
      註: Rational Engineering Lifecycle Manager 不支援 JRE 5.0。支援的 JRE 版本是 6.0 及 7.0。ojdbc5.jar 類別庫需要 JRE 5.0,ojdbc6.jar 類別庫需要 JRE 6.0 或更新版本。您必須使用 ojdbc6.jar

      如果您使用 WebSphere® Application Server,您也必須新增指向 ojdbc6.jar JDBC 驅動程式的自訂內容。 如需相關資訊,請參閱設定 Rational Engineering Lifecycle Manager 的 WebSphere Application Server

  6. 如果要配置您的資料庫連線,以及建立資料庫表格,請完成下列步驟之一:
    1. 如果您使用 Tomcat,請啟動伺服器,繼續對 Rational Engineering Lifecycle Manager 應用程式執行 Jazz Team Server 安裝精靈
    2. 如果您要部署 WebSphere Application Server,請參閱對 Rational Engineering Lifecycle Manager 應用程式執行 Jazz Team Server 安裝精靈

手動配置 Oracle 資料庫

關於這項作業

執行安裝精靈是配置資料庫連線及建立資料庫表格的建議方法。 如果要執行設定精靈,請遵循對 Rational Engineering Lifecycle Manager 應用程式執行 Jazz Team Server 安裝精靈中的指示。

如果您偏好手動執行這個程序,請利用這個主題來編輯 teamserver.properties 檔,以設定 Oracle 資料庫連線,並執行 -createTables 指令來建立資料庫表格。

程序

  1. 每個應用程式都有您必須將開啟及修改個別的 teamserver.properties 檔。 這些檔案位於 <JazzInstallDir>/server/conf 目錄下其各自的目錄(relmjtsrelmvvc)中。 請開啟每個 teamserver.properties 檔,指定資料庫和連線的詳細資料。
    1. 在「Derby 配置」之下的各行,在每一行之前放置 # 記號,以將它們註銷:
      #com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/relmjts/derby/repositoryDB
    2. 在「Oracle 配置」之下的各行,移除每一行旁的 # 記號,以將它們解除註解:
      註: 提供給每一個儲存庫的資料庫位置有兩行。 一行用於本端系統,一行用於遠端系統的資料庫伺服器。 只要將適合您環境的那一行解除註解。 這裡的範例適用於遠端伺服器,在伺服器 URL 之前有 2 條正斜線:@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.vendor = ORACLE
      com.ibm.team.repository.db.jdbc.location=thin:relmjtsDBuser/{password}@//oracleserver.example.com:1521/ORCL
      com.ibm.team.repository.db.jdbc.password=relmjtsDBpswd
    3. 編輯 com.ibm.team.repository.db.jdbc.locationcom.ibm.team.datawarehouse.db.jdbc.location 兩行中的下列值:
      • //oracleserver.example.com:1521:請輸入資料庫伺服器的完整主機名稱。
      • jtsDBuser:請輸入資料庫使用者。
      • jazzDBuser:請輸入資料倉儲資料庫使用者。 必須是一個 DBA。
      • ORCL:請輸入 Oracle 服務名稱。 連接到 Oracle DB 時,請確定 ORCL 服務名稱存在於伺服器電腦上。
      記住: Oracle 位置 URL 可有多種格式。這裡的範例對於大部分情況都適用。如需詳細資料,請參閱 Oracle JDBC 說明文件。
      註: 請勿變更 com.ibm.team.repository.db.jdbc.locationcom.ibm.team.datawarehouse.db.jdbc.location 內容中的 password={password} 文字。
    4. com.ibm.team.repository.db.jdbc.passwordcom.ibm.team.datawarehouse.db.jdbc.password 內容中,指定使用者密碼。
    5. com.ibm.team.fulltext.indexLocation=conf/relmjts/indices/workitemindex 這一行的值變更為全文索引的完整路徑位置。 例如,輸入 com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices/workitemindex
    6. com.ibm.team.jfs.index.root.directory=indices 這一行的值變更為 Jazz Foundation Service 索引根目錄的完整路徑位置。 例如,輸入 com.ibm.team.jfs.index.root.directory=c:/Progra~1/IBM/JazzTeamServer/server/conf/relmjts/indices
  2. 建立資料庫之後,請執行儲存庫工具指令來建立資料庫表格。
    重要: 只有在這是新安裝時,才能執行 createTables 指令。
    註: 執行 -createWarehouse 指令的使用者必須有 DBA 許可權。 .
    註: 當您執行 repotools 指令時,將會更新 teamserver.properties 檔,而具有原始內容的原始檔案會儲在相同目錄中。 您也可能看到警告指出公用 URI 未設定。您現在可以忽略這個警告,因為對 Rational Engineering Lifecycle Manager 應用程式執行 Jazz Team Server 安裝精靈時會設定公用 URI。
    1. 如果要建立 Jazz Team Server 的資料庫表格,請移至 JazzInstallDir/server 目錄,然後執行下列指令:
      repotools-relmjts -createTables
    2. 如果要建立 Rational Engineering Lifecycle Manager 應用程式的資料庫表格,請移至 RELMInstallDir/server 目錄,然後執行下列指令:
      repotools-relm -createTables 
    3. 如果要建立「配置管理」應用程式的資料庫表格, 請移至 VVCInstallDir/server 目錄,然後執行下列指令:
      repotools-vvc -createTables 

意見