English

How To: Manually configure ArcIMS with IIS and ServletExec Application Server 6

Summary

Instructions provided describe how to manually configure ArcIMS with IIS and ServletExec Application Server 6 and configure the following connectors:

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

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


Warning:
ServletExec ISAPI is not supported with ArcIMS 10.

Procedure

Configuring IIS with ServletExec Application Server 6.0 for ArcIMS

1. Provide read/write access to the ServletExec Data directory:

A. Navigate to the ServletExec AS directory in the ServletExec installation folder. For example, <drive>:\Program Files\New Atlanta\ServletExec AS.
B. Right-click on the ServletExec AS directory and select Properties.
C. Click the Security tab.
· On Windows 2008: Click Edit > Add. Click Add (again).
· On Windows 2003: Click Add.
D. Click on Locations and select the computer name as location.
E. Enter Users in the ‘Enter the objects name to select’ text box. Click OK.
F. Under Group or user names click on Users. Under Permissions for Users, grant the users the following permissions:
· Read & Execute
· List Folder Contents
· Read
· Write
Click OK.
G. Windows 2008 only: Click OK.

2. Locate the file arcimsservletconnector.war in the <ArcIMS install directory>\ArcIMS\Connectors\Servlet directory. This is the WAR file to deploy.


A. Click Start > [All] Programs > New Atlanta > ServletExec 6.0 AS > ServletExec Admin to open ServletExec Admin.
B. In the left sidebar under Web Applications, click Manage.
C. Click Add Web Application.

3. For Application Name, type: servlet

4. For URL Context Path, type: /servlet

5. For Location, type or browse to: <ArcIMS install directory>\ArcIMS\Connectors\Servlet\arcimsservletconnector.war
Click OK.

6. Click Submit and close ServletExec Admin.

7. Navigate to the Esrimap_prop file located under the deployed servlet folder (for example, <drive>:\Program Files\New Atlanta\ServletExec AS\se-<instance_name>\ServletExecData\default\servlet\WAR\WEB-INF\classes\).

8. Edit the Esrimap_prop file, replacing APPSMACHINE (value of appServerMachine property) with the name or IP address of the machine ArcIMS Application Server is installed on. Change the AppServerClientPort if you are using a non-default client port. Save the file.

9. Restart services:

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services.
Stop and Start the IIS Admin and World Wide Web Publishing services.
· On Windows 2008, click Start > Administrative Tools > Internet Information Services (IIS) Manager. Click on the machine name. On the right side under Actions > Manage Server, click Restart.

10. Create virtual directories in IIS:

A. Start Internet Information Services (IIS) Manager.

· For IIS 7.0 (Windows Server 2008), click Start > Administrative Tools > Internet Information Services (IIS) Manager. Expand machine name and Sites.

· For IIS 7.0 (Windows Vista), click Start > Control Panel > [System and Maintenance] > Administrative Tools > Internet Information Services (IIS) Manager. Expand machine name and Sites.

· For IIS 6.0 (Windows Server 2003), click Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager. Expand machine name and Web Sites.

· For IIS 5.1 (Windows XP), click Start > Administrative Tools > Internet Information Services. Expand localhost folder and Web Sites.

B. All Windows Operating Systems: Click Default Web Site to highlight it.

· Windows Server 2008 and Windows Vista: Right-click and select Add Virtual Directory.

· Windows Server 2003 and Windows XP: Right-click > New > Virtual Directory.

C. Windows 2003 and Windows XP only (Windows Server 2008 and Windows Vista skip this step): the Virtual Directory Creation Wizard displays. Click Next.

D. Windows Server 2008 and Windows Vista: In the Alias text box type output.
Windows 2003 and Windows XP: Type the following for the Alias: output and Click Next.

E. Select output directory:

· Windows Server 2008 and Windows Vista: Click the Browse button next to the Physical path text box. Browse to location of ArcIMS Output directory chosen during installation (for example, C:\ArcIMS\Output). Click OK. Click OK. output appears in the virtual directory list.

· Windows 2003 and Windows XP: Click Browse and browse to location of ArcIMS Output directory chosen during installation (for example, C:\ArcIMS\Output). Click OK. Click Next.

F. Grant user permissions:

· Windows Server 2008 and Windows Vista: Expand Default Web Site if unexpanded. Click on Output directory to highlight. In right panel (Actions) click Edit Permissions. Click Security tab. Click Edit. Click Add. Click on Locations and select the computer name as location. Click OK. In the ‘Enter the objects name to select’ text box, enter Users. Click OK. Under Group or user names click on Users. Under Permissions for Users grant the user the following permissions:
▪ Read & execute
▪ List Folder Contents
▪ Read
Click OK. Click OK.

· Windows 2003 and Windows XP: Enable the following Access Permissions: Read, Run Scripts (such as ASP), and Browse by checking the box next to each one, if not enabled. Click Next, and click Finish. Output appears in the virtual directory list.

G. In IIS Manager, Click Default Web Site to highlight it.

H. Add virtual directories:

· Windows Server 2008 and Windows Vista: Right-click and select Add Virtual Directory.

· Windows Server 2003 and Windows XP: Right-click > New > Virtual Directory.

I. Windows 2003 and Windows XP only (Windows Server 2008 and Windows Vista skip this step): the Virtual Directory Creation Wizard displays. Click Next.

J. Enter name of alias:

· Windows Server 2008 and Windows Vista: In the Alias text box type website.

· Windows 2003 and Windows XP: Type the following for the Alias: website and Click Next.

K. Add ArcIMS directory:

· Windows Server 2008 and Windows Vista: Click the Browse button next to the Physical path text box. Browse to location of ArcIMS Website directory chosen during installation (for example, C:\ArcIMS\Website). Click OK. Click OK. website appears in the virtual directory list.

· Windows 2003 and Windows XP: Click Browse and browse to location of ArcIMS Website directory chosen during installation (for example, C:\ArcIMS\Website). Click OK. Click Next.

L. Enable access permissions:

· Windows Server 2008 and Windows Vista: Expand Default Web Site if unexpanded. Click on Output directory to highlight. In right panel (Actions) click Edit Permissions. Click Security tab. Click Edit. Click Add. Click on Locations and select the computer name as location. Click OK. In the ‘Enter the objects name to select’ text box, enter Users. Click OK. Under Group or user names click on Users. Under Permissions for Users grant the user the following permissions: Read & execute, List Folder Contents, and Read. Click OK. Click OK.

· Windows 2003 and Windows XP: Enable the following Access Permissions: Read, Run Scripts (such as ASP), and Browse by checking the box next to each one, if not enabled. Click Next, and click Finish. Website appears in the virtual directory list.

Virtual directories for Output and Website will be created.

11. Use the Diagnostics tool to test the ArcIMS installation: Verify that the ArcIMS installation was successful.

A. Navigate to Start > [All] Programs > ArcGIS > ArcIMS > ArcIMS Diagnostics.
B. Verify that the Web server protocol and the Web server name are correct, including the domain and port number. The default is port 80.
C. On Windows XP/2003 machines, Internet Explorer sometimes does not show the host name and port number. If this is the case, right-click near the top of the window, under the address bar, and select 'Allow Blocked Content'.
D. Test both components.
The result for Test 1 should be:

IMS v10.0.0
Build_Number=1XX.1916
Version=10.0.0
Test successful

The result for Test 2 should be:

Version=10.0.0
Build_Number=1XX.2159
Test successful

E. If these tests are successful, the ArcIMS Application Server and ArcIMS Servlet Connector are configured correctly. If an error message is received, select the error number from the drop-down list and click View. The error number and a description displays. Follow the instructions in the description to fix the problem and run the Diagnostics tool again.

Configuring IIS with ServletExec Application Server 6.0 for Service Administrator

To use the ArcIMS Service Administrator to remotely administer ArcIMS services, deploy the esriadmin Web application in ServletExec Application Server 6.0.

Follow these steps to manually configure IIS with ServletExec AS 6.0 for Service Administrator:

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

A. Click Start > [All] Programs > New Atlanta > ServletExec 6.0 AS > ServletExec Admin to open ServletExec Admin.
B. In the left sidebar under Web Applications, click Manage.
C. Click Add Web Application.

2. For Application Name, type: esriadmin

3. For URL Context Path, type: /esriadmin
This is the name to use to run the ArcIMS Service Administrator.

Note:
The context path specified is case-sensitive. More than one Web Application may be created with path names like ESRIadmin or ESRIADMIN pointing to the ArcIMS Service Administrator.

4. For Location, type:
<ArcIMS Installation Directory>\ArcIMS\Administrator\esriadmin.war
Click OK.

5. Click Submit and close ServletExec Admin.

6. Restart services:

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services.
Stop and Start the IIS Admin and World Wide Web Publishing services.
· On Windows 2008, click Start > Administrative Tools > Internet Information Services (IIS) Manager. Click on the machine name. On the right side under Actions > Manage Server, click Restart.


When the WAR file is deployed, the servlet engine expands the WAR file. The default location is: <servlet install directory>\se-<instance>\ServletExec Data\default\esriadmin\WAR.

See the ArcGIS Installation Guide help files for more information: Installing ArcIMS on Microsoft Windows, Step 5: Configure ArcIMS for the final step required to get ArcIMS running.

Configuring IIS with ServletExec Application Server 6.0 for the WFS connector

Follow these steps to configure IIS with ServletExec AS 6.0 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 deploy.

A. Click Start > [All] Programs > New Atlanta > ServletExec 6.0 AS > ServletExec Admin to open ServletExec Admin.
B. In the left sidebar under Web Applications, click Manage.
C. Click Add Web Application.

2. For Application Name, type: wfsconnector

3. For URL Context Path, type: /wfsconnector
This is the name to use to run WFS administrator and applications.

Note:
The context path specified is case-sensitive. More than one Web Application may be created with path names like WFSConnector or WFSCONNECTOR.

4. For Location, type: <ArcIMS install directory>\ArcIMS\Connectors\wfs_connector\wfsconnector.war
Click OK.

5. Click Submit and close ServletExec Admin.

6. Restart services

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services.
Stop and Start the IIS Admin and World Wide Web Publishing services.
· On Windows 2008, click Start > Administrative Tools > Internet Information Services (IIS) Manager. Click on the machine name. On the right side under Actions > Manage Server, click Restart.


When the WAR file is deployed, the servlet engine expands the WAR file. The default location is <servlet install directory>\se-<instance>\ServletExec Data\default\wfsconnector\WAR.

To complete configuration of the WFS 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.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 IIS with ServletExec Application Server 6.0 for the WMS connector

Follow these steps to configure IIS with ServletExec AS 6.0 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 deploy.

A. Click Start > [All] Programs > New Atlanta > ServletExec 6.0 AS > ServletExec Admin to open ServletExec Admin.
B. In the left sidebar under Web Applications, click Manage.
C. Click Add Web Application.

2. For Application Name, type: wmsconnector

3. For URL Context Path, type: /wmsconnector
This is the name to use to run WMS administrator and applications.

Note:
The context path specified is case-sensitive. More than one Web Application may be created with path names like WMSConnector or WMSCONNECTOR.

4. For Location, type: <ArcIMS install directory>\ArcIMS\Connectors\wms_connector\wmsconnector.war
Click OK.

5. Click Submit and close ServletExec Admin.

6. Restart services:

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services.
Stop and Start the IIS Admin and World Wide Web Publishing services.
· On Windows 2008, click Start > Administrative Tools > Internet Information Services (IIS) Manager. Click on the machine name. On the right side under Actions > Manage Server, click Restart.


When the WAR file is deployed, the servlet engine expands the WAR file. The default location is <servlet install directory>\se-<instance>\ServletExec Data\default\wmsconnector\WAR.

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 IIS with ServletExec Application Server 6.0 for the CS-W connector

Follow these steps to configure IIS with ServletExec AS 6.0 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 deploy.

A. Click Start > [All] Programs > New Atlanta > ServletExec 6.0 AS > ServletExec Admin to open ServletExec Admin.
B. In the left sidebar under Web Applications, click Manage.
C. Click Add Web Application.

2. For Application Name, type: aimscsw

3. For URL Context Path, type: /aimscsw
This is the name to use to run the CS-W connector.

Note:
The context path specified is case-sensitive. More than one Web Application with path names like AimsCSW or AIMSCSW may be created.

4. For Location, type: <ArcIMS install directory>\ArcIMS\Metadata\CSW\Connector\aimscsw.war

5. Click Submit and close ServletExec Admin.

6. Restart services:

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services.
Stop and Start the IIS Admin and World Wide Web Publishing services.
· On Windows 2008, click Start > Administrative Tools > Internet Information Services (IIS) Manager. Click on the machine name. On the right side under Actions > Manage Server, click Restart.

7. 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>\ServletExec Data\default\aimscsw\WAR.

Configuring IIS with Servlet Exec AS 6.0 for OAI-PMH connector

Follow these steps to configure IIS with ServletExec 5.0/6.0 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 deploy.

A. Click Start > [All] Programs > New Atlanta > ServletExec 6.0 AS > ServletExec Admin to open ServletExec Admin.
B. In the left sidebar under Web Applications, click Manage.
C. Click Add Web Application.

2. For Application Name, type: aimsharvester

3. For URL Context Path, type: /aimsharvester
This is the name to use to run the OAI-PMH connector.

Note:
The context path specified is case-sensitive. More than one Web Application with path names like AimsHarvester or AIMSHARVESTER may be created.

4. For Location, type: <ArcIMS install directory>\ArcIMS\Metadata\OAI-PMH\Connector\aimsharvester.war

5. Click Submit and close ServletExec Admin.

6. Restart services:

· On Windows XP, click Start > Control Panel > [Performance and Maintenance] > Administrative Tools > Component Services and click Services on the Tree tab. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Vista, click Start > Control Panel (switch to Classic View, if necessary) > Administrative Tools > Services. Restart the IIS Admin and World Wide Web Publishing services.
· On Windows Server 2003, click Start > Control Panel > Administrative Tools > Services.
Stop and Start the IIS Admin and World Wide Web Publishing services.
· On Windows 2008, click Start > Administrative Tools > Internet Information Services (IIS) Manager. Click on the machine name. On the right side under Actions > Manage Server, click Restart.

7. 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: http://webhelp.esri.com/arcims/9.3/General/mergedProjects/Creating_Metadata_Services/topics/addoaipmhconnector.htm

After saving the changes and restarting the servlet engine and Web server, verify 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 servlet engine expands the WAR file when the WAR file is deployed. The default location is <servlet install directory>\ServletExec Data\default\aimsharvester\WAR.

Related Information