Difference between revisions of "Install and Configure GeoServer"

From Gcube Wiki
Jump to: navigation, search
(Created page with "<!-- CATEGORIES --> Category: Administrator's GuideCategory: gCube Spatial Data Infrastructure <!-- CATEGORIES --> =Installation= ==SmartGears Installation== ===GeoS...")
 
(GeoServer Connector installation)
 
(11 intermediate revisions by 3 users not shown)
Line 6: Line 6:
 
=Installation=
 
=Installation=
 
==SmartGears Installation==
 
==SmartGears Installation==
 +
In order to enable SmartGears to correctly handle the web application, the following values must be declared in its '''gcube-app.xml''' file :
 +
* Name : '''GeoServer'''
 +
* Group : '''SDI'''
 +
* Description : '''OGC compliant map viewer by geosolutions'''
 +
 +
The following SmartGears handlers should be excluded :
 +
*'''request-validation'''
 +
 +
In order to support data-transfer capabilities, the following setting should also be added :
 +
* persistence location : '''/srv/geoserver_data'''
 +
 
===GeoServer Connector installation===
 
===GeoServer Connector installation===
 +
 +
'''GeoServer Connector''' is a jar library that should be included among the jars of a Geoserver instance deployed on SmartGear. The jar includes a ''Tomcat Filter'' and a ''SmartGear Request Handler''.
 +
 +
The detailed steps to install and configure the library on an existing Geoserver instance are listed below:
 +
 +
1. Download latest version of the jar from [http://maven.research-infrastructures.eu/nexus/index.html#nexus-search;quick~geoserver-connector Nexus repository]
 +
 +
2. Move the jar file to lib folder (''geoserver/WEB-INF/lib'') of the Geoserver Service deployed on SmartGear
 +
 +
3. Configure ''GeoServerFilter'' filter class in the ''web.xml'' of GeoServer Service just '''before filterChainProxy filter''' as follow:
 +
   
 +
    '''<filter>'''
 +
      '''<filter-name>gcubeAuthenticationFilter</filter-name>'''
 +
      '''<filter-class>org.gcube.data.access.connector.GeoServerFilter</filter-class>'''
 +
    '''</filter>'''
 +
    <filter>
 +
    <filter-name>filterChainProxy</filter-name>
 +
    ....
 +
 +
4. Reference the filter mapping to all the URLs of the Service:
 +
 +
    <filter-mapping>
 +
      <filter-name>gcubeAuthenticationFilter</filter-name>
 +
      <url-pattern>/*</url-pattern>
 +
    </filter-mapping>
 +
 +
5. Edit ''gcube-handlers.xml'' (under WEB-INF)  adding '''authentication-filter''' Request Handler under '''request''' element:
 +
 +
    <handlers>
 +
        <lifecycle>
 +
            <profile-management />
 +
        </lifecycle>
 +
        <request>
 +
            <request-validation />
 +
            <request-accounting />
 +
            '''<authentication-filter />'''
 +
        </request>
 +
    </handlers>
 +
 +
6. restart the service

Latest revision as of 11:39, 15 November 2017


Installation

SmartGears Installation

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

  • Name : GeoServer
  • Group : SDI
  • Description : OGC compliant map viewer by geosolutions

The following SmartGears handlers should be excluded :

  • request-validation

In order to support data-transfer capabilities, the following setting should also be added :

  • persistence location : /srv/geoserver_data

GeoServer Connector installation

GeoServer Connector is a jar library that should be included among the jars of a Geoserver instance deployed on SmartGear. The jar includes a Tomcat Filter and a SmartGear Request Handler.

The detailed steps to install and configure the library on an existing Geoserver instance are listed below:

1. Download latest version of the jar from Nexus repository

2. Move the jar file to lib folder (geoserver/WEB-INF/lib) of the Geoserver Service deployed on SmartGear

3. Configure GeoServerFilter filter class in the web.xml of GeoServer Service just before filterChainProxy filter as follow:

   <filter>
      <filter-name>gcubeAuthenticationFilter</filter-name>
      <filter-class>org.gcube.data.access.connector.GeoServerFilter</filter-class>
   </filter> 
   <filter>
   <filter-name>filterChainProxy</filter-name>
   ....

4. Reference the filter mapping to all the URLs of the Service:

   <filter-mapping>
      <filter-name>gcubeAuthenticationFilter</filter-name>
      <url-pattern>/*</url-pattern>
   </filter-mapping>

5. Edit gcube-handlers.xml (under WEB-INF) adding authentication-filter Request Handler under request element:

   <handlers>	
       <lifecycle>
           <profile-management />
       </lifecycle>
       <request>
           <request-validation />
           <request-accounting /> 
           <authentication-filter /> 
       </request>
   </handlers>

6. restart the service