wiki:PetascopeInstallGuide

Version 4 (modified by dmisev, 2 weeks ago) (diff)

--

Petascope Installation Guide

This page serves as an introduction to the petascope component from a developer's perspective (see also installation guide and user guide).

Petascope relies on a SECORE Coordinate Reference System (CRS) resolver that can provide proper metadata on a coverage's native CRSs. One can either deploy a local SECORE instance, or use the official OGC SECORE resolver at http://www.opengis.net/def/ .

Petascope database schema: petascopedb

Coverage metadata is stored in relational database tables, called petascopedb. The database schema visual documentation of this database can be browsed here here. This is where database creation and update is handled.

Petascope

To implement the geo semantics, petascope uses a relational database for the geo-related metadata. Currently, only PostgreSQL is supported; for the future, support of SQLite is planned (in parallel to the rasdaman array engine). This is how to set up PostgreSQL for use by petascope:

  1. Prepare PostgreSQL for use with rasdaman
  1. Add a user to PostgreSQL for petascope:
    sudo -u postgres createuser -s petauser -P
    
  2. Set the metadata_user and metadata_pass variables in $RMANHOME/etc/petascope.properties to the above user and password.
  3. make sure PostgreSQL needs to be running
  4. Initialize the petascope database schema:
    update_petascopedb.sh
    

Running the Servlet

As petascope is implemented as a Java servlet it needs a servlet container for its operations. Two alternatives are available:

  • separately install some servlet container, like Tomcat, and deploy petascope there; In case of problems, consult the servlet container log files (such as /var/log/tomcat7/catalina.out on Debian 8 and /usr/share/tomcat/petascope.log on CentOS 7).
  • run the petascope service directly, by way of the embedded servlet container, jetty; More information on how to use this option can be found on this page.

Initialize SECORE

SECORE (Semantic Coordinate Reference System Resolver) is a service that maps CRS URLs to CRS definitions. This component, which is part of the standard rasdaman distribution, is used by the Open Geospatial Consortium (OGC) for operating their official CRS resolver.

SECORE, being a servlet like petascope, gets installed automatically unless --disable-java is specified at configure. The deployment directory of all war files can be set during the configure step with the --with-wardir=DIR option.

For further details on SECORE management, security and troubleshooting see the administration and developer guide pages.