WebSphere Application Server Community Edition での REST データ・サービスの開始

このトピックでは、WebSphere® Application Server Community Edition を使用して eXtreme Scale REST データ・サービスを構成および開始する方法について説明します。

始める前に

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

手順

  1. WebSphere Application Server Community Edition バージョン 2.1.1.3 以降をダウンロードして、 wasce_root (/opt/IBM/wasce など) にインストールします。
  2. 以下のコマンドを実行して、WebSphere Application Server Community Edition サーバーを始動します。
    • [Linux][Unix] wasce_root/bin/startup.sh
    • [Windows] wasce_root/bin/startup.bat

  3. eXtreme Scale セキュリティーを使用可能にして eXtreme Scale グリッドを始動した場合には、 restservice_home/gettingstarted/restclient/bin/wxsRestService.properties ファイルで以下のプロパティーを設定します。
    ogClientPropertyFile=restservice_home/gettingstarted/security/security.ogclient.properties
    loginType=none
  4. 以下のように、eXtreme Scale REST データ・サービスおよび提供サンプルを WebSphere Application Server Community Edition サーバーにインストールします。
    1. 以下のように、ObjectGrid クライアント・ランタイム JAR を WebSphere Application Server Community Edition リポジトリーに追加します。
      1. WebSphere Application Server Community Edition 管理コンソールを開いてログインします。
        ヒント: デフォルト URL は http://localhost:8080/console です。 デフォルト・ユーザー ID は system で、パスワードは manager です。
      2. 「サービス」フォルダー内の「リポジトリー」をクリックします。
      3. リポジトリーへのアーカイブの追加」セクションで、入力テキスト・ボックスに以下を入力します。
        表 1. リポジトリーへのアーカイブ
        テキスト・ボックス
        ファイル wxs_home/lib/ogclient.jar
        グループ com.ibm.websphere.xs
        成果物 ogclient
        バージョン 7.0
        タイプ jar
      4. 「インストール」ボタンをクリックします。
        ヒント: 構成クラスおよびライブラリーの依存関係のさまざまな方法の詳細については、技術情報 Specifying external dependencies to applications running on WebSphere Application Server Community Edition を参照してください。
    2. REST データ・サービス・モジュール wxsrestservice.war ファイルを WebSphere Application Server Community Edition サーバーにデプロイします。
      1. 開始用 (getting started) サンプル・クラスパス・ディレクトリーへのパス依存関係を組み込むように、サンプルの restservice_home/gettingstarted/wasce/geronimo-web.xml デプロイメント XML ファイルを編集します。
        2 つの開始用 (getting started) クライアント GBean の classesDirs パスを変更します。
        • GettingStarted_Client_SharedLib GBean の「classesDirs」パスを restservice_home/gettingstarted/restclient/bin に設定する必要があります。
        • GettingStarted_Common_SharedLib GBean の「classesDirs」パスを restservice_home/gettingstarted/common/bin に設定する必要があります。

      2. WebSphere Application Server Community Edition 管理コンソールを開いてログインします。
        ヒント: デフォルト URL は http://localhost:8080/console です。 デフォルト・ユーザー ID は system で、パスワードは manager です。
      3. 新規デプロイ」をクリックします。
      4. 新規アプリケーションのインストール」ページで、テキスト・ボックスに以下の値を入力します。
        表 2. インストール値
        テキスト・ボックス
        アーカイブ restservice_home/lib/wxsrestservice.war
        プラン restservice_home/gettingstarted/wasce/geronimo-web.xml
      5. 「インストール」ボタンをクリックします。

        コンソール・ページに、アプリケーションが正常にインストールされて開始されたことが示されます。

      6. WebSphere Application Server Community Edition システム出力ログまたはコンソールで以下のメッセージが存在することを確認して、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. WebSphere Application Server Community Edition を停止するには、以下のコマンドを使用します。
    • [Unix][Linux] wasce_root/bin/shutdown.sh
    • [Windows] wasce_root¥bin¥shutdown.bat
    ヒント: デフォルト・ユーザー ID は system で、パスワードは manager です。カスタム・ポートを使用する場合は、-port オプションを使用します。