1. Spatial開発者ガイド
  2. 空間Webサービス
  3. SpatialのWebサービスの概要
  4. 空間Webサービスのデプロイと構成

11.3 空間Webサービスのデプロイと構成

このトピックでは、Oracle Spatial Webサービス、特にWFS、WCS、CSWおよびGeoRaster REST APIのデプロイと構成に適用される処理について説明します。

これらのサービスはJava Webアプリケーションとして実装され、WebLogic 12.1.3以上にデプロイして実行できます。必要なJavaのバージョンはJDK 8以上です。

ノート:

Oracle Databaseリリース23aiでは、データベースのOJVMがJDK11をサポートしているため、Oracle Spatial Java APIはJDK 11を使用してコンパイルされます。ただし、APIは下位互換性のために引き続きJDK8でサポートされます。APIを使用する場合は、関連するすべてのJARファイルが、使用されているJDKバージョン(JDK 8またはJDK 11)と一致していることを確認してください。様々なJDKバージョンでサポートされているJDBCドライバの詳細は、Oracle JDBCドライバのRDBMSおよびJDKバージョンの互換性を参照してください。
  • WFS、WCSおよびCSWは、sdows.earファイルにパッケージされています。
  • GeoRaster REST APIは、sdows.earファイルにパッケージされています。
  • ジオコーダ・サービスは、geocoder.ear.zipファイルにパッケージされています。
  • ルーティング・エンジンは、routeserver.ear.zipファイルにパッケージされています。

ジオコーダおよびルーティングのファイルは、Oracleインストールの$ORACLE_HOME/md/jlibディレクトリにあります。このトピック内の一般的な手順に加えて、使用する各空間Webサービスに関する個別の章を参照し、その他のデプロイおよび構成のタスクを確認してください。

WFS、WCS、CSWおよびGeoRaster REST API (sdows.ear)は、次の方法でインストールできます。

  • Oracle Cloud MarketplaceからOracle Spatial Webサービス・アプリケーションをインストールできます。これにより、Apache Tomcat Webサーバー・インスタンスにsdows.earがインストールされ、Oracle Cloudアカウントの新しいOracle Cloud Infrastructure ComputeにGDALが構成されます。インストールが完了したら、空間Webサービスの構成を続行できます。詳細は、「各空間Webサービスの構成」を参照してください。
  • LinuxまたはWindowsマシン上のWebLogic Serverで、sdows.earパッケージをデプロイできます。このパッケージは、次の2つのいずれかの場所で入手できます。
    • Oracleホーム・インストール内のディレクトリ: 
      $ORACLE_HOME/md/jlib.
    • My Oracle Supportで、Doc ID 3019446.1を使用します。

    デプロイメント・パッケージを取得したら、「WebLogic Serverの準備」に進むことができます。

親トピック: 空間Webサービスの概要

11.3.1 WebLogic Serverの準備

空間Webサービスは、JDK 8またはJDK 11をサポートする任意のOracle WebLogic Serverバージョンにデプロイできます。

ただし、Oracle WebLogic Serverバージョン14.1.1.0.0を使用することをお薦めします。

WebLogic環境を準備するには、次のステップを実行します。

  1. Oracle WebLogic Serverバージョン14.1.1.0.0をインストールします。
    インストール手順は、Oracle WebLogic Serverのインストールを参照してください。
  2. WebLogicドメインを作成および構成します。管理サーバーとノード・マネージャを作成することをお薦めします。
    詳細は、WebLogicドメインの作成と構成を参照してください。
  3. ノード・マネージャを起動し、さらにWebLogic Serverを起動します。
  4. Oracle WebLogic Server管理コンソールで次のステップを実行します。
    1. マシンを作成および構成します。
    2. 管理対象サーバーを作成します。
    3. 管理対象サーバーの構成に関する「一般」タブで「マシン」名を構成します。
    4. 管理対象サーバーを起動します。

親トピック: 空間Webサービスのデプロイと構成

11.3.2 WebLogic Serverへの空間Webサービスのデプロイ

この項では、sdows.earファイルに含まれるサービス(WFS、WCS、CSW、GeoRaster REST APIなど)をデプロイする方法について説明します。

その他のWebサービスについては、それぞれの章の手順に従ってください。

また、WCSまたはGeoRaster REST APIを構成する場合は、sdows.earファイルのデプロイ前にGDALを設定する必要があることに注意してください。WFSまたはCSWにのみ関心がある場合は、「GDALの設定」の項をスキップできます。

WebLogic Serverにsdows.earファイルをデプロイするには、次のステップを実行します。

  1. 構成ファイルおよびログ・ファイルを格納するフォルダを作成します。
  2. 前のステップで作成したフォルダを指す環境変数SDOWS_HOMEを作成します。
  3. <WLS_HOME>/wlserver/common/deployable-libraries/jax-rs-2.0.warをライブラリとしてOracle WebLogic Serverにデプロイします。詳細は、エンタープライズ・アプリケーションのインストールを参照してください。
  4. オプションで、WCSまたはGeoRaster REST APIをデプロイする場合にのみ、GDALを設定します(「GDALの設定」を参照)。
  5. WebLogicデータ・ソースを追加します(「WebLogicデータ・ソースの追加」を参照)。
  6. オプションで、GeoRaster REST APIをデプロイする場合は、必要な環境変数とOracle Walletを設定します。
  7. sdows.earをアプリケーションとしてデプロイします(エンタープライズ・アプリケーションのインストールを参照)。

空間Webサービスに必要なステップを完了したら、「デプロイ」ページでアプリケーションがActive状態であることを確認します。Prepared状態の場合、「起動」をクリックしてアプリケーションを起動します。手順は、デプロイされたエンタープライズ・アプリケーションの起動と停止を参照してください。

親トピック: 空間Webサービスのデプロイと構成

11.3.2.1 GDALの設定

この項では、GDAL (GeoSpatial Data Abstraction Library)の設定方法について説明します。

GDALは、MOSノート2997919.1にリストされているパッチIDを使用して、My Oracle Supportからダウンロードできます。

Linux 64オペレーティング・システム用とWindows 64オペレーティング・システム用の2つのGDAL zipファイルがあります。

GDAL zipファイル内のREADME.txtファイルには、GDALを設定する手順が含まれています。

GDALが設定されている端末からサーバーを起動するか、WebLogicドメインのbinフォルダにあるWebLogic ServerのsetDomainEnvスクリプトからgdal_setupスクリプトを起動して、実行中のOracle WebLogic ServerでGDALが使用可能であることを確認します。

親トピック: WebLogic Serverへの空間Webサービスのデプロイ

11.3.2.2 WebLogicデータ・ソースの追加

JDBCデータ・ソースをWebLogicドメインに追加して、WebLogic Serverでデータベース接続を構成できます。

JDBC汎用データ・ソースの作成の手順に従って、汎用データ・ソースを作成できます。

ただし、データ・ソースの構成時に値を選択する際には、次の点を考慮する必要があります。

  1. JDBCデータ・ソース名には、文字A-Z、a-z、0-9のみを含める必要があります。この値は、サービスURLの一部になります。
  2. JNDI名の形式はJDBC/<name>である必要があります。<name>はJDBCデータ・ソース名と同じです。

親トピック: WebLogic Serverへの空間Webサービスのデプロイ

11.3.2.3 GeoRaster REST APIの設定

GeoRaster REST APIの設定について学習します。

WebLogic ServerでGeoRaster REST APIを設定するには、次のステップを実行します。

  1. Oracle Walletを構成し、WebLogicデータ・ソース接続を追加します。
    1. mkstoreツールを使用して、Oracle Walletを新規作成します。
      手順については、外部パスワード・ストアの作成方法を参照してください。
    2. TNS別名を使用して資格証明および接続文字列をOracle Walletに格納します。
      Oracle WalletにTNS別名を追加する手順は、DB接続文字列のかわりにTNS別名を使用を参照してください。

      必要な数のデータベース接続をOracle Walletに追加します。

    3. Oracle WalletおよびJNDI名でjdbc/<alias>の形式で定義されている別名をJDBCデータ・ソース名として使用して、WebLogicデータ・ソースを追加します。ここで、<alias>はOracle Walletで定義された別名です。
      Oracle Walletを使用してWebLogicデータ・ソースを定義する手順は、ウォレットを使用するWebLogic Serverデータ・ソースの定義を参照してください。
    4. Oracle Walletファイルを含むzipファイルを作成し、圧縮されたOracle Walletファイルを指す環境変数GEOR_WALLET_FILEを追加します。
      GEOR_WALLET_FILEが以前に設定されている端末からサーバーを起動するか、WebLogicドメインのbinフォルダにあるWebLogic ServerのsetDomainEnvスクリプトに環境変数定義を追加して、WebLogic ServerでGEOR_WALLET_FILE環境変数が使用可能であることを確認します。
  2. オプションで、ラスターのインポート/エクスポート用一時格納場所のフォルダを設定します。

    このオプションのステップは、REST APIを使用してラスター・ファイルをインポートおよびエクスポートする場合にのみ必要です。

    1. GEOR_IMPORT_EXPORT_FOLDERという環境変数を追加します。この値は、インポートおよびエクスポート機能の一時格納場所として使用されるフォルダを指します。
    2. GEOR_IMPORT_EXPORT_FOLDERが以前に設定されている端末からサーバーを起動するか、WebLogicドメインのbinフォルダにあるWebLogic ServerのsetDomainEnvスクリプトに環境変数定義を追加して、WebLogic ServerでGEOR_IMPORT_EXPORT_FOLDER環境変数が使用可能であることを確認します。

親トピック: WebLogic Serverへの空間Webサービスのデプロイ

11.3.3 各空間Webサービスの構成

使用する各空間Webサービスは個別に構成する必要があります。

ご使用の環境でサポートするWebサービスに応じて、特定のタスクを実行する必要があります。権限を作成し、データベース・ユーザーに付与する必要がある場合があります。WebLogic Serverで、特別なデータ(ジオコーディング用など)のダウンロードおよびロード、構成ファイルの変更、またはデータ・ソースの作成が必要な場合もあります。

親トピック: 空間Webサービスのデプロイと構成

11.3.3.1 空間Webサービスの管理コンソール

Oracle Spatialは、WFS、WCSおよびCSW Webサービス・エンジンを構成するのに役立つWebアプリケーションを提供します。

次の図は、Oracle Spatial Webサービス管理コンソールのユーザー・インタフェースを示しています。

図11-1 空間Webサービスの管理コンソール

図11-1の説明が続く
「図11-1 空間Webサービスの管理コンソール」の説明

管理コンソールのユーザー・インタフェースは次のページで構成されています。

  • フィーチャのパブリッシュ: 各サービスについて含まれるデータを追加および削除します。
  • テスト: 各サービスのリクエストおよびレスポンスをテストします。
  • ログ: 診断用のログ・ファイルのコンテンツを表示およびダウンロードします。
  • サービス構成: 各サービスを構成します。

ブラウザで管理コンソールを起動するには、次のURLを使用します。

http://<system-name>:<port>/oraclespatial/

前の図に示すように、アプリケーションにログインするには、認証用に「ユーザー名」および「パスワード」資格証明を指定するか、ゲストとしてサービスをテスト・リンクをクリックしてテスト・ページを開くことができます。テスト・ページでは、使用可能なすべてのサービス操作リクエストを表示して、OGCリクエストを作成できます。テスト・ページを除く他のすべてのページで認証が必要であることに注意してください。

ページの右上にあるユーザー・メニューを使用して、「ログイン」または「ログアウト」を実行できます。すべてのユーザーは、管理コンソールがデプロイされているOracle WebLogic Serverで構成されます。

「サービス」メニューservices_menuは、ページの左上にあります。

「サービス」メニュー・オプションは次のとおりです。

  • Web Feature Service
  • Web Coverage Service
  • Catalog Service for the Web

いずれかのサービス・オプションをクリックすると、選択したサービスで使用可能なすべてのタブがメイン・ページに表示されます。

選択したサービスのページの右上にある「データソース」ドロップダウンから、構成済データ・ソースを選択します。選択したデータ・ソースはいつでも変更できます。WebLogic Serverで複数のデータ・ソースを構成して、異なるスキーマまたはデータベースのデータにアクセスできます。

「サービス構成」タブでは、GetCapabilitiesレスポンスに示されるロギング・レベルなどのサービス・パラメータやサービス・プロバイダ情報を変更できます。

「テスト」タブでは、様々な操作に対して単純なリクエストを作成できます。パラメータを編集、追加または変更し、HTTP POST/XMLリクエストとして送信できます。レスポンスも表示されます。

「ログ」タブには、問題を診断するためのログ・ファイルの内容が表示されます。zipファイルに圧縮されたログをダウンロードし、後で問題の診断に使用できます。

関連項目:

親トピック: 各空間Webサービスの構成