Application Server Solutions for Microsoft IIS and ASP.NET
       solutions   products   partners   company   support   downloads         store
Integrating ServletExec 3.1 with ArcIMS

Up one level

Which version of ServletExec is right for me?

These instructions apply only to ServletExec 3.1, 4.0, or 4.1 with ArcIMS 3.1, using Microsoft IIS web server on the Windows operating system. Instructions for integrating other versions of ServletExec and ArcIMS can be found here.

Installing ArcIMS 3.1:

a. Run ArcIMS setup.exe.

b. At the Welcome screen, click View Readme to read about last-minute changes to the ArcIMS installation instructions. Close the window when done.
Click Next.
At the License Agreement screen, click I Agree.

c. At the Installation screen, click Typical and click Next.

d. At the Installation Directory screen, click Browse to change the installation directory, if desired, and click OK. Click Next.

e. If JRE 1.3.0_02 is not installed or not detected, a Java Runtime Environment Installation screen displays. You must have JRE installed to install and run ArcIMS Manager and the Java Viewers. Click OK to begin JRE installation or Browse to an existing JDK location. After JRE installation, click Next to continue ArcIMS installation.

f. At the Host Name and Working Directories screen, choose a protocol and change the Web Server Host Name, if needed. If you are setting up an Internet Web site or a multiple ArcIMS Spatial Server configuration, you must include your domain name, for example, If your web server has a port number other than the default HTTP port (80), then it should have the syntax webservername:port number, for example,

g. For the Web Site Working Directory, accept the default location to store Web pages and ArcIMS output, or click Browse to change the directory. If you keep the default, after installation you must create virtual directories for output and website. See step 5 for instructions. If you navigate to the location of your Web server root directory, then you don?t need to create virtual directories for output and Web site.

h. For the User?s Working Directory, accept the default location or click Browse to navigate to another location.
Click Next.

i. At the Application Server Information screen, change the Registry Port and Connector Port, if desired. The ArcIMS Spatial Server, Monitor, and Tasker communicate with the ArcIMS Application Server via the Registry port. The Servlet Connector and ArcIMS Application Server communicate via the Connector port. Click Next.

j. At the Servlet Connector Directory screen, navigate to the location of your Servlets directory, for example:

    \Program Files\New Atlanta\ServletExec ISAPI\Servlets

If you don?t know this location, click Help for a list of the most common Servlets directory locations. If you are unsure, use this location:

    \<ArcIMS Installation Directory>\Connectors\Servlet

and then later on contact your system administrator, because in this case, the servlet connector (com directory and associated files) must be copied from

    \<ArcIMS Installation Directory>\Connectors\Servlet

to the appropriate ServletExec directory before ArcIMS can be used. See step 5 for more details.

k. Click Next.

l. At the Windows Services Authorization screen, change your Domain\User Name, if necessary. The User Name and Password must be for the installation account and must have administrator privileges. This information gives ArcIMS the ability to start Windows services (ArcIMS Application Server, Monitor, and Tasker) and gives the ArcIMS Spatial Server the necessary privileges to access resources on the local computer and/or network.

m. Type your Password for the selected User Name and type it again to confirm it. Click Next.

n. At the Summary of Installation Information screen, verify that the information displayed is correct. After installation, it is written to a log file located at

    \<ArcIMS Installation Directory>\Common\InstallSummary.log

Click Next to begin installation.

Microsoft?s Java VM 3186 or later is required for the ArcIMS Windows Services. The installation prompts you to update your system if Microsoft Java VM is not detected or if you have an older version.

o. At the Installation Successful screen, click Finish to restart your computer. You must restart your computer to complete ArcIMS installation.

p. After ArcIMS installation, it is recommended that you update your Services file. This file contains a record of what ports are in use. It is typically located at


Open the Services file (usually named hosts in a text editor, scroll to the place where the port numbers fit in, and add the Connector and Registry port numbers to the file.

Save the file.

This tells your system administrator which ports are in use, so they will not be duplicated. The port numbers are listed on the ArcIMS Summary screen; this information is written to a summary log file located at

    \<ArcIMS Installation Directory>\Common


company media information terms of use privacy policy contact us