Tudu Lists

Currently, Tudu Lists is NOT in active development anymore.

At the beginning, Tudu Lists was the example application of French book "Spring par la pratique"...

"(...) the authors commitment to providing a realistic sample application (rather than the simplistic effort that mars many books), is shown by the fact that Tudu Lists has become a viable open source project in its own right" -- Rod Johnson, Founder of the Spring Framework

If you are French and interested by "Spring par la pratique", please see this section of the Website : Spring par la pratique

Tudu Lists is an Open Source software, available on Github : https://github.com/jdubois/Tudu-Lists.

Using Tudu Lists

Tudu Lists is an on-line application for managing todo lists. With Tudu Lists, todo lists can be easily accessed, edited and shared on the Web. It is a simple but effective project management tool.

If you want to use Tudu Lists, go to http://tudu.rasc.ch/tudu/welcome.action, which provides a free installation for everyone to use. Many thanks to ESS Development AG for this service.


Installation

The source code of Tudu Lists is available on Github : https://github.com/jdubois/Tudu-Lists.

Introduction

If you just want to use Tudu Lists online, you can use http://tudu.rasc.ch/tudu/welcome.action, which provides a free installation for everyone to use. This is hosted by ESS Development AG, so if you experience any problem with this installation please contact them directly.

Of course, you can easily have your own installation of Tudu Lists in your company. We have reports of 10 to 20 companies doing so, but this is far from being a complete list (as always with Open Source, you don't always know who is using your software!).


Step 1 : Download Tudu Lists

Tudu Lists is downloadable from SourceForge : https://sourceforge.net/project/showfiles.php?group_id=131842&package_id=144702

Step 2 : Database setup

WARNING This section needs to be re-written for Tudu Lists 3.0 (if you're using an older version it is still acurate)

Introduction

Tudu Lists uses the Hibernate persistence layer, so it should work seamlessly on most databases (in fact, we have seen it working with MySQL, Postgresql, MS SQL Server, HSQLDB and Oracle).

However, developement is focused on the HSLQDB and MySQL databases :

HSQLDB installation

HSQLDB is bundled into Tudu Lists, and is automatically launched at application start up, if MySQL is not found.

So there is nothing to do (excepted shutting down MySQL if you also have a production database running).


MySQL installation

Download MySQL at http://www.mysql.com/, and follow the instructions in order to install the database.

If you're using Windows or Mac OS X, an easy-to-use graphical installer is provided.

If you're running Linux, chances are that MySQL is already running on your system, or that a simple "apt-get install mysql" will do the trick.

Now that MySQL is installed, let's create the "tudu" database.

Using a graphical front-end could help for following the next steps. There are a lot of different front-ends for MySQL, but you could use :

Now follow the next steps :

  1. Step 1 : create the "tudu" schema.
  2. Step 2 : In the "tudu" database, open the create_schema_mysql.sql script. This script is provided in the "sql/" directory of the Tudu Lists distribution (Note that before Tudu Lists 2.0, it was located in the "src/sql" directory, and that before version 1.1.1, is was in stored in the "sql/" directory). If you want the latest version of this script, it is available in the Subversion repository.
  3. Step 3 : Execute the script (with MySQL Query Browser, click on the green "Execute" icon).

You should now have a ready-to-work version of the "tudu" database.

Tudu Lists searches the MySQL instance in 2 different ways :

If you want to use this second option, and if you have changed something in the default configuration (your password, for example), then you will have to edit the applicationContext-jpa.xml configuration file.

This file is located inside the Tudu Lists web application :


Step 3 : Application Server setup

Tudu Lists is a standard WAR application, which should run on any Java EE 5-compliant application server (in fact, we have seen it working with Jetty, JBoss, Resin and Geronimo).

However, developement is focused on the Tomcat application server as it's the most commonly used application server.

JDK and Tomcat installation
Web application installation

Copy the tudu-dwr.war file into the Tomcat webapps/ directory : cp $TUDU_HOME/tudu.war $TOMCAT_HOME/webapps

Step 4 : Testing the installation

Connect to your Tudu Lists installation - the default URL is http://127.0.0.1:8080/tudu/