設定 SQL Server 資料庫以用於 Rational Engineering Lifecycle Manager

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

開始之前

這個程序要求符合 SQL Server 的下列必要條件:

註: 如果您以英文以外的其他語言使用 SQL Server,則必須先將語言變更為英文,然後再建立資料倉儲:
  1. 在 SQL Server Management Studio 中,用滑鼠右鍵按一下與資料庫伺服器的連線。
  2. 從蹦現視窗中,選取內容
  3. 在「伺服器內容」視窗中,選取進階,然後將預設語言項目設定為英文
  4. 儲存您的變更。

程序

  1. Jazz Team Server, Rational Engineering Lifecycle Manager 以及「配置管理」應用程式的每一個實例建立資料庫。為與 Jazz Team Server 相關聯的資料倉儲建立資料庫。 例如,如果您有一個 Rational Engineering Lifecycle Manager、一個「配置管理」應用程式、一個 Jazz Team Server 以及一個資料倉儲,則需要建立四個資料庫。請使用下列範例來建立 Jazz Team Server 資料庫。若要建立 Rational Engineering Lifecycle Manager 以及「配置管理」應用程式資料庫,請用資料庫名稱取代 jts(例如,relmvvc):
    CREATE DATABASE jts 
    GO 
  2. 建立每一個資料庫的使用者及密碼,並變更每一個資料庫的所有權。
    執行下列指令:
    CREATE LOGIN jtsDBuser
    WITH PASSWORD = 'jtsDBpswd';
    USE jts;
    exec sp_changedbowner 'jtsDBuser'
    GO 
  3. 變更 Jazz Team ServerRational Engineering Lifecycle Manager 以及「配置管理」應用程式資料庫的對照。 從指令行工具中,針對 Jazz Team Server 執行以下指令。對於 Rational Engineering Lifecycle Manager 以及「配置管理」應用程式資料庫,請用 relmvvc 取代 jts
    ALTER DATABASE jts COLLATE SQL_Latin1_General_CP437_CS_AS 
    GO
  4. 變更 Jazz Team ServerRational Engineering Lifecycle Manager 以及「配置管理」應用程式資料庫的列版本系統。 從指令行工具中,針對 Jazz Team Server 執行以下指令。對於 Rational Engineering Lifecycle Manager 以及「配置管理」應用程式資料庫,請用 relmvvc 取代 jts
    註: 在執行此指令之前,請確定與資料庫的連線處於開啟狀態。
    ALTER DATABASE jts SET READ_COMMITTED_SNAPSHOT ON
    GO
  5. 變更資料倉儲資料庫的對照。 從指令行鍵入:
    ALTER DATABASE dw COLLATE SQL_Latin1_General_CP1_CS_AS
    GO
  6. 建立名為 SQLSERVER_JDBC_DRIVER_FILE 的環境變數並指向 sqljdbc4.jar JDBC 驅動程式。 驅動程式的位置隨您的安裝而不同。
    Windows
    1. 按一下開始 > 控制台 > 系統
    2. 按一下進階標籤,然後按一下環境變數
    3. 系統變數清單中,按一下新建
    4. 變數名稱中,輸入 SQLSERVER_JDBC_DRIVER_FILE,在變數值中,輸入 C:\Path_to_JDBC_driver\sqljdbc4.jar
    Linux 在 UNIX 系統上,新增下列環境變數宣告:
    SQLSERVER_JDBC_DRIVER_FILE =.:Path_to_JDBC_driver/sqljdbc4.jar
    註: Rational Engineering Lifecycle Manager 不支援 JRE 5.0。支援的 JRE 是 6.0 版及 7.0 版。

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

  7. 如果要配置資料庫連線,以及建立資料庫表格,請完成下列步驟之一:
    1. 如果您使用 Tomcat,或者要部署 WebSphere Application Server,請啟動伺服器,繼續對 Rational Engineering Lifecycle Manager 應用程式執行 Jazz Team Server 安裝精靈
    2. 如果您偏好手動修改資料庫連線的 teamserver.properties 檔,請執行 repotools 指令以建立資料庫表格。如需相關資訊,請閱讀手動配置 SQL Server 資料庫
    3. 如果您是從舊版升級,請繼續執行適當的升級 Script,其會移轉現有的資料庫連線。如需相關資訊,請閱讀「升級 Rational Engineering Lifecycle Manager」。

手動配置 SQL Server 資料庫

執行安裝精靈是配置資料庫連線及建立資料庫表格的建議方法。 如果您偏好手動執行這個程序,請編輯 teamserver.properties 檔,以設定 SQL Server 資料庫連線,並執行 -createTables 指令來建立資料庫表格。

程序

  1. 對於每一個應用程式,請開啟並修改個別 teamserver.properties。這些檔案位於 <JazzInstallDir>/server/conf 目錄下其各自的目錄(jtsrelmvvc)中。請開啟每一個 teamserver.properties 檔,並指定資料庫和連線詳細資料。
    1. 在「Derby 配置」之下的各行,在每一行之前放置 # 記號,以將它們註銷。下面以 JTS teamserver.properties 檔為例進行說明:
      #com.ibm.team.repository.db.vendor = DERBY
      # com.ibm.team.repository.db.jdbc.location=conf/jts/derby/repositoryDB
    2. 在「SQL Server 配置」之下的各行,移除每一行前面的 # 記號,以將它們解除註解:
      com.ibm.team.repository.db.vendor = SQLSERVER
      com.ibm.team.repository.db.jdbc.location=//localhost:1433;databaseName=jazz;user=jazzDBuser;password={password}
      com.ibm.team.repository.db.jdbc.password=jazzDBpswd
    3. 編輯 com.ibm.team.repository.db.jdbc.locationcom.ibm.team.datawarehouse.db.jdbc.location 內容中的下列值:
      • //localhost:1433:請輸入資料庫伺服器的完整主機名稱。
        註: 您必須利用「SQL Server 配置」工具,將靜態埠手動設為 1433。
      • jazz:請輸入資料庫名稱。
      • jazzDBuser:請輸入使用者名稱
      註: 請勿變更 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/jts/indices/workitemindex 這一行的值變更為全文索引的完整路徑位置。 例如,輸入 com.ibm.team.fulltext.indexLocation=c:/Progra~1/IBM/JazzTeamServer/server/conf/jts/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/jts/indices
  2. 建立每一個資料庫之後,必須執行 repotools 指令來建立資料庫表格。
    重要: 只有在這是新安裝時,才能執行 createTables 指令。
    註: 當您執行 repotools 指令時,將會更新 teamserver.properties 檔,而具有原始內容的原始檔案會儲在相同目錄中。您可能看到警告指出公用 URI 未設定。您現在可以忽略此警告,因為公用 URI 在執行 Rational Engineering Lifecycle Manager 應用程式的 Jazz Team Server 安裝精靈時設定。
    1. 如果要建立 Jazz Team Server 的資料庫表格,請移至 JazzInstallDir/server 目錄,然後執行以下指令:
      repotools-jts -createTables 
    2. 如果要建立 Rational Engineering Lifecycle Manager 應用程式的資料庫表格,請移至 RELMInstallDir/server 目錄,然後執行以下指令:
      repotools-relm -createTables 
    3. 如果要建立「配置管理」應用程式的資料庫表格, 請移至 VVCInstallDir/server 目錄,然後執行以下指令:
      repotools-vvc -createTables 

疑難排解

程序

  • 如果 repotools 指令不起作用,請檢查適當的日誌檔,這些檔案位於 JazzInstallDir/server 目錄中。
  • 請驗證下列狀況正確:
    • SQL Server 已配置成容許使用 TCP/IP 通訊協定來連線。 必要的話,請重新啟動 SQL 服務。
    • teamserver.properties 檔中,正確反映 SQL Server 電腦的主機名稱和埠。
    • teamserver.properties 檔中,正確反映登入名稱、密碼和資料庫名稱。
    • 防火牆不會妨礙您存取 SQL Server。使用 Telnet 指令連接至伺服器。輸入 teamserver.properties 檔案中的主機名稱和埠。
    • 所建立的使用者在 Jazz Team Server 資料庫中具備正確的許可權。
    • 已適當配置環境的 JDBC 驅動程式環境變數。
    註: Jazz Team Server 可在多個資料庫平台上執行;不過,企業資料庫之間存在語法、最佳化策略和鎖定語意上的差別。已使用自動化測試、正常工作量模擬及壓力測試的組合,在 SQL Server 上測試該伺服器。模擬正常工作量的結果,顯示效能是可接受的。在某些情況下,自動化並行測試中會發生資料庫死鎖;不過,並未在不同的伺服器硬體上一致地重新產生這些錯誤。

    伺服器設計為可處理大量同時進行的要求。在異常情況下,儲存資料庫中會發生死鎖,與在與要求相關聯的交易中並行更新的物件相似或相等。這些錯誤雖然很少見,但是屬於一般事件。系統可以防禦死鎖,資料完整性因此得以保持;不會遺失資料。建置引擎執行等之類的作業偶爾會記載死鎖。一般情況下,可以偵測到這種狀況,並再次執行作業。

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

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

    如果您遇到頻繁發生的死鎖,請與產品支援聯絡,或者檢查 jazz.net 上的論壇,以取得最新資訊、更新項目和緩和技術。


意見