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.


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



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.


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

Edit | Attach | Watch | Print version | History: r11 < r10 < r9 < r8 < r7 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r11 - 17 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