Cinnamon Webclient - developer information

Note: The Cinnamon webclient is currently under development.

A very simple version is available in the Cinnamon Subversion repository, which offers browsing and editing of folder and object metadata. You can checkout the Illicium project via

svn co https://cinnamon.svn.sourceforge.net/svnroot/cinnamon/Illicium

(click image for larger version)

Introduction

The webclient depends on Humulus, the base library for Cinnamon web applications implemented with the Grails framework. Humulus is also re-used in Dandelion, the administrative tool which allows almost complete administration of a Cinnamon repository through the browser. To run Illicium from source, you have to check out both Humulus and Illicium from the Subversion repository.

svn co https://cinnamon.svn.sourceforge.net/svnroot/cinnamon/Illicium
svn co https://cinnamon.svn.sourceforge.net/svnroot/cinnamon/Humulus

Illicium comes with an example configuration file (illicium-config.example.groovy) that it tries to load from CINNAMON_HOME_DIR. You should adjust it to your system settings and put it into the CINNAMON_HOME_DIR as illicium-config.groovy.

To run Illicium, you will need a current version of the Cinnamon server. We recommend downloading and configuring the virtual machine for the server - this is currently the easiest way to get the system up and running.

You can start Illicium from the command line (provided you have a working Grails installation) by:

cd c:\cinnamon\illicium
grails run-app

Of course, you will need to adjust the directory path to match your installation.

Then you can go to http://localhost:8080/illicium and start to work with the current version of the webclient.

Updating the webclient

The webclient is currently under development and will probably change quite often (as time permits). Before working on the source version, you should update to the most recent version. Use your favorite subversion client to update both directories (Illicium and Humulus). If Humulus has changed, you have to install the plugin again:

cd c:\cinnamon\humulus
grails package-plugin
cd ..\illicium
grails install-plugin ..\humulus\grails-humulus-x.x.x.zip
grails clean
grails run-app

Set x.x.x to the current version of the plugin - you just need to look into the humulus directory and pick the grails-humulus package with the highest version number. When running grails install-plugin, you will be asked if you want to upgrade the plugin - choose [y] and enjoy the new version.