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 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 to input 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 -version
If Perl is not already installed or the version is inferior to version 5, use the ActivePerl distribution included on 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 : workshop.env

If you followed the preceding 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 paths, please set correctly the JAVA_HOME, TOMCAT_HOME and ANT_HOME environment variables.

Finally, load the edited environment config file : source workshop.env

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

Testing the workshop set-up

To test the Java JDK installation run : javac -version
You should get : javac 1.6.0_14

To test the Tomcat installation run : startup.sh
You should get :
Using CATALINA_BASE:   /home/user/work_dir/apache-tomcat-6.0.20
Using CATALINA_HOME:   /home/user/work_dir/apache-tomcat-6.0.20
Using CATALINA_TMPDIR: /home/user/work_dir/apache-tomcat-6.0.20/temp
Using JRE_HOME:       /home/user/work_dir/jdk1.6.0_14

Open http://localhost:8080/manager/html with your browser, it should ask you for your Tomcat manager username and password, and then give you the list of installed Tomcat WebApps.

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

To test the Apache Ant installation run : ant -version
You should get : Apache Ant version 1.7.1 compiled on June 27 2008

To test the PostGreSQL installation use the Start server, SQL Shell and Stop server you should find in the PostgreSQL sub-menu of your Applications menu.

If all went well, congratulations you are set and ready for the workshop tutorials.
If you encountered any problem, please ask for help from any of the tutors during the Monday morning "set-up session for participants".