リモート・サーバー上の SDO を使用する Web プロジェクトのテストまたはデプロイ

Rational® Software 開発プラットフォーム内から、または WebSphere® 管理コンソールから、リモート WebSphere Application Server V6 へのデータ・アクセスのための Service Data Objects (SDO) を使用する Web プロジェクトをテストまたはデプロイできます。リモート WebSphere Application Server V5.1.0.3 (またはそれ以上) へのデータ・アクセスのために WebSphere Data Objects (WDO) を使用する Web プロジェクトの場合は、管理コンソールまたは Rational Software 開発プラットフォームを使用することもできます。ただし、Rational プラットフォーム内からテストまたはデプロイしたい場合は、開始する前に、WebSphere サーバーに IBM® Agent Controller を別個にインストールしておく必要があります。 Agent Controller に関する更新済み情報については、Agent Controller のインストール・ディスク上の「最初にお読みください (Read Me)」文書を参照してください。

重要: WDO を使用する Web アプリケーションをリモート側でテストまたはデプロイする前に、以下の手順のいずれか 1 つのみを実行することが重要です。そうしないと、サーバー上の WebSphere 管理コンソールの設定に支障をきたすことになります。

Rational Software 開発プラットフォームの使用

  1. Web プロジェクト内から、サーバー上のデータベースおよび JDBC ドライバーのロケーション情報を設定する。
    注: Cloudscape™ データベースを使用している場合は、 クラス・ロケーションデータベース・ロケーションを更新して、 ご使用のサーバー・マシン上のパスを反映させる必要があります。使用のサーバーでは変数設定を使用することができます。たとえば、パス ${CLOUDSCAPE_JDBC_DRIVER_PATH}¥db2j.jar は、WebSphere Application Server とともに組み込まれている Cloudscape ドライバーを指します。パス ${APP_INSTALL_ROOT}¥localhost¥DefaultEAR.ear¥myproject.war¥CloudscapeData¥database は、 ご使用のデータベースを指します。ここで、ご使用の EAR プロジェクトではデフォルト名の DefaultEAR が保持されており、ご使用の Web プロジェクトには myproject という名前が付けられています。 Cloudscape 以外のデータベースの場合は、クラス・ロケーションを更新する必要があります。
    1. プロジェクト・エクスプローラーで、SDO を含むプロジェクト内の任意の JSP ファイルを開く。
      注: JSP ファイルに SDO が含まれていることがわからない場合に、それを識別する唯一の方法は、Page Designer のファイルを開いてデータ・オブジェクトが含まれているかどうかを確認することです。ページ・データ・ビューを使用して、データ・オブジェクトが SDO かどうかを判別します。データ・オブジェクトが SDO の場合は、<data_object_name> (Service Data Object) として識別されます。
    2. 「ページ・データ」ビューで SDO をダブルクリックする。「関連レコード・リストの構成 (Configure Relational Record List)」ダイアログが開きます。
    3. 「接続 (Connections)」タブから、「ランタイム接続の詳細」の隣の「編集」をクリックして、既存のデータベース接続を変更する。 まだデータベース接続を構成していない場合は、『ウィザードを使用したデータベースへの接続』を参照してください。
    4. JDBC ドライバー jar ファイルのサーバー・サイドのロケーションとともに、「クラス・ロケーション」フィールドにパスを入力する。
    5. ウィザードのその他のすべてのステップを完了してから、「終了」をクリックする。
    6. 「開発接続」ウィザードで「終了」をクリックしてから、「関連レコード・リストの構成 (Configure Relational Record List)」ページで「閉じる」をクリックする。
  2. プロジェクト・エクスプローラーで、Web プロジェクトを右クリックし、「実行」 > 「サーバーで実行」を選択して、テスト用のリモート・サーバーにアプリケーションをデプロイする。

管理コンソールの使用

  1. Rational Software 開発プラットフォームから、「ファイル」 > 「エクスポート」 > 「EAR ファイル」をクリックして、ご使用のアプリケーションを EAR ファイルにエクスポートする。
  2. まだ始動していない場合は、WebSphere Application Server を始動する。
  3. ブラウザーの中で、ご使用のサーバーの管理コンソールにナビゲートしてログインする。 デフォルトでは、WebSphere V5.1.0.3 (またはそれ以上) サーバーのコンソールにアクセスする URL は http://servername.domain:9090/admin/ です。また WebSphere V6 サーバーにアクセスするデフォルト URL は http://servername.domain:9060/ibm/console です。
  4. JDBC データ・ソースを作成する。手順について詳しくは、WebSphere V5.1 および V6 のインフォメーション・センターの『管理コンソールを使用した JDBC プロバイダーの作成と構成』のトピックを参照してください。
    注: JNDI 名は、ワークベンチで作成したときにデータ・ソースに付けられた名前と一致する必要があります。このデータ・ソース名は web.xml ファイル内で見付けることができ、このファイルはご使用のプロジェクトの WebContent/WEB-INF フォルダーにあります。res-ref-name 名エレメントは、リソース・マネージャーの接続ファクトリー参照の名前を指定します。例えば、次のとおりです。
    <resource-ref id="ResourceRef_100">
           <res-ref-name>DB2_Connection_2</res-ref-name>
           <res-type>javax.sql.DataSource</res-type>
           <res-auth>Container</res-auth>
           <res-sharing-scope>Shareable</res-sharing-scope>
    </resource-ref>
  5. アプリケーションをインストールする。手順について詳しくは、WebSphere V5.1 および V6 のインフォメーション・センターの『コンソールを使用したアプリケーション・ファイルのインストール』のトピックを参照してください。
    注: 「リソース参照をリソースにマップする」ステップで、リソースの JNDI 名を指定してください。
  6. WebSphere V5.1.0.3 (またはそれ以上) サーバー上にデプロイしている場合は、共用ライブラリーを作成し、EAR プロパティーを更新する。WebSphere V6.0 サーバー上にデプロイしている場合は、このステップをスキップしてください
    注: 共用ライブラリー情報を手動でクラスパスに追加しないでください。
    1. 「環境」 > 「共用ライブラリー」を選択する。
    2. 「新規」をクリックする。
    3. 以下のものを入力する。
      Name = WDO Relational Mediator Shared Library
      Classpath = ${WAS_INSTALL_ROOT}/optionalLibraries/WDO/wdo-interface.jar
      ${WAS_INSTALL_ROOT}/optionalLibraries/WDO/emf-runtime.jar
      ${WAS_INSTALL_ROOT}/optionalLibraries/WDO/emf-event.jar
      ${WAS_INSTALL_ROOT}/optionalLibraries/WDO/jdbcmediator.jar
      ${WAS_INSTALL_ROOT}/optionalLibraries/WDO/wdo.jar
      ${WAS_INSTALL_ROOT}/optionalLibraries/WDO/wdo.xmlmediator.jar
    4. 「OK」をクリックして、この変更をコミットする。
    5. 「アプリケーション」 > 「エンタープライズ・アプリケーション」を選択してから EAR ファイルを選択する。
    6. アプリケーション・クラス・ローダー・モードを PARENT_LAST に切り替える。
    7. 該当ページ下部の「追加プロパティー」セクションから「ライブラリー」を選択する。
    8. 「追加」をクリックする。
    9. 共用ライブラリーを選択する。
    10. 「OK」をクリックして、この変更をコミットする。
  7. 「保管」をクリックして変更を保管してから、アプリケーションを実行する。
フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.