DimensioneX Change language Tomcat 3.3


Home
Features
Play Online
Download
Forum
Tutorial
Documentation
Wiki
Support
Resources
Members
Gadgets
Contacts
Links






free screen-saver
Fantasy Screensavers and Desktop Backgrounds

 


DimensioneX on SourceForge.net

 

How to download, install and configure 
the Tomcat 3.3 web server
in order to host and run DimensioneX games

KB Article n. 004
Updated: 19 August 2004
Originally for: DimensioneX 5.5.0

Abstract

Users could install and use Tomcat 3.3. This article assumes you have Java 1.4.0 or higher installed and explains how to download, install and configure Tomcat 3.3 for use with DimensioneX. 

Important notes

Note: These instructions won't work on later versions of Tomcat (4.x, 5.x).

Note2: These instructions assume you have Java2 version 1.4.0 installed under c:\jdk. If your Java installation is elsewhere, please take note of where exactly it is, because you will need this information for correct configuring.

Note3: These instructions will work both on the Java2 SDK (full) edition, and on the JRE (runtime environment only) edition. In the latter case, the Tomcat server home page on your PC won't show up, however, because it cannot be compiled. This won't affect DimensioneX anyway.

Note4: If in trouble, read carefully this article first, then go to our Support section if you have not solved your problem.

Downloading Tomcat 3

Tomcat (jakarta.apache.org/tomcat). It comes from a work group related to the worldwide famous web server Apache. It is freeware. It is 4.4 MB to download for the version 3.3. At present I recommend to use this one.

 

1. Download the product from http://jakarta.apache.org/tomcat and you should be able to find the version 3.3.2 between the "Release Builds". If you want to save time download it directly from this shortcut

2.    Once the ZIP file is opened by WinZip, extract the content on C:\ verifying that the checkbox "Use folder names" is checked so that the whole folder tree is re-created.

3.   Rename the folder you now have in your C: disk from "jakarta-tomcat-3.3" to "tomcat". This for simplicity only. 
At this point, Windows 98/ME users should go directly to the section below: "Additional instructions for Windows98/ME". Other users may continue.

Instructions for Windows XP / Windows 2000 / Windows NT

4.     Edit with a text editor (eg. Notepad) the file C:\tomcat\bin\startup.bat

5.     Put on top the command written in bold below, right after the "@echo off": Then save and close the file.

@echo off
set JAVA_HOME=C:\jdk\jre

Important! If your Java installation is not in c:\jdk please adjust the value above so that it matches your own situation. The folder you specify for "JAVA_ HOME" should contain at least a folder named bin (abbreviation for binaries) containing the java executables.

6.      Do the same with C:\tomcat\bin\shutdown.bat.

7.     Open a DOS Command Prompt window and type the following commands so that you can test it:

c:
cd \
cd tomcat
cd bin
startup

8.    If you get a screen like the one below, then OK you did it right.

2001-10-25 15:30:01 - ServerXmlReader: Config=$TOMCAT_HOME\conf\server.xml
2001-10-25 15:30:01 - PathSetter: home=C:\tomcat
2001-10-25 15:30:01 - ContextXmlReader: Context config=$TOMCAT_HOME\conf\apps-12
7.0.0.1.xml
2001-10-25 15:30:01 - ContextXmlReader: Context config=$TOMCAT_HOME\conf\apps-ad
min.xml
2001-10-25 15:30:01 - ContextXmlReader: Context config=$TOMCAT_HOME\conf\apps-ex
amples.xml
2001-10-25 15:30:01 - AutoWebApp: Loaded from config: DEFAULT:/admin
2001-10-25 15:30:01 - AutoWebApp: Loaded from config: DEFAULT:/examples
2001-10-25 15:30:01 - AutoWebApp: Auto-Adding DEFAULT:/
2001-10-25 15:30:01 - ContextManager: Tomcat configured and in stable state
2001-10-25 15:30:01 - ContextManager: Adding  DEFAULT:/admin
2001-10-25 15:30:01 - ContextManager: Adding  DEFAULT:/examples
2001-10-25 15:30:01 - ContextManager: Adding  DEFAULT:/ROOT
EmbededTomcat: Init time 1361
2001-10-25 15:30:02 - Http10Interceptor: Starting on 8080
2001-10-25 15:30:02 - Ajp12Interceptor: Starting on 8007
2001-10-25 15:30:02 - Ajp13Interceptor: Starting on 8009
EmbededTomcat: Startup time 211

If you are running Windows98 or WindowsME , it is quite likely that Tomcat won't start up. You will probably see a few error messages such as:

"No more environment space" 

"Invalid command"

possibly trnslated in your own language. This is becuase the tomcat startup script was probably perpared and tested for Windows NT/2000/XP. 

Luckily, starting from version 5.5.0, DimensioneX includes a batch file, tomstart.bat, which is actually capable of starting up Tomcat. Just read the following section.

Before proceeding, stop the web server. Usually you would use the specific bat file, which you call via the command:

shutdown

9. Done !!

Instructions for Windows98/ME users

  1. Copy the file C:\tomcat\lib\tomcat.jar in the java runtime libraries folder.
    If you have JDK/JRE 1.4.2 it is something like: C:\j2se\jre\lib\ext  
    If you have JDK/JRE 1.3.1 it is something like: C:\j2se\jre\ext
  2. If your java installation is somewhere else, just open tomstart.bat with a text editor and customise it accordingly.
  3. Launch the web server with the command:

    tomstart
  4. It is actually a good idea to create a desktop shortcut to launch the tomstart.bat file.
  5. When you want to shut down the web server just move to the tomcat DOS window, and use the key combination Ctrl-C.
  6. Done!

Install DimensioneX, configure it

Now you have the web server working, but still you have to add the necessary files to run DimensioneX. According to the instructions in the README.pdf file, you now have to download the DimensioneX kit, and unpack the content into c:\tomcat\webapps

This is not sufficient, though, because a file named WEB.XML is designed for use with another version of Tomcat. So: 

  1. Identify this file (it should be in C:\tomcat\webapps\WEB-INF ) and delete it or rename it to something different. 
  2. Then take the file named WEB_3.XML, rename it to WEB.XML. This one is designed for use with Tomcat 3.3.

Now your DimensioneX system based on Tomcat 3.3 should be ready to run. Stop and restart Tomcat 3.3 in order to make changes to take effect.

Test installation

The README.pdf file, will explain you how to test your installation and how to get the best out of your DimensioneX environment. In case of problems, just post on our forum.