SWiM/development

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.

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):



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

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.