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

Custom harvester to work in a disconnected environment

• Update ..\harvester\WEB-INF\classes\config\hrv.properties
  • Replace url for geometry service

geometry.service.url=http://zguo:6080/arcgis/rest/services/Utilities/Geometry/GeometryServer

• Update ..\harvester\index.html
  • Replace url to JavaScript API with local instance, for example: https://servername/arcgis_js_api/library/3.22/3.22/

	...
    <link rel="stylesheet" href="https://js.arcgis.com/3.22/esri/themes/calcite/dijit/calcite.css">
    <link rel="stylesheet" href="https://js.arcgis.com/3.22/esri/themes/calcite/esri/esri.css">
    ...
    <script src="//js.arcgis.com/3.22/"></script>

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.