How to run DimensioneX
under Tomcat 4.1.x
KB Article n. 009
Date: 4 March 2003
Originally for: DimensioneX v.5.0.3
Abstract
DimensioneX version 5.0.3 and earlier will not run
out-of-the box on Tomcat 4.1.x. However, it is quite easy to run DimensioneX
under this version of Tomcat, simply by replacing one file.
This document tells you how to do this, letting you to take
advantage of the new features of Tomcat.
Which Tomcat 4?
1. On the Tomcat Web Site, the Tomcat
4.1.17 stable version has
just been released. This version is made for running on JDK1.4.
2. There are basically two editions: Standard
and JDK1.4LE. The second one is lighter, and this instruction have been
tested on this one. These instructions are assumed to work also on the Standard
edition and should work on other 4.x releases of Tomcat.
3. So, briefly, verify your Java version
is 1.4.x and - if you are a Windows user - download
jakarta-tomcat-4.1.17-LE-jdk14.exe which has a nice installer.
Install Tomcat 4
1. Install Tomcat 4 using the installer, and please use a
simple folder name such as:
D:\tomcat
instead of the proposed one. Take note of the drive letter
you specified (D or C or .. ?)
2. Test your Tomcat installation by running the server and
accessing for example http://localhost:8080/ If
the tomcat home page appears, then OK proceed. Otherwise, refer to tomcat's
documentation.
Install and patch Dimensione X
- Now unpack the dimensionex package into D:\tomcat (or
C:\tomcat) as explained in the DimensioneX readme file (that is, keeping
folder structure).
- The dimensioneX server will not run immediately you now
need this patch (removed).
- Unpack the patch file, extract from the patch ZIP archive
the web.xml file and place it in the webapps/dimx/WEB-INF
folder of your tomcat installation. You will replace a file with the same
name which should be already there. Done!
DimensioneX should be able to correctly run as explained in
its Readme document. You should be able to test world3 and also the
other games.
If you make a mistake, you will be able however to read the
result on the DimensioneX log file or browser, depending of the version you
are using.
As always, if you run into problems ask for support.
|