Tuesday 12 May 2015

Jamesui - a web admin console for Apache James 3





What is
Jamesui is an unofficial Web admin console that I have made to manage Apache James 3.0 (a mail server written in java) ( http://james.apache.org/server/3/ ).

Why Jamesui
Some time ago i have decided to try Vaadin ( https://vaadin.com/home ) to create web applications. The best solution to learn it was create a “real case application”.
At work i have used Apache James to perform some tests, and i noticed that was missing a graphical user interface for the administration tasks....ok, that was my “real case application”.
Screenshot
Here some screenshot of Jamesui:





Quick reference
Here some little notes about jamesui features (please, for detailed informations see the pdf guide on download site, see above for the link).

After the login the available functions are divided on different panels:
Domain: allow to display the currently configured James domains, delete them or add new ones.
User: allow to display the currently configured James users , delete them, add new ones or modify his password.
Mapping: offer the necessary operations to add, delete any of the mapping types supported by James.
Mail Store: allow to configure the store used by James to save mails and other informations. To configure it is necessary install Jamesui on the same host of Apache James. After a mail store modification is necessary restart Apache James.
Note: depending on the store type chosen could be necessary add a new jar library to Apache James classpath (see James web site for more informations).
Statistics: display an instantaneous snapshot of Apache James status; update it on demand and export it to a pdf file.
Hystory statistic: show a previously saved statistic data collected using the monitoring functionality.
Monitoring: allow to schedule a monitoring job that periodically pick-up informations from James and save them to a Database (ie: MapDB).
Server configuration: allow to display and edit the Apache James server configuration (ie: the files under james/conf folder). To do this is necessary install Jamesui on the same host of James server.
(A restart of James is required) .
Product info: display in read-only mode some Jamesui informations (eg: the version of Apache james used in background and so on).
Jamesui configuration: display in read-only mode the content of the jamesui configuration files (see technical guide fo details).

Download
To download jamesui go to: https://github.com/fulvio999/jamesui

Installation and support
For more informations about the product and for technical details, please read the jamesui-tech-guide.pdf in the "Files" section on GitHub site ( https://github.com/fulvio999/jamesui/ ).