Changes between Version 2 and Version 3 of PetascopeInstallGuide


Ignore:
Timestamp:
Dec 30, 2015 3:31:31 PM (21 months ago)
Author:
pbaumann
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • PetascopeInstallGuide

    v2 v3  
    1414Coverage metadata is stored in relational database tables, called __'''`petascopedb`'''__. The [browser:manuals_and_examples/manuals/doc-petascope/dbschema database schema visual documentation] of this database can be downloaded from [attachment:schema9.zip here]. [source:applications/petascope/src/main/db This] is where database creation and update is handled.
    1515
     16=== Petascope ===
     17
     18To 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:
     19
     201. [wiki:rasdamanStoragePostgreSQL Prepare PostgreSQL for use with rasdaman]
     21
     221. Add a user to PostgreSQL for petascope:
     23{{{
     24sudo -u postgres createuser -s petauser -P
     25}}}
     261. Set the `metadata_user` and `metadata_pass` variables in `$RMANHOME/etc/petascope.properties` to the above user and password.
     271. make sure PostgreSQL needs to be running
     281. Initialize the petascope database schema:
     29{{{
     30#!sh
     31update_petascopedb.sh
     32}}}
     33
     34=== Running the Servlet ===
     35
     36As petascope is implemented as a Java servlet it needs a servlet container for its operations. Two alternatives are available:
     37* 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).
     38* 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 [wiki:PetascopeEmbedded this page].
     39
     40== Initialize SECORE ==
     41
     42SECORE (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 [http://www.opengeospatial.com Open Geospatial Consortium] (OGC) for operating their official CRS resolver.
     43
     44SECORE, 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.
     45
     46For further details on SECORE management, security and troubleshooting see the [wiki:SecoreAdministration administration] and [wiki:SecoreDevGuide developer guide] pages.
     47