Difference between revisions of "Install and Configure GeoServer"

From Gcube Wiki
Jump to: navigation, search
(→‎GeoServer Connector installation)
(→‎GeoServer Connector installation)
Line 8: Line 8:
 
===GeoServer Connector installation===
 
===GeoServer Connector installation===
  
−
Here follow the steps to install the '''GeoServer Connector''' (''version 0.1.0'') in SmartGear:
+
'''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''.
  
−
1. download the '''gcube-geoserver-connector''' source code from gCube repository (https://svn.research-infrastructures.eu/d4science/gcube/trunk/data-access/gcube-geoserver-connector/).
+
The detailed steps to install and configure the library on an existing Geosrver instance are listed below:
  
−
2. compile the code using the '''pom.xml''' file to generate the JAR file (''gcube-geoserver-connector-0.1.0-SNAPSHOT.jar''). To compile please use ''maven 3'' and ''JDK 8''.
+
1. Download latest version of the jar from [http://maven.research-infrastructures.eu/nexus/index.html#nexus-search;quick~geoserver-connector Nexus repository]
  
−
3. add '''gcube-geoserver-connector-0.1.0-SNAPSHOT.jar''' file in to ''/home/gcube/tomcat/webapps/geoserver/WEB-INF/lib'' folder of GeoServer Virtual Machine.
+
2. Move the jar file to lib folder (''geoserver/WEB-INF/lib'') of the Geoserver Service deployed on SmartGear
−
To access on GeoServer VM you need of the '''keypair''', the '''host''' (geoserver1-spatial-dev.d4science.org) and the '''user''' (gcube).
+
  
−
4. add ''GeoServerFilter'' filter in the '''web.xml''' (''/home/gcube/tomcat/webapps/geoserver/WEB-INF'') of GeoServer VM as follow:
+
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>
−
      <filter-name>gcubeAuthenticationFilter</filter-name>
+
    <filter-name>filterChainProxy</filter-name>
−
      <filter-class>org.gcube.data.access.connector.GeoServerFilter</filter-class>
+
    ....
−
    </filter>
+
 
 +
4. Reference the filter mapping to all the URLs of the Service:
  
 
     <filter-mapping>
 
     <filter-mapping>
Line 28: Line 33:
 
     </filter-mapping>
 
     </filter-mapping>
 
   
 
   
−
5. edit the ''''/home/gcube/tomcat/webapps/geoserver/WEB-INF/gcube-handlers.xml'''' file to add the request handler as '''authentication-filter''' tag inside the '''request''' tag:
+
5. Edit ''gcube-handlers.xml'' (under WEB-INF)  adding '''authentication-filter''' Request Handler under '''request''' element:
  
 
     <handlers>
 
     <handlers>
Line 41: Line 46:
 
     </handlers>
 
     </handlers>
  
−
''Please note that you need to edit steps 4 and 5 only the first time. If you change the source code you can jump these.''
 
 
   
 
   
−
6. restart the service. In ''''/home/gcube'''' folder stop and start the server with these commands:
+
6. restart the service
−
 
+
−
  gcube@geoserver1-spatial-dev:~$ ./stopContainer.sh
+
−
  gcube@geoserver1-spatial-dev:~$ ./startContainer.sh
+
−
 
+
−
To see the log, you can open the ''''/srv/geoserver_spatialite/data/logs/geoserver.log'''' file.
+

Revision as of 12:26, 23 June 2017


Installation

SmartGears 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 Geosrver 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

Retrieved from "https://wiki.gcube-system.org/index.php?title=Install_and_Configure_GeoServer&oldid=29270"