Apache/JAVA/Tomcat/GeoServer/uDIG/Open JUMP Installation

thumbsshameServers

Nov 17, 2013 (3 years and 10 months ago)

216 views

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

Apache/JAVA/Tomcat/GeoServer/uDIG/Open JUMP
Installation

Table of Contents

1. Apache Installation 2
2. Installing JAVA JDK 1.4.2 in Windows 8
3. Apache Tomcat 11
4. Connecting Tomcat to Apache 16
5. Geoserver (Tomcat Installation) 19
6. Installing and running the uDIG application 20
7. Open Jump Installation (PIROL) edition 24





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

1

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

1. Apache Installation

The following are instructions for installing Apache for a 32-bit windows operating
system.

Step 1: Download the Win32 Binary.

The W32 Binary for verson 2.2.4 can be downloaded from:
http://httpd.apache.org/download.cgi?Preferred=http%3A%2F%2Fmirror.inetc.co.uk
%2Fapache

Downloading the Wind32 Binary from the Apache website


Step 2: Install Apache

The installation instructions can be found at:
http://httpd.apache.org/docs/2.2/platform/windows.html

• double click on the msi file to begin installation.

Installation Screen 1
• click on next




Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

2

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

Installation Screen 2
• accept the terms in the license agreement
• click on next



Installation Screen 3
• read the information about Apache HTTP Server if required
• click on next





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

3

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

Installation Screen 4
• enter the Network Domain [what does this mean?]
• enter the Server Name [what does this mean?]
• enter the Administrator’s Email Address
• check the option for installation for All Users on Port 80
• click on Next



Installation Screen 5
• select setup type as typical
• click on next





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

4

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

Installation Screen 6
• change the installation address if desired
• click on next



Installation Screen 7
• click on install





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

5

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

Installation Screen 8
Once installation is complete, the following screen appears.
• click on Finish.



Apache is now installed as a service which will start up when the server is turned on.
The service is named as ‘Apache2’

Step 3: Starting, Stopping & Checking the Apache Service

To check the server works

• open an internet browser and enter the web address:
http://localhost
This should return a web page which contains the text ‘It works!’.
This web page is: index.html
which is found in the root folder of the Apache set up which is:
C:\Program Files\Apache Software Foundation\Apache2.2\htdocs
%Apache%\htdocs [is this correct?]

Location of the Apache Configuration File

C:\Program Files\Apache Software Foundation\Apache2.2\conf\httpd.conf
%Apache%\conf\httpd.conf [is this correct?]

View Available Services

The services being run can be viewed using the Administrative Tools/Service option
on the start menu.
If this is not visible, it can be turned on by clicking on the ‘Display Administrative
Tools’ option in the advanced start menu options


Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

6

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter



Method 1 for Starting, Restarting and Stopping the Apache Service.

The Apache service can be started and stopped from the services window.


Method 2 for Starting, Restarting and Stopping the Apache Service.

Use the httpd.exe file via the command prompt.
The httpd.exe file is found at:
C:\Program Files\Apache Software Foundation\Apache2.2\bin\httpd.exe
%Apache%\bin\httpd.exe [is this correct?]

To start an installed Apache service
>httpd –n “Apache2” –k start
To stop an Apache service (2 options)
>httpd –n “Apache2” –k stop
>httpd –n “Apache2” –k shutdown
To restart an Apache service & force it to read the configuration file
>httpd –n “Apache2” –k restart




















Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

7

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

2. Installing JAVA JDK 1.4.2 in Windows
Double click in the downloaded file to begin the installation. The following screenshots will
show you the options you need to select. Make sure you follow and choose the settings as
displayed in these images:

1) Agree to the license










2) Keep default Installation path and click next to proceed











Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

8

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

3) Choose Browser Registration








4) Installing....






Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

9

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

5) Done!


















6) Reboot your machine




























Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.


10

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

3. Apache Tomcat

Step 1: Check that JDK is installed

Install the Java SE Development Kit (JDK) if not already done so. This is available to
download from
http://java.sun.com/javase/downloads/index_jdk5.jsp
As of writing
(March 2007) the latest version is JDK 5.0 Update 11. The JDK contains the Java
Runtime Environment (JRE) and command-line development tools

Step 2: Download Apache Tomcat

Download the Windows Service Installer, apache-tomcat-5.5.20.exe, from:
http://tomcat.apache.org/download-55.cgi



Step 3: Install Apache Tomcat

• double click on apache-tomcat-5.5.20.exe to begin the installation

Installation Screen 1
• click on next





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

11

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

Installation Screen 2
• click on I Agree



Installation Screen 3
• select the type of install as ‘Custom’
• select all the optional components except for service
• click on Next





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

12

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

Installation Screen 4
• change the installation folder if desired.
• click on Next



Installation Screen 5
• ensure that the port number is recorded as 8080
• keep the user name as admin
• make a note of the password chosen
• click on Next





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

13

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

Installation Screen 6
The installer uses either the registry or the JAVA_HOME environment variable to
determine the base path of the Java Runtime Environment installed as part of the
JDK.
• click on Install.



Installation Screen 7
Once installation is complete the following screen appears.
• click on Finish.




Step 4: Starting, Stopping & Checking the Tomcat Service

The Apache Tomcat service can be started and stopped from the services window.



Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

14

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter



To check that Apache Tomcat works.
Open an internet browser and enter the web address:
http://localhost:8080
This should return the following web page:



This web page is:
index.jsp
which is found in the root folder of the Tomcat set up which is:
C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps\ROOT
%TOMCAT%\webapps\ROOT [is this correct?]





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

15

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

4. Connecting Tomcat to Apache

STEP 1: Install the mod_jk module

[what is the mod_jk module?]

• download the mod_jk module ‘mod_jk-apache-2.2.4.so’ from the JK 1.2 binary
releases section of:
http://tomcat.apache.org/download-connectors.cgi
?
mod_jk-apache-2.2.4.so is for Apache 2.2 and works with Apache 2.2.3 and later




• rename mod_jk-apache-2.2.3 to mod_jk.so
• move mod_jk.so into the %APACHE%/modules directory (C:\Program
Files\Apache Software Foundation\Apache2.2\modules)

STEP 2: Update the Apache httpd.conf file

Update the Apache HTTP server httpd.conf file found at:
C:\Program Files\Apache Software Foundation\Apache2.2\conf\
%APACHE%\conf\

[what is the significance of these alterations?]

Add the following lines to the end of the file.
The alterations to take note of are the last lines containing the commands JkMount.
These give the types of web addresses which the Apache service redirects to the
Tomcat service.
In this case, the web addresses redirected will be:
http://localhost/geoserver*
http://localhost/*jsp

# Load mod_jk module
LoadModule jk_module modules/mod_jk.so


Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

16

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter



Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

# Where to find workers.properties
JkWorkersFile conf/workers.properties
# Where to put jk shared memory
JkShmFile logs/mod_jk.shm
# Where to put jk logs
JkLogFile logs/mod_jk.log
# Set the jk log level [debug/error/info]
JkLogLevel info
# Select the timestamp log format
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
# Send everything for context /geoserver to worker named worker1 (ajp13)
JkMount /geoserver* worker1
# Send all .jsp files to worker1
JkMount /*jsp worker1

STEP 3: Create the workers.properties file

• create a text file called workers.properties and place it in:
C:\Program Files\Apache Software Foundation\Apache2.2\conf
%APACHE%\conf

[what is the workers.properties file?]

• enter the following text into the workers.properties file:

# Define 1 real worker using ajp13
worker.list=worker1
# Set properties for worker1 (ajp13)
worker.worker1.type=ajp13
worker.worker1.host=localhost
worker.worker1.port=8009

Step 4: Check that the appropriate requests are being directed from Apache to
Tomcat

• copy index.jsp from
C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps\ROOT to
C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps
%TOMCAT%\webapps\ROOT to %TOMCAT%\webapps

The reason that the index.jsp file needs to be copied to the webapps folder is that
the line ‘JkMount /*jsp worker1’ looks for the *jsp file in the webapps folder, not the
webapps\ROOT folder.
The author has not found a way to direct Apache to the \ROOT folder though he
suspects that there is most definitely a way!
[Is there a way to direct the worker to the ROOT folder?]

17

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

The Apache Tomcat webpage should now be visible through:
http://localhost/index.jsp





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

18

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

5. GeoServer (Tomcat Installation)

Step 1: Download the War file

• download the War file from:
http://sourceforge.net/project/downloading.php?groupname=geoserver&filename=geo
server-1.6.4b-war.zip&use_mirror=kent



Installation Instructions

• ensure that the Apache Tomcat service is not running
• copy geoserver.war to:
C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps
%TOMCAT%\webapps
• start the Apache Tomcat service

The geoserver.war will extract all files into a folder geoserver within the webapps
folder.

GeoServer will now be available on:
http://localhost:8080/geoserver/

If Apache and Apache Tomcat have been successfully linked, GeoServer will also be
available on:
http://localhost/geoserver/









Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

19

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

6. Installing and running the uDIG application

Windows install:


1. Double-click the installer udig-1.1-RC14.exe





2. The installer will allow you to install uDig into the directory of your choice.






































Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

20

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

3. Agree to the License Agreement – uDig is made available under the LGPL.
























4. By default uDig will be installed into your Program Files directory.

























Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

21

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter


5. Shortcuts will be created in your start menu.























6. Click finish button, uDig has been installed on your computer.

























Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

22

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter



7. After completing the installation, run the uDig application from the Windows
Start->Programs menu




















8. Click on the Workbench arrow in the top right corner of the uDig welcome
Screen to open the uDig workbench area.





Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.


23

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

7. Open Jump Installation (PIROL) edition
Double click the OpenJump_PIROL-Edition.exe and select the language.











Click on “Next” button to continue the installation.























Choose the components which you want to install along with Open JUMP. There are
following components available
1) PIROL plugins
2) Other plugins
3) Java 1.50-3
4) JAI (Java Advanced Imaging)
5) Java 3D






Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.


24

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter























If you have Java already installed on your machine, then uncheck the checkbox and
click “next” button.



























Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

25

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter



Choose the folder in which you want to install Open JUMP and click “Next” button.























Click “Install” button to continue installation.
























Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

26

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter

Following is the screen showing the Open JUMP installation progress.



JAI (Java Advanced Imaging) Installation

While installation progresses, it will ask you to install JAI (Java Advanced Imaging)



Click “Next” button to continue JAI installation.


















Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.


27

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter


Click “Yes” button to accept the license agreement.


















Click “Next” button as JAI will get installed in Java folder by default.






























Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

28

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter


After this, JAI installation will get finished. Later installer will ask to install Java 3D.
Click “Yes” button to accept license agreement.























Click “next” button to continue the installation.
























Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

29

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter



Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

30



Installer will install Java 3D in JDK folder by default and click “Next” button to
continue.























Click “Next” button to continue the installation.




















Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter


Click “finish” button to finish the Java 3D installation.























Click “Finish” button to finish Open JUMP installation.

























Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

31

Open Source Geospatial tools workshop
28th – 30th August 2008
Pune Chapter


Installing the PostGIS/SRID PlugIn:

Later, unzip the file jump_postgis_plugin_srid_v1.2.1.zip and extract it into a folder.

* place the file JumpPostGIS60415B.jar in the ...\lib\ext of your (Open-)JUMP folder
* place the file sridsupport.jar in the ...\lib\ext of your (Open-)JUMP folder
* place the postgresql driver file in the ...\lib\ext folder of your java installation
(e.g. for JRE 1.4 in the folder: c:\Program Files\Java\j2re1.4.2_04\lib\ext>)



Salim Ali Centre For Ornithology And Natural History (SACON), Hyderabad.

32