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

Perl 5 (optional)

Download

Open the following URL: http://www.activestate.com/store/activeperl/ and click "download" for "ActivePerl" (there is no need to fill in personal data). On the download page, download the "MSI" installation file for "ActivePerl 5.8.8.822"

Install

Execute the installation program:

ActivePerl-5.8.8.822-MSWin32-x86-280952.msi

Follow the wizard for the installation of Perl on your computer (most default values are fine). PostgreSQL is installed by default in C:\Perl\. If that is not the case in your system, please replace the examples below with the correct value.

Configure

The installation program should have already added perl to your PATH. If not, add it:

PATH=C:\Perl\bin

PostgreSQL (optional)

Download

Open the following URL: http://www.postgresql.org/ftp/binary and download the "v8.3.1", "win32", "postgresql-8.3.1-1.zip" installation file.

Install

PostgreSQL requires another user account than your own to run. In this example we will create a Windows user with username "postgres", password "postgres".

  • Open the "Control Panel" > "Administrative Tools" > "Computer Management" > "Local Users and Groups" > "Users".
  • To add a new user, select "Action" > "New User..."
  • Set the username and password fields to "postgres" (without quotes)
  • Click "Create"

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

Execute the installation program:

SETUP.bat

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

  • when asked for a windows user, set the username and password fields to "postgres" (the user we just created)
  • on the "Initialise database cluster" screen, set the password fields to "postgres" (note this is a database user, not a windows user; but for simplicity, we keep them identical)
  • on the "Installation complete" screen, you are given the option to "Launch Stack Builder at exit". This is not required

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

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


This topic: EuroVODCA > DcaJune2008Workshop > DcaJune2008Software > DcaJune2008PreparationWindows
Topic revision: r7 - 10 Jun 2008 - BrunoRino
 
This site is powered by the TWiki collaboration platform Powered by Perl This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback