English

How To: Manually configure ArcIMS with Apache HTTP (Web) Server and Apache Tomcat

Summary

Instructions provided describe how to manually configure ArcIMS with Apache HTTP (Web) Server 2.2 and Apache Tomcat 6.0.

Procedure

Follow these steps to configure the Apache HTTP Web server and the Apache Tomcat servlet container, the Service Administrator and the following connectors:

• WFS
• WMS
• CS-W
• OAI-PMH

If the Web server and servlet engine were not configured during the post-installation setup, the Web server must be configured manually.

If installation of the WFS, WMS, CS-W or OAI-PMH connectors and the Web server-servlet engine configuration were completed in the post-installation setup, these steps have been automatically completed.

Note:
For supported versions of Web server-servlet engines, see the ArcIMS 10 System Requirements.

Configuring Apache HTTP (Web) Server with Apache Tomcat for ArcIMS

1. Stop the Apache2 service, then the Apache Tomcat service.

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

2. Navigate to <ArcIMS Installation Directory>\ArcIMS\Connectors\Servlet and copy the file aimsservletconnector.war file from <ArcIMS Installation location>\ArcIMS\Connectors\Servlet to the <Tomcat Installation Directory>\webapps directory.

3. Rename the file aimsservletconnector.war to servlet.war.

4. Start the Apache2 service and the Apache Tomcat service. The war file is automatically expanded to a folder with the same name. If it has already been deployed, rename the aimsservletconnector directory to 'servlet'.

5. Go to the <Tomcat Installation Directory>\webapps\servlet\WEB-INF\classes directory and open Esrimap_prop.

6. Rename the AppServerMachine variable 'APPSMACHINE' to the name or IP address of the machine where ArcIMS Application Server is installed. Change the AppServerClientPort if using a non-default client port.

7. Modify the httpd.conf file. Go to Start > Programs > Apache HTTP Server 2.2.x > Configure Apache Server > Edit the Apache httpd.conf Configuration File. Scroll to the bottom of the file and add the following lines:

        JkMount /servlet ajp13
JkMount /servlet/* ajp13

Save and close the configuration file.

8. Restart the Apache2 and Apache Tomcat services, in the following order:

a. Stop Apache2
b. Stop Apache Tomcat
c. Start Apache Tomcat
d. Start Apache2

9. Create virtual directories: After installing ArcIMS, virtual directories for Output and Website must be created. A virtual directory is a mapped location on the Web server to a physical path.

Note:
If the location of the Web server root directory was selected to create directories for Output and Website (the Web Site Working Directories) during ArcIMS installation, virtual directories for Output and Website don't need to be created.


10. Stop the Apache Web server.

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

11. In a text editor (such as Notepad), open <httpd.conf file location>. Under the line

        Alias /icons/ "<icons folder location>"

paste the following lines to create the Website and Output virtual directories (Replace the paths in these lines with the appropriate paths for your configuration where necessary):

Alias /website/ "C:\ArcIMS\Website/"
Alias /Website/ "C:\ArcIMS\Website/"
Alias /WebSite/ "C:\ArcIMS\Website/"
Alias /WEBSITE/ "C:\ArcIMS\Website/"
Alias /output/ "C:\ArcIMS\Output/"
Alias /Output/ "C:\ArcIMS\Output/"
Alias /OUTPUT/ "C:\ArcIMS\Output/"

<Directory "C:/ArcIMS/Output">
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>

<Directory "C:/ArcIMS/Website">
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>

12. Save and close the file.

13. Start the Apache Web Server and close the Services window.

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

14. Using the Diagnostics tool to test the ArcIMS installation: Verify that the ArcIMS installation was successful.

a. Click Start > Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics. The ArcIMS Diagnostics page displays.
b. Select the Web server protocol, type the Web server name including domain, and type the port number. The default is 80.
c. Click 1 to test the ArcIMS Servlet Connector and 2 to test the ArcIMS Application Server.


If these tests are successful, the ArcIMS Application Server and ArcIMS Servlet Connector are configured properly.

If an error message is received, select the error number in the dropdown list and click View. The error number and a description are displayed. Follow the instructions in the description to fix the problem and try the Diagnostics tool again. The diagnostic tests might only be successful on the second or third try due to a Tomcat timing issue. If the error persists, retrace the configuration steps.

For the final step required to get ArcIMS running, see the ArcGIS Installation Guide help files: Installing ArcIMS on Microsoft Windows, Step 5: Configure ArcIMS.

Configuring Apache HTTP (Web) Server with Apache Tomcat for Service Administrator

Follow these steps to manually configure Apache with Tomcat for the Service Administrator:

1. Locate the file esriadmin.war in the <ArcIMS install directory>\ArcIMS\Administrator directory. This is the WAR file to deploy.

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

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

3. Copy the file esriadmin.war from <ArcIMS Installation Directory>\ArcIMS\Administrator to the <Tomcat installation location>\webapps directory.

4. The .war file deploys itself and an 'esriadmin' directory is displayed. If an esriadmin directory does not appear, stop and restart the Apache Tomcat service.

5. Modify the httpd.conf file. Go to Start > Programs > Apache HTTP Server 2.2.x > Configure Apache Server. Edit the Apache httpd.conf configuration file. Scroll to the bottom of the file and add the following lines:

        JkMount /esriadmin ajp13
JkMount /esriadmin/* ajp13

Save and close the file.

6. Restart the Apache Tomcat service, and restart the Apache2 service.

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

7. Ensure that a folder appears in the <Tomcat Installation Directory>\webapps directory called 'esriadmin'. Go to http://localhost/esriadmin.

See ArcIMS Help for more information on the ArcIMS Service Administrator.

Configuring WFS connector for Apache with Tomcat

Follow these steps to manually configure Apache with Tomcat for the WFS Connector:

1. Locate the file wfsconnector.war in the <ArcIMS install directory>\ArcIMS\Connectors\wfs_connector directory. This is the WAR file to be deployed.

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

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

3. Copy the file wfsconnector.war from <ArcIMS install directory>\ArcIMS\connectors\wfs_connector directory to <Tomcat installation location>\webapps.

4. The .war file deploys itself and a 'wfsconnector' directory is displayed. If a wfsconnector directory does not appear, stop and restart the Apache Tomcat service.

5. Modify the httpd.conf file. Go to Start > Programs > Apache HTTP Server 2.2.x > Configure Apache Server > Edit the Apache httpd.conf configuration file. Scroll to the bottom of the file and add the following lines:

        JkMount /wfsconnector ajp13
JkMount /wfsconnector/* ajp13

Save and close the configuration file.

6. Restart the Apache Tomcat service, and restart the Apache2 service.

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

7. Ensure that a folder appears in the webapps directory called 'wfsconnector'.

When the WAR file is deployed, the servlet engine expands the WAR file. The default location is <servlet install directory>\webapps\wfsconnector.

To complete configuration of the WFS connector, verify the connector was successfully installed. Type the following URL in a Web browser to verify the connection:

http://<hostname>/<deploy_name>/com.esri.wfs.Esrimap?cmd=connectorPing

Where

• <hostname> is the URL domain name for the site such as www.esri.com or localhost.

• <deploy_name> is the name assigned when the WFS Connector was deployed. The recommended deployment name is 'wfsconnector'.

Configuring WMS connector for Apache with Tomcat

Follow these steps to manually configure Apache with Tomcat for the WMS Connector:

1. Locate the file wmsconnector.war in the <ArcIMS install directory>\ArcIMS\Connectors\wms_connector directory. This is the WAR file to be deployed.

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

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.



3. Copy the file wmsconnector.war from <ArcIMS install directory>\ArcIMS\connectors\wms_connector directory to <Tomcat installation location>\webapps.

4. The .war file deploys itself and a 'wmsconnector' directory is displayed. If a wmsconnector directory does not appear, stop and restart the Apache Tomcat service.

5. Modify the httpd.conf file. Go to Start > Programs > Apache HTTP Server 2.2.x > Configure Apache Server > Edit the Apache httpd.conf Configuration File. Scroll to the bottom of the file and add the following lines:

        JkMount /wmsconnector ajp13
JkMount /wmsconnector/* ajp13

Save and close the file.

6. Restart the Apache Tomcat service, and restart the Apache2 service.

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

7. Ensure that a folder appears in the webapps directory called 'wmsconnector'.

When the WAR file is deployed, the servlet engine expands the WAR file. The default location is <servlet install directory>\webapps\wmsconnector.

To complete configuration of the WMS connector, verify the connector was successfully installed. Type the following URL in a Web browser to verify that it has been installed correctly:
http://<hostname>/<deploy_name>/com.esri.wms.Esrimap?cmd=connectorPing

Where

• <hostname> is the URL domain name for the site such as www.esri.com or localhost.

• <deploy_name> is the name assigned when the WMS connector was deployed. The recommended deployment name is 'wmsconnector'.

Configuring Apache with Tomcat for CS-W connector

Follow these steps to manually configure Apache with Tomcat for the CS-W Connector:
1. Locate the file aimscsw.war in the <ArcIMS install directory>\ArcIMS\Metadata\CSW\Connector directory. This is the WAR file to be deployed.

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

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

3. Copy the file aimscsw.war from <ArcIMS install directory>\ArcIMS\Metadata\CSW\Connector directory to <Tomcat installation location>\webapps.

4. The .war file deploys itself and a 'aimscsw' directory is displayed. If an aimscsw directory does not appear, stop and restart the Apache Tomcat service.

5. Modify the httpd.conf file. Go to Start > Programs > Apache HTTP Server 2.2.x > Configure Apache Server > Edit the Apache httpd.conf Configuration File. Scroll to the bottom of the file and add the following lines:

        JkMount /aimscsw ajp13
JkMount /aimscsw/* ajp13

Save and close the file.

6. Restart the Apache Tomcat service, and restart the Apache2 service.

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

7. Ensure that a folder appears in the webapps directory called 'aimscsw'.

8. Navigate to the URL: http://hostname/aimscsw/login.jsf to configure the CSW service.

The servlet engine expands the .war file when the .war file is deployed. The default location is <servlet install directory>\webapps\aimscsw.

Configuring Apache with Tomcat for OAI-PMH connector

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 to be deployed.

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

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

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

4. The .war file deploys itself and a 'aimsharvester' directory is displayed. If an aimsharvester directory does not appear, stop and restart the Apache Tomcat service.

5. Modify the httpd.conf file. Go to Start > Programs > Apache HTTP Server 2.2.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 the file.

6. Restart the Apache Tomcat service, and restart the Apache2 service.

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab to access the Apache2 and Apache Tomcat services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services to access the Apache2 and Apache Tomcat services.
· On Windows 2008, click Server Manager or right-click Computer on the desktop and select Manage. Expand Configuration and click on Services to access the Apache2 and Apache Tomcat services.

7. Ensure that a folder appears in the webapps directory called 'aimsharvester'.

8. 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:

defaultServiceName=Browse_Metadata (replace Browse_Metadata with the name of the Metadata Service the connector accesses)

url=http://www.geographynetwork.com (replace http://www.geographynetwork.com with the Internet address of the server that hosts the ArcIMS Metadata Service)

username= and password= (optionally, add a user name and password defined in the ArcIMS Server’s Access Control List if browsing the Metadata Service is restricted but metadata discovery is allowed with a specific user name that has access to public information)

appServerMachine=hostname (replace hostname with Application Server machine name)

appServerPort=5300 (or port for Application Server machine)

Identify.repositoryName=ArcIMS Metadata Service (replace ArcIMS Metadata Service with an appropriate name for an organization’s Metadata Service)

Identify.baseURL=http://localhost/aimsharvester/oai2.0 (replace http://localhost with the same value provided in the URL variable above; this is the URL to which OAI-PMH requests are sent)

Identify.adminEmail.0= (add an email address where the administrator of the Metadata Service can be contacted)

Identify.repositoryIdentifier=myhost.org (replace myhost.org with an identifier representing the server that hosts the Metadata Service—this should not be prefaced by “http://”)

Identify.description.0=<description>�</description> (update this XML response to properly identify the service by replacing both occurrences of localhost in this string with an appropriate host name for the ArcIMS Application Server such as the value of the repositoryIdentifier variable)
Logger.level=INFO (optionally, update the level of information that is recorded in the connector’s log file)


Some additional information is available at the following Web page: Adding the OAI-PMH Connector to your Metadata Service


After saving the changes and restarting the servlet engine and Web server, verify that the OAI-PMH Connector has been successfully configured. In a Web browser, type the following URL:
http://<hostname>/aimsharvester/oai2.0?verb=Identify
Note:
Some Web servers may require an additional forward slash (/) at the end of the above URL. The default location is <servlet install directory>\webapps\aimsharvester.

Related Information