Difference between revisions of "Install and Configure THREDDS Data Server"

From Gcube Wiki
Jump to: navigation, search
(Legacy applications compatibility)
(Configuring as SmartGears Application)
 
(4 intermediate revisions by 2 users not shown)
Line 18: Line 18:
 
***$TOMCAT_HOME/content -> /data/content
 
***$TOMCAT_HOME/content -> /data/content
 
**Set JRE property :  
 
**Set JRE property :  
***THREDDS_CONTENT_ROOT=$TOMCAT_HOME/content
+
***THREDDS_CONTENT_ROOT=/data/content
 
***JAVA_OPTS="-Dtds.content.root.path=$THREDDS_CONTENT_ROOT $JAVA_OPTS"
 
***JAVA_OPTS="-Dtds.content.root.path=$THREDDS_CONTENT_ROOT $JAVA_OPTS"
  
Line 29: Line 29:
  
 
==Configuring as SmartGears Application==
 
==Configuring as SmartGears Application==
In order to enable SmartGears to correctly handle the web application, the gcube-app.xml file must be present under $TOMCAT_HOME/webapps/thredds/WEB-INF location. A valid copy of such file can be retrieved in shared workspace folder https://goo.gl/ct28Jn.
+
In order to enable SmartGears to correctly handle the web application, the following values must be declared in its '''gcube-app.xml''' file :
 +
* Name : '''Thredds'''
 +
* Group : '''SDI'''
 +
* Description : '''Unicar OGC compliant data catalog'''
 +
 
 +
The following SmartGears handlers should be excluded :
 +
*'''request-validation'''
 +
 
 +
The following parameter needs to be set in order to configure integration with Data Transfer service (see ''THREDDS_CONTENT_ROOT'' setting above) :  
 +
* '''persistence location''' = ''THREDDS_CONTENT_ROOT''/thredds
  
 
==Legacy applications compatibility==
 
==Legacy applications compatibility==
 
In order to enable legacy application to publish data into THREDDS catalogs, the same machine should host a gCore installation with legacy service ''org.gcube.data-transfer.agent-service''. This service needs write privileges on thredds catalog directory and its subdirectories, which legacy applications expect to be under "/data/content".
 
In order to enable legacy application to publish data into THREDDS catalogs, the same machine should host a gCore installation with legacy service ''org.gcube.data-transfer.agent-service''. This service needs write privileges on thredds catalog directory and its subdirectories, which legacy applications expect to be under "/data/content".

Latest revision as of 16:23, 8 September 2017


THREDDS is a web server that provides metadata and data access for geospatial datasets.Purpose of this page is to explain how to configure a GeoNetwork service instance in order to fulfill the needs of gCube environment. Please refer to third party's website for further details.

Installation

Environment prerequisites :

  • JRE 7+
  • Tomcat 7+

Suggested environment : SmartGears installation.

Tomcat configuration

In D4Science infrastructure, the following configuration is recommended :

  • Setting the catalog directory :
    • Symbolic link
      • $TOMCAT_HOME/content -> /data/content
    • Set JRE property :
      • THREDDS_CONTENT_ROOT=/data/content
      • JAVA_OPTS="-Dtds.content.root.path=$THREDDS_CONTENT_ROOT $JAVA_OPTS"

Thredds Catalog configuration

Once Thredds is deployed and the containing tomcat instance is started, the webapp creates a basic configuration under $THREDDS_CONTENT_ROOT/thredds. The following files in such directory need to be replaced with the ones in shared workspace folder https://goo.gl/ct28Jn :

  • catalog.xml
  • threddsConfig.xml

Configuring as SmartGears Application

In order to enable SmartGears to correctly handle the web application, the following values must be declared in its gcube-app.xml file :

  • Name : Thredds
  • Group : SDI
  • Description : Unicar OGC compliant data catalog

The following SmartGears handlers should be excluded :

  • request-validation

The following parameter needs to be set in order to configure integration with Data Transfer service (see THREDDS_CONTENT_ROOT setting above) :

  • persistence location = THREDDS_CONTENT_ROOT/thredds

Legacy applications compatibility

In order to enable legacy application to publish data into THREDDS catalogs, the same machine should host a gCore installation with legacy service org.gcube.data-transfer.agent-service. This service needs write privileges on thredds catalog directory and its subdirectories, which legacy applications expect to be under "/data/content".