SQL サーバー・データベースのセットアップ

Jazz™ Team Server と連動するように SQL サーバー・データベースをセッ トアップします。

この手順では、次の前提条件が満たされているものとします。

注: SQL サーバー・データベースに対するデフォルトのログイン名 (JazzInstallDir/server/teamserver.properties ファイルに定義されています) は jazzDBuser であり、デフォルトのパスワードは jazzDBPswd です。これらの 値は、以下のデータベースの作成ステップで使用します。 これらの値を、ご使用 のデータベースの ユーザー名およびパスワードで置き換えることができます。

データベースのセットアップ

注: このセクションでは、SQL サーバー のインストールで用意されているコマンド行ツール sqlcmd を使用して、SQL サーバ ー・データベースをセットアップする方法を説明します。 SQL Server Studio Management (Express™ バージョンでも SQL Server Studio Management Express として利用可能) などのビジュアル・ツール を使用することもできます。 詳しくは、SQL サーバー資料を参照 するか、また は SQL サーバーのデータベース管理者 (DBA) に問い 合わせてください。

コマンド・ツール sqlcmd を使用して SQL サーバー ・データベースをセットアップするには、以下の手順を実行します。

  1. Jazz Team Server データベースを作成します。 コマンド行ツールから、以下のように入力します。 
    CREATE DATABASE jazz 
検索
  2. ユーザーとパスワードを作成して、 Jazz Team Server データベースの所有権を変更します。 コマンド行ツールから、以下の ように入力します。 
    CREATE LOGIN jazzDBuser
WITH PASSWORD = 'jazzDBPswd';
USE jazz;
exec sp_changedbowner 'jazzDBuser'
検索
  3. Jazz Team Server データベースの照合を変更します。 コマンド行ツールから、以下のように入力します。 
    ALTER DATABASE jazz COLLATE SQL_Latin1_General_CP437_CS_AS 
検索

サーバーの構成

注: デフォル トでは、 JazzInstallDir/server ディレ クトリー内の teamserver.properties ファイ ルは、SQL サーバー・データベースに接続するよう にセットアップされていません。 すべてのデフォルトの設定および SQL サーバー固有の設定は、同 じディレクトリー内の teamserver.sqlserver.properties ファイルにあります。

サーバーを構成するには、以 下の手順を実行します。

  1. 以下のファイルの名前を変更します。
    • JazzInstallDir/server/ teamserver.properties ファイルの名前を teamserver.OtherDBProvider.properties に変更します。
    • teamserver.sqlserver.properties ファイルの名前を teamserver.properties に変更 します。
    注: 元の teamserver.properties ファイ ルの名前を変更することで、ファイルを以前の作業バ ージョンに戻すことができます。 デフォルトでは、 DB プロバイダーは derby です。
  2. 別のユーザー名、パスワード、またはデータベ ース名を使用した場合、SQL サーバーを Jazz Team Server 以外のマシンにインストールした場合、またはデフォ ルト以外のポートを使用している場合は、サーバー構 成ファイルを編集します。 JazzInstallDir/server ディレ クトリー内のファイル 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
  3. sqljdbc.jar という、SQL サーバー JDBC ドライバーの JAR ファイルを見つけ ます。 前提条件のセクションで説明したように、どこにドライバーをインストールしたかによってロケーションは異なる場合があります。
  4. 以下のいずれかの操作を実行して、JDBC の JDBC JAR ファイルのロケーションを指定します。
    • JDBC ドライバー JAR ファイルを JazzInstallDir/server/sqlserver ディレクトリーにコピーします。
    • 環境変数 SQLSERVER_ABSPATH を、JAR ファ イルを含むディレクトリーを指すようにセットアップ します。
      注: WebSphere® Application Server を使用する場合、SQLSERVER_JDBC というプロパティーを構成し、SQL サーバー JDBC ドライバーのディレクトリーへの絶対ファイル・パス (URL ではなく) にそのプロパティーを設定します。詳しくは、 WebSphere Application Server セットアップ手順を 参照してください。 このファイル・パスをメモしておいてください (この後の手順で使用します)。

これで、データベースのセットアップが完了しまし た。 次に、 Jazz Team Server データベース表を作成します。 詳しくは、Jazz Team Server データベース表の作成を参照してください。

トラブルシューティング

repotools コマンドが正常に実行できない場合、 JazzInstallDir/server ディレ クトリーにある repotools_createTables.log というログ・ファイルを確認してください。

以下につい ても確認してください。

注: さまざまなデータベース・プラットフォームで使用できるように、Jazz Team Server のデータベース・コードは汎用性があり、標準的なものになるように設計されています。ただし、構文、最適化の戦略、およびロッキングのセマンティックは、エンタープライズ・データベースの各ベンダーで異なります。サーバーに対しては、SQL サーバー上で、自動テスト 、通常のワークロードのシミュレーション、およびストレス・テストを組み合わせ たテストを実行しています。 通常のワークロードのシミュレーション でのパフォーマンスは、許容できる範囲でした。 並行性の自動テストでは、データベースのデッドロックが発生した場合もありましたが、別のサーバー・ハードウェアではこの現象は常に再現されたわけではありませんでした。

サーバーは、同時に発生する多数の要求を処理 するように 設計されています。 例外として、リポジトリー・データベース でデッドロックが発生する場合があります。これは、要求に関連するトランザクションにおいて、類似オブジェクトや同等のオブジェクトが同時に更新されるためです。これらは、めったに発生しませんが、通常のイベントです。 これに対して防御できるようシステムが設計されており、データ保全性は維持されます。データの損失は発生しません。デッドロックは、ビルド・エンジンの 実行などのタスクによってログに記録されること があります。 通常は、状態が検出され、タスクが再試行さ れます。 デッドロックによってビルドが失敗することが あります。 デッドロックを解決するために、ワークアイテムやソー ス・コードでの作業などのユーザー・アクションが中断されることが、非常にまれにあります。 この場合、ユーザー・アクシ ョンは失敗し、デッドロックについての詳細とともに 、エラーがユーザーに表示されます。 このとき、ユーザーはアクションを再試行することができます。

発生したすべてのデッドロックは、サーバーでロ グに記録されます。ログには、デッドロックの発生 時に起こったことについての情報が記載されています。 ログ・エントリーのテキストは、com.ibm.team.repository.common.RetryableDatabaseException: Serialization failure のようになります。

システムでデッドロックが発生した場合は、https://servername:9443/jazz/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog にあるエラー・ログを参照してください。

頻繁にデッドロックの例外が発生する場合は、製品サポートに連絡するか、または jazz.net のフォーラムにアクセスして、最新情報や更新情報、または問題の軽減手法を確認してください。

親トピック: データベースのセットアップ
フィードバック