Step 3: Tomcat

<- Step 2: SVG plugin Step 4: Hello geGIS ->

Installation - Configuration - Extra information

1. Tomcat installation

As geGIS also has a client and server side, you also need to install a web application server. Tomcat is a free, rapid and simple solution for Java technologies. You can download Tomcat at the Apache web site: Apache Tomcat 5.5. Try to find an .exe so you can go through the installation guide below.

Double click on the executable to start the installation:

Click next to continue.

Cilck “I agree” to accept the license agreement.

Choose normal installation and click next.

Click next.

Choose HTTP port 8080 and username admin (default values) and click next.

Select the location of your Java Runtime Environment (step1). If you didn't change the location, choose C:\Program Files\Java\jre1.5.0_10. Click install to continue.

Before you click 'Finish" make sure that “Run Apache Tomcat” is selected. Then you can test if the installation was completed succesfully.

You can just close the "read me" file.

Surf to http://localhost:8080/ and check whether the aforementioned page is shown. If this is the case, the Apache Tomcat has been properly installed.

Important: If your system uses a firewall the service may not have been started. This shows from the icon status in the system tray in the right bottom corner:

Service started (green arrow):
Service switched off (red arrow):

If the service has not been started you must temporarily deactivate the firewall (or correctly configure it, depending on the type of firewall) and then try to start the service again. In order to start the service, move the mouse to the status icon and click on the right mouse button. Then select the “Start service” option:

You'll get the following dialogue:

If the service started successfully the green arrow icon should be visible in the status bar:

If the problem still occurs, please contact your system administrator.

2. Tomcat configuration

Now that Tomcat has been installed, there are still two things to do. To make changes to Tomcat, it is better to close Tomcat first. (see above)
The first change you need to make is to add a number of users. GeGIS uses Tomcat users. In order to create these, simply copy this file to the Tomcat configuration directory. As a standard this is: “C:\Program Files\Apache Software Foundation\Tomcat 5.5\conf”. The system will ask whether you wish to overwrite the current file. Select “yes”.

There is another file (download here) which needs to be copied to the Tomcat bin directory. As a standard this is: “C:\Program Files\ Apache Software Foundation\Tomcat 5.5\bin”. This file will make sure that Tomcat has sufficient memory. Once this has been done, the Tomcat service can be restarted. To do so, return to the icon completely at the right bottom, press the second mouse button and select "Start service". You may test Tomcat again by surfing to http://localhost:8080/ again.

3. Extra information

If the computer is restarted the Tomcat icon at the right bottom may no longer be there. In this case you can go to "Apache Tomcat 5.5" and then to "Monitor Tomcat" (see also figure below) via the Windows start menu.