WebSphere Application Server での Rational ClearQuest アダプターのタスク

IBM® Rational® ClearQuest® 共有ライブラリーを、 IBM Rational Publishing Engine データ・サービス・アプリケーション で使用可能にして、Rational ClearQuest API を Rational Publishing Engine から使用できるようにすることができます。

始める前に

手順

  1. Rational ClearQuest インストール済み環境で共有ライブラリーを指すパスを、 Rational Publishing Engine データ・サービス・アプリケーション がデプロイされている WebSphere Application Server ノードに 追加します。
    1. WebSphere Application Server で、「環境」 > 「共有ライブラリー」をクリックします。
    2. 有効範囲の設定値を指定するには、Node=RationalPublishingEngineNode01, Server=RationalPublishingEngineServer 項目を選択します。 RationalPublishingEngineNode01 はノードのデフォルト名、RationalPublishingEngineServer はサーバーのデフォルト名です。
    3. 共有ライブラリー参照を作成するには、「新規」をクリックします。
    4. 「名前」「説明」、および「クラスパス」に値を設定します。正しいロケーションにあるファイルをクラスパスが指すように注意してください。
      表 1. 共有ライブラリー参照フィールド
      説明
      名前 ClearQuest CM API
      説明 ClearQuest アダプターの共有ライブラリー。
      クラスパス

      application_files\IBM\RationalSDLC\ClearQuest\cqjni.jar
      application_files\IBM\RationalSDLC\ClearQuest\stpcq.jar
      application_files\IBM\RationalSDLC\Common\stpcmmn.jar
      application_files\IBM\RationalSDLC\Common\stpwvcm.jar

      注: リストされているデフォルト値は、Rational ClearQuest 7.1 の場合の値です。 実際に使用するパスは、Rational ClearQuest がインストールされている場所およびバージョンによって異なります。正しいロケーションにあるファイルを参照していることを確認してください。ご使用の Rational ClearQuest インストール済み環境のロケーションを表示するには、「スタート」 > 「すべてのプログラム」 > 「IBM Installation Manager」 > 「インストール済みパッケージの表示 (View Installed Packages)」をクリックして、IBM Installation Manager にチェックインします。
    5. 「OK」をクリックし、「保存」をクリックします。
  2. Rational ClearQuest 共有ライブラリーを データ・サービス・アプリケーション プロファイルと関連付けるには、以下のようにします。
    1. 「サーバー」 > 「アプリケーション・サーバー」をクリックします。
    2. データ・サービス・アプリケーション をデプロイしたサーバーをクリックします。 デフォルトのサーバー名は RationalPublishingEngineServer です。
    3. 「サーバー・インフラストラクチャー」 > 「Java およびプロセス管理」 > 「クラス・ローダー」をクリックします。
    4. 共有ライブラリーのクラス・ローダーを作成するには、「新規」 > 「OK」をクリックします。
    5. 共有ライブラリー参照をクラス・ローダーと関連付けるため、2.dのサブステップで作成された新規クラス・ローダーのハイパーリンクをクリックします。
    6. 関連付けるライブラリーごとに、「追加」をクリックし、ライブラリーを選択して「OK」をクリックします。
    7. 「共有ライブラリー参照」をクリックします。
    8. 各ライブラリーを関連付けるには、「追加」をクリックし、ライブラリーを選択して「OK」をクリックします。
    9. 「保存」をクリックします。
  3. Linux アイコン Linux を使用している場合は、汎用 JVM 引数を構成します。
    1. 「サーバー」 > 「サーバー・タイプ」 > 「WebSphere Application Servers」をクリックします。
    2. サーバー名をクリックします。
    3. 「サーバー・インフラストラクチャー」セクションで、「Java およびプロセス管理」を展開して、「プロセス定義」をクリックします。
    4. 「Java 仮想マシン」をクリックします。
    5. 「汎用 JVM 引数」フィールドに、Generic JVM arguments -Djava.library.path=/opt/ibm/RationalSDLC/clearquest/linux_x86/shlib と入力します。
    6. 「OK」をクリックします。
  4. Linux アイコン Linux を使用している場合は、LD_LIBRARY_PATH 環境変数を構成します。
    1. 「プロセス定義」ページで、「環境 エントリー」をクリックして、「LD_LIBRARY_PATH」をクリックします。
    2. 名前とライブラリー・パスを入力します。 例: /opt/ibm/RationalSDLC/clearquest/linux_x86/odbc/lib:/usr/local/ibm/gsk7/lib
  5. データ・サービス・アプリケーション を再始動します。
  6. IBM Rational ClearQuest アダプターおよびライブラリーが正しく構成されていることを確認します。 Rational ClearQuest アダプターの URL をブラウザーに 入力します。
    • http://host:port/DataServices/ClearQuest と入力します。 正常にインストールされている場合は、Rational ClearQuest 接続のリストが、 Rational ClearQuest メンテナンス・ツールで表示されているように 表示されます。
    • http://host:port/DataServices/ClearQuest/version と入力します。 正常にインストールされている場合は、Rational ClearQuest ユーザー・データベースの リストが表示されます。
    • http://host:port/DataServices/ClearQuest/version/database_name と入力します。 正常にインストールされている場合は、照会のリストが表示されます。

次のタスク

テンプレートまたは文書仕様に追加する照会 URL を コピーします。
注: データ・サービス・アプリケーション は、静的結果セットを持つ照会のみを サポートします。動的照会はサポートされていません。

All Defects 照会の URL では、 照会が Rational ClearQuest クライアントに返すヒット数を含んだ結果セットが 表示されます。 それぞれの結果は、特定のレコード・タイプに対する固有の DBID です。このプロセスは、特定のレコードのデータに対する リターンがあるまで続行できます。Rational Publishing Engine レポート・オーサリングで使用する照会 URL を 保持します。

疑問符 (?) 以降の引数を 削除します。

削除前: http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects?Type=Query
削除後: http://localhost:9081/DataServices/ClearQuest/7.0.0/SAMPL/Public+Queries/All+Defects


フィードバック