Configuring Apache with Tomcat for OAI-PMH connector

 

If you chose to install the OAI-PMH connector and you completed the Web server-servlet engine configuration in the post installation setup, these manual steps will have automatically been completed for you.

 

IMPORTANT: For supported versions of Web server-servlet engines, visit http://support.esri.com, select software > ArcIMS > System Requirements

 

Follow these steps to manually configure Apache with Tomcat for the OAI-PMH Connector:

  1. Locate the file aimsharvester.war in the <ArcIMS install directory>\ArcIMS\Metadata\OAI-PMH\Connector directory. This is the WAR file you will deploy.

 

  1. Verify that the services Apache 2 and Apache Tomcat are running.

 

  1. Copy the file aimsharvester.war from <ArcIMS install directory>\ArcIMS\Metadata\OAI-PMH\Connector directory to <Tomcat installation location>\webapps.

 

  1. The .war file will deploy itself and a "aimsharvester" directory will appear. If an aimsharvester directory does not appear, stop and restart the Apache Tomcat service.

 

  1. If using mod_jk2, edit the workers2.properties file in <Apache Installation Directory>\conf and add the following lines at the end of the file:

[uri:/aimsharvester/*]

info=OAI 2.0 Connector for ArcIMS

 

If using mod_jk, modify the httpd.conf file. Go to Start > Programs > Apache HTTP Server 2.0.x > Configure Apache Server > Edit the Apache httpd.conf Configuration File. Scroll to the bottom of the file and add the following lines:

JkMount /aimsharvester ajp13

JkMount /aimsharvester/* ajp13

Save and close this file.

 

 

  1. Start the services in the following order:

a. Start Apache Tomcat

b. Start Apache2

 

  1. Ensure that a folder appears in the webapps directory called “aimsharvester”.

 

  1. In a text editor (such as Notepad), open <ArcIMS install directory>\ArcIMS\Metadata\OAI-PMH\Connector\aimsharvester\WEB-INF\classes\aims_oai.properties and edit the following variables:

appServerMachine=hostname (replace hostname with Application Server machine)

appServerPort=5300 (or port for Application Server machine)

Identify.baseURL=http://localhost/aimsharvester/oai2.0 (replace localhost with appropriate local host name)

Identify.repositoryIdentifier=myhost.org (replace myhost with appropriate host name)

 

 

 

When you deploy the WAR file, the servlet engine expands the WAR file. The default location is <servlet install directory>\webapps\aimsharvester.

 

After your Web server has been configured you will need to configure the OAI-PMH connector for your Metadata Service. See the Creating_Metadata_Services.pdf (Harvesting documents section) for details.