-
Notifications
You must be signed in to change notification settings - Fork 24
Installation guide
Marten edited this page Jun 21, 2023
·
26 revisions
- For Harvester 2.7.0, if you install this version on a machine where an earlier version was hosted, you will need to rename the h2 database or put it in a different location. The 2.6.5 h2 database cannot be used with 2.7.0.
- A Java Application Server such as Tomcat 9.x installed if you want to use Harvester as a web application
- A Geoportal 2.6.x instance if you plan to harvest to Geoportal 2.x
- Harvester 2.6.4 was tested with AdoptOpenJDK 11, Tomcat 9.0.29 and ElasticSearch 7.5.0, it should work with other similar versions.
- Harvester 2.6.5 was tested with AdoptOpenJDK 11, Tomcat 9.0.29 and ElasticSearch 7.9.3, it should work with other similar versions as well.
- 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
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
- Setup a local instance of ArcGIS JavaScript API
- Please visit https://developers.arcgis.com/javascript/3/jshelp/intro_accessapi.html for more information about the API, and download and installation instructions.
- Setup a local instance of ArcGIS geometry service that is shared with everyone
- Update ..\harvester\WEB-INF\classes\config\hrv.properties
- Replace url for geometry service
geometry.service.url=http://servername/arcgis/rest/services/Utilities/Geometry/GeometryServer
- Update ..\harvester\index.html
before:
...
<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>
...
<body class="calcite">
after:
...
<link rel="stylesheet" href="http://servername/arcgis_js_api/library/3.22/3.22/dijit/themes/claro/claro.css">
<link rel="stylesheet" href="http://servername/arcgis_js_api/library/3.22/3.22/esri/css/esri.css">
...
<script src="//servername/arcgis_js_api/library/3.22/3.22/"></script>
...
<body class="claro">
- AdoptOpenJDK 11
- Copy harvest.jar to a destination folder
- Follow instructions in Command line interface to run the tool.