Preparation steps for Windows

Only Windows XP is supported for this workshop.

Download

A copy of the download files are available at http://www.euro-vo.org/dcaworkshop2008/CommonSoftware/Windows/

You are however advised to get the files from their original source. This will allow you to revise any applicable End User Agreements and software licenses before installing, and to know where to get updated versions of the software in the future.

Java JDK 1.5

Download

Open the following URL: http://java.sun.com/javase/downloads/index_jdk5.jsp and click on the "Download" button next to "JDK 5.0 Update 15". Download the "Windows", "Multi-language", "Offline Installation" installation file (jdk-1_5_0_15-windows-i586-p.exe)

Install

Execute the installation program:

jdk-1_5_0_15-windows-i586-p.exe

Follow the wizard for the installation of the Java JDK and JRE on your computer. The Java JDK is installed by default in C:\Program Files\Java\jdk1.5.0_15. If that is not the case in your system, please replace the examples below with the correct value.

Configure

You now need to set the following environment variables:

JAVA_HOME=C:\Program Files\Java\jdk1.5.0_15

And add java to your PATH:

PATH=C:\Program Files\Java\jdk1.5.0_15\bin

Tomcat 5.5

Download

Open the following URL: http://tomcat.apache.org/download-55.cgi#Binary%20Distributions and download the "Windows Service Installer" installation file.

Install

Execute the installation program:

apache-tomcat-5.5.26.exe

Follow the wizard for the installation of Tomcat on your computer. Tomcat is installed by default in C:\Program Files\Apache Software Foundation\Tomcat 5.5. If that is not the case in your system, please replace the examples below with the correct value.

When prompted for the administration settings : leave the port ("8080") and the username ("admin") as is; input a password of your choice ("admin" is a common choice for testing purposes).

Configure

You now need to set the following environment variables:

CATALINA_HOME=C:\Program Files\Apache Software Foundation\Tomcat 5.5
CATALINA_BASE=C:\Program Files\Apache Software Foundation\Tomcat 5.5

MySQL 5.0

Download

Open the following URL: http://dev.mysql.com/downloads/mysql/5.0.html#win32 and download the "Windows ZIP/Setup.EXE" installation file.

Install

Unpack the MySQL package by right-clicking and selecting "Extract All...", or using your ZIP tool.

Execute the installation program:

Setup.exe

Follow the wizard for the installation of MySQL on your computer ("Typical" installation is fine). MySQL is installed by default in C:\Program Files\MySQL\MySQL Server 5.0. If that is not the case in your system, please replace the examples below with the correct value.

Run the "Configuration Wizard". The default settings are OK. Give a password for the root user ("root" is a common choice for testing purposes). If you create an Anonymous Account, you will be able to connect to your database with having to create a database user.

Configure

You now need to set the following environment variables:

MYSQL_HOME=C:\Program Files\MySQL\MySQL Server 5.0

And add MySQL to your PATH:

PATH=C:\Program Files\MySQL\MySQL Server 5.0\bin

Ant

Download

Open the following URL: http://ant.apache.org/bindownload.cgi#Current%20Release%20of%20Ant and download the ".zip archive" installation file (apache-ant-1.7.0-bin.zip).

Install

Unpack the Apache Ant package by right-clicking and selecting "Extract All...", or using your ZIP tool.

Move the extracted folder apache-ant-1.7.0 to your programs folder (usually C:\Program Files\, making C:\Program Files\apache-ant-1.7.0 the location of Apache Ant)

Configure

You now need to set the following environment variables:

ANT_HOME=C:\Program Files\apache-ant-1.7.0

And add Ant to your PATH:

PATH=C:\Program Files\apache-ant-1.7.0\bin

Test the installation

Once you have installed and configured all the required software, you should run the test script.

This test script verifies that you have (details below):

• installed all required software
• server software (Tomcat, MySQL, PostgreSQL) are running
• made the necessary configurations
• set the environment variables as described

If all is well, you will be greeted with a success message; if not, with an error message. Additional software used only in some sessions (Perl, PostgreSQL) is also tested for; warning (instead of errors) are issued in case.

Steps

1. Download
2. Unpack
3. Configure
4. Run

Download

• • Windows: testsetup.zip
  • Linux or MacOSX: testsetup.tar.gz

Configure

You must edit the properties file test.properties to reflect some of your installation settings. If you followed the installation instructions most notably the usernames and passwords, there should be no need to edit this file.

If you already had some of the software installed and want to use it, make the appropriate changes to this file and you will be able to test all your environment is setup correctly. This also allows to verify that a computer other than your laptop can run the software required for the workshop.

Run

Before running the test script, the following installed server software must be running: Tomcat, MySQL, PostgreSQL

To run the test script, just execute on a command line (make sure the current directory is the "testsetup" directory):

• on Windows: test.bat
• on Linux and MacOSX: ./test.sh

Note: Java is required to run the test script.

What is tested:

Java JDK

• Version is 1.5
• JAVA_HOME environment variable set
• JAVA_HOME/bin is on the PATH

Ant

• Version is 1.6+
• ANT_HOME environment variable set
• ANT_HOME/bin is on the PATH

Tomcat

• Version is 5.5
• Running at http://localhost:8080
• Running under Java 1.5
• CATALINA_HOME and CATALINA_BASE environment variables set
• write permissions to CATALINA_BASE/webapps
• user admin/admin has "manager" role

MySQL

• Version is 5.0
• MYSQL_HOME environment variable set
• MYSQL_HOME/bin is on the PATH
• user root/root has can create databases

Perl 5 (optional)

• Version is 5

PostgreSQL (optional)

• user postgres/postgres can create databases

Known issues and troubleshooting:

• The first time the test script is run, a series of messages stating *sys-package-mgr*: processing new jar are displayed. These can be safely ignored.
• An error message appears sporadically stating Write end dead. Please re-run the test script, as it should disappear.
• If the first error message is Testing Java...  Failed to get environment, environ will be empty, you might be using a custom version of Java that is not adequate. Please download and install the Java JDK from Sun as described in the instructions.

About environment variables

Environment variables are system-wide settings that configure your computer. They are used, among other things, to make sure that several programs on your system are easy to find.

To set an environment variable in Windows:

• Right-click "My computer", and select "Properties". The "System Properties" window will open
• Select the "Advanced" tab, and click the "Environment variables" button
• The "User variables" have precedence, so we will use that list
  • To add a new environment variable, click the "New" button
  • To change an existing environment variable, click the "Edit" button
• The changes made to the list of variables are valid once you click the "OK" button, but not to already running application (e.g. the Command Prompt)

The PATH environment variable

The PATH environment variable allows easy access to several programs. If it already has a value, you should add the new value(s) to the beginning of the existing one using a semicolon ";" as separator, e.g:

Existing value:

C:\Programs\bin;C:\Programs\UnxUtils\usr\local\wbin;C:\Programs\PsTools

Values to add:

C:\Program Files\Java\jdk1.5.0_15\bin;C:\Program Files\MySQL\MySQL Server 5.0\bin;C:\Program Files\apache-ant-1.7.0\bin

Result:

C:\Program Files\Java\jdk1.5.0_15\bin;C:\Program Files\MySQL\MySQL Server 5.0\bin;C:\Program Files\apache-ant-1.7.0\bin;C:\Programs\bin;C:\Programs\UnxUtils\usr\local\wbin;C:\Programs\PsTools

Acknowledgments

These instructions were based upon PreparationWindows