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

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

• 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

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

• Version is 5

• 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.