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>
By this (insert an actual password instead of {MY_PASSWORD},
admin
will do fine) :
<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