Running ArcIMS9.1 with Tomcat5.5 in Windows - Part C: Configure Virtual Directory

Use virtual directory in Tomcat5.5 Application Server

1. Create ArcIMS Website and Ouput folders at desired location, for example,
D:\arcgis\ArcIMS\Website
D:\arcgis\ArcIMS\Output
Note: both of folders have been created in for sample as installing ArcIMS9.1. They can be copied to the path above.

2. Create xml-format context files for both directories in Tomcat, they are put in \conf\Catalina\localhost\ for virtual directory service, for example, if the website is ArcIMS_WebSite and output site it ArcIMS_OutputSite, then create ArcIMS_WebSite.xml and ArcIMS_OutputSite.xml with following content, respectively, (omit ... symbol since it is escape character)
<...?xml version="1.0" encoding="UTF-8"?...>
<...Context path="/ArcIMS_WebSite" docBase="D:\arcgis\ArcIMS\Website" debug="0" privileged="true" /...>

<...?xml version="1.0" encoding="UTF-8"?...>
<...Context path="/ArcIMS_OutputSite" docBase="D:\arcgis\ArcIMS\Output" debug="0" privileged="true" /...>

3. Run ArcIMS Administrator, with correct login username and password, the web folder, server and service will be listed.

4. Check view->site properties, input data for ArcIMS Site and Server Ouput tags:
in ArcIMS Site tag, make sure hostname and host alias are correct, then input HTTP Location (URL) and Web Site Directory. For example:
http://server_name:8000
D:\arcgis\ArcIMS\Website
in Server Output tag, input Directory Location and HTTP Location (URL), e.g.
D:\arcgis\ArcIMS\Output
http://server_name:8000/ArcIMS_OutputSite

5. Check service item, and create new service. Herein, in Service pan, the name, map file and virtual server are required. For example, set them as
ServiceTest
mapfile.mxd
ImageArcMapServer1
Note: as selecting map file, if mxd format file is selected, the virtual server must be ImageArcMapServer; if axl format file is selected, the virtual server would be ImageServer. The mxd file is created by ArcMap tool, the axl file is created by ArcIMS Author tool.

6. Then, go to check service output in the same panel, the image type should be jpeg format, the output directory and URL should be the same as setup above, i.e.
D:\arcgis\ArcIMS\Output
http://server_name:8000/ArcIMS_OutputSite

7. Click OK! If the service works, the service status would be running.

8. It is also available to create a virtual server by selecting server item and indicating server type. The new virtual server can be assigned to service.

9. Check Tools->Start Designer, input a web site directory, say ShapeTest, the folder “ShapeTest” will be created under D:\arcgis\ArcIMS\Website\ and include all material related to display image map.

10. Determinate a hostname and connect it, then select a service for display map.
Note: the hostname will be a key to browse it from the client site. For example, if the hostname is servername in this case, it might be only browsed at local machine or local network; e.g., http://server_name:8000/.... If the hostname is intranet IP address, such as 192.168.1.2, or internet IP like 140.128.65.114, it would be able to work through internet.

11. Follow up indication for choosing viewer such as html or Java viewer and click OK. HTML viewer will be recommended for easy setup.

12. When it is done, click “create site” button to complete.

Open the browser, type the website to view. For example in this case,
http://server_name:8000/ArcIMS_WebSite/ShapeTest
if the hostname is IP like 192.168.1.2, the it would be
http://192.168.1.2:8000/ArcIMS_WebSite/ShapeTest