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

Up one level

Which version of ServletExec is right for me?

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

The instructions at this website are provided by New Atlanta Communications.
In addition to these instructions, Esri provides its own steps for installation and configuration of ServletExec and ArcIMS.
For ServletExec 4.1.1 ISAPI on Windows and ArcIMS 4.0.1 click here.
For ServletExec 4.2 ISAPI on Windows and ArcIMS 4.0.1 click here.
A listing of all such Esri knowledge base articles can be found here.

Prior to Installation:

Before installing ServletExec version 4.1.1 or 4.2 you must first install the Java 2 SDK, Standard Edition version 1.4.0 (this is the version of JDK recommended by Esri for use with ArcIMS 4.0.1). The SDK/JDK 1.4.0 can be freely downloaded from Sun's Website.

Note: Another term for JDK is SDK (Software Development Kit).

Esri also requires that the installed copy of ServletExec be a fully enabled/licensed* one prior to running ArcIMS. (An unlicensed copy of ServletExec will not be sufficient for running ArcIMS.)

*You may fully enable your free copy of ServletExec by:
  1. Entering the key that you receive when you purchase a ServletExec license.
  2. Obtaining a 30-day evaluation key for free, and entering it.
In either case, the key (registration number) is entered in your browser via the Administration tool which is included with ServletExec.
See step 'b' below for specific information explaining how to enter your key after you have installed and tested ServletExec.

Before installing ServletExec for Microsoft IIS, it's very important to completely stop your IIS web server. Here are instructions for stopping IIS to make sure the ServletExec installation is completed properly... Stop IIS

Installing ServletExec:

On the ArcIMS 4.0.1 Installation CD, you'll find ServletExec_ReadMe.html in the ServletExec folder.
It contains useful information and links to the ServletExec documentation and installers. The ServletExec 4.1.1 Installation Guide is a great resource for installing ServletExec. It contains Screen shots and other useuful steps and information for installing ServletExec.

Follow the ServletExec Installation Guide as the installation wizard guides you through the installation process.

After installing ServletExec for Microsoft IIS, it's very important to completely stop and restart the IIS web server. Here are instructions for stopping and restarting IIS to make sure the ServletExec installation is completed properly... Stop and Start IIS

To verify the ServletExec installation was successful:

a. Open a browser window and type:


If you see the TestServlet Output screen, your install was successful and you may continue. If you don?t see this screen, something is wrong. Carefully review the ServletExec Installation Guide and the FAQs at this website to make sure all installation steps have completed properly. One specific FAQ that may be of general assistance in this case is:
FAQ #7
If that FAQ does not help you to solve the problem, then please send an email describing the problem along with any relevant data such as DBMON or ServletExec.log output to Esri Support

b. To fully enable/license ServletExec type in your browser:


c. Access the license & security page, and in the License key box, paste in your license code and click Enter License Key. (Typing the key in manually can be error prone)
If you have not yet purchased an SE license key, and wish to "try before you buy", a 30-day evaluation key can be obtained from New Atlanta for free.
If you receive an error when trying to enter a license key, please see:
FAQ #60
Note: Once SE is registered, it is possible to specify an admin username in order to password-protect access to the SE admin UI. If you choose to do this, you should first read section 2.6.2 of the ServletExec 4.1.1 Installation Guide and FAQ #65

d. Close ServletExec Admin (your browser window).

<hostname*> is the name of the computer on which the HTTP Web Server (IIS) is installed.
If your browser is running on the same machine as your Web Server, then localhost or will usually work here.

company media information terms of use privacy policy contact us