Preparation steps for MacOSX

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.

Only MacOSX 10.4.x is supported for this workshop.

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/MacOSX/

Note: download only the MySQL package for your Mac platform.
Either mysql-5.0.41-osx10.4-powerpc.tar.gz for the old PowerPC based Mac,
or mysql-5.0.41-osx10.4-i686.tar.gz for the new Intel based Mac.

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

I chose for example :

/Users/astebe/Desktop/Euro-VO_Workshop/

Open the Terminal application (in "Applications/Utilities/Terminal") and go to your working directory.

You should have something like this :

dhcp-131-176-164-181:~ astebe$ cd Desktop/Euro-VO_Workshop/
dhcp-131-176-164-181:~/Desktop/Euro-VO_Workshop astebe$ ls -l
total 431520
-rwxr--r--   1 astebe  astebe   42045440 Jun 21 17:42 jakarta-tomcat-5.0.28.tar.gz
-rwxr--r--   1 astebe  astebe  178892800 Jun 21 17:47 mysql-5.0.41-osx10.4-i686.tar.gz
-rwxr--r--   1 astebe  astebe  180858880 Jun 21 17:47 mysql-5.0.41-osx10.4-powerpc.tar.gz

Install and configure Java JDK 1.5

You shouldn't need to install the Java JDK 1.5 on MacOSX as it is already on your system.

To check this, type:

javac -version

You should get:

dhcp-131-176-164-181:~/Desktop/Euro-VO_Workshop astebe$ javac -version
javac 1.5.0_07
javac: no source files
Usage: javac <options> <source files>
where possible options include:
 ......
 ....
 ...

If this is not the case, you need to update your system.
Open the "Software Update" utility, an update package should appear for Java, you need to install it.

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

export JAVA_HOME=/usr

Install and configure Tomcat 5.0

Unpack the Tomcat package :

tar xvfz jakarta-tomcat-5.0.28.tar.gz

Note: if you downloaded the package using Safari, your browser might have already uncompressed the file.
In that case use      tar xvf jakarta-tomcat-5.0.28.tar      instead.

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
pico 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:       /usr

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:       /usr

Finally, go back to your working directory :

cd ..

Install and configure MySQL 5.0

Unpack the MySQL package (using one of) :

tar xvfz mysql-5.0.41-osx10.4-i686.tar.gz
tar xvfz mysql-5.0.41-osx10.4-powerpc.tar.gz

Note: if you downloaded the package using Safari, your browser might have already uncompressed the file.
In that case use      tar xvf mysql-5.0.41-osx10.4-{YOUR_ARCH}.tar      instead.

Create a link to this newly installed software for easy access (using one of) :

ln -s mysql-5.0.41-osx10.4-i686 mysql
ln -s mysql-5.0.41-osx10.4-powerpc 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