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

Up one level

Which version of ServletExec is right for me?

These instructions apply only to ServletExec 5.0 with ArcIMS 9.0, using Apache web server (v. 1.3.x or 2.x) 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 5.0 AS for Apache 2.x on Windows and ArcIMS 9.0 click here.

Note: ServletExec 5.0 works fine with Apache 1.3.x, but if you want to use Apache 1.3.x with ArcIMS 9.0 and ServletExec, Esri may require you to use version 4.2 of ServletExec instead of version 5.0.
We say this because at the time of this writing, Esri did not offer any instructions for running SE 5.0/ArcIMS 9.0/Apache 1.3.x.
If using Apache 1.3.x, with ArcIMS 9.0, find out which versions of SE, that Esri will support.
From our standpoint, we see no reason why you could not use SE 5.0 with Apache 1.3.x as we have many, many non-ArcIMS customers who do this. But check with Esri to see if they will support this combination for use with ArcIMS 9.0.

A listing of all such Esri knowledge base articles can be found here.

Prior to Installation:

Before installing ServletExec you should first install the Java 2 SDK (not the JRE), Standard Edition version 1.4.2.
Note: The ArcIMS 9.0 Installation Guide states that SDK 1.3.1 or higher is supported, so we recommend that you use SDK 1.4.2 since it is newer.
In addition, that guide lists versions of JRE that you could use (instead of using the SDK), but if you use the JRE, there are several versions that Esri specifically states as NOT being supported with ArcIMS 9.0 (for its ArcIMS Manager and Java Viewers).
Therefore, to make your life easier, just install the SDK (i.e. don't use the JRE).
Sun's SDK/JDK 1.4.2 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 any of the following means:
  1. Allowing the ArcIMS post-installer to install a free 30-day evaluation license key into your ServletExec 5.0 installation.
  2. Entering the key that you receive when you purchase a ServletExec license.
In the 2nd case, the key (registration number) is entered in your browser via the Administration tool which is included with ServletExec.
See step 'c' below for specific information explaining how to enter your key after you have installed and tested ServletExec.

Before installing ServletExec with Apache, you should stop the Apache web server.

Installing ServletExec:

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

Choose 'yes' when prompted by the ServletExec AS installer to allow the installer to update httpd.conf for you.

After installing ServletExec with the Apache web server you should do the following:

  1. start up the Apache web server.
  2. open a browser window and access http://<hostname*>/ to verify that your web server is still able to serve you a simple static html page. If it cannot, then something is wrong with your web server. Diagnose and fix that before continuing.
  3. start up your ServletExec instance by running the StartServletExec.bat batch file from a command window or by starting the ServletExec Service (if you chose to install ServletExec as a Windows service during the SE AS installation.

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 #9
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 ServletExec.log output to Esri Support

b. To access the ServletExec main Admin UI, type in your browser:


After entering the username and password you specified during the SE installation, you should see the Main SE admin UI pages:

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)

d. Close ServletExec Admin (your browser window).

<hostname*> is the name of the computer on which the HTTP Web Server (Apache) 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