Installation guide

Option 1 - As Web application

Installation prerequisites

• A Java Application Server such as Tomcat 8.x installed if you want to use Harvester as a web application
• A Geoportal 2.5.x instance if you plan to harvest to Geoportal 2.x

Installation steps

• Deploy harvester.war to Tomcat (e.g. drop harvester.war into Tomcat webapps folder)
• Restart Tomcat if necessary
• Open Harvester application (e.g. http://localhost:8080/harvester)
• Run quick smoke test by following steps in Quick start guide

Custom configuration - security

Starting from 2.6.1, you can configure various authentication options such as simple, LDAP, OAuth2 in Harvester. to turn on security

• In harvester\WEB-INF\web.xml:20 – uncomment springSecurityFilterChain filter

  <filter>
   <filter-name>springSecurityFilterChain</filter-name>
   <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
   <async-supported>true</async-supported>
 </filter>
 <filter-mapping>
   <filter-name>springSecurityFilterChain</filter-name>
   <url-pattern>/*</url-pattern>
   <dispatcher>ERROR</dispatcher>
   <dispatcher>REQUEST</dispatcher>
 </filter-mapping>

• In harvester\hrv\ui\main\templates\Header.html, change “display” style from "none" to "block"
• Decide upon minimum permission required to access application (default: PUBLISHER), and update value in harvester\WEB-INF\classes\config\app-security.xml accordingly.

   <security:intercept-url pattern="/login.html" access="permitAll" />
   <security:intercept-url pattern="/**" access="hasRole('PUBLISHER')" />

• To configure Harvester to use simple authentication, see Security configuration simple
• To configure Harvester to use LDAP authentication, see Security configuration LDAP

Option 2 - As stand alone application

Prerequisites

• JRE or JDK 8.x

Installation steps

• Copy harvest.jar to a destination folder
• Follow instructions in Command line interface to run the tool.