Preparation steps for Linux

Any recent Linux distribution is supported and should work with the following steps.

Initial set-up steps

First, open a new terminal window and make sure you are running the BASH shell by typing : bash

Create a new working directory inside which you will install all the workshop software : mkdir {MY_WORKING_DIRECTORY}

Then, copy all the common software from the workshop DVD in your welcome package (/DVD/Software/Linux/)
or from the online DVD on our server to your new working directory.

Finally, move inside your working directory : cd {MY_WORKING_DIRECTORY}

Java JDK installation

Start the Java JDK installation and accept the license terms : sh jdk-6u14-linux-i586.bin

Tomcat installation

Unpack the Tomcat application : tar xvfz apache-tomcat-6.0.20.tar.gz

Tomcat configuration

Replace the following portion from the apache-tomcat-6.0.20/conf/tomcat-users.xml configuration file :

<tomcat-users>
<!--
  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <user username="tomcat" password="tomcat" roles="tomcat"/>
  <user username="both" password="tomcat" roles="tomcat,role1"/>
  <user username="role1" password="tomcat" roles="role1"/>
-->
</tomcat-users>

<tomcat-users>
  <role rolename="admin"/>
  <role rolename="manager"/>
  <user username="admin" password="{MY_PASSWORD}" roles="admin,manager"/>
</tomcat-users>

Apache Ant installation

Unpack the Apache Ant application : tar xvfz apache-ant-1.7.1-bin.tar.gz

PostGreSQL installation

Start the PostGreSQL installation and follow the wizard steps : sudo sh postgresql-8.3.7-1-linux.bin

Note that you will need your machine root password to realize this installation.
You do not need to modify any of the proposed configuration options except to introduce a password for the postgres user.

Perl check & installation

You should already have a recent version of Perl installed; check the version number by typing : perl -v

If Perl is not already installed or the version is inferior to version 5, use the ActivePerl distribution included in the workshop DVD. Ask a tutor if you encounter any issue in the process.

Environment variables set-up

Save the following text file inside your working directory and edit it :

If you followed the above instructions, using the supplied software versions, you only need to edit the WORK_DIR environment variable and set it to the full path of your directory.
If you used different versions or installation path, please set correctly the JAVA_HOME, TOMCAT_HOME and ANT_HOME environment variables.

Finally, load the edited environment config file : source workshopEnv

Remember that every time you open a new terminal window for the workshop tutorial, you need to make sure you are running BASH : bash ... and you load the environment config file : source /path/to/env/config/file/workshopEnv

Testing the workshop set-up

To test the Java JDK installation run : javac --version

To test the Tomcat installation run : startup.sh

Open URL with your browser, you should get the list of intalled Tomcat WebApps :

Don't forget to stop the Tomcat server : shutdown.sh

To test the Ant installation run : ant --version