Apache Tomcat での REST データ・サービスの開始

このトピックでは、Apache Tomcat バージョン 5.5 以上を使用して、eXtreme Scale REST データ・サービスを構成および開始する方法について説明します。

始める前に

サンプル eXtreme Scale データ・グリッドが開始されていることを確認します。データ・グリッドの開始方法の詳細については、REST データ・サービスの使用可能化を参照してください。

手順

  1. tomcat_root に Apache Tomcat バージョン 5.5 以上をダウンロードしてインストールします。例: /opt/tomcat
  2. 以下のように、eXtreme Scale REST データ・サービスおよび提供サンプルを Tomcat サーバーにインストールします。
    1. Oracle JRE または JDK を使用している場合は、IBM® ORB を Tomcat にインストールする必要があります。
      • Tomcat バージョン 5.5 の場合

        すべての JAR ファイルを以下のようにコピーします。

        wxs_home/lib/endorsed

        to

        tomcat_root/common/endorsed

      • Tomcat バージョン 6.0 の場合
        1. 「endorsed」ディレクトリーを作成します。
          • [Unix][Linux] mkdir tomcat_root/endorsed
          • [Windows] md tomcat_root/endorsed
        2. すべての JAR ファイルを以下のようにコピーします。

          wxs_home/lib/endorsed

          to

          tomcat_root/endorsed

    2. REST データ・サービス・モジュール wxsrestservice.war を Tomcat サーバーにデプロイします。

      wxsrestservice.war ファイルを以下のようにコピーします。

      restservice_home/lib

      から

      tomcat_root/webapps

    3. ObjectGrid クライアント・ランタイム JAR およびアプリケーション JAR を Tomcat の共有クラスパスに追加します。
      1. tomcat_root/conf/catalina.properties ファイルを編集します。
      2. コンマ区切りリストの形式で、以下のパス名を shared.loader プロパティーの末尾に追加します。
        • wxs_home/lib/ogclient.jar
        • restservice_home/gettingstarted/restclient/bin
        • restservice_home/gettingstarted/common/bin
        重要: パス分離文字は、スラッシュにする必要があります。

  3. eXtreme Scale セキュリティーを使用可能にして eXtreme Scale データ・グリッドを始動した場合には、 restservice_home/gettingstarted/restclient/bin/wxsRestService.properties ファイルで以下のプロパティーを設定します。
    ogClientPropertyFile=restservice_home/gettingstarted/security/security.ogclient.properties
    loginType=none
  4. REST データ・サービスが含まれた Tomcat サーバーを始動します。
    • Tomcat 5.5 を UNIX または Windows で、あるいは Tomcat 6.0 を UNIX で使用する場合:
      1. cd tomcat_root/bin
      2. 以下のように、サーバーを始動します。
        • [Unix][Linux] ./catalina.sh run
        • [Windows] catalina.bat run
      3. コンソールに、Apache Tomcat のログが表示されます。 REST データ・サービスが正常に開始すると、管理コンソールに以下のメッセージが表示されます。

        CWOBJ4000I: WebSphere eXtreme Scale REST データ・サービスが開始されました。

    • Tomcat 6.0 を Windows で使用する場合:
      1. cd tomcat_root/bin
      2. tomcat6w.exe コマンドで、Apache Tomcat 6 構成ツールを開始します。
      3. Apache Tomcat 6 のプロパティー・ウィンドウの「Start」ボタンをクリックして、Tomcat サーバーを始動します。
      4. 以下のログを確認して、Tomcat サーバーが正常に始動していることを確認します。
        • tomcat_root/bin/catalina.log

          Tomcat サーバー・エンジンの状況を表示します。

        • tomcat_root/bin/stdout.log

          システム出力ログを表示します。

      5. REST データ・サービスが正常に開始されていると、以下のメッセージがシステム出力ログに表示されます。 CWOBJ4000I: WebSphere eXtreme Scale REST データ・サービスが開始されました。
  5. 以下のように、REST データ・サービスが動作していることを確認します。
    1. ブラウザーを開いて、以下にナビゲートします。

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid

      NorthwindGrid のサービス文書が表示されます。

    2. 以下にナビゲートします。

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/$metadata

      Entity Model Data Extensions (EDMX) 文書が表示されます。

  6. データ・グリッド・プロセスを停止するには、それぞれのコマンド・ウィンドウで CTRL+C を使用します。
  7. Tomcat を停止するには、Tomcat を開始したウィンドウで CTRL+C を使用します。