Prior to Installation:
Before installing ServletExec version 4.1.1 or 4.2 for use with ArcIMS 4.0.1,
you must first install the Java 2 SDK, Standard Edition.
For Red Hat Linux 7.1, ESRI appears to recommend J2SDK version 1.4.0
The SDK/JDK 1.4.0 can be freely downloaded from Sun's Website.
For Sun Solaris 7, ESRI appears to recommend version J2SDK 1.3.1_02
The SDK/JDK 1.3.1 can be freely downloaded from Sun's website
Note: Another term for JDK is SDK (Software Development Kit).
While ServletExec itself is officially supported with other versions of JDK/SDK, and other Unix OS flavors than those listed above,
please be aware that since you'll be running the ArcIMS Connector Servlet inside of ServletExec
and since ESRI has some specific requirements concerning ArcIMS, we encourage you to
check with ESRI to ensure that you are using a version of JDK/SDK (and Operating System and webserver) which ArcIMS 4.0.1 supports.
The ArcIMS 4.0.1 System Requirements section of
the ESRI website would be a good place to begin looking for this sort of information.
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:
- Entering the key that you receive when you
purchase a ServletExec license.
- 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 with Apache, you should stop the Apache web server.
Installing ServletExec:
Follow the
ServletExec Installation Guide
as the ServletExec installation script prompts 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:
- start up the Apache web server.
-
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.
-
start up your ServletExec instance by running the StartServletExec script file from
a command window
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 #14
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 ServletExec.log output
to ESRI Support
b. To fully enable/license ServletExec type in your browser:
http://<hostname*>/servlet/admin
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 127.0.0.1 will usually work here.