From MathWeb

Contents 1 Getting started 2 Building 3 Tips & Tricks 3.1 Tomcat manager 3.2 Logging

Getting started

The recommended way of working on the SWiM sources is to:

1. check them out from the Subversion repository
2. create an Eclipse workspace directory, preferably outside the Subversion working copy
3. import the SWiM project into the workspace ("Import -> existing project into workspace")

Do not create a new Java project from the ant build file, as this will result in some incorrect path settings.

Building

• Before the first installation and after any major update of the sources, be sure to run ant dojo. We disabled it by default to save time.
• Then run ant warfile.

Tips & Tricks

Tomcat manager

You may want to add a user with manager privileges, who is allowed to start/stop/reload/undeploy a Tomcat application. If not yet existing, add the following entries to your tomcat-users.xml file (in /path/to/tomcat/conf or /etc/tomcat):

<role rolename="manager"/>
 <user username="swim" password="password" roles="manager"/>

This user is independent from the database user for SWiM.

To make use of the tomcatmgr shell script that reloads a Tomcat context and is called by the deploy-war ant task, you need:

• a Tomcat user with “manager” privileges
• a Bourne-compatible shell like bash
• The command-line HTTP client wget
• HTML Tidy
• The xpath command-line tool from the XML::XPath Perl module
• Be sure to adapt tomcat.properties in SWiM's main directory accordingly:

tomcat.lib = /opt/local/share/java/tomcat5/common/lib
tomcat.log = /opt/local/share/java/tomcat5/logs
tomcat.webapps = /opt/local/share/java/tomcat5/webapps
tomcat.manager.user = swim
tomcat.manager.password = password

A template can be found in tomcat.properties.template.

Logging

If no output from SWiM appears in Tomcat's general logfile catalina.out, be sure to check all directories of the SWiM distribution (including build/*) for left-over log4j.properties files with wrong settings.