Rational® Engineering Lifecycle Manager を使用している場合は、この製品を TRS プロバイダーとしてセットアップし、ライフサイクル照会エンジンがそれらのデータにアクセスできるようにするための追加ステップが必要です。Rational Engineering Lifecycle Manager を使用していない場合は、このセクションのステップを実行する必要はありません。
すべてのアプリケーションをインストールして構成し、リモート・サーバーのアプリケーション間でフレンド関係を作成したら、ライフサイクル照会エンジンが索引の作成時にそれらのアプリケーションのデータにアクセスできるように、各アプリケーションを「追跡するリソース・セット」(TRS) プロバイダーとして設定する必要があります。
前提条件:- 構成するアプリケーションごとにサーバーを始動します
TRS コンシューマー内部ライセンスの割り当て
TRS コンシューマー内部
ライセンスを lqe_user 機能ユーザーおよび jts_user 機能ユーザーに割り当てます。
- JTS 管理コンソール (https://host_name:port/jts/admin) を開きます。
- 「ユーザー」>「アクティブ・ユーザー」を選択します。
- 「lqe_user」リンクをクリックします。「lqe_user」ページで
「クライアント・アクセス・ライセンス」エリアに移動し、「TRS コンシューマー内部」を
選択して「保存」をクリックします。
- 「アクティブ・ユーザー」ページに戻ります。「jts_user」リンクを
クリックします。「jts_user」ページで「クライアント・アクセス・ライセンス」エリアに
移動し、「TRS コンシューマー内部」を選択します。
- 「保存」をクリックします。
CLM アプリケーション用の TRS の構成
これらのアプリケーションが、同じ Jazz™ Team Server に LQE としてデプロイされている場合は、インバウンド・コンシューマーを作成する必要はありません。これらのステップは、CCM、QM、および RM の各アプリケーションが、別々の Jazz Team Server 上にある場合にのみ実行してください。
- CCM 用の LQE インバウンド・コンシューマー鍵を作成します。CCM 管理ページ (https://host_name:port/ccm/admin) を開きます。
- 「アプリケーション」ページで、「通信」 > 「コンシューマー (インバウンド)」を選択し、LQE 用の新規の OAuth コンシューマー鍵を作成します。
- 名前: LQE
- 秘密情報: xyz
- トラステッド: はい
「登録」をクリックします。
- 「許可された鍵」リストに移動し、鉛筆アイコンをクリックして「LQE」項目を
編集します。
- 「コンシューマー鍵のプロパティーの編集」ダイアログで
「ユーザーの選択...」リンクをクリックします。
- フィルター・フィールドに「lqe」と入力し、一致するユーザーのリストから「lqe_user」を
選択します。「追加して閉じる」をクリックしてから「終了」をクリックします。
- QM 用の LQE インバウンド・コンシューマー鍵を作成します。QM 管理ページ (https://host_name:port/qm/admin) を開き、ステップ 7 から 10 を再度実行します。
- DOORS® Next Generation が RM アプリケーションの場合は、これの LQE インバウンドコンシューマー鍵を作成します。RM 管理ページ (https://host_name:port/rm/admin) を開き、ステップ 7 から 10 を再度実行します。
- アプリケーションを TRS プロバイダーとして登録し、それらの索引を生成します。ライフサイクル照会エンジンの管理ページ (https://host_name:port/lqe/web) を開きます。
- 「管理」>「データ・ソース」>「データ・ソースの追加」をクリックします。
- 「データ・ソースの追加」ダイアログで「https://host_name:port/ccm/oslc/workitem/trs」を選択し、「RTC」というラベルを追加します。残りのデフォルトを受け入れ (索引付けするデータが大量にある場合は、
初期の索引付けのスレッド数を 4 に増やすことができます)、「終了」をクリックします。
- QM を TRS プロバイダーとして登録し、その索引を生成します。「データ・ソース」ページで「データ・ソースの追加」をクリックします。
- 「データ・ソースの追加」ダイアログで「https://host_name:port/qm/trs」を選択し、「RQM」というラベルを追加します。残りのデフォルトを受け入れて「終了」を
クリックします。
- RM を TRS プロバイダーとして登録し、その索引を生成します。「データ・ソース」ページで「データ・ソースの追加」をクリックします。
- 「データ・ソースの追加」ダイアログで「https://host_name:port/rm/trs」を選択し、「DNG」というラベルを追加します。残りのデフォルトを受け入れて「終了」を
クリックします。
Rational Team Concert™、Rational Quality Manager、および Rational DOORS Next Generation の各アプリケーションが索引付けされ、Rational Engineering Lifecycle Manager で使用できるようになりました。進行中の索引付けの設定について詳しくは、ライフサイクル照会エンジンの
資料 (ライフサイクル照会エンジンを使用したデータの索引付け (Indexing your data with the Lifecycle Query Engine)) を参照してください。
DOORS および DOORS Web Access を TRS プロバイダーとして構成する
Rational DOORS および Derby は、TRS
イネーブルメントのための、いくつかのデフォルト・ユーザーおよびパスワードと一緒に出荷されています。
下の手順で説明されているように、それらのユーザーに関連付けられている構成パラメーターを編集する必要があります。
統合では、以下のユーザーが使用されます。
- LQE 機能ユーザー:
このユーザーは、統合 TRS コンシューマー・アプリケーションから Rational DOORS Web Access への LQE 要求を処理します。
このユーザーは Rational DOORS データベースに存在していなければなりません。
このユーザー用のパラメーターを festival.xml ファイルに指定する必要があります。
- trs.db.user:
これは、TRS データベース・データへのアクセス権を持つ Derby データベース・ユーザーです。
データをデータベースから取り出すために、Rational DOORS Web Access によって使用されます。
このユーザー用のパスワードを festival.xml ファイルおよび Derby プロパティー・ファイルに指定する必要があります。
- derby.user.admin:
これは、Derby データベース管理者です。
このユーザーには現在、Rational DOORS Web
Access または Derby データベース用の機能が用意されていません。
このユーザー用のパスワードを Derby プロパティー・ファイルに設定することができます。
- [DWA_path]¥server¥festival¥config¥festival.xml を開きます。
- 「構成可能なシステム・プロパティー (Configurable system properties)」セクションを検索します。
- oauth.domain プロパティーの下に、以下の表にリストされているプロパティーを追加して、DOORS 管理 ID とパスワードを置き換え、コンシューマー鍵と秘密情報を選択します。
これらのプロパティーのフォーマットは、次のようにしてください。
<f:property name="functional.user.consumer.key" value="consumer_key" />
表 1. TRS および LQE 用の festival.xml ファイルのプロパティープロパティー |
説明/値 |
ForceHttpsForAuthenticationForOAuth |
この値は true に設定してください。 |
oauth.domain |
この値は https://server:port/dwa
(server はサーバー・ドメイン・ネームまたは IP アドレス) に設定してください。 |
functional.user.consumer.key |
LQE 機能ユーザーに関連付けられているコンシューマー鍵。
DOORS Tracked Resource Set (TRS) にアクセスするために、ライフサイクル照会エンジンによって使用されます。
このキーは、Rational DOORS
構成の「ローカル・キー」タブにあります。
デフォルト値は LQE Functional User Key です。 |
functional.user.consumer.secret |
LQE 機能ユーザーに関連付けられているコンシューマー・シークレット。
DOORS Tracked Resource Set (TRS) にアクセスするために、ライフサイクル照会エンジンによって使用されます。
このシークレットは、Rational DOORS
構成の「ローカル・キー」タブにあります。
デフォルト値は qwert6 です。 |
functional.user.name |
LQE 機能ユーザーのユーザー名。
このユーザー名は、有効な Rational DOORS ユーザーでなければなりません。
デフォルト値は LQE Functional User です。 |
functional.user.password |
LQE 機能ユーザーのパスワード。
デフォルト値は qwert6 です。 |
trs.db.user |
TRS イネーブルメントのユーザー名。
簡略化のため、デフォルト・ユーザー名 trs.db.user を使用してください。 |
trs.db.password |
trs.db.user のパスワード。
このパスワードも Derby プロパティー・ファイルに指定しなければなりません。 |
trs.page.size |
1 ページに入れる TRS リソースの数。
デフォルト値は 250 です。 |
trs.enable |
この値は true に設定してください。 |
- derby.properties ファイルをエディターで開きます。
このファイルは、dwa_install/derby ディレクトリーにあります。
- 下の表にあるパラメーターについて、パスワード値を置き換えてください。
表 2. TRS 用の Derby プロパティー・ファイルのパラメーターパラメーター |
説明 |
derby.user.trs |
festival.xml ファイルに指定した trs.db.user のパスワード。
デフォルト値は dwaTrsPa11word です。 |
derby.user.admin |
Derby データベース管理者のパスワード。
このユーザーには現在、Rational DOORS Web
Access または Derby データベース用の機能が用意されていません。
デフォルト値は dwaTrsPa11word です。 |
- バッチ・ファイル dwa_install/derby.start.bat を実行します。
- バッチ・ファイル dwa_install/derby/scripts/init_trs.bat を実行します。
- Data Change Notifications (DCN) パラメーターを有効にして、Rational DOORS Web Access ブローカーおよび Rational DOORS Web Access サーバーと通信するように
Rational DOORS データベース・サーバーを構成します。詳しくは、次のトピックを参照してください: http://publib.boulder.ibm.com/infocenter/doorshlp/v9/index.jsp?topic=/com.ibm.rational.dwa.install.doc/topics/c_setupddbs.html。
- 次の順に DOORS Web Access サーバーを再始動します。
- ブローカー
- 相互協調処理
- データベース・サーバー
- Web アプリケーション・サーバー
- 以下の資格情報を使用して、Rational DOORS にログオンします。
- ユーザー名: LQE Functional User または festival.xml ファイルに指定した機能ユーザー名。
- パスワード: qwert6 または festival.xml ファイルに指定した機能ユーザー・パスワード。
- 「ファイル」メニューから「OSLC...ローカル・キー」を選択し、「追加」をクリックします。
「登録」をクリックしてから「OK」をクリックします。
- 「ファイル」メニューから「OSLC...作業セット」を選択します。
- 「プロジェクトの選択」ペインで「要求」フォルダーを見つけ、「モジュールの選択」ペインで、このフォルダーに含まれているすべてのモジュールを選択します。「適用」をクリックします。
DOORS Web Access をデータ・ソースとして使用するように LQE を構成する
- https://hostname:port/lqe/web にナビゲートします。
- ツールバー・メニューの「管理」を選択します。
- 「データ・ソース」ページで「データ・ソースの追加」を選択します。
- 「データ・ソースの追加」ダイアログで、ルート・サービス文書 URL オプションを選択し、
DOORS ルート・サービス URL を入力し、TRS URL を選択し、ラベルを入力して、「認証詳細の指定」を選択します。
- ルート・サービス URL: https://doorsserver:port/dwa/public/rootservices
- https://doorsserver:port/dwa/rm/trs を選択します
- ラベル: DOORS
- コンシューマー鍵と秘密情報を入力します。
注: このコンシューマー鍵と秘密情報は、DOORS Web Access
Festival.XML ファイル内の値と一致している必要があります。
<f:property name="functional.user.consumer.key" value="xyz"/>
<f:property name="functional.user.consumer.secret" value="xyz"/>
- 初回索引付けおよび増分索引付けのスレッドの数を 1 に設定し、「終了」をクリックします。索引付けに複数のスレッドを使用すると、エラーが発生することがあります。
Rhapsody Design Manager アプリケーション用の TRS の構成
- https://hostname:port/jts/admin にナビゲートします。
注: Design Manager のインバウンド・コンシューマーは、Design Manager コンソールではなく、Jazz Team Server 管理コンソールに定義されています。
- 「サーバー」>「コンシューマー (インバウンド)」を選択し、以下を入力して「登録」をクリックします。
- 名前: LQE
- 秘密情報: xyz
- トラステッド: はい
- 「許可された鍵」リストに移動し、鉛筆アイコンをクリックして「LQE」項目を
編集します。
- 「コンシューマー鍵のプロパティーの編集」ダイアログで
「ユーザーの選択...」リンクをクリックします。
- フィルター・フィールドに「lqe」と入力し、一致するユーザーのリストから「lqe_user」を
選択します。「追加して閉じる」をクリックしてから「終了」をクリックします。
- https://hostname:port/dm/web にナビゲートします。
- 管理ユーザーとしてログインします。
- プロジェクト・エリアを選択し、「管理」ドロップダウン・メニュー (ギヤ・アイコン) から
「プロジェクト・プロパティーの管理」を選択します。「デフォルトの OSLC コンテキスト」を選択して
「選択」をクリックし、プロジェクト名をクリックしてから「OK」を押し、
最後に「保存」を押します。
- Rhapsody® DM を TRS プロバイダーとして登録し、その索引を生成します。ライフサイクル照会エンジンの管理ページ (https://lqe_host_name:port/lqe/web) を開きます。
- 「管理」>「データ・ソース」>「データ・ソースの追加」をクリックします。
- 「データ・ソースの追加」ダイアログで、http://rdm_host_name:9443/dm/trs を選択し、ラベル「RDM」を追加します。残りのデフォルトを受け入れ (索引付けするデータが大量にある場合は、
初期の索引付けのスレッド数を 4 に増やすことができます)、「終了」をクリックします。
Rational Engineering Lifecycle
Manager アプリケーション用の TRS の構成
インストールが新規である場合は、索引付けするデータはありません。
サンプルのプロジェクトおよび製品を作成して、索引付けが正常に作成されることを確認することができます。
- ライフサイクル照会エンジンの管理ページ (https://lqe_host_name:port/lqe/web) を開きます。
- 「管理」>「データ・ソース」>「データ・ソースの追加」をクリックします。
- 「データ・ソースの追加」ダイアログで「http://relm_host_name:port/productdef/resource/tracked_resource_set」を選択し、「RELM」というラベルを追加します。残りのデフォルトを受け入れ (索引付けするデータが大量にある場合は、
初期の索引付けのスレッド数を 4 に増やすことができます)、「終了」をクリックします。
- 索引をテストするには、Rational Engineering Lifecycle Manager (https://relm_host_name:port/relm/web) を開きます。
- サンプル・プロジェクトを選択します。「照会」メニューから「共有照会」を選択します。
- 「サンプル」ノードを展開し、「すべての成果物」を選択します。照会を実行するすべてのアプリケーションに
対する許可を求められる場合があります。
照会する各アプリケーションの横にある「許可」をクリックします。
- 照会結果に、作成したサンプル製品が表示されます。
Jazz Team Server ユーザー用の TRS の構成
- ライフサイクル照会エンジンの管理ページ (https://lqe_host_name:port/lqe/web) を開きます。
- 「管理」>「データ・ソース」>「データ・ソースの追加」をクリックします。
- 「データ・ソースの追加」ダイアログで「http://host_name:port/jts/trsUsers」を選択し、「ユーザー」というラベルを追加します。残りのデフォルトを受け入れて「終了」を
クリックします。