Jazz™ Team Server、「変更管理と構成管理」、および「品質管理」アプリケーションと連動するように SQL Server データベースをセットアップします。
この手順では、SQL Server についての以下の前提条件が満たされている必要があります。
- 大/小文字を区別するデータベース照合をデフォルト設定として選択して、サーバーがインストールされている。
- サービスが始動済みである。
- Java Database Connectivity (JDBC) ドライバーがインストール済みである。
- SQL Server に対して TCP プロトコルが有効
になっている
- データベース表を作成するユーザーは、sysadmin 固定サーバー・ロールのメンバー、またはデータベースの所有者 (dbo) でなければならない。
ご使用のサーバーのセキュリティーが混合モードであることを確認してください。
モードを検証するには、サーバーのセキュリティーを確認します。これは「SQL Server 認証モードと Windows 認証モード」に設定されている必要があります。
データベースのセットアップ
SQL Server のインストール済み環境で提供される
sqlcmd コマンド行ツールを使用して SQL Server データベースをセットアップします。
Microsoft SQL Server 2008 Express Edition の sqlcmd ツールのアクティブ化: - 「スタート」メニューから、Microsoft SQL
Server 2008 を見つけて、をクリックします。
- 「SQL Server 構成マネージャー」ウィンドウの左ペインで、をクリックします。
- プロトコル「名前付きパイプ」をダブルクリックします。
- 「名前付きパイプのプロパティー」ダイアログ・ボックスの「使用可能」フィールドで「はい」を選択します。
- 「パイプ名」を ¥¥.¥pipe¥sql¥query に変更します。
- 「適用」をクリックします。その後、SQL Server サービスを再始動します。
SQL Server Studio Management
(Express®
バージョンでも SQL Server Studio Management
Express として利用可能) などのビジュアル・ツール
を使用することもできます。 詳しくは、SQL Server 資料を参照
するか、または SQL Server のデータベース管理者
(DBA) に問い合わせてください。
重要: Jazz Team Server を「変更管理と構成管理」アプリケーションまたは「品質管理」アプリケーションと共に同一のコンピューターまたは分散プラットフォームにインストールする場合は、別々のデータベースとそのデータベースに関連付けられたデータベース・ユーザーを作成する必要があります。
- 「変更管理と構成管理」、「品質管理」、Jazz Team Server、およびデータウェアハウスのインスタンスごとにデータベースを作成します。次の例を使用し、jts をユーザーのデータベース名に置換してください。
注: 「要求管理」アプリケーションは、Jazz Team Server と同じデータベースを使用します。
CREATE DATABASE jts
GO
- ユーザーおよびパスワードを作成し、以下のコマンドを実行してデータベースの所有権を変更します。
CREATE LOGIN jtsDBuser
WITH PASSWORD = 'jtsDBpswd';
USE jts;
exec sp_changedbowner 'jtsDBuser'
GO
- Jazz Team Server データベースの照合を変更します。
コマンド行ツールから、以下のように入力します。
ALTER DATABASE jts COLLATE SQL_Latin1_General_CP437_CS_AS
GO
- データベースの行のバージョン・システムを変更します。コマンド行ツールから、次のコマンドを実行してください。
注: このコマンドを実行する前に、データベースへの接続が開かれていることを確認してください。
ALTER DATABASE jts SET READ_COMMITTED_SNAPSHOT ON
GO
- データウェアハウス・データベースの照合を変更します。コマンド行から、以下のように入力します。
ALTER DATABASE dw COLLATE SQL_Latin1_General_CP1_CS_AS
GO
- SQLSERVER_JDBC_DRIVER_FILE という名前の環境変数を作成し、sqljdbc4.jar JDBC ドライバーを指すように指定します。このドライバーのロケーションは、ユーザーのインストール済み環境によって異なります。
- をクリックします。
- 「詳細設定」タブをクリックしてから、「環境変数」をクリックします。
- 「システム変数」リストで、「新規」をクリックします。
- 「変数名」に SQLSERVER_JDBC_DRIVER_FILE を入力し、「変数値」に C:¥Path_to_JDBC_dirver¥sqljdbc4.jar を入力します。
- UNIX システムでは、以下の環境変数宣言を追加します。
SQLSERVER_JDBC_DRIVER_FILE =.;Path_to_JDBC_dirver/sqljdbc4.jar
注: Rational solution for CLM 4.0 では、JRE 5.0 はサポートされなくなりました。サポートされる JRE は 6.0 と 7.0 です。
sqljdbc.jar クラス・ライブラリーには JRE 5.0 が必要であり、
sqljdbc4.jar クラス・ライブラリーには JRE 6.0 以降が必要です。
sqljdbc4.jar を使用する必要があります。
WebSphere Application Server を使用している場合は、さらに、sqljdbc4.jar JDBC ドライバーを指すカスタム・プロパティーを追加する必要があります。詳しくは、WebSphere Application Server のセットアップを参照してください。
- データベース接続を構成し、データベース表を作成するには、次のいずれかのステップを実行してください。
- Tomcat を使用する場合、サーバーを始動して、セットアップ・ウィザードの実行 (カスタム・セットアップ)を続行してください。
- WebSphere Application Server をデプロイする場合、WebSphere Application Server のデプロイおよび始動を参照してから、セットアップ・ウィザードの実行 (カスタム・セットアップ)を続行してください。
- データベース接続用の teamserver.properties ファイルを手動で変更し、repotools コマンドを実行してデータベース表を作成する方法を選択する場合は、SQL Server データベースを手動で構成するを参照してください。
- 以前のバージョンからアップグレードする場合は、適切なアップグレード・スクリプトの実行を続けてください。これにより、既存のデータベース接続がマイグレーションされます。データウェアハウスについては、アップグレード後にサーバーを構成する際に、データベースに接続するための情報を変更できます。
トラブルシューティング
repotools コマンドが正常に機能しない場合は、JazzInstallDir/server ディレクトリーにある適切なログ・ファイルを確認してください。
また、以下の条件が正しいことを確認してください。
- SQL Server が TCP/IP プロトコルを使用した接続を許可するように構成されている。必要な場合は、SQL サービスを再始動します。
- SQL Server コンピューターのホスト名およびポートが teamserver.properties ファイルに正しく反映されている。
- ログイン名、パスワード、およびデータベース名が teamserver.properties ファイルに正しく反映されている。
- ファイアウォールによって、SQL Server への
アクセスが阻止されない。 Telnet コマンドで、teamserver.properties ファイルのホスト名およびポートを使用してサーバーに接続してください。
- 作成されたユーザーが、
Jazz Team Server
データベース内での適切なアクセス権を持っている。
- JDBC ドライバーの環境変数が、使用している環境に合わせて適切に構成されている。
注: さまざまなデータベース・プラットフォームで使用できるように、
Jazz Team Server のデータベース・コードは汎用性があり、標準的なものになるように設計されています。ただし、構文、最適化の戦略、およびロッキングのセマンティックは、各エンタープライズ・データベースで異なります。サーバーは SQL Server 上で、自動化テスト、通常ワークロードのシミュレーション、およびストレス・テストの組み合わせを使用してテストされています。
通常ワークロードのシミュレーションでは、許容可能なパフォーマンスが示されました。
並行性の自動化テストでは、データベースのデッドロックが発生した場合もありましたが、別のサーバー・ハードウェアでこの現象が常に再現されたわけではありませんでした。
サーバーは、多数の同時要求を処理するように設計されています。例外的なケースとして、要求と関連付けられたトランザクションで類似または同等のオブジェクトが同時に更新されるときに、リポジトリー・データベースでデッドロックが発生する場合があります。
これらはまれなケースですが、標準的なイベントです。システムはデッドロックに対して防御するよう設計されており、データ保全性は維持されます。データの損失は発生しません。時々、ビルド・エンジン実行などのタスクによってデッドロックがログに記録されることがあります。
通常は、状態が検出され、タスクが再試行され
ます。 デッドロックによってビルドが失敗することがあります。非常にまれなケースとして、デッドロックを解決するために、ワークアイテムまたはソース・コードの処理などのユーザー・アクションが停止することがあります。
その場合、ユーザー・アクションは失敗に終わり、デッドロックに関する詳細を示すエラー・メッセージがユーザーに表示されます。
その後、ユーザーはアクションを再試行できます。
すべてのデッドロックは、サーバーでログに記録されます。ログには、デッドロックの発生時に起こったことについての情報が記載されています。
ログ・エントリーのテキストは、com.ibm.team.repository.common.RetryableDatabaseException:
Serialization failure のようになります。
システムがデッドロックを検出した場合は、エラー・ログを参照してください。これは https://servername:9443/jts/service/com.ibm.team.repository.common.internal.IFeedService?category=SystemLog から入手可能です。
頻繁にデッドロックが発生する場合は、製品サポートに連絡するか、または jazz.net のフォーラムにアクセスして、最新情報や更新情報、または問題の軽減手法を確認してください。