Preparation steps for Linux

For all the hands on sessions you will need 3 common software:

• Java JDK 1.5 (programmation language development environment)
• Tomcat 5.0 (application server to install your newly created services)
• MySQL 5.0 (relational database server to contain the data/metadata)

We invite you to install those in advance to be ready for the workshop.

Due to the large variety of Linux platforms, we tried to provide steps that should work on most distributions.
Help will be provided on the first day of the workshop if you encounter difficulties.

Note: the values in uppercase between curly brackets must be replaced by your own values.
For example, replace all {YOUR_PASSWORD} occurrences by an actual password of your choosing.

Download the packages

Open the following URL and download all the packages in a working directory.

http://esavo.esac.esa.int/EuroVOWorkshopJune2007/Software/Linux/

The "working directory" will be used to install those software and to work during the workshop.

I chose for example :

/home/astebe/Euro-VO_Workshop/

Open a terminal and go to your working directory. You should have something like this :

[astebe@satl15:/home/astebe]> cd Euro-VO_Workshop
[astebe@satl15:/home/astebe/Euro-VO_Workshop]> ls -l
total 116M
-rw-r--r--  1 astebe 11M Jun 21 14:53 jakarta-tomcat-5.0.28.tar.gz
-rw-r--r--  1 astebe 48M Jun 21 14:53 jdk-1_5_0_12-linux-i586.bin
-rw-r--r--  1 astebe 58M Jun 21 14:53 mysql-5.0.41-linux-i686.tar.gz

Eventually, add the "executable" mode on the files if needed :

chmod u+x *

Install and configure Java JDK 1.5

Execute the installation script from SUN :

./jdk-1_5_0_12-linux-i586.bin

You will be asked to agree to the license terms and the package will be installed.

Create a link to this newly installed software for easy access :

ln -s jdk1.5.0_12 java

You now need to tell your system where the Java JDK is :

For    csh    do:

setenv JAVA_HOME {YOUR_WORKING_DIR}/java

For    bash    do:

export JAVA_HOME={YOUR_WORKING_DIR}/java

Install and configure Tomcat 5.0

Unpack the Tomcat package :

tar xvfz jakarta-tomcat-5.0.28.tar.gz

Create a link to this newly installed software for easy access :

ln -s jakarta-tomcat-5.0.28 tomcat

Edit the user configuration file :

cd tomcat
nedit conf/tomcat-users.xml

You should change the file from this :

<!--
  NOTE:  By default, no user is included in the "manager" role required
  to operate the "/manager" web application.  If you wish to use this app,
  you must define such a user - the username and password are arbitrary.
-->
<tomcat-users>
  <user name="tomcat" password="tomcat" roles="tomcat" />
  <user name="role1"  password="tomcat" roles="role1"  />
  <user name="both"   password="tomcat" roles="tomcat,role1" />
</tomcat-users>

To this :

<!--
  NOTE:  By default, no user is included in the "manager" role required
  to operate the "/manager" web application.  If you wish to use this app,
  you must define such a user - the username and password are arbitrary.
-->
<tomcat-users>
  <user name="admin" password="{YOUR_PASSWORD}" roles="admin,manager" />
</tomcat-users>

Now, try to start your Tomcat server :

./bin/startup.sh

You should get :

Using CATALINA_BASE:   {YOUR_WORKING_DIR}/tomcat
Using CATALINA_HOME:   {YOUR_WORKING_DIR}/tomcat
Using CATALINA_TMPDIR: {YOUR_WORKING_DIR}/tomcat/temp
Using JAVA_HOME:       {YOUR_WORKING_DIR}/java

And shutdown your Tomcat server :

./bin/shutdown.sh

You should get :

Using CATALINA_BASE:   {YOUR_WORKING_DIR}/tomcat
Using CATALINA_HOME:   {YOUR_WORKING_DIR}/tomcat
Using CATALINA_TMPDIR: {YOUR_WORKING_DIR}/tomcat/temp
Using JAVA_HOME:       {YOUR_WORKING_DIR}/java

Finally, go back to your working directory :

cd ..

Install and configure MySQL 5.0

Unpack the MySQL package :

tar xvfz mysql-5.0.41-linux-i686.tar.gz

Create a link to this newly installed software for easy access :

ln -s mysql-5.0.41-linux-i686 mysql

Execute the "configure" script provided :

cd mysql
./configure

Set a password for the "root" user as the script indicates you :

./bin/mysqladmin -u root password {YOUR_PASSWORD}

In the end, shut down your MySQL server :

./bin/mysqladmin shutdown -u root -p
(type in your password)

Finally, go back to your working directory :

cd ..

You are now ready to start the hands on sessions of the workshop. Well done !

-- AurelienStebe - 21 Jun 2007