ENGLISH VERSION

GLOBALBASE PROJECT POWERED BY HIROHISA MORI
ホーム

GLOBALBASEとは？ トピックス ダウンロード ドキュメント 実例とリンク
 
ver.B リリースノート
GLOBALBASEガイドブック
COSMOSマニュアル
LANDSCAPEマニュアル
開発情報
文献情報
GLOBALBASEマニュアル集 >> LOCALBASEセットアップマニュアル
2007-11-04版

LOCALBASEセットアップマニュアル

著者:　森　洋久 / joshua＠globalbase.org 　※　中島　智人 / nakajima＠zeta.co.jp / 株式会社ゼータ 　※　

* 目的と概要
* このマニュアルを読むために必要な知識
* 前提となるシステム用件
* HTTP-GATEWAYとgbviewエージェントの動き
* HTTP-GATEWAYの表示スタイル
* LOCALBASE編集機能
* LOCALBASEサーバの構成に関する注意事項
* LOCALBASEのデフォルトのインストール方法(閲覧システムのみ)
* アップデートの方法
* プロットデータ編集機能のインストール
* 複数の異なる設定のHTTP-GATEWAYとgbviewをつなぐ方法
* トラブルシューティング
* 履歴

目的と概要

WWWからGLOBALBASEのコンテンツを閲覧可能にするLOCALBASEのセットアップ方法について説明する。LOCALBASEはGLOBALBASEがわの gbviewエージェント 、および、 WWW側のHTTP-GATEWAY の組み合せで実現される物であり、詳しくは、両方のリファレンスマニュアルを参照してください。

▲ページトップへ戻る

このマニュアルを読むために必要な知識

このマニュアルを読む場合には、 xlスクリプト および、 xlサーバ の知識を必要とします。また、GLOBALBASEの座標系の検索、重ね合わせの原理について概略をわかっている必要があります。デフォルトのインストールはそれほど完璧な知識を求めません。これらお他のエージェントなどのマニュアルを片手に、デフォルトのインストールからステップバイステップで、徐々に知識を増やして行くことをお勧めします。これらの技術的理解については、 GLOBALBASE技術資料 [UNDEF REF (GLOBALBASE-tech)]を参照してください。サーバの知識などに薄い場合は、 COSMOS GLOBALBASE VIEWER を動かしてみることをお勧めします。

また、HTTP-GATEWAYはWWW上で動作します。また、ほんシステムはapacheを想定しているのでapacheの知識が必要です。 以下の関連知識を持っている事を前提として記述されています。
  1. XML記述用語に関する知識
  2. 初歩的なperlスクリプトに関する知識
  3. 初歩的なCGIに関する知識
  4. 初歩的なHTTPに関する知識
  5. 初歩的なHTMLに関する知識


▲ページトップへ戻る

前提となるシステム用件

▲ページトップへ戻る

HTTP-GATEWAYとgbviewエージェントの動き

図　HTTP-GATEWAYの構造


図(HTTP-GATEWAYの構造)にGLOBALBASEのコンテンツをWWWブラウザで閲覧可能にするために必要なシステムの概要を示した。

HTTPゲートウェイはWWWブラウザからのHTTPによる地図や巨大画像表示リクエストに応じて、GBサーバ群をアクセスし、重ねあわせ処理をし、クライアント側に結果を返す仕組みでる。

ゲートウェイは２つのフェーズからなる。一つはクライアントの要求をHTTPにより受け止め、スタイルの設定などを行う、HTTPフェーズ。これは、WWWサーバ上で動作する。一方、実際にGBサーバをアクセスし、地図を重ねあわせ処理をするGBVIEWフェーズである。HTTPフェーズはapacheなどのWWWサーバ上で動作する。一方、GBVIEWフェーズは、GLOBALBASEサーバ掾で動作する。 xlsvエージェント は、HTTPによる画像などのリクエストをXLスクリプトに変換し、バックで動作している、当該gbviewエージェントへ引き渡す。gbviewエージェントは引き渡されたXLスクリプトを解釈実行し、結果をxlsvへ返す。xlsvはそれを、HTTPの返答へ変換し、WWWサーバやブラウザへ返す。

▲ページトップへ戻る

HTTP-GATEWAYの表示スタイル

ver.B.b16.11より、様々なカラフルなHTTP-GATEWAYスタイルを準備しています。LANDSCAPEインストール後、/usr/local/xl-gbs/xlsamples/www/gateway/packagesの下にいくつかのディレクトリが用意されており、選ぶことができます。以下にその例を示します。このディレクトリの下に、old/skeleton, aqua/black といった形でディレクトリが作ってあり、それらのディレクトリ名が、図の名前となっています。

とりあえず、細かい設定はおいておいて、これらのディレクトリを、Apacheの公開用ディレクトリの下へコピーすると、テンプレートにすでに設定されている地図のページを作ることがd家います。HTTP-GATEWAYの動きを理解するために１度この方法をとってみるのもよいと思います。たとえば、以下のようにコピーしますと、 

cp /usr/local/xl-gbs/xlsamples/www/gateway/packages/aqua/blue /var/www/html/hogehoge/gateway

この場合、http://www.yourwwwserverdomain/hogehoge/gateway/main.html を参照すると、地図画像がみられます。

/var/www/html/hogehoge/gatewayの中にある、server_conf.plはどの中LADNSCAPEサーバを中継してGLOBALBASEの地図を得るかが記載されています。client_conf.xmlは画面構成をどのようにして、どのような地図を重ね合わせるかを指定します。

さらに詳細なインストール方法は、 「LOCALBASEのデフォルトのインストール方法(閲覧システムのみ)」にそってインストールしてください。


図　aqua/black





図　aqua/red





図　aqua/blue





図　aqua/green


また、この４つを動かしているサンプルページを用意しました。以下のページをアクセスして参考にしてください。
  1. BLACK
  2. BLUE
  3. GREEN
  4. RED


▲ページトップへ戻る

LOCALBASE編集機能

LOCALBASEには、簡単なプロットデータの編集機能がついています。本マニュアルでは、編集機能のインストール方法も説明します。インストール後の編集機能の利用方法に関しては、 文献「LOCALBASEユーザインタフェース・マニュアル」を参照してください。

▲ページトップへ戻る

LOCALBASEサーバの構成に関する注意事項

前述のように、LOCALBASEはGLOBALBASEとHTTP-GATEWAYの両方を立ち上げる必要があります。また、クライアントとなるWWWブラウザはHTTPのプロトコルで、その両方をアクセスします。そのため、二つのサーバのそれぞれのポートが外部から認識可能で無ければなりません。例えば、1台のサーバでGLOBALBASEサーバとHTTP-GATEWAYの両方を動作させようとした場合は、GLOBALBASEサーバをポート番号8080、HTTP-GATEWAY ( WWWサーバ ) を80番ポートというように異なるポート番号に割り当てます。

もし、双方のサーバともに同じポート番号、たとえば80番に割り付けたいという場合が考えられます。たとえば、セキュリティー上HTTPの通信は、80番ポートのみしか許可されていないといった場合です。こういった場合は、サーバを2台用意し、それぞれにGLOBALBASEサーバ、HTTP-GATEWAYをインストールする必要があります。

一台のサーバで、しかもポート番号は80番しか使えない状況で、LOCALBASEを実現することは現在出来ません。将来的にはHTTP-GATEWAYに、画像のアクセスについてもポートをリレーする機能を実装すれば、それは可能となるでしょう。

LOCALBASEは、GLOBALBASEのネットワーク上で公開されているすべてのコンテンツがセットアップの仕方によってWWWで閲覧可能です。しかし、編集機能を利用する場合、編集対象のデータはgbviewエージェントと同じサーバ上に無ければなりません。なぜならば、編集対象をgbviewエージェントがファイルとしてオープン出来る必要があるからです。

▲ページトップへ戻る

履歴

日時:2007-11-04
マニュアル生成。(2007-11-04版)
--
日時:2006-07-18
著者:森　洋久 / 反映されたバージョン:ver.B.b11
このマニュアルを作成。中島（株式会社ゼータ）の書いたマニュアルに加筆。
--
日時:2006-07-23
著者:森　洋久 / 反映されたバージョン:ver.B.b11
複数の異なる設定のHTTP-GATEWAYから、一つのgbviewへアクセスするためのセットアップ方法の追加。
--
日時:2006-07-25
著者:森　洋久 / 反映されたバージョン:ver.B.b11
htmlIdの処理に関する記述を追加。
--
日時:2006-08-02
著者:森　洋久 / 反映されたバージョン:ver.B.b11
文献「xl(standard)エージェント・リファレンス・マニュアル」に関連してtarget/human-requirementなどを若干修正。
--
日時:2006-10-23
著者:森　洋久 / 反映されたバージョン:ver.B.b13.01
FAQを追加。
--
日時:2006-11-02
著者:森　洋久 / 反映されたバージョン:ver.B.b13.01
chmodの処理について、ver.B.b13.01について追加。
--
日時:2007-08-17
著者:森　洋久 / 反映されたバージョン:ver.B.b16.11
ver.B.b16.11における、複数GATEWAYスタイルに対応した説明の追加。
--
日時:2007-09-10
著者:森　洋久 / 反映されたバージョン:ver.B.b16.12
ver.B.b16.12における、複数GATEWAYスタイルに対応した説明の追加。
--


▲ページトップへ戻る



  GLOBALBASEAI[v\[XE\tgEFAxvOSOURCEFORGE.JPQBĂ܂B SourceForge.jp SourceForge.net Logo