• What's GLOBALBASE?
  • Project
  • Architecture
  • Data Stractures
  • Protocol
• Topics
  • What's New Back Number
  • Tomorrow's Map
  • Face of GLOBALBASE
  • Books
  • What's Map?
  • Computer Science
  • Art
  • Natural Environment
  • Economics
  • Infromation Engineering
  • Innovation Japan
  • GIS
• Download
• Documents
  • ver.B Release Note
  • GLOBALBASE Guide Book
  • COSMOS Manuals
  • LANDSCAPE Manuals
  • Development
  • Bibliography
• Collection Model case
• Links
  • Companies
  • Universities & Institutes
  • Joint Research
  • NPOs
  • Others

---

LOCALBASE Setup Manual

Author: Hirohisa Mori / joshuaï¼ globalbase.org + Tomohito Nakajima / nakajimaï¼ zeta.co.jp / ZETA Co. + [Transrate]Reiko Inoue Bendtsen c/o Suzaku Translations / (http://www.suzaku-translations.com/) +

---

* Abstract and Goal
* Human Requirements
* System Requirements
* Behaviors of HTTP-GATEWAY and gbview
* Display Styles of HTTP-GATEWAY
* LOCALBASE Edit Function
* Precautions on Configuration of LOCALBASE Server
* How to Install Default LOCALBASE (View System Only)
* Update Method
* Installation of Plot Data Edit Function
* How to Connect to Multiple HTTP-GATEWAY and gbview Servers with Different Settings
* Toubleshooting
* History

---

Abstract and Goal

This manual explains how to set up LOCALBASE to allow viewing GLOBALBASE contents in WWW browsers. LOCALBASE relies on a combination of the gbview agent [UNDEF REF (gbview)]technology on the GLOBALBASE side and the HTTP-GATEWAY [UNDEF REF (http-gateway)]technology on the WWW side. Please refer to the reference manuals of each of these technologies for the details.

[UP] Go To Page Top

---

Human Requirements

In order to understand the contents of this manual, you should be familiar with xl scripts [UNDEF REF (xl)]and xl servers [UNDEF REF (xlsv)]. Moreover, you should have a general understanding of how to browse and overlap coordinate systems of GLOBALBASE. The default installation does not require you to know all details of these subjects, however. We recommend that you build up your knowledge step-by-step starting from the default installation while referring to the manuals for the other technologies whenever new subjects appear. Please refer to the GLOBALBASE Technical Material [UNDEF REF (GLOBALBASE-tech)]to understand such technical details. If you are not familiar with subjects such as servers etc., we recommend that you study COSMOS GLOBALBASE VIEWER first.

HTTP-GATEWAY is a WWW-centric technology that relies heavily on the Apache webserver, so knowledge about Apache is a definite advantage as well. This manual assumes that readers have at least basic knowledge of the following subjects.

1. XML programming
2. Basic perl scrips
3. Basic CGI scripts
4. Basic understanding of HTTP
5. Basic HTML markup

[UP] Go To Page Top

---

System Requirements

• Web server that can execute CGI scripts compliant with perl 5or later
  We are currently checking the operations on Apache 2.0.49. In all the setting examples in this document, it is assumed that Apache is used as the web server. Make sure that execution of CGI scripts is permitted in all directories containing relevant files.
• Connection destination GLOBALBASE server
  A machine on which LANDSCAPE GLOBALBASE server of version ver.B.b11 or later is installed.

[UP] Go To Page Top

---

Behaviors of HTTP-GATEWAY and gbview

Figure HTTP-GATEWAY Structure

Fig.(HTTP-GATEWAY Structure) shows an overview of the basic system required to allow viewing GLOBALBASE contents on a WWW browser.

The HTTP gateway acts as a front-end that receives HTTP requests from a WWW browser, decodes the requests and accesses groups of GLOBALBASE servers to acquire the requested map information, image files etc., performs the necessary overlapping processing and finally returns the result to the client side.

The gateway consists of two modules. The first is the HTTP module, which receives HTTP requests from the client side and sets styles and so on. This module operates in a WWW server context. The other module is the GLOBALBASE view module, which actually accesses the GLOBALBASE server ( s) and performs map overlapping processing. Whereas the HTTP module operates on a WWW server such as Apache, the GLOBALBASE view module operates in a GLOBALBASE server context. An xlsv agent [UNDEF REF (xlsv)]converts requests for images and similar from HTTP to XL scripts and passes them to the corresponding gbview agent operating in the background. The gbview agent parses the passed XL scripts and returns the results to the xlsv agent. The xlsv agent in turn converts the results to HTTP responses and returns them to the WWW server and/or browser.

[UP] Go To Page Top

---

Display Styles of HTTP-GATEWAY

From ver.B.b16.11, HTTP-GATEWAY provides a diverse selection of colorful styles. After installing LANDSCAPE, you will find various directories under /usr/local/xl-gbs/xlsamples/www/gateway/packages, from which you will be able to select your favorite style. An example is shown below. Under this directory, various directories named old/skeleton, aqua/black etc. are created. The names of these directories represent the names of the templates.

Do not worry about the detailed settings for the moment; for now, simply try copying one of these directories to the directory from which Apache publishes content. You will then be able to create a page with a map already set as a template. It may be a good idea to try this at least once to understand the overall behavior of HTTP-GATEWAY. For example, execute the following copy command.

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

In this case, refer to http://www.yourwwwserverdomain/hogehoge/gateway/main.html to see the map image.

The server_conf.pl perl script in /var/www/html/hogehoge/gateway describes via which LANDSCAPE server the GLOBALBASE map is obtained. client_conf.xml specifies how the screen should be configured and what types of maps should be overlapped.

For more detailed installation instructions, please refer to "How to Install Default LOCALBASE (View System Only)".

Figure aqua/black

Figure aqua/red

Figure aqua/blue

Figure aqua/green

We prepared sample pages for each of these four styles. Please access the following pages to refer to the examples.

1. Black
2. Blue
3. Green
4. Red

[UP] Go To Page Top

---

LOCALBASE Edit Function

LOCALBASE is equipped with functions to edit simple plot data. This manual explains how to install the edit functions as well. For how to use the edit functions after installation, please refer to Document "LOCALBASE User Interface Manual".

[UP] Go To Page Top

---

Precautions on Configuration of LOCALBASE Server

As explained earlier, in order to use LOCALBASE, it is necessary to launch both GLOBALBASE and HTTP-GATEWAY servers. The WWW browser acting as the client accesses both of these entities via the HTTP protocol. For this reason, the ports of the two servers must be accessible from the outside. For example, if you want to operate the GLOBALBASE and HTTP-GATEWAY servers on a single host, it is necessary to assign different port numbers, e.g., port number 8080for the GLOBALBASE server and port number 80for the HTTP-GATEWAY server ( WWW server ) .

There may be cases where you want to assign the same port number for both servers, for example port number 80,as this is the only port that allows HTTP communication due to security reasons. In such cases, it is necessary to prepare one server for GLOBALBASE and one server for HTTP-GATEWAY and run each server individually.

At the moment, it is not possible to run LOCALBASE if only a single server and port number 80are available. In the future, it may become possible through implementation of functions to relay ports so that images may be accessed on HTTP-GATEWAY.

If set up properly, LOCALBASE allows viewing all the contents published on GLOBALBASE networks in WWW browsers. Note that, to use the edit function, the data to be edited must be on the same server as the gbview agent because the gbview agent must be able to open the files containing the data to be edited.

[UP] Go To Page Top

---

History

Date:2010-12-01
Generate the Manual (Edition 2010-12-01)
--
Date: 2006-07-18
Author: Hirohisa Mori / TargetVersion: ver.B.b11
Created this manual by modifying the manual written by Mr. Nakajima ( ZETA Co. ).
--
Date: 2006-07-23
Author: Hirohisa Mori / TargetVersion: ver.B.b11
Added how to make a setup so that one GLOBALBASE view could be accessed from multiple HTTP gateways with different settings
--
Date: 2006-07-25
Author: Hirohisa Mori / TargetVersion: ver.B.b11
Added description of htmlId processing.
--
Date: 2006-08-02
Author: Hirohisa Mori / TargetVersion: ver.B.b11
Modified targets and human-requirement related to [UNDEF REF (xl)]slightly
--
Date: 2006-10-23
Author: Hirohisa Mori / TargetVersion: ver.B.b13.01
Added FAQ
--
Date: 2006-11-02
Author: Hirohisa Mori / TargetVersion: ver.B.b13.01
Added chmod processing in ver.B.b13.01
--
Date: 2007-08-17
Author: Hirohisa Mori / TargetVersion: ver.B.b16.11
Added explanations of various gateway styles of ver.B.b16.11
--
Date: 2007-09-10
Author: Hirohisa Mori / TargetVersion: ver.B.b16.12
Added explanations of various gateway styles of ver.B.b16.12
--
Date: 2008-10-4
Author: Reiko Inoue Bendtsen / TargetVersion: ver.B.b17.10
Transrated this manual into English
--


[UP] Go To Page Top

Copyright©