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:
-
Allowing the ArcIMS post-installer to install a free 30-day evaluation license key into your ServletExec 5.0 installation.
- 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 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 9.0 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 Installation Guide is a great resource for installing ServletExec.
It contains Screenshots and other useful 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:
http://<hostname*>/servlet/TestServlet
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 access the ServletExec main Admin UI, type in your browser:
http://<hostname*>/servletexec/admin
After entering the username and password you specified during the SE installation, you should see the
Main SE admin UI pages:
c. If you intend to have the ArcIMS post-installer install a free 30-day evaluation key for ServletExec,
then you don't need this step. You would simply cycle ServletExec after the ArcIMS post-installer completes.
But if you have already purchased a full SE 5.x license key and you wish to use it now to fully enable/license
ServletExec, then access the license page, and in the License key box, paste in your license key and
click Enter License Key. (Typing the key in manually can be error prone)
If you receive an error when trying to enter a license key, please see:
FAQ #60
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 127.0.0.1 will usually work here.
products
