Installing

If you want to give it a try, just install java 5, download the full testing application bundled with jetty, and uncompress the archive somewhere.

Then execute the script clepsydra.sh or clepsydra.bat dependending on your operating system.

Point your web browser to http://localhost:23000/clepsydra, connect with admin/admin and you're done. In this mode not all features will be available (no maps for example, for maps to work you have to get a google map api key), and there is probably more bugs, and data you added will be lost when you stop the server, but it can help you determine if this appication can be useful for you or no.

Client requirements

Any modern browser should work as a client, Mozilla Firefox is a good choice for example, internet explorer is supported, konqueror is not yet supported but will be soon.

Configuring the database

To use PostgresSQL you need to run the "create-postgres-database.sql" sql script against your database And configure the url (host, login, password...) to connect to your database in the file jetty/webapps/clepsydra/WEB-INF/classes/database.xml, that's all (i hope). The version of postgres used is the latest (8.1), but the application should work with postgres 7 too.

For another database system the process is the same, but the creation script should probably be modified, i think that MySQL for example is not supporting foreign key constraints, so you should delete the lines regarding this kind of constraints. And you should also add the jdbc driver library to the WEB-INF/lib directory. I never tried myself but it should not be too hard. But the application is untested against this database.

Configuring the application

All of the application specific configuration is done by modifying the files located in the WEB-INF/classes/META-INF directory.

I'll just explain the database configuration element, but the files are commented so you can just look at it and change the configuration as you want. For example it's better to change the settings in globalconfig.xml, otherwise maps will not work as google maps needs your own key to be displayed, e-mail notifications will not be sent to you, and application url's so documents e-mailing work.

To switch between memory and database persitence of your data change the following section by commenting the system that you do not want to use in the file "persistence.xml". In the sample the database persistence is used.

		  <service-point id="IPersistencer" interface="org.jys.clepsydra.pers.IPersistencer">
	    	<!--<create-instance class="org.jys.clepsydra.pers.InMemoryPersistencer"/>-->
		    <create-instance class="org.jys.clepsydra.pers.OJBPersistencer"/>
	  	  </service-point>	
	  	        
		  

Starting the server

Execute the script clepsydra.sh or clepsydra.bat dependending on your operating system (don't forget to make it executable on Unix systems).

Then point your browser to http://yourexternalip:23000/clepsydra

I really hope it's working, if it's not the case just drop me an e-mail with some description of the issue you're facing, or open an issue.

The application stores everything in the database configured in database.xml, so to save all your documents and entities you can just dump this database to a file (with pg_dump for postgres).