| Oracle® Fusion Middleware Oracle MapViewerユーザーズ・ガイド 11gリリース1 (11.1.1) B61387-04 |
|
 前 |
 次 |
Oracle Fusion Middleware MapViewer (MapViewer)は、Oracle Spatial and GraphまたはOracle Locator (Locatorとも呼びます)によって管理される空間データを使用してマップをレンダリングするための、プログラム可能なツールです。MapViewerには、空間データの問合せおよび地図レンダリングの複雑さを意識させず、より上級のユーザーに対してはカスタマイズ可能なオプションを提供するツールが備わっています。これらのツールは、プラットフォームに依存しない方法でデプロイでき、マップ・レンダリング・アプリケーションと統合するように設計されています。
この章の主な項目は、次のとおりです。
1.7項「高可用性とMapViewer」(上級ユーザー向け)
MapViewerは、Oracle Fusion Middlewareの一部として出荷されます。その主要な提供物は、Oracle Fusion Middlewareの場合と同様に、Java EE (Java Platform, Enterprise Edition)コンテナにデプロイできるJava EEアプリケーションです。MapViewerには、次の主要なコンポーネントが含まれています。
SDOVISという名前のコア・レンダリング・エンジン(Javaライブラリ)。地図レンダリングを実行します。レンダリング機能をWebアプリケーションに公開するためのサーブレットが提供されています。
MapViewer機能に対するプログラマブルなアクセスを許可する一連のApplication Program Interface (API)。これらのAPIには、XML、JavaおよびAJAXベースのJavaScript APIが含まれています。
グラフィカル・マップ・ビルダー・ツール。マップ記号の作成、空間データ・レンダリング・ルールの定義、およびMapViewerオブジェクトの作成と編集が行えます。
Oracle Maps。インタラクティブな地理空間Webアプリケーションの開発を容易にするマップ・キャッシュ・サーバーおよびFOI (対象地物)サーバーが含まれます。
コア・レンダリング・エンジンは、Java Database Connectivity (JDBC)によってOracleデータベースに接続します。また、データベースからマップ・メタデータ(Map Builderツールによって作成されたマップ定義、スタイル指定ルール、記号など)を読み取り、レンダリング操作の際にそのメタデータを適用して空間データを取得します。
XML APIは、アプリケーションの開発者に対し、マップ・リクエストをMapViewerに発行してマップ・レスポンスを受け取るための多様なインタフェースを提供します。JavaBeanベースのAPIを使用すると、MapViewerのレンダリング機能にアクセスできます。JavaScript APIを使用すると、MapViewerのOracle Maps機能を使用する、インタラクティブ性の高いWebアプリケーションを作成できます。
Map Builderツールを使用すると、空間データベース内のマップ、テーマおよび記号メタデータの作成と管理のプロセスを簡略化することができます。このツールについては、第9章を参照してください。
MapViewerのコア機能の上に構築されたOracle Mapsでは、マップ画像タイルをキャッシングするマップ・タイル・サーバーと、データベースからライブ・データを取り出してストリーミングしインタラクティブな地物としてマップ上に表示する対象地物(FOI)サーバーを使用します。AjaxベースのJavaScript APIとOracle Mapsを併用すると、高度なマッピング・ソリューションが得られます。Oracle Mapsでは、高度なカスタマイズ機能および問合せ機能もサポートしています。
MapViewerの主要な利点は、Oracle Spatial and Graph、Oracle LocatorおよびOracle Fusion Middlewareとの統合にあります。MapViewerでは、Oracle Spatial and Graphに格納されている2次元ベクター・ジオメトリ、GeoRasterのデータ、およびOracle Spatial and Graphのトポロジおよびネットワーク・データ・モデル内のデータをサポートしています。Oracle MapViewerは、Open Geospatial Consortium (OGC)に準拠したWeb Map Service (WMS)サーバーでもあります。
MapViewerの基本的なアクション・フローには、クライアントによってマップまたはMapViewer管理アクションのどちらがリクエストされた場合にも、2つの手順から構成されるリクエスト/レスポンス・モデルがあります。
マップ・リクエストの場合:
クライアントによってマップがリクエストされ、マップ名、データソース、中心位置、マップ・サイズおよびオプションでマップ最上部に表示するその他のデータが渡されます。
サーバーにより、マップ画像(または画像のURL)、マップの最小外接矩形(MBR)およびリクエストのステータスが返されます。
MapViewer管理リクエストの場合:
クライアントによってMapViewer管理アクションがリクエストされ、特定タイプのリクエストおよび適切な入力値が渡されます。
サーバーにより、リクエストのステータスおよびリクエストされた情報が返されます。
図1-1では、MapViewerの基本的なアクション・フローを示しています。
図1-2では、MapViewerのアーキテクチャを示しています。
図1-2では次のことが示されています。
MapViewerは、Oracle Fusion Middleware中間層の一部です。
MapViewerにはレンダリング・エンジンが含まれます。
MapViewerは、HTTPプロトコルを使用して、クライアントのWebブラウザまたはアプリケーションと通信できます。
MapViewerは、データベースへのJDBCコールによって、空間データ・アクセス(Oracle Spatial and GraphまたはOracle Locatorのデータの読取りおよび書込み)を実行します。
データベースには、マッピング・メタデータの他に、Oracle Spatial and GraphまたはOracle Locatorが含まれます。
MapViewerの使用を開始するには、次の手順を実行します。
MapViewerのインストールおよびデプロイの前後いずれかで、第2章に目を通し、重要な用語および概念を確実に理解しておきます。
前提条件となるソフトウェア(1.3項を参照)を所有していることを確認します。
MapViewerをインストール(必要な場合)およびデプロイします(1.4項を参照)。
MapViewerを使用して、基本タスクをいくつか実行します。たとえば、Oracle Mapsアプリケーション(第8章を参照)を作成します。
オプションとしてMap Builderツール(第9章を参照)を使用し、スタイル、テーマおよびマップと、それぞれのオプションについて理解しておきます。また、空間データをプレビューすることもできます。
MapViewerを使用するには、以下のソフトウェアが必要です。
Oracle MapViewerでサポートされるJava EEサーバー(http://www.oracle.com/technetwork/middleware/mapviewer/j2ee-server-support-097757.htmlを参照)
Oracle Spatial and GraphオプションまたはOracle Locator (リリース10g以上)を備えたOracle Database
JDBC Oracle Call Interface (OCI)機能を使用する必要がある場合は、Oracle Client (リリース10g以上)。ただし一般に、MapViewerと併用するにはJDBCシン・ドライバをお薦めします。その場合、Oracle Clientは不要です。
Java SDK 1.6以上
また、MapViewerではJ2SE SDKでHeadless AWTメカニズムがサポートされています。これによって、MapViewerは、X11 DISPLAY変数を設定することなく、LinuxシステムまたはUNIXシステム上で動作できます。LinuxシステムまたはUNIXシステムでAWT Headlessモードを有効にするには、コマンドラインに次のように指定してMapViewerを起動します。
-Djava.awt.headless=true
MapViewerをインストール(必要な場合)およびデプロイして、中間層で動作させることができます。MapViewerはJava EE Webアプリケーションとして動作し、コンテナのHTTPポートで着信マップ・リクエストをリスニングします。
MapViewerをデプロイするには、要件に合せて、次のいずれかの手順を実行します。
すでにWebLogic Server 10以上がインストール済で、そこにMapViewerをデプロイする場合は、1.4.1項の手順を実行します。
アーカイブ済(圧縮済) EARファイルまたは展開済(解凍済) EARフォルダから、MapViewerをJava Platform, Enterprise Edition (Java EE)サーバーにデプロイする場合は、第1.4.2項の手順に従います。
Oracle Technology Network (OTN)のMapViewerページから、最新のMapViewerクイック・スタート・キットをダウンロードします。このキットには、スタンドアロンのGlassfishサーバーと、デプロイおよび構成済のMapViewerが含まれています。MapViewerを数分で動作させることができ、テストおよび簡単な開発に便利です。
MapViewerのデプロイ先およびデプロイ方法とは無関係に、MapViewer用のホーム・ディレクトリがデプロイ中に作成されます。たとえば、クイック・スタート・キットでは、このディレクトリは次のディレクトリ内に配置されます。
$ORACLE_HOME/apps
$ORACLE_HOMEは、Glassfishインストールの最上位ディレクトリです。MapViewerディレクトリは、通常mapviewer.warまたはmapviewerという名前(またはMapViewerのデプロイ先のコンテキスト・パスと同じ名前)であり、多数のサブディレクトリが存在します。デバッグ、管理作業または手動による構成を実行する場合は、それらサブディレクトリのいくつかに対する理解が必要なことがあります。
MapViewerデプロイ先の主要なサブディレクトリは、次のとおりです。
/mapviewer
admin/
fsmc/
jslib/
WEB-INF/
lib/
conf/
log/
tilecache/
classes/
admin/
/mapviewer/fsmcディレクトリにはOracle Maps JavaScript V1 APIライブラリが含まれ、/mapviewer/jslibディレクトリにはOracle Maps JavaScript V2 APIライブラリが含まれています。ディレクトリ/mapviewer/WEB-INFとそのサブディレクトリには、一連のライブラリと、MapViewerの管理および構成用ファイルが含まれています。
MapViewerを正常にデプロイした後、GeoRasterテーマを使用してGeoRasterデータを表示する場合は、特定のJava Advanced Imaging (JAI)ライブラリ・ファイルがMapViewer Javaクラスパス内にあることの確認が必要なことがあります。該当するライブラリ・ファイルは、jai_core.jar、jai_codec.jarおよびjai_imageio.jarであり、完全なOracle Fusion MiddlewareまたはOracle Databaseインストール内の、通常はOracle Multimedia(旧称はOracle interMedia)ファイル用のディレクトリ下にあります。それらのファイルは、MapViewer WEB-INF/libディレクトリにコピーできます。
注釈テーマについては、MapViewerはJAXB 2.xライブラリのjsr173_api.jar、jaxb-api.jar、jaxb-impl.jarおよびactivation.jarを使用します。
この項では、MapViewerをWebLogic Serverバージョン10または10.3にデプロイする方法について説明します。(これより前のWebLogic Serverバージョンへのデプロイはテストされていません。)デプロイする際の注意点は次のとおりです。
MapViewerは、展開済ディレクトリからデプロイするか、EARアーカイブから直接デプロイできます。この項では、展開済ディレクトリからMapViewerをデプロイする方法を示しますが、その全体的なプロセスは、解凍済EARのデプロイメントや、読取り専用の展開済EARのデプロイメントと似ています。
直接EARファイルをデプロイする場合は、第1.4.1.1項「MapViewer EARアーカイブのアンパック」をスキップし、後からWebLogic Serverコンソールで、デプロイメント用に開かれたディレクトリではなく、EARファイルを選択します。
この項ではWebLogicコンソールを使用しますが、かわりにWLSコマンドラインを使用することもできます。
MapViewerをホストする新しいWebLogicドメインが作成されます。MapViewerはリソース集中型のアプリケーションであり、独自のドメインなど、個別の環境で実行することが望ましいため、このアプローチが推奨されます。ただし、(推奨されませんが)MapViewerを既存のWebLogicドメインにデプロイすることも可能です。
MapViewerをWebLogic Serverにデプロイする主な手順は次のとおりです。
MapViewer EARアーカイブをアンパックします。
WebLogic Serverを構成します。
WebLogic ServerでMapViewerのデプロイと起動を行います。
必要に応じて、MapViewer管理ページを使用します。
MapViewerは、展開済ディレクトリ、つまりmapviewer.earをアンパックしたディレクトリからデプロイできます。
mapveiwer.earアーカイブは、WebLogicが稼働しているサーバー上の任意のディレクトリにアンパックできます。このディレクトリがMapViewerインストールの作業フォルダになり、デフォルトでは、MapViewerはこの場所から構成ファイルを読み取って、生成したマップ画像をこのディレクトリの下のフォルダに保存します。これは(一時的ではなく)永続的なものにすることをお薦めします。同一のMapViewerバイナリを複数のホストで稼働する複数のWebLogic Serverにデプロイする場合は、共有ディレクトリにすることができます。
次の手順では、/ul/mapviewerという名前のディレクトリをMapViewerの最上位ディレクトリに作成済であることを想定しています。(別のディレクトリを作成した場合は、手順をそれに従って読み替えてください。)次の手順を実行します。
mapviewer.earを/ul/mapviewerにコピーします。
カレント・ディレクトリが/ul/mapviewerでない場合は、このディレクトリに移動します。
mapviewer.earをmapviewer1.earという名前に変更します。
mapviewer.earという名前のサブディレクトリを作成します。
mapviewer1.earをmapviewer.ear(つまり/ul/mapviewer/mapviewer.ear)にアンパックします。
mapviewer.earに移動します。
web.warをweb1.warという名前に変更します。
web.warという名前のサブディレクトリを作成します。
web1.warをweb.war(つまり/ul/mapviewer/mapviewer.ear/web.war)に解凍します。
MapViewer構成ファイル(/ul/mapviewer/mapviewer.ear/web.war/WEB-INF/conf/mapViewerConfig.xml)を必要に応じて変更します(ロギング・レベルの変更や永続的データソースの定義など)。この構成は後で変更することもできます。
これで、MapViewerのアンパックと構成ができました。次に、WebLogic ServerがMapViewer用に適切に構成されていることを確認する必要があります。その後、WebLogic ServerでのMapViewerのデプロイと起動ができるようになります。
WebLogic Serverを構成するには、次の手順を実行します。
次のスクリプトを実行して、MapViewerをホストする新しいWebLogicドメインを作成します。
$BEA_HOME/wlserver_10.0/common/bin/config.sh
このスクリプトにより、構成ウィザードが開始されます。管理ユーザーをweblogicという名前にすることをお薦めしますが、別の名前を使用する場合は、MapViewerを構成するときにその名前を指定できます。MapViewer管理ページにログインするには、管理ユーザーを使用することになります。
次のスクリプトを実行してドメインを起動します。
$BEA_HOME/user_projects/domains/map-domain/startWebLogic.sh
ここで、map-domainはステップ1で作成したドメインの名前です。
新しいドメインを起動したら、コンソールにログインしてMapViewerのデプロイを開始できます。次の手順を実行します。
コンソールにログインします。通常、次のURLでアクセスできます。
http://<host>:7001/console
ここで、<host>はWebLogic Serverが稼働しているシステムのホスト名またはIPアドレスです。
「チェンジ・センター」で、「ロックして編集」ボタンが表示されている場合は、そのボタンをクリックします。
「ロックして編集」ボタンが表示されていない場合は、次の手順に進みます。このボタンが表示されていない場合、WebLogic Serverが「ロックを自動取得して変更をアクティブ化」オプションを有効にして構成されていることが考えられます。
「ドメイン構造」の下で、「デプロイメント」をクリックします。
管理コンソールのページは図1-3のように表示されます。
「デプロイメント」の下で、「インストール」をクリックします。
次のページが表示されます(図1-4を参照)。MapViewerディレクトリの位置(この場合は/ul/mapviewer/mapviewer.ear)はディレクトリの名前であり、.earファイルの名前ではありません。
「次へ」をクリックします。
このデプロイメントをアプリケーションとしてインストールするを選択し、「次へ」をクリックします。
ソースのアクセス可能性セクションを持つページが表示されます(図1-5を参照)。
ソースのアクセス可能性セクションでは、デプロイメントを次の場所からアクセス可能にするを選択します。
このオプションにより、アンパックされたMapViewerの場所がMapViewerの「作業」ディレクトリになります。また、将来MapViewerをアップグレードする際の作業が容易になり、新しいmapviewer.earファイルをこのディレクトリにアンパックし、WebLogic Serverを再起動するだけで、アップグレードが可能です。
「完了」をクリックして、MapViewerのデプロイを開始します。
WebLogic Serverでロックを自動取得して変更をアクティブ化するオプションが有効になっている場合は、この手順の残りの部分をスキップし、デプロイが終了したら次の手順に進んでください。
WebLogic Serverでロックを自動取得して変更をアクティブ化するオプションが有効になっていない場合は、デプロイが終了したら「チェンジ・センター」に移動し、変更のアクティブ化に続いて構成の解放をクリックして、デプロイのプロセスを完了させます。
「デプロイメント」からmapviewerを選択して「開始」をクリックし、すべての要求を処理を選択して、MapViewerを起動します(図1-6を参照)。
次の場所に移動してMapViewerにアクセスします。
http://<host>:7001/mapviewer
ここで、<host>はWebLogic Serverが稼働しているシステムのホスト名またはIPアドレスです。
初めてMapViewerホームページの管理ボタンをクリックすると、ログイン情報を入力するプロンプトが表示されます。WebLogic管理アカウントのデフォルトのユーザー名であるweblogicを使用してログインすることができます。ただし、WebLogicドメイン管理アカウントで別のユーザー名を使用している場合は、$MAPVIEWER_HOME/mapviewer.ear/web.war/WEB-INF/にあるMapViewerのweblogic.xmlファイルを変更する必要があります。
weblogic.xmlファイルを変更するには、テキスト・エディタでファイルを開き、2つ含まれているweblogicを実際の管理アカウント名に置き換えます。次の抜粋は、置き換える名前が含まれている行を示しています。
<security-role-assignment>
<role-name>map_admin_role</role-name>
<principal-name>weblogic</principal-name>
</security-role-assignment>
<security-role-assignment>
<role-name>secure_maps_role</role-name>
<principal-name>weblogic</principal-name>
</security-role-assignment>
リリース11.1.1.7からは、アーカイブ済(圧縮済) EARファイルまたは展開済(解凍済) EARフォルダから、MapViewerをJava Platform, Enterprise Edition (Java EE)サーバーにデプロイできます。MapViewerを展開済EARフォルダからデプロイする場合、そのフォルダを読取り専用にして、実行中にMapViewerが展開済EARフォルダ内にファイルを作成したり、フォルダ内のファイルを変更しないようにすることもできます。このようなデプロイメントだけでなく、実行時にMapViewerに書き込むこともできる展開済EARフォルダ・ツリーに基づく、従来のデプロイメントもサポートされます。
MapViewerをEARファイルまたは読取り専用の展開済EARフォルダからデプロイして実行するには、外部のmapViewerConfig.xmlファイルを指定することにより、実行時にMapViewerが、MapViewer EARアーカイブのWEB-INF/conf/ディレクトリに含まれているデフォルトのファイルからではなく、このファイルから構成パラメータを検出してロードできるようにする必要があります。
外部のmapViewerConfig.xmlファイルの配置場所は規定されていませんが、MapViewerのプライベート・フォルダとして使用するフォルダを指定し、mapViewerConfig.xmlファイルをconfという名前のサブフォルダに格納することをお薦めします。このプライベート・フォルダは、一時デプロイメント・フォルダや、システムのインストールまたはアップグレード中に上書きされる可能性がある場所には配置しないようにする必要があります。Java EEサーバーをクラスタとして実行している場合は、MapViewerのプライベート・フォルダを共有ドライブに配置し、デプロイしたすべてのMapViewerバイナリから、そのフォルダを参照および使用できるようにすることを強くお薦めします。このプライベート・フォルダは、パブリック・フォルダとしてアクセスできないようにする必要があります。実行中、MapViewerはプライベート・フォルダ内にいくつかのフォルダとファイル(ログ・ファイル、一時ファイル、生成したマップ・タイルを格納するフォルダなど)を作成し、それらを変更することにも注意してください。
MapViewerによる外部のmapViewerConfig.xmlファイルの検索場所を指定するには、次のいずれかの方法を使用します。
どの方法でもファイルへの絶対パスを指定し、MapViewerがこのパスに基づいてプライベート・フォルダを導出します。たとえば、外部のmapViewerConfig.xmlファイルが次の場所に格納されているとします。
/scratch/_maps/conf/mapViewreConfig.xml
この場合、MapViewerは起動中に、前述の方法で示した場所を記載順に確認し、最初に検出したmapViewerConfig.xmlファイルを使用します。この例では、MapViewerは場所を検出した後、/scratch/_maps/をプライベート・フォルダとして使用します。
前述の方法で示した場所をすべて確認しても、外部のmapViewerConfig.xmlファイルを検出できない場合、MapViewerは、EARファイルのWEB-INF/conf/フォルダにあるデフォルトのmapViewerConfig.xmlファイルの検出を試行します。この場合は、結果的にMapViewerが従来のデプロイメントと同様、ファイルを展開済EARフォルダに書き込むことになるため、デプロイメントは読取り専用になりません。
外部のmapViewerConfig.xmlファイルを使用する場合は、MapViewerが生成したマップ・イメージを保存するためのパブリック・フォルダも常に指定する必要があります(第1.4.2.4項「生成したマップ・イメージを保存するパブリック・フォルダの指定」を参照)。
この方法では、Java EEサーバーの起動スクリプトに通常追加されるJVMオプションoracle.maps.configを使用して、外部のmapViewerConfig.xmlファイルの場所を指定します。たとえば、WebLogicサーバーの場合、このオプションをドメインのsetDomainEvn.shスクリプト(–Djava.awt.headless=trueオプションの直後)に追加できます。
EXTRA_JAVA_PROPERTIES= "… -Doracle.maps.config=/scratch/_maps/conf/mapViewerConfig.xml … "
変更後、MapViewerのデプロイメントを試行する前に、サーバーを再起動する必要があります。
この方法では、デプロイメントの前に、MapViewer EARアーカイブのWEB-INF/フォルダに含まれているweb.xmlファイルを変更する必要があります。web.xmlファイルで、新しい<context-param>タグを<description>タグの直後に追加して、外部構成ファイルの場所を指定します。例:
<context-param>
<param-name>oracle.maps.config</param-name>
<param-value>/scratch/_maps/conf/mapViewerConfig.xml</param-value>
</context-param>
この方法では、MapViewerのデプロイメントを試行する前に、いくつかの手順を実行する必要があります。
mapViewerConfig.xmlファイルの場所を参照する1つの行が含まれた、config.propertiesという名前のテキスト・ファイルを作成します。例:
oracle.maps.config= /scratch/_maps/conf/mapViewerConfig.xml
空のフォルダoracle/とサブフォルダmaps/を作成し、作成したファイルをmaps/サブフォルダに保存します。つまり、次のようなパスになります。
oracle/maps/config.properties
このパスとファイルを含むJARアーカイブを作成し、oracleの親フォルダ内からjarコマンドを実行します。例:
jar cvf maps_config.jar oracle
JARファイルには任意の名前を付けることができます。
この新しく作成したjarファイルをMapViewerのクラスパスに配置します。たとえば、WebLogic Serverでは、このjarをドメインのlibフォルダに配置できます。
外部のmapViewerConfig.xmlファイルを使用する場合は、MapViewerが生成したマップ・イメージを保存するためのパブリック・フォルダも指定して、ユーザーとMapViewerクライアント・アプリケーションが、Web経由でそれらのイメージにアクセスできるようにする必要があります。これを行うには、外部のmapViewerConfig.xmlファイルに含まれる<save_images_at>要素に適切なパス属性を指定します。
<save_images_at>要素がコメント化されていないことを確認してください。(対照的に、従来のデプロイメントでは、<save_images_at>要素をコメント化したままにすることがよくあります。この場合、MapViewerは展開済WARファイルのimagesフォルダを使用して、生成したマップ・イメージを保存します。)
ここでは、MapViewer EARアーカイブまたはフォルダ内の場所を指すパスを指定しないようにする必要があります。
クラスタ内で複数のMapViewerインスタンスを実行している場合、このパブリック・フォルダは共有ドライブに配置する必要があります。
MapViewerをOracle Fusion Middleware 10gR3、スタンドアロンOC4JまたはWebLogic Serverに正常にデプロイした後は、1.4.3.1項に従って、MapViewerが実際に動作しているかどうかを確認します。そのWebインタフェース、特に管理ページに慣れておくのもよい考えです。
また、1.4.3.2項に従って、SQLスクリプトを1つまたは複数個実行する必要もあります。
MapViewerサーバーが正しく起動したかどうかをテストするには、OC4Jインスタンスをブラウザに表示します。たとえば、MapViewerがwww.example.comというシステムにインストールされており、HTTPポートが8888である場合、次のURLを入力し、単純なバージョン取得リクエストを指定して、MapViewerサーバーを起動します。
http://www.example.com:8888/mapviewer/omserver?getv=t
MapViewerは、正しく動作していると、次のようなバージョンおよびビルド番号を示すレスポンス・テキスト文字列を即時返送します。
Ver11_1_1_7_B121108
実際のバージョンおよびビルド番号には、インストールされたバージョンが反映されます。
サーバーが正しく起動および初期化されていない場合は、レスポンスが返されないか、または「500 内部サーバー・エラー」というメッセージが表示されます。
レスポンス・メッセージに「MapServerが利用できません。しばらくしてから再試行してください。」という表現が含まれている場合、MapViewerサーバーは初期化中であり、処理にはもう少し時間がかかることを意味している可能性があります(たとえば、システムが遅いか、構成ファイルで複数の事前定義済データソースが指定されているため、MapViewerが該当するデータベースへの接続を試行している)。この場合、少なくとも数秒待ってから、そのリクエストを再び試行します。
ただし、このレスポンス・メッセージの受信が続く場合は、デプロイに問題がある可能性があります。スタンドアロンOC4Jデプロイメント用のOC4Jコンソールか、Oracle Fusion Middleware 10gR3の完全デプロイメント用のOC4Jインスタンスのリダイレクトされた出力/エラー・ログ・ファイルに、エラー・メッセージがないかチェックします。この問題の一般的な原因は、次のとおりです。
UNIXまたはLinuxオペレーティング・システムで、Java仮想マシン(JVM)が–Djava.awt.headless=trueオプションを指定して起動されず、DISPLAY環境変数が設定されていません。このため、MapViewerサーバーが、UNIXシステムとLinuxシステムでX11ウィンドウ・システムに依存するJavaグラフィックス・ライブラリにアクセスすると、障害が発生します。
mapviewer.earファイルが、互換性のないバージョンのOracle WebLogic ServerまたはGlassfishにデプロイされています。以前のバージョンとは異なり、MapViewerのリリース11.1.1.7は、スタンドアロンOC4Jと連携して動作しません。
この項で説明するSQLスクリプトのいくつかは、MDSYSユーザーとして接続されているときに実行する必要があります。実行する各スクリプトは、MapViewerが空間データのレンダリングを実行することになる各ターゲットのOracleデータベース上で実行する必要があります。
MapViewerは、一連のシステム・ビューを使用して、必要なマッピング用メタデータをターゲット・データベースに格納します。ターゲット・データベースとは、Oracle Spatial and GraphまたはOracle Locator (リリース10g以上)がインストールされており、MapViewerがマップをレンダリングする際の元になるデータベースです。MapViewerに必要なシステム・ビューは、次のとおりです。
USER_SDO_MAPS
USER_SDO_THEMES
USER_SDO_STYLES
USER_SDO_CACHED_MAPS
USER_SDO_CACHED_MAPSビューは、Oracle Maps機能が使用します。これには、マップ・タイル・キャッシュ・インスタンスの定義が格納されます。このビューは、SYSユーザーとして接続されているときに次のスクリプトを実行し、手動で作成する必要があります。
$MV_HOME/WEB-INF/admin/mcsdefinition.sql
ターゲット・データベースがリリース9.2以上の場合、他の3つのビュー(SER_SDO_MAPS、USER_SDO_THEMES、USER_SDO_STYLES)は自動的に作成され、移入されます。ただし、ターゲット・データベースのリリース番号が9.2未満の場合、該当するビューはMDSYSユーザーとして接続されているときに次のスクリプトを実行し、手動で作成して移入する必要があります。
$MV_HOME/WEB-INF/admin/mapdefinition.sql
$MV_HOME/WEB-INF/admin/defaultstyles.sql
接続先のそれぞれのデータベース・スキーマについて、MapViewerは、一部の事前定義済みテーマに存在する可能性のある配列タイプバインディング変数をサポートする、以下のSQL配列タイプがあるかどうかをチェックします。
MV_STRINGLIST
MV_NUMBERLIST
MV_DATELIST
これらのタイプが存在しない場合、MapViewerはMapViewerデータソースに関連付けられたデータベース・スキーマにこれらを作成しようとします。ただし、スキーマに関連するユーザーに新規のタイプを作成する十分な権限がない場合、権限のあるユーザーがデータソース・スキーマに接続して以下の文を入力することにより、タイプを作成する必要があります。
CREATE or REPLACE type MV_STRINGLIST as TABLE of VARCHAR2(1000); CREATE or REPLACE type MV_NUMBERLIST as TABLE of NUMBER; CREATE or REPLACE type MV_DATELIST as TABLE of DATE;
この項では、MapViewer管理ページの概要と、ユーザーが実行できる管理および構成タスクの一部(新規データソースの追加、Oracle Mapsが使用するマップ・タイル層の管理、ロギング・レベルの設定など)について説明します。
MapViewerが正しく動作していることを確認したら、MapViewer管理ページにログインします。そのためには、まずMapViewer「ようこそ」ページ(通常はhttp://<host>:<port>/mapviewer。<host>および<port>は、インストールの正しい値に置き換えてください)を表示します。MapViewer「ようこそ」ページを、図1-7に示します。
右上の「管理」アイコンをクリックします。ログイン・プロンプトが表示され、MapViewer管理ページに対するユーザー名とパスワードが尋ねられます。
ユーザー名: adminを入力します。
パスワード: GlassfishインストールのWebLogic ServerのServer Controlページにログインする際に使用するパスワードを入力します。
ログインすると、図1-8に示すMapViewer管理ページが(「管理」タブに)表示されます。
このページでは、自サイトに固有な要件に合わせたMapViewerの構成、事前定義済データソースの追加(MapViewerの起動時に指定されたターゲット・データベースに自動的に接続されることが目的)、マップ・タイル層の管理などの管理タスクを実行できます。構成タスクの詳細は1.5.2項、管理タスクについては1.5.3項を参照してください。
動作中のMapViewerに関するデフォルト構成設定が適切でない場合、$MAPVIEWER_HOME/WEB-INF/confディレクトリに格納されているMapViewer構成ファイルmapViewerConfig.xmlを編集することで、MapViewerを構成できます。このファイルは、テキスト・エディタまたはMapViewer管理ページで変更できます。
このファイルを変更した後、変更を有効にするにはコンテナを再起動する必要があります。ただし、スタンドアロンのGlassfishインスタンスとともにMapViewerをインストールした場合は、かわりにMapViewer管理ページを使用して、(他のアプリケーションがデプロイされ、動作している可能性のあるJava EEインスタンス全体ではなく) MapViewerサーブレットのみを再起動できます。
MapViewerを、複数のプロセスを持つ(つまり、同一ホスト上に複数の物理JVMを持つ) WebLogic Serverインスタンスにデプロイした場合、またはクラスタ・アイランド内にある(複数のホスト上で複数のWLSインスタンスが実行されている) WebLogic Serverインスタンスにデプロイした場合、MapViewer構成ファイルに対する変更をすべてのMapViewerサーバーで有効にするには、そのWebLogic Serverインスタンス自体を再起動する必要があります。後者(クラスタ化されたWebLogic Serverインスタンス)の場合、クラスタ内にあるホストのWebLogic Serverインスタンスごとに、MapViewerディレクトリ階層内のMapViewer構成ファイルを変更することが必要になる可能性があります。リポジトリベースの中間層クラスタリングの詳細は、『Oracle Fusion Middleware高可用性ガイド』を参照してください。
MapViewer構成ファイルでは、次の情報がXML形式で定義されます。
ログ情報。コンテナ制御ロギング(推奨)または<logging>要素で定義されます(1.5.2.1項を参照)。
マップ画像ファイル情報。<save_images_at>要素で定義されます(1.5.2.2項を参照)。
管理リクエスト制限。<ip_monitor>要素で定義されます(1.5.2.3項を参照)。
ファイアウォールを隔てた外部情報にアクセスするためのWebプロキシ情報。<web_proxy>要素で定義されます(1.5.2.4項を参照)。
グローバル・マップ「ルック・アンド・フィール」構成。<global_map_config>要素で定義されます(1.5.2.5項を参照)。
内部空間データ・キャッシュの設定値。<spatial_data_cache>要素で定義されます(1.5.2.6項を参照)。
カスタム・イメージ・レンダラ登録。<custom_image_renderer>要素で定義されます(付録Cを参照)。
永続マップ・データソース。<map_data_source>要素で定義されます(1.5.2.14項を参照)。
セキュリティ構成。<security_config>要素で定義されます。
WMSサービス構成。<wms_config>要素で定義されます。
外部属性データ・プロバイダ登録。<ns_data_provider>要素で定義されます。
マップ・タイル・サーバー構成。<map_tile_server>要素で定義されます。
別途指定されていないかぎり、mapViewerConfig.xmlファイルのすべてのパス名は、ファイルが格納されているディレクトリに対する相対パスです。
例1-1は、mapViewerConfig.xmlファイルの例を示しています。
例1-1 MapViewer構成ファイルの例
<?xml version="1.0" ?>
<!-- This is the configuration file for MapViewer. -->
<!-- Note: All paths are resolved relative to this directory (where
this config file is located), unless specified as an absolute
path name.
-->
<MapperConfig>
<!-- ****************************************************************** -->
<!-- ************************ Logging Settings ************************ -->
<!-- ****************************************************************** -->
<!-- Uncomment the following to modify logging. Possible values are:
log_level = "fatal"|"error"|"warn"|"info"|"debug"|"finest"
default: info) ;
log_thread_name = "true" | "false" ;
log_time = "true" | "false" ;
one or more log_output elements.
-->
<!--
<logging log_level="info" log_thread_name="false"
log_time="true">
<log_output name="System.err" />
<log_output name="../log/mapviewer.log" />
</logging>
-->
<!-- ****************************************************************** -->
<!-- ********************** Map Image Settings ************************ -->
<!-- ****************************************************************** -->
<!-- Uncomment the following only if you want generated images to
be stored in a different directory, or if you want to customize
the life cycle of generated image files.
By default, all maps are generated under
$ORACLE_HOME/lbs/mapviewer/web/images.
Images location-related attributes:
file_prefix: image file prefix, default value is "omsmap"
url: the URL at which images can be accessed. It must match the 'path'
attribute below. Its default value is "%HOST_URL%/mapviewer/images"
path: the corresponding path in the server where the images are
saved; default value is "%ORACLE_HOME%/lbs/mapviewer/web/images"
Images life cycle-related attributes:
life: the life period of generated images, specified in minutes.
If not specified or if the value is 0, images saved on disk will
never be deleted.
recycle_interval: this attribute specifies how often the recycling
of generated map images will be performed. The unit is minute.
The default interval (when not specified or if the value is 0)
is 8*60, or 8 hours.
-->
<!--
<save_images_at file_prefix="omsmap"
url="http://mypc.mycorp.com:8888/mapviewer/images"
path="../web/images"
/>
-->
<!-- ****************************************************************** -->
<!-- ********************* IP Monitoring Settings ********************* -->
<!-- ****************************************************************** -->
<!-- Uncomment the following to enable IP filtering for administrative
requests.
Note:
- Use <ips> and <ip_range> to specify which IPs (and ranges) are allowed.
Wildcard form such as 20.* is also accepted. Use a comma-delimited
list in <ips>.
- Use <ips_exclude> and <ip_range_exclude> for IPs and IP ranges
prohibited from accessing eLocation.
- If an IP falls into both "allowed" and "prohibited" categories, it is
prohibited.
- If you put "*" in an <ips> element, then all IPs are allowed, except
those specified in <ips_exclude> and <ip_range_exclude>.
On the other hand, if you put "*" in an <ips_exclude> element, no one
will be able to access MapViewer (regardless of whether an IP is in
<ips> or <ip_range>).
- You can have multiple <ips>, <ip_range>, <ips_exclude>, and
<ip_range_exclude> elements under <ip_monitor>.
- If no <ip_monitor> element is present in the XML configuration
file, then no IP filtering will be performed (all allowed).
- The way MapViewer determines if an IP is allowed is:
if(IP filtering is not enabled) then allow;
if(IP is in exclude-list) then not allow;
else if(IP is in allow-list) then allow;
else not allow;
-->
<!--
<ip_monitor>
<ips> 138.1.17.9, 138.1.17.21, 138.3.*, 20.* </ips>
<ip_range> 24.17.1.3 - 24.17.1.20 </ip_range>
<ips_exclude> 138.3.29.* </ips_exclude>
<ip_range_exclude>20.22.34.1 - 20.22.34.255</ip_range_exclude>
</ip_monitor>
-->
<!-- ****************************************************************** -->
<!-- ********************** Web Proxy Setting ************************ -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to specify the web proxy setting.
This is only needed for passing background image URLs to
MapViewer in map requests or for setting a logo image URL, if
such URLs cannot be accessed without the proxy.
-->
<!--
<web_proxy host="www-proxy.my_corp.com" port="80" />
-->
<!-- ****************************************************************** -->
<!-- *********************** Security Configuration ******************* -->
<!-- ****************************************************************** -->
<!-- Here you can set various security related configurations of MapViewer.
-->
<security_config>
<disable_direct_info_request> false </disable_direct_info_request>
</security_config>
<!-- ****************************************************************** -->
<!-- *********************** Global Map Configuration ***************** -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to specify systemwide parameters
for generated maps. You can specify your copyright note, map title, and
an image to be used as a custom logo shown on maps. The logo image must
be accessible to this MapViewer and in either GIF or JPEG format.
Notes:
- To disable a global note or title, specify an empty string ("") for
the text attribute of <note> and <title> element.
- position specifies a relative position on the map where the
logo, note, or title will be displayed. Possible values are
NORTH, EAST, SOUTH, WEST, NORTH_EAST, SOUTH_EAST,
SOUTH_WEST, NORTH_WEST, and CENTER.
- image_path specifies a file path or a URL (starts with "http://")
for the image.
<rendering> element attributes:
- Local geodetic data adjustment: If allow_local_adjustment="true",
MapViewer automatically performs local data
"flattening" with geodetic data if the data window is less than
3 decimal degrees. Specifically, MapViewer performs a simple
mathematical transformation of the coordinates using a tangential
plane at the current map request center.
If allow_local_adjustment="false" (default), no adjustment is
performed.
- Automatically applies a globular map projection (geodetic data only):
If use_globular_projection="true", MapViewer will
apply a globular projection on the fly to geometries being displayed.
If use_globular_projection="false" (the default), MapViewer does no map
projection to geodetic geometries. This option has no effect on
non-geodetic data.
-->
<!--
<global_map_config>
<note text="Copyright 2009, Oracle Corporation"
font="sans serif"
position="SOUTH_EAST"/>
<title text="MapViewer Demo"
font="Serif"
position="NORTH" />
<logo image_path="C:\\images\\a.gif"
position="SOUTH_WEST" />
<rendering allow_local_adjustment="false"
use_globular_projection="false" />
</global_map_config>
-->
<!-- ****************************************************************** -->
<!-- ****************** Spatial Data Cache Setting ******************* -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to customize the spatial data cache
used by MapViewer. The default is 64 MB for in-memory cache.
To disable the cache, set max_cache_size to 0.
max_cache_size: Maximum size of in-memory spatial cache of MapViewer.
Size must be specified in megabytes (MB).
report_stats: If you would like to see periodic output of cache
statistics, set this attribute to true. The default
is false.
-->
<!--
<spatial_data_cache max_cache_size="64"
report_stats="false"
/>
-->
<!-- ****************************************************************** -->
<!-- ******************** Custom Image Renderers ********************** -->
<!-- ****************************************************************** -->
<!-- Uncomment and add as many custom image renderers as needed here,
each in its own <custom_image_renderer> element. The "image_format"
attribute specifies the format of images that are to be custom
rendered using the class with full name specified in "impl_class".
You are responsible for placing the implementation classes in the
MapViewer's classpath.
-->
<!--
<custom_image_renderer image_format="ECW"
impl_class="com.my_corp.image.ECWRenderer" />
-->
<!-- ****************************************************************** -->
<!-- ****************** Custom WMS Capabilities Info ****************** -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following tag if you want MapViewer to
use the following information in its getCapabilities response.
Note: all attributes and elements of <wms_config> are optional.
-->
<!--
<wms_config host="www.my_corp.com" port="80">
<title>
WMS 1.1 interface for Oracle Mapviewer
</title>
<abstract>
This WMS service is provided through MapViewer.
</abstract>
<keyword_list>
<keyword>bird</keyword>
<keyword>roadrunner</keyword>
<keyword>ambush</keyword>
</keyword_list>
<sdo_epsg_mapfile>
../config/epsg_srids.properties
</sdo_epsg_mapfile>
</wms_config>
-->
<!-- ****************************************************************** -->
<!-- **************** Custom Non-Spatial Data Provider **************** -->
<!-- ****************************************************************** -->
<!-- Uncomment and add as many custom non-spatial data provider as
needed here, each in its own <ns_data_provider> element.
You must provide the id and full class name here. Optionally you
can also specify any number of global parameters, which MapViewer
will pass to the data provider implementation during initialization.
The name and value of each parameter is interpreted only by the
implementation.
-->
<!-- this is the default data provider that comes with MapViewer; please
refer to the MapViewer User's Guide for instructions on how to use it.
<ns_data_provider
id="defaultNSDP"
class="oracle.sdovis.NSDataProviderDefault"
/>
-->
<!-- this is a sample NS data provider with prameters:
<ns_data_provider
id="myProvider1" class="com.mycorp.bi.NSDataProviderImpl" >
<parameters>
<parameter name="myparam1" value="value1" />
<parameter name="p2" value="v2" />
</parameters>
</ns_data_provider>
-->
<!-- ****************************************************************** -->
<!-- ******************* Map Tile Server Setting ******************* -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to customize the map tile server.
<tile_storage> specifies the default root directory under which the
cached tile images are to be stored if the cache instance configuration
does not specify the root directory for the cache instance. If the
default root directory is not set or not valid, the default root
direcotry will be set to be $MAPVIEWER_HOME/web/tilecache
default_root_path: The default root directory under which the cached
tile images are stored.
-->
<!--
<map_tile_server>
<tile_storage default_root_path="/scratch/tilecachetest/"/>
</map_tile_server>
-->
<!-- ****************************************************************** -->
<!-- ******************** Predefined Data Sources ******************** -->
<!-- ****************************************************************** -->
<!-- Uncomment and modify the following to predefine one or more data
sources.
Note: You must precede the jdbc_password value with a '!'
(exclamation point), so that when MapViewer starts the next
time, it will encrypt and replace the clear text password.
-->
<!--
<map_data_source name="mvdemo"
jdbc_host="elocation.us.oracle.com"
jdbc_sid="orcl"
jdbc_port="1521"
jdbc_user="scott"
jdbc_password="!password"
jdbc_mode="thin"
number_of_mappers="3"
/>
-->
</MapperConfig>
MapViewerには、ランタイム情報およびイベントを記録するための柔軟なロギング・メカニズムが備わっています。ログ出力の粒度、量、形式および出力先を設定できます。ログ・ファイルの最大サイズや、自動的なログ・ファイル・ローテーションも設定できます。
MapViewerのロギングを構成する方法には、コンテナ制御アプローチと、構成ファイルの<logging>要素を使用する従来のロギングの2つがあります。
コンテナ制御ロギング: MapViewerがOracle Fusion Middleware 10gR3インスタンスにデプロイされている場合は、Oracle Fusion Middleware 10gR3 Controlを使用します。MapViewerがスタンドアロンOC4Jインスタンスにデプロイされている場合は、$OC4J_HOME/j2ee/home/config/j2ee-logging.xmlファイルを直接編集します。このアプローチでは、Fusion Middleware 10gR3の診断ロギング・メカニズムを最大限に活用して、最大ログ・ファイル・サイズやログ・ファイル・ローテーションなどの高度な機能を利用できます。
従来のロギング: mapViewerConfig.xmlファイルの<logging>要素を使用する方法です。MapViewerがWebLogic Serverにデプロイされる場合、MapViewerのロギング動作を構成する唯一のサポートされた方法は従来のロギングです。
コンテナ制御ロギング
|
注意: コンテナ制御ロギングを機能させるには、mapViewerConfig.xmlファイルの<logging>要素をコメント化するか、削除します。デフォルトでは、この要素はコメント化(無効化)されているため、コンテナ制御ロギング設定が正しく機能します。<logging>要素を有効にすると(その属性にはその他の変更を行わなくても)、MapViewerではコンテナ制御ロギング設定が無視されます。 |
MapViewerがOC4J 11gのスタンドアロン・インスタンスにデプロイされている場合、MapViewerのロギングを構成するには、$OC4J_HOME/j2ee/home/config/j2ee-logging.xmlファイルを編集します。たとえば、このファイルにある次のコードは、MapViewerのすべてのメッセージをFINESTレベルでデフォルトのOC4Jログ・ファイル(j2ee/home/log/oc4j/diagnostic.log)に記録します。
<log_handler name='oc4j-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='../log/oc4j'/>
<property name='maxFileSize' value='10485700'/>
<property name='maxLogSize' value='1048576'/>
<property name='encoding' value='UTF-8'/>
<property name='supplementalAttributes' value='J2EE_APP.name,J2EE_MODULE.name,WEBSERVICE.name,WEBSERVICE_PORT.name'/>
</log_handler>
このコードでは、デフォルトのOC4Jログ・ハンドラを定義しています。これは、ログ・ファイルの保存場所や最大ファイル・サイズなどの情報を指定します。このようなログ・ハンドラは、OC4Jのコンポーネントやアプリケーション(MapViewerなど)で作成される複数の実際のログ出力と関連付けることができます。
次の例では、MapViewerのログ出力(この場合は、すべての内部ログ・メッセージの生成を行うログ出力)を前述のログ・ハンドラに関連付けています。
<logger name="oracle.mapviewer.logger" level="FINEST" useParentHandlers='false'>
<handler name='oc4j-handler'/>
</logger>
この例では、oracle.mapviewer.loggerという名前のログ出力により作成されたすべてのログ・レコードをoc4j-handlerという名前のログ・ハンドラで処理するようにOC4Jに指示しています。ロギング・レベルをFINESTに設定しているため、MapViewerによって生成されたすべてのメッセージがログ・ファイルに表示されます。ここでサポートされるロギング・レベルは、標準のJavaロギング・レベル(SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINEST)です。
コンテナ制御ロギングでは、MapViewerによって次のログ出力が使用されます。
oracle.mapviewer.logger。MapViewerのすべてのサーバー側のコンポーネントにより、診断レコードを生成するために使用されます。
oracle.mapviewer.access。MapViewerにより、ユーザー・アクセス・レコードのみを記録するために使用されます。
前述の例では、oc4j-handlerという名前の、すでにj2ee-logging.xmlファイルに定義されている既存のログ・ハンドラを関連付けました。j2ee-logging.xmlファイルに独自のログ・ハンドラを定義すれば、最大ファイル・サイズやファイル・ローテーションに加えて、ログ・ファイルの場所や名前を変更することもできます。次の例では、MapViewerのアクセス・レコードのみを格納する新しいログ・ハンドラを作成しています。
<log_handler name='mv-handler' class='oracle.core.ojdl.logging.ODLHandlerFactory'>
<property name='path' value='../log/mapaccess/access.log'/>
<property name='maxFileSize' value='600000'/>
<property name='maxLogSize' value='10000'/>
<property name='format' value='ODL-TEXT'/>
<property name='encoding' value='UTF-8'/>
<property name='supplementalAttributes' value='J2EE_APP.name'/>
</log_handler>
次の例では、この新しいログ・ハンドラを、oracle.mapviewer.accessという名前のMapViewerのアクセス・ログ出力に関連付けています。
<logger name='oracle.mapviewer.access' level='FINEST' useParentHandlers='false'>
<handler name='mv-handler'/>
</logger>
アクセス・ログ・メッセージをログ・ファイルに表示するには、レベルをFINESTまたはFINERに設定する必要があることに注意してください。これで、OC4Jを再起動してマップ・リクエストを作成すると、OC4Jのlog/mapaccessディレクトリにある新しいログ・ファイル(access.log)に、MapViewerにアクセスしたユーザーのレコードが格納されます。
ロギング構成、特にFusion Middleware 10gR3 Controlを使用したロギングの構成方法の詳細は、『Oracle Containers for J2EE構成および管理ガイド』を参照してください。
従来のロギング
コンテナ制御ロギングを使用しない場合は、従来のアプローチを使用できます。その場合、MapViewer構成ファイルの<logging>要素を非コメント化して変更する必要があります。
<logging>要素の属性またはサブ要素として、次の情報を指定できます。
log_level属性では、ログに記録される情報のレベルが制御され、このレベルによってログ出力量が左右されます。log_level属性には、FATAL、ERROR、WARN、INFO、DEBUGまたはFINESTという値(ログ出力量が最も少ないレベルから最も多いレベルの順)を設定します。FATALレベルでは出力されるログ情報が最も少なくなり(回復不能なイベントのみがログに記録されます)、他のレベルでは前述にリストした順で含まれるログ情報が多くなり、FINESTレベルではほとんどの情報がログに記録されます。本番作業では、WARNまたはより制限の大きいレベル(ERRORまたはFATAL)をお薦めします。ただし、デバッグの場合は制限のより小さいレベルに設定する必要があります。
log_thread_name属性では、イベントを検出してログに記録したスレッドの名前を含めるかどうかが制御されます。
log_time属性では、ロギング・イベント発生時の現在時刻が含まれるかどうかが制御されます。
log_outputサブ要素では、ログ情報の出力先が識別されます。デフォルトで、ログ・レコードはシステム・エラー・コンソールに書き込まれます。この設定は、システム出力コンソールまたは1つ以上のファイル、あるいはなんらかの組合せに変更できます。複数のlog_outputサブ要素によって複数のデバイスを指定した場合、ログ・レコードは、同じロギング・レベルおよび属性を使用してすべてのデバイスに送信されます。
マップ画像ファイル情報は、<save_images_at>要素で指定します。デフォルトで画像は、$ORACLE_HOME /lbs/mapviewer/web/imagesディレクトリに格納されます。画像の格納用に別のディレクトリを指定する場合を除き、<save_images_at>要素を変更する必要はありません。
マッピング・クライアントは、<map_request>要素のformat属性(3.2.1.1項を参照)をGIF_URLまたはPNG_URLに設定することで、MapViewerが実際のマップ画像データではなく画像ファイルのURLを返すようにリクエストできます。この場合、MapViewerでは、リクエストされたマップ画像がファイルとしてMapViewerが動作するホスト・システムに保存され、画像ファイルのURLが含まれるレスポンスがマップ・クライアントに返されます。
<save_images_at>要素の属性として、次のマップ画像ファイル情報を指定できます。
file_prefix属性では、マップ画像ファイル接頭辞が指定されます。マップ画像ファイル名は、固定のファイル接頭辞の後に、シリアル番号および画像型接尾辞が続きます。たとえば、マップ画像ファイル接頭辞がomsmapである場合、考えられるGIFマップ画像ファイルにはomsmap1.gifがあります。
デフォルト値: file_prefix=omsmap
url属性では、マップ画像のベースURLが指定されます。このURLは、MapViewerホスト上ですべてのマップ画像ファイルが保存されているディレクトリを指します。マッピング・クライアントに送信されるマップ画像URLは、マップ画像のベースURLにマップ画像ファイル名を加えたものです。たとえば、マップ画像のベースURLがhttp://dev04.example.com:1521/mapviewer/imagesである場合、omsmap1.gifのマップ画像URLは、http://dev04.example.com:1521/mapviewer/images/omsmap1.gifとなります。
デフォルト値: url=$HOST_URL/mapviewer/images
path属性では、MapViewerホスト・システム上ですべてのマップ画像ファイルが保存されるディレクトリのパスが指定されます。このディレクトリは、HTTPによるアクセスが可能で、マップ画像URLと一致する必要があります。path属性で指定されたディレクトリに保存されたマップ画像ファイルは、url属性で指定されたURLからアクセスできる必要があります。
ただし、MapViewerをWebLogic Serverにデプロイする場合、path属性(../web/images)のデフォルト値は正しくありません。この場合のパス属性は、../../images,である必要があります。これは、物理的な"images"ディレクトリはmapviewer.ear/web.war/imagesであるからです。相対パスを使用すると、物理ディレクトリを解決するpath属性の値は../../imagesでなければなりません。
life属性では、生成されたマップ画像が削除されるまでに確実にファイル・システム上にとどまる分数が指定されます。life属性が指定された場合、recycle_interval属性によって、MapViewerが削除対象のファイルの有無をチェックする頻度が制御されます。
デフォルト: MapViewerでは生成済のマップ画像は削除されません。
recycle_interval属性では、life属性値の分数より長くファイル・システム上に存在する画像ファイルを削除できるかどうかをMapViewerがチェックする間隔が分数で指定されます。
デフォルト値: 480 (8時間)
MapViewerは、マップ・リクエストの他に、すべてのデータソースをリストするリクエストやデータソースを追加および削除するリクエストなどの、管理(非マップ)リクエストを受け入れます。(管理リクエストについては第7章で説明しています。)デフォルトでは、すべてのMapViewerユーザーが管理リクエストの発行を許可されています。
ただし、管理リクエストを発行できるかどうかを制限する場合には、MapViewer構成ファイルを編集し、指定したIPアドレスのユーザーからの管理リクエストのみを許可します。
管理リクエストを特定のIPアドレスのユーザーに制限するには、<ip_monitor>要素をMapViewer構成ファイルに追加します(既存の要素がコメント化されている場合は、非コメント化して変更します)。例1-2は、構成ファイルから抜粋した<ip_monitor>要素の例を示しています。
例1-2 管理リクエストの制限
<MapperConfig>
. . .
<ip_monitor>
<ips> 138.1.17.9, 138.1.17.21, 138.3.*, 20.* </ips>
<ip_range> 24.17.1.3 - 24.17.1.20 </ip_range>
<ips_exclude> 138.3.29.* </ips_exclude>
<ip_range_exclude>20.22.34.1 - 20.22.34.255</ip_range_exclude>
</ip_monitor>
. . .
</MapperConfig>
例1-2では、次のことを示しています。
次のIPアドレスは、管理リクエストを発行できるものとして明示的に含まれています(<ips_exclude>要素により除外されている場合を除く): 138.1.17.9、138.1.17.21、138.3.で始まる全アドレス、20.で始まる全アドレス、24.17.1.3から24.17.1.20の範囲内の全アドレス。
次のIPアドレスは、管理リクエストの発行から明示的に除外されています: 138.3.29.で始まる全アドレス、20.22.34.1から20.22.34.255の範囲内の全アドレス。
明示的に含まれていない他のすべてのIPアドレスは、管理リクエストを発行できません。
<ip_monitor>要素の構文に関する注意:
許可するIPアドレス(および範囲)を指定するには、<ips>要素および<ip_range>要素を使用してください。アスタリスクのワイルドカード(20.*など)を使用できます。アドレスにはカンマ区切りリストを使用します。
発行する管理リクエストからIPアドレスおよびアドレス範囲を除外するには、<ips_exclude>要素および<ip_range_exclude>要素を使用してください。アドレスが包含および除外カテゴリの両方に入る場合、このアドレスは除外されます。
<ips>要素の中でアスタリスクのワイルドカードを指定すると、<ips_exclude>要素および<ip_range_exclude>要素内で指定した場合を除き、関連するすべてのIPアドレスが含まれます。
MapViewerサーバーは、URLを介してバックグラウンド・イメージを取得したり、外部WMSサーバーに接続してそのマップ画像をフェッチしたりするために、外部Webサーバーに対してHTTP接続を実行する必要がある場合もあります。そのような場合、MapViewerサーバーとターゲットWebサーバーの間にファイアウォールが存在していると、ファイアウォールによってMapViewerがブロックされないように、MapViewerに対してHTTPプロキシ情報を指定する必要がある場合があります。次の例では、Webプロキシ情報を指定しています。
<web_proxy host="www-proxy.mycorp.com" port="80" />
MapViewerで生成される各マップの表示について、次のグローバル・ルックアンドフィール・オプションを指定できます。
タイトル
注釈(著作権の記述または脚注など)
ロゴ(カスタム・シンボルまたは企業ロゴ)
ローカル測地データ調整
子午線180度に沿ったジオメトリの分割
これらのオプションを指定するには、<global_map_config>要素を使用します。例:
<global_map_config>
<note text="Copyright (c) 2009, Example Corporation"
font="sans serif"
position="SOUTH_EAST"/>
<title text="Map Courtesy of Example Corp."
font="Serif"
position="NORTH"/>
<logo image_path="C:\\images\\a.gif"
position="SOUTH_WEST"/>
<rendering allow_local_adjustment="false"
use_globular_projection="false"/>
</global_map_config>
マップ・タイトルは、<global_map_config>要素の<title>要素を使用して設定します。また、個々のマップ・リクエストで<map_request>要素のtitle属性を指定することで、マップ・タイトルを設定できます。この場合、MapViewer構成ファイル内のグローバル・タイトルのかわりに、マップ・リクエスト内のタイトルが使用されます。<title>要素の属性については、次の点に注意してください。
text属性ではタイトル文字列が指定されます。
font属性ではフォントが指定されます。このフォントは、MapViewerが動作するシステム上に存在する必要があります。
position属性では、マップ上でのマップ・タイトルの描画位置を決定する際に、位置設定のヒントがMapViewerに提供されます。指定できる値は、NORTH、EAST、SOUTH、WEST、NORTH_EAST、SOUTH_EAST、SOUTH_WEST、NORTH_WESTおよびCENTERです。
デフォルト値: NORTH
マップの注釈は、<global_map_config>要素の<note>要素を使用して設定します。<note>要素の属性については、次の点に注意してください。
text属性では注釈文字列が指定されます。
font属性ではフォントが指定されます。このフォントは、MapViewerが動作するシステム上に存在する必要があります。
position属性では、マップ上でのマップの注釈の表示位置を決定する際に、位置設定のヒントがMapViewerに提供されます。指定できる値は、NORTH、EAST、SOUTH、WEST、NORTH_EAST、SOUTH_EAST、SOUTH_WEST、NORTH_WESTおよびCENTERです。
デフォルト値: SOUTH_EAST
マップ・ロゴは、<global_map_config>要素の<logo>要素を使用して設定します。マップ・ロゴ画像は、JPEGまたはGIFのいずれかの形式である必要があります。この画像は、ローカル・ファイル・システムに格納し、MapViewerインスタンスが画像にアクセスできるようにするか、画像のURLを指定してWebから取得できます。マップ・ロゴを指定するには、MapViewer構成ファイルで<map_logo>要素を非コメント化し、必要に応じてこの要素の属性を編集します。
<logo>要素の属性については、次の点に注意してください。
image_path属性では、有効なファイル・パス名またはhttp://で始まるURLが指定される必要があります。
position属性では、マップ上でのマップ・ロゴの描画位置を決定する際に、位置設定のヒントがMapViewerに提供されます。指定できる値は、NORTH、EAST、SOUTH、WEST、NORTH_EAST、SOUTH_EAST、SOUTH_WEST、NORTH_WESTおよびCENTERです。
デフォルト値: SOUTH_WEST
ファイアウォールの外側のURLからロゴ画像を取得する場合、MapViewerがロゴ画像を取得するためのWebプロキシの設定が必要となる場合があります。Webプロキシの指定については、第1.5.2.4項を参照してください。
また、マップ凡例を指定する場合は、凡例の位置がマップ・タイトル、注釈またはロゴの位置と同じでないことを確認してください。(マップ凡例については、2.4.2項と3.2.11項を参照してください。マップ凡例のデフォルト位置はSOUTH_WESTです。)
マップ・データ・ウィンドウが3度(10進)未満の場合、MapViewerによって測地データが表示される前に、自動的にローカルの非測地座標系に投影されるようにするには、<rendering>要素でallow_local_adjustment="true"と指定します。
MapViewerにより球面投影(つまり、世界の表示に適したマップ投影であり、具体的にはMapViewerの正距方位図法があります)が自動的に適用されるようにするには、<rendering>要素でuse_globular_projection="true"と指定します。このオプションは測地データのみに適用されます。
MapViewerで空間データに使用されるメモリー内キャッシュをカスタマイズするには、<spatial_data_cache>要素を使用します。例:
<spatial_data_cache max_cache_size="64"
report_stats="true"
/>
<spatial_data_cache>要素の属性として、次の情報を指定できます。
max_cache_size属性では、メモリー内キャッシュの最大MB数が指定されます。
デフォルト値: 64
report_stats属性は、trueに設定されている場合、MapViewerサーバーに、キャッシュ済のオブジェクト数、キャッシュ・オブジェクト全体のサイズ、内部キャッシュ構造の効率に関するデータなど、キャッシュ統計を定期的(5分ごと)に出力するように指示します。統計はデータソースおよび事前定義済テーマごとに提供されます。これはメモリー内キャッシュの最適な設定を決定する場合に役立ちます。たとえば、メモリー・キャッシュに一部のテーマについてのすべてのジオメトリ・データを確保する場合は、これらのテーマを格納するのに十分なmax_cache_size値を指定する必要があります。
デフォルト値: false
構成ファイルでこの要素がコメント化されている場合でも、空間データ・キャッシュはデフォルトで常に使用可能です。空間データのキャッシュを完全に使用不可にするには、max_cache_size属性の値を0(ゼロ)に指定する必要があります。
|
注意: 前のリリースでサポートされていたディスクベースの空間キャッシュは、必要に応じてデータベースから空間オブジェクトを直接フェッチする(つまり、キャッシュ後にキャッシュ済オブジェクトを頻繁に再取得する必要がない場合)よりも効率が悪い場合が多いことがパフォーマンス・テストでわかったため、サポートされなくなりました。 |
事前定義済テーマのキャッシュの詳細は、2.3.1.5項を参照してください。
<security_config>要素を使用すると、リクエスト内の<info_request>要素をMapViewerが拒否するかどうかを指定できます。<info_request>要素は、単純なSQL文を実行して結果行をプレーン・テキストまたはXML形式で返すようMapViewerに要求するクライアントからのリクエストのタイプです。このリクエストは、MapViewerアプリケーションがマップに表示された地物を特定したり、単純な空間検索問合せを実行したりする際によく使用されます。
ただし、MapViewerデータソース情報を公開すると、悪質な攻撃者がこの機能を乱用し、機密情報を取得するおそれがあります。これを防止するには、アクセス権が非常に制限され、機密情報以外の情報しか提供しないデータベース・スキーマにMapViewerを常に接続するよう徹底する必要があります。また、次のように<security_config>要素を指定して、<info_request>リクエストをすべて拒否することもできます。
<security_config> <disable_direct_info_request> true </disable_direct_info_request> </security_config>
ただし、この設定は、MapViewerの一部の機能に影響を与えます。たとえば、MapViewer Java APIのidentify()メソッドが機能しなくなるので、アプリケーションでは他の手段を使用して独自のidentify()メソッドを実装する必要があります。
MapViewerでは、データベースのBLOBに格納されている画像を、そのイメージ・テーマ機能を使用して表示できます。BLOBに格納されている画像データが、MapViewerにとって未知のECWのような形式である場合は、そのような画像をMapViewerが表示できるようにカスタム・イメージ・レンダラを登録することができます。カスタム・イメージ・レンダラの作成および登録については、付録Cを参照してください。
カスタム・イメージ・レンダラを指定するには、次の例のように、<custom_image_renderer>要素を使用します。
<custom_image_renderer image_format="ECW"
impl_class="com.my_corp.image.ECWRenderer" />
image_format属性では、カスタム・イメージ・レンダラと関連付ける画像形式名を指定します。
impl_class属性では、カスタム・イメージ・レンダラを実装するクラスの名前を指定します。
MapViewerでは、シェープファイルなどの外部(Oracle Spatial and Graph以外の)ネイティブ形式用に登録された空間プロバイダの実装が存在する場合、該当する形式の空間データをレンダリングできます。(カスタム・ジオメトリ・テーマに関連付けられる)外部空間データ・プロバイダの実装については、2.3.9項を参照してください。
外部空間データ・プロバイダを登録するには、次の例のように<s_data_provider>要素を使用します。
<s_data_provider
id="shapefileSDP"
class="oracle.sdovis.ShapefileDataProvider"
>
<parameters>
<parameter name="datadir" value="/temp/data" />
</parameters>
</s_data_provider>
class属性では、外部空間データ・プロバイダを実装するクラスの名前を指定します。
<parameters>要素では、該当するデータ・プロバイダがその初期化プロセスで使用する一連の初期化パラメータを指定します。この例では、シェープファイル・プロバイダのデータ・ディレクトリ・("datadir")パラメータによって、MapViewerがデータを検索するディレクトリが示されています。
テーマ・マップ層の生成時、MapViewerは外部ソースから生成される(各地域の売上高のような)非空間属性データと、データベースに格納されているベース・ジオメトリ(全地域の境界線)を結合できます。非空間データ・プロバイダの外部属性データを使用したテーマ・マッピングについては、2.3.11.1項を参照してください。
非空間データ・プロバイダを登録するには、次の例のように<ns_data_provider>要素を使用します。
<ns_data_provider id="testProvider"
class="com.mycorp.GetSalesData" >
<parameters>
<parameter name="bi_database" value="stadb32.mycorp.com" />
<parameter name="sid" value="bidata" />
</parameters>
</ns_data_provider>
id属性では、非空間データ・プロバイダを一意に指定します。このid値は、該当するプロバイダに関連するすべてのマップ・リクエストで使用します。
class属性では、非空間データ・プロバイダを実装するクラスの名前を指定します。
<parameters>要素では、非空間データ・プロバイダがその初期化プロセスで使用する一連の初期化パラメータを指定します。
<srs_mapping>要素を使用して、Oracle Spatial and Graph SDO_SRID値とEPSGコードのマッピングを定義する、SDO SRIDからEPSG SRIDへのマッピング・ファイルを指定できます。E.1.3項で説明するように、指定したマッピング・ファイルの各行には、SDO_SRID値とそれに対応するEPSGコードが含まれている必要があります。<srs_mapping>要素は、WMSテーマおよびWFSテーマで使用できます。
次の例では、<srs_mapping>要素を使用してSDO SRIDからEPSG SRIDへのマッピング・ファイルを指定しています。
<srs_mapping>
<sdo_epsg_mapfile>
../config/epsg_srids.properties
</sdo_epsg_mapfile>
</srs_mapping>
MapViewerは、Open Geospatial Consortium Web Map Server (WMS) 1.1.1に準拠したサーバーとして使用できます。そのため、WMSクライアントは、GetCapabilitiesリクエストをMapViewerに送信できます。MapViewerはリクエスト元のクライアントにとって重要な、自ら保持しているテーマのリストや、データ・プロバイダの名前、キーワードのリストなどの情報をレスポンスで返送します。
次の例のように<wms_config>要素を使用すると、GetCapabilitiesレスポンスの一部としてクライアントに返送する説明情報をカスタマイズすることができます。
<wms_config host="www.my_corp.com" port="80"
protocol="http" default_datasource="dsrc1"
public_datasources="dsrc1,dsrc2">
<title>
WMS 1.1 interface for Oracle Application Server 10g MapViewer
</title>
<abstract>
This WMS service is provided through Oracle MapViewer.
</abstract>
<keyword_list>
<keyword>bird</keyword>
<keyword>roadrunner</keyword>
<keyword>ambush</keyword>
</keyword_list>
<sdo_epsg_mapfile>
../config/epsg_srids.properties
</sdo_epsg_mapfile>
</wms_config>
host属性では、該当するMapViewerサーバーに発行される今後のWMSリクエストでクライアントが使用するサービス・リクエストURLのホスト部を指定します。
port属性では、該当するMapViewerサーバーに発行される今後のWMSリクエストでクライアントが使用するサービス・リクエストURLのポート部を指定します。
protocol属性では、該当するMapViewerサーバーに発行される今後のWMSリクエストでクライアントが使用するサービス・リクエストURLのプロトコル部を指定します。
default_datasource属性は、機能レスポンスの取得に使用される基本データソースを指定します。この属性が定義されていない場合、データソースWMSが使用され、そのデータソースがこのMapViewerサーバーに存在する必要があります。
public_datasources属性では、GetCapabilitiesレスポンスでどのデータソース・コンテンツをリストするかを指定します。この属性が定義されていない場合、すべてのデータソース・コンテンツがリストされます。
<title>要素では、レスポンスの一部として含めるサービス・タイトルを指定します。
<abstract>要素では、レスポンスの一部として含める概要を指定します。
<keyword_list>要素では、該当するMapViewerサーバーによってサービスが提供される層のタイプを最もよく表現するキーワードのリストを指定します。
<sdo_epsg_mapfile>要素では、Oracle Spatial and Graph (SDO) SRID値から対応するEPSG SRID値へのマッピングを定義するテキスト・ファイル(通常はほとんどのWMSリクエストおよびレスポンスで使用される)を指定します。このマッピング・ファイルについては、E.1.3項を参照してください。
MapViewerのOracle Maps機能では、ベース・マップ画像タイルを事前に生成し、マップ・タイル・サーバーを使用してそれらをキャッシングすることができます。<map_tile_server>要素を使用すると、次の例のように、マップ・タイル・ファイルのデフォルトの格納先やログ情報などの構成情報をマップ・タイル・サーバーに提供できます。
<map_tile_server>
<tile_storage default_root_path="/scratch/tilecache/" />
<logging log_level="finest" log_thread_name="false" log_time="true">
<log_output name="System.err"/>
</logging>
</map_tile_server>
<tile_storage>要素では、該当するMapViewerサーバーによって生成されるすべてのマップ画像タイルが格納されるデフォルトのルート・ディレクトリを指定します。
<logging>要素では、マップ・タイル・サーバーに固有なログ情報を指定します。
すべてのマップ・リクエストには、地理空間データを持つデータベース・ユーザーである、マップ・データソースを指定するデータソース属性が必要です。使用可能なマップ・データソースを事前定義するには、<map_data_source>要素を使用します。例:
<map_data_source name="mvdemo"
jdbc_host="mapsrus.us.oracle.com"
jdbc_sid="orcl"
jdbc_port="1521"
jdbc_user="scott"
jdbc_password="!password"
jdbc_mode="thin"
number_of_mappers="5"
allow_jdbc_theme_based_foi="true"
plsql_package="web_user_info"
/>
<map_data_source>要素の属性として、次の情報を指定できます。
name属性では、MapViewerに対して一意のデータソース名を指定します。データソースを識別するすべてのマップ・リクエストで、データソース名を指定する必要があります。
必要なすべての接続情報、コンテナ・データソース名またはネット・サービス名(TNS名)のいずれかを指定する必要があります。つまり、jdbc_host、jdbc_sid、jdbc_port、jdbc_user、またはcontainer_ds、またはjdbc_tns_nameのうちどれか1つのみを指定する必要があります(いずれもこの項で説明します)。
データソースを定義したデータベースを再起動して、そのデータソースがjdbc_host/jdbc_sid/jdbc_port属性またはjdbc_tns_name属性から作成される場合、データベースがオンラインに戻り次第、MapViewerは通常の動作(たとえば、マップ・リクエストに正しく作成されたマップで応答するなど)を再開します。
jdbc_host、jdbc_sid、jdbc_portおよびjdbc_user属性では、データベース接続情報およびデータベース・ユーザー名を指定します。(これらの属性と、jdbc_password属性およびjdbc_mode属性を指定するかわりに、この項で後述するように、container_ds属性を指定することもできます。)
jdbc_password属性では、データベース・ユーザーのログイン・パスワードを指定します。初めてパスワードを指定する場合は、先頭に感嘆符(!)を付ける必要があります。次のMapViewerの再起動時に、クリア・テキスト・パスワードは自動的に不明瞭化され、置き換えられます。
MapViewerによってこのパスワード文字列が変更されることはありません。大文字または小文字の変換も行われません。データベースで大/小文字を区別したパスワードが使用される場合は、指定したパスワードがデータベースのパスワードと完全に一致する必要があります。
jdbc_mode属性では、データベースに接続する際に使用するOracle JDBCドライバがMapViewerに通知されます。デフォルトはthin(シン・ドライバ)です。その他の可能な値はoci8です。この場合、MapViewerが動作するホスト上にOracle Databaseクライアントもインストールされている必要があります。
container_ds属性を使用すると、jdbc_host属性、jdbc_sid属性、jdbc_port属性、jdbc_user属性、jdbc_password属性およびjdbc_mode属性を指定するかわりに、(ejb-location属性値の) Java EEコンテナ名を指定できます。たとえば、OC4Jのスタンドアロン・インスタンスのdata-source.xmlファイルで<data_source>要素にejb-location="jdbc/OracleDS"が含まれているとします。この場合、この項の初めにある例を使用するかわりに、永続MapViewerデータソースを次のように定義できます。
<map_data_source name="mvdemo"
container_ds="jdbc/OracleDS"
number_of_mappers="5"
/>
MapViewer構成ファイルのcontainer_ds属性を使用するには、OC4Jインスタンスを-userThreadsオプションを指定して起動する必要があります。MapViewerはその構成ファイルを別のユーザー・スレッドで処理します。-userThreadsオプションを指定しない場合、ユーザー・スレッドでコンテナのコンテキスト情報を使用できません。ただし、MapViewer管理ページを使用してデータソースを動的に定義する場合は、-userThreadsオプションを指定してOC4Jインスタンスを起動したかどうかにかかわらず、container_ds属性を使用できます。
container_ds属性を使用していて、データソースを定義したデータベースを再起動したらすぐにMapViewerが通常の動作(たとえば、マップ・リクエストに正しく作成されたマップで応答するなど)を自動的に再開するようにする場合、アプリケーションに戻される前に接続を常に検証するように、コンテナ・データソースに指示する必要があります。このオプションがサポートされているかどうか、またサポートされている場合には有効化する方法を、ミドルウェアのドキュメントで確認してください。
jdbc_tns_name属性では、tnsnames.oraファイルで定義されているネット・サービス名を識別します。
number_of_mappers属性では、このデータソースで使用可能なマップ・レンダラの最大数(つまり、このデータソースでMapViewerが同時に処理できるマップ・リクエストの最大数)を指定します。未処理のマップ・リクエストはキューに入れられ、最終的には処理されます。たとえば、この値が3の場合、MapViewerでは最大3つのマップ・リクエストを同時に処理できます。3つのリクエストの処理中に送信された4つ目のマップ・リクエストは、MapViewerが現在のリクエストのいずれかの処理を完了するまで待機します。
number_of_mappersに大きな値(50、100など)を指定すると、全体的なスループットを向上できますが、MapViewerがより多くの同時マップ・リクエストを処理しようとするため、ピーク負荷時のランタイム・メモリーとCPU使用率も増加させることになります。これは、アクティブなデータベース・セッションの数も増加させます。したがって、この属性にあまり大きな数値を設定しないようにしてください。
|
注意: 廃止されるmax_connections属性は、レンダリングに影響を与えなくなり、無視されます。number_of_mappers属性の値は、データソースに対して常にオープンになっているデータベース接続またはセッションの実際の最大数に影響を与えます。 |
allow_jdbc_theme_based_foi属性を使用すると、該当するデータソースに対するJDBCテーマベースのFOIリクエストの実行を許可するかどうかを指定できます。JDBCテーマベースのFOIリクエストは、JavaScriptクライアント・アプリケーションによって作成された動的SQL問合せに基づくものです。
デフォルトでは、そのようなFOIリクエストは、この属性をtrueに設定しないかぎり、許可されません。セキュリティ侵害のおそれがあるため、JDBCテーマベースのFOIリクエストは注意して使用する必要があります。JDBCテーマベースのFOIリクエストは、非常に低い権限しか付与されず、公開対象のデータしか含まれないデータベース上でのみ許可してください。JDBCテーマベースのFOIリクエストの詳細は、8.3.1.3項を参照してください。
plsql_package属性では、セキュアなマップ・レンダリング用に使用するPL/SQLパッケージを指定できます(1.8項を参照)。
web_user_type属性(この項の例には表示されていません)を使用すると、認証済ユーザー名のソースを指定できます。これは、セキュアなソース・レンダリングで使用するPL/SQLパッケージの指定とあわせてCookieから認証済ユーザー名を取得する場合に特に有効です。web_user_type属性および使用例の詳細は、1.8.2項を参照してください。
MapViewerの構成方法だけでなく、MapViewer管理ページを使用したその他の重要な管理タスクの実行方法も知っておく必要があります。MapViewer管理ページへのログイン方法については、1.5.1項を参照してください。
MapViewer管理者として実行できるタスクには、次のようなものがあります。
構成ファイルの編集
「Manage MapViewer」、「Configuration」の順にクリックします。
動的データソースの作成
「Manage MapViewer」、「Datasources」の順にクリックします。適切なパラメータを入力した後、「Submit」をクリックします。
データソースのリストのリフレッシュ
「Manage MapViewer」、「Datasources」の順にクリックします。「Refresh」をクリックします。
MapViewerのスタイル、テーマ、およびベース・マップのキャッシングされた定義の消去
「Manage MapViewer」、「Datasources」の順にクリックします。データソースを選択した後、「Purge Cached Metadata」をクリックします。
事前定義済テーマからのキャッシュされたジオメトリ・データの消去
「Manage MapViewer」、「Geometry Cache」の順にクリックします。「Purge Cached Geometries」の下で、データソースを選択し、「Submit」をクリックします。
Oracle Mapsのマップ・タイル層の作成
「Manage Map Caches」、「Create」の順にクリックします。マップ・ソース・タイプに対して「Internal」または「External」を選択し、「Continue」をクリックします。
「Internal」マップ・ソース: マップ・キャッシュ名を入力した後、データソースとベース・マップを選択します。また、キャッシュ記憶域(タイルの格納先)、ズーム・レベル、最小および最大スケール、空間参照ID (SRID)、データ枠ボックス(MBR)、およびタイルのサイズと形式のパラメータも定義します。「Submit」をクリックして、マップ・タイル層を作成します。また、「XML」をクリックし、XMLでマップ・キャッシュ・プロパティを定義することもできます。
「External」マップ・ソース: マップ・キャッシュ名を入力した後、データソースを選択します。外部ソースにアクセスするには、マップ・サービスURL、リクエスト・メソッド(GETまたはPOST)、プロキシ情報(必要な場合)、サーバー上のJavaアダプタ・クラス名とその位置、アダプタのその他のプロパティなどのパラメータを定義します。また、キャッシュ記憶域(タイルの格納先)、ズーム・レベル、最小および最大スケール、空間参照ID (SRID)、データ枠ボックス(MBR)、およびタイルのサイズと形式のパラメータも定義します。「Submit」をクリックして、マップ・タイル層を作成します。また、「XML」をクリックし、XMLでマップ・キャッシュ・プロパティを定義することもできます。
Oracle Mapsのマップ・タイル層の管理
「Manage Map Caches」、「Manage」の順にクリックします。その後、次のいずれかの操作を実行します。
マップ・キャッシュをリフレッシュするには、「Refresh」をクリックします。
マップ・タイル層を編集するには、「Existing Map Tile Layers」の下のデータソースを選択します。キャッシュ・レベルでは、キャッシュの削除、キャッシュ詳細の表示およびキャッシュのオフライン/オンラインの切り替えを実行できます。タイル・レベルでは、タイルの消去、プリフェッチ、リフレッシュ、ズーム・レベルの指定、枠ボックスの指定などの操作を実行できます。
リクエストのステータスをチェックするには、リクエストIDを入力し、「Submit」をクリックします。
データベースがOracle Real Application Cluster (Oracle RAC)である場合、このデータベースに直接接続するMapViewerデータソースは作成できません。かわりに、MapViewerはJava EEコンテナのデータソースを介してOracle RACデータベースに接続する必要があります。MapViewerがOracle RACデータベースに接続できるようにするには、次の手順を実行します。
対象のOracle RACデータベースにOC4Jレベルで接続するJDBCデータソースを作成します(1.6.1項を参照)。このデータソースは、JNDIルックアップを利用してMapViewerなどのアプリケーションで使用できます。
Oracle RACデータソースのJNDIロケーションをパブリッシュするようにOC4Jインスタンスを構成し、MapViewerがそのロケーションにアクセスできるようにします(1.6.2項を参照)。
構成ファイル内のJNDIロケーションを利用してコンテナ・データソースを再利用するMapViewerデータソースを定義します(1.6.3項を参照)。
MapViewerを再起動します。
Oracle Fusion Middlewareの完全インストールまたはスタンドアロンのOC4Jインストールを行った場合は、Oracle Enterprise Managerを使用して、Oracle RACデータベースに接続するデータソースを作成します。たとえば、Oracle Application Serverリリース10.1.3以上を使用している場合、Enterprise Managerにログインし、MapViewerサーバーを格納しているOC4Jインスタンスに移動して「管理」タブをクリックし、さらに「JDBCリソース」の「タスクに移動」リンクをクリックして、新しいデータソースの作成を開始します(図1-9を参照)。
Oracle RACデータベースに接続するためのデータソースの作成方法の詳細は、『Oracle Application Server管理者ガイド』を参照してください。
データソースを作成したら、Enterprise Managerを使用して接続をテストする必要があります。該当する接続の「接続テスト」アイコンをクリックします(図1-10を参照)。
「JNDIロケーション」の値(図1-10ではjdbc/mvdemods)をメモしておくようにしてください。MapViewerデータソースを作成するときにこの値が必要になります(1.6.3項を参照)。
JNDIロケーション(たとえば新規作成したデータソースのJNDIロケーション)がすべてのユーザー・スレッドにパブリッシュされるようにOC4Jインスタンスを構成するには、userThreadsオプションを指定する必要があります。このオプションを指定しないと、MapViewerは対象のデータソースを参照するJNDIロケーションにアクセスできません。OC4Jのデフォルト設定では、OC4J自体が動作するメイン・スレッドでしかこのようなJNDIロケーションを利用できないようになっているためです。しかし、MapViewerは別のユーザー・スレッドで起動されます。
userThreadsオプションを指定するメカニズムは、スタンドアロンのOC4Jインスタンスを使用しているか、Oracle Fusion Middlewareの完全インストールを使用しているかによって異なります。
スタンドアロンのOC4Jインスタンスの場合は、次の例のように-userThreadsオプションを指定してOC4Jインスタンスを起動する必要があります。
java –jar oc4j.jar –userThreads
Oracle Fusion Middleware 10gR3の完全インストールの場合は、Javaの起動パラメータが$OAS_HOME/opmn/conf/opmn.xml構成ファイルに定義されます。(opmnは、OC4Jインスタンスなどの各種Oracle Fusion Middleware 10gR3コンポーネントを起動および停止するマスター・プロセスです。)
このファイルでは、MapViewerを実行するOC4JインスタンスのJava JVM起動パラメータを指定できます。たとえば、MapViewerをhome OC4Jインスタンスにデプロイした場合、次の例のように-Doc4j.userThreads=trueというテキストを追加します。
<ias-component id="OC4J">
<process-type id="home" module-id="OC4J" status="enabled">
<module-data>
<category id="start-parameters">
<data id="java-options" value="-server
-Djava.security.policy=$ORACLE_HOME/j2ee/home/config/java2.policy
-Djava.awt.headless=true -Dhttp.webdir.enable=false
-Doc4j.userThreads=true"/>
</category>
...
opmn.xmlファイルを編集して保存したら、userThreadsオプションを有効にするためにOC4Jインスタンスを再起動する必要があります。正しく機能しない場合は、Oracle Fusion Middleware 10gR3を再起動します。OC4JインスタンスまたはOracle Fusion Middleware 10gR3の再起動については、『Oracle Application Server管理者ガイド』を参照してください。
データベースへの接続が可能な新しいMapViewerデータソースを作成するには、MapViewerデータソースのcontainer_ds属性を使用します。具体的には、mapViewerConfig.xmlファイルに次のようなエントリを追加します。
<map_data_source name="mvdemo"
container_ds="jdbc/mvdemods"
number_of_mappers="7" />
この例の内容は、次のとおりです。
name属性では、マップ・リクエストに必要となるMapViewerデータソース名を指定します。
container_ds属性の値は、Oracle RACコンテナ・データソースの作成時にメモしておいたJNDIロケーションの文字列と一致する必要があります(1.6.1項を参照)。
number_of_mappers属性では、このデータソースをターゲットにできる、サポートされる同時マップ・リクエストの最大数を指定します。
name属性およびnumber_of_mappers属性の詳細は、1.5.2.14項を参照してください。
データソース定義を追加したら、新しいデータソースが作成されるようにするためMapViewerを再起動する必要があります。その後、このデータソースからマップ・リクエストを発行するたびに、MapViewerではコンテナから必要なデータベース接続を取得してから処理を続行します。
|
注意: この項は、MapViewerでOracle Fusion Middlewareの高可用性機能をフルに利用する上級ユーザーを対象としています。ユーザーには高可用性機能についての十分な理解が必要です。高可用性機能については、『Oracle Fusion Middleware高可用性ガイド』を参照してください。 |
MapViewerのユーザーは、Oracle DatabaseおよびOracle Fusion Middlewareの高可用性機能を利用できます。
複数のプロセスを持つOracle Fusion MiddlewareのOC4Jインスタンスに、MapViewerを安全にデプロイできます。Oracle Fusion Middlewareでは、各OC4Jインスタンスで起動可能な実際のプロセス(JVM)の数を構成できます。マルチプロセッサ・ホストでは、1つのOC4Jで複数のプロセスを起動すると、システム・リソースをより有効に利用できます。(10g リリース2 (10.1.2)より前のリリースのMapViewerではこの機能を利用できないため、そのようなOC4Jインスタンス上にはデプロイできません。)
MapViewerが複数のプロセスを持つOC4Jインスタンスにデプロイされると、各プロセスの内部でMapViewerサーバーが稼働します。これらのMapViewerサーバーはすべて同じホスト上に存在しますが、異なるJavaプロセスで稼働します。このOC4Jインスタンスに送信されたマップ・リクエストは、個々のMapViewerサーバーに自動的にディスパッチされます。MapViewerサーバーでは、最初に異なるMapViewerサーバーが起動された場合(つまり、サーバーを含むOC4Jインスタンスが起動された場合)に名前を調整し、一意のネーミング方法に従ってマップ画像ファイルを生成します。これにより、2つのMapViewerサーバーによって、同じファイル名を持つマップ・ファイルが同じ順序で生成されることがなくなります。
異なるOracle Fusion Middleware 10gR3インストールのOC4Jインスタンスは、1つのアイランドにクラスタ化できます。これは、中間層のフェイルセーフ・オプションとなります。MapViewerは、1つのOC4Jアイランドにデプロイできます。ただし、各ホストで生成された画像ファイルの命名方法およびクライアント・アプリケーションによるURLでの参照方法には注意する必要があります。
次の例を検討します。マップ・リクエストがフロントWebサーバーに送信されると、リクエストはホストAで稼働しているMapViewerサーバーに届けられます。ホストAのMapViewerからは生成されたマップ画像のURLが返信され、クライアントは実際の画像をフェッチするために2番目のリクエストを送信します。この2番目のリクエストはホストBで稼働しているOC4Jコンテナで受信されますが、このコンテナにはそのような画像がありません(あるいは、同じ名前の間違った画像が返されます)。
どのような環境でも、この問題に対する最善の解決策はありません。1つの選択肢として、異なるホストで稼働する異なるMapViewerサーバーによってマップ画像が同一の仮想(ネットワーク化された)ファイル・システムに置かれるように、ホストで共通のネットワーク・ストレージを共有する方法があります。画像を異なるサブディレクトリに置いたり、画像に異なるファイル接頭辞を付けたりするため、MapViewerインスタンスごとに、マップ・ファイル・ストレージ情報(1.5.2.2項を参照)を構成する必要があります。この情報を構成しない場合、複数のMapViewerサーバーによって生成された画像ファイルが、ディスク上で互いを上書きする可能性があります。マップ・ファイル・ストレージ情報を適切に構成すると、クライアントに返された各URLにより、ネットワーク・ドライブ上で確実に正しいマップが一意に識別されます。
ネットワーク・ドライブを使用できない場合は、ロード・バランサの使用を検討してください。各MapViewerインスタンスで、確実に一意性を保つための適切な方法を使用して、生成された画像ファイルに名前を付けるため、まずMapViewerインスタンスごとに、マップ・ファイル・ストレージ情報を構成する必要があります(前のパラグラフを参照)。これで、URLがあるパターン(指定したマップ画像ファイル接頭辞を含むなど)に一致する場合に画像リクエストを特定のホストにリダイレクトするルールを、ロード・バランサで指定できます。
この項では、Webユーザーの識別情報に基づいてセキュアなマップ・レンダリングを実装する方法について説明します。同じテーマを表示するときでも、ユーザー各自のロールや権限に応じて、表示される地物のセットを変えることができます。基本的な考え方は、Webユーザーがテーマを利用するためにデータベースにアクセスする場合、MapViewerでは常に特定のPL/SQLパッケージを起動してそのユーザーの識別情報をデータベース内に設定するというものです。このユーザー情報は、データ・アクセス制御を行うためにデータベースで使用されます。
|
注意: この項では、「ユーザー」および「認証済ユーザー」という用語は、Oracle Fusion MiddlewareまたはOracle Single Sign-On (SSO)にログインするアプリケーションまたはWebユーザーを意味します。これは、データベース・ユーザーとは異なります。MapViewer自体は、すべての地理空間データが格納されているデータベース・スキーマに直接接続します。 |
MapViewerは、すべての地理空間データが格納されているデータベース・スキーマに直接接続します。このスキーマ内のデータについて、MapViewerのアクセス制御を実施するには、次の手順を実行する必要があります。
データベース・スキーマにPL/SQLパッケージを作成します。このパッケージには、少なくともset_user(username)およびclear_user()という2つのプロシージャを含める必要があります。
PL/SQLパッケージに格納されるユーザー識別情報に基づき(この情報は、データベース・セッションごとにset_userプロシージャを使用してMapViewerによって設定されます)、ビューの作成、データベース・オブジェクトに対するアクセス権の設定、およびその他のタスクを実行します。
スキーマに対するMapViewerデータソースを作成し、データソース定義の一部としてPL/SQLパッケージの名前を指定します。これがセキュアなデータソースとみなされます。
ステップ2で作成したビューを基にしてMapViewerテーマを作成します。
MapViewerアプリケーションのページにアクセスするユーザー用のWeb認証を設定し、マップ・リクエストがMapViewerサーブレットに届いたときに、Webセッション・オブジェクトに認証済ユーザーの識別情報が含まれるようにします。
ステップ4で定義したテーマを表示するマップ・リクエストまたはFOI(対象地物)リクエストを、直接発行するか、またはベース・マップとOracle Mapsを使用して発行します。
MapViewerでは、PL/SQLパッケージを使用してユーザー識別情報をデータベースに自動的に渡した後、これらのテーマに関する問合せを実行します。識別されたユーザーに対して表示可能な行のみがデータベースから返されて、MapViewerによってレンダリングされます。
1.8.1項では、セキュアなマップ・レンダリングが機能する仕組みについて説明し、実装の詳細といくつかの例を紹介します。1.8.3項では、ユーザー認証のオプションおよび付属のデモについて説明します。
MapViewerは、Java EEアプリケーションとして、Oracle Fusion MiddlewareまたはOracle Single Sign-On (SSO)で認証済であるWebユーザーの識別情報を取得できます。このユーザー情報はデータベースに送ったり保存したりできます。データベースでは、このユーザー識別情報に基づいて、マップ層や表へのセキュア・アクセスを設定できます。たとえば、データベース管理者(DBA)は、特定のユーザーに対して表示できる空間地物のみを選択する実表のビューを作成することが可能です。
Oracle Fusion MiddlewareまたはOracle Single Sign-On (SSO)からデータベースにWebユーザーの識別情報を渡すには、データベースにユーザー識別情報を設定するセキュアなPL/SQLパッケージを使用します。このPL/SQLパッケージは、DBAまたはアプリケーション開発者が作成し、データソース・スキーマにインストールします。このようなパッケージには、プロシージャやファンクションをいくつ含めてもかまいませんが、少なくとも次の2つのプロシージャは必ず含める必要があります。
set_user(username)
clear_user()
セキュアなデータソースからテーマがリクエストされると、MapViewerでは、関連するPL/SQLパッケージのset_userプロシージャを起動した後でそのテーマに対するデータの問合せを実行します。テーマに対する問合せプロセスが完了すると、MapViewerはclear_userプロシージャを起動します。
例1-3に、セキュアなマップ・レンダリング用として使用できるPL/SQLパッケージを示します。このパッケージは、MVDEMOサンプル・スキーマで作成できます。
例1-3 セキュアなマップ・レンダリング用のPL/SQLパッケージ
CREATE OR REPLACE PACKAGE web_user_info
AS
PROCEDURE set_user (p_name IN VARCHAR2);
PROCEDURE clear_user;
FUNCTION get_user
RETURN VARCHAR2;
END;
CREATE OR REPLACE PACKAGE BODY web_user_info
AS
w_name VARCHAR2 (32767);
PROCEDURE set_user (p_name IN VARCHAR2)
AS
BEGIN
w_name := LOWER (p_name);
END;
PROCEDURE clear_user
AS
BEGIN
w_name := null;
END;
FUNCTION get_user
RETURN VARCHAR2
AS
BEGIN
RETURN w_name;
END;
END;
/
例1-3では、set_userとclear_userが必須の2つのメソッドで、get_userは、ビューを作成したり他のデータ・アクセスを制御したりするために使用できる便宜的なファンクションです。
このパッケージ(基本的に現行のデータベース・セッションに対するユーザー識別情報を含む)を作成した後、このユーザー情報を使用する複雑な仮想プライベート・データベースを設定できます(Oracle Virtual Private DatabaseまたはVPDの詳細は、『Oracle Databaseセキュリティ・ガイド』を参照)。ただし、わかりやすくするため、この項ではVPDの作成については扱わず、このユーザー情報を使用してデータ・アクセス制御を行うビューを作成できることのみを示します。
たとえば、MVDEMOサンプル・スキーマ内の既存のCUSTOMERS表にACCOUNT_MGRという列を追加して、この表に格納されている各顧客にアカウント・マネージャを割り当てることができます。次に、特定のアカウント・マネージャに対して顧客の行のみを返すビューを作成します(例1-4を参照)。
例1-4 セキュアなマップ・レンダリング用のビュー
CREATE OR REPLACE VIEW customers_view AS SELECT * FROM customers WHERE account_mgr = web_user_info.get_user;
このビューを基にして、アカウント・マネージャがログインして顧客データをマップ上に表示する場合に、各自の担当する顧客しか表示されないようなMapViewerテーマを定義することが可能になります。
PL/SQLパッケージをインストールしたら、データソース定義の一部として、plsql_package属性を使用してこのパッケージの名前をMapViewerに渡すことができます(例1-5を参照)。
例1-5 セキュアなマップ・レンダリング用のデータソース定義
<map_data_source name="mvdemo"
jdbc_host="stadb32.us.oracle.com"
jdbc_sid="mv"
jdbc_port="15214"
jdbc_user="mvdemo"
jdbc_password="password"
jdbc_mode="thin"
number_of_mappers="3"
allow_jdbc_theme_based_foi="true"
plsql_package="web_user_info"
/>
データソース定義にPL/SQLパッケージ名を指定すると、MapViewerは該当するデータソースをセキュアなデータソースとしてフラグ付けし、このデータソースでテーマの問合せを実行するときは常に、パッケージのset_userプロシージャおよびclear_userプロシージャを自動的に起動します。
認証済ユーザー情報は、Java EEやOSSOのセッションからMapViewerに渡されない場合があります。MapViewerをApplication Express (APEX)内に統合したときなどがそうですが、この場合、認証がAPEXにより行われるため、Java EEやOSSOのセッションからユーザー名を取得できません。この問題を回避するため、MapViewerではCookieからのユーザー名の取得もサポートしています。認証済ユーザー名を保持するためのAPEX内のCookieの設定は、各自の責任において行ってください。
指定したCookieからMapViewerがユーザー名を確実に取得するようにするには、データソース定義にweb_user_type属性を(必須のplsql_package属性に加えて)指定する必要があります。たとえば、MapViewerでMON_USERという名前のCookieからユーザー名を取得する場合は、セキュアなデータソース定義は例1-6のようになります。
例1-6 Cookie名を指定するデータソース定義
<map_data_source name="mvdemo"
jdbc_host="stadb32.us.oracle.com"
jdbc_sid="mv"
jdbc_port="25650"
jdbc_user="mvdemo"
jdbc_password="LfCDQ6NH59nuV7zbeY5QY06sqN7XhiUQ"
jdbc_mode="thin"
number_of_mappers="3"
allow_jdbc_theme_based_foi="true"
plsql_package="web_user_info"
web_user_type="MON_USER"
/>
web_user_type属性に使用できる値は次のとおりです。
J2EE_USER: Java EEセッションから認証済ユーザー名を取得するようMapViewerに指示します。
OSSO_USER: OSSOセッションから認証済ユーザー名を取得するようMapViewerに指示します。
<cookie-name>: 指定した名前のCookieから認証済ユーザー名を取得するようMapViewerに指示します。Cookie名は大/小文字が区別されません。
web_user_type属性が指定されていない場合、MapViewerではユーザー名をまずJava EEセッションで検索し、見つからない場合はOSSOセッションで検索します(存在する場合)。
ユーザーをいつ、どこで、どのように認証するかは、アプリケーションの要件やインストールのセットアップに応じて異なります。たとえば、次のようなオプションがあります。
MapViewerをエンタープライズ・ポータル・サイトの一部としてデプロイし、エンド・ユーザーがMapViewerを利用してマッピング機能を実行する前に、最初に必ずこのポータルにログインするようにします。
MapViewerを別のシステムにデプロイし、中央のOracle SSOサーバーでユーザーを認証するようにします。
MapViewerに届くHTTPリクエストに認証済のユーザー情報が含まれているかぎり、MapViewerはそのリクエストをデータベースに渡すことができ、セキュアなデータ・アクセス方法は想定どおりに機能します。
MapViewer付属のデモ・ファイル(1.9項を参照)には、単一のマッピング・ページに認証済ユーザーしかアクセスできないように制限するための説明および関連するファイルが含まれています。このデモを使用する際は、MapViewerのデプロイ・ファイルに簡単な変更を加えます。この場合、この保護されたページがユーザー認証を行うためのエントリ・ポイントとなり、MapViewerを実行するOC4Jインスタンスによって認証が実行されます。
いくつかのMapViewerデモおよびチュートリアルは、mvdemo.earという名前の別のアプリケーション・アーカイブに含まれており、このアーカイブは、mapviewer.earのデプロイ先と同じJava EEコンテナにデプロイされます。
これらのデモとチュートリアルは、一度デプロイすると、http://host:port/mvdemo/という形式のURLからアクセス可能になります。
また、次の場所から入手可能なリソースも参照してください。
http://www.oracle.com/technetwork/middleware/mapviewer/downloads/
