Momo Installation
System Requirements
To install Momo you need:
- Tomcat 6
- Folder in your file system to store Momo's database files
Download Momo
Download the latest version of Momo from Sourceforge: https://sourceforge.net/projects/momo-timetracking/files/; or check out the code from the repository: https://sourceforge.net/p/momo-timetracking/code/HEAD/tree/.
Configuration
There are several files that need to be configured. If you use the current version of the code in the repository, you can change these files directly. Otherwise change them either in the war file or in the unpacked folder once deployed in Tomcat (if you Tomcat is set to unpacking wars):
- WEB-INF/classes/db4o.properties
- WEB-INF/spring/spring-security.xml
- WEB-INF/spring/email-config.xml
If you've downloaded the latest war-file from Sourceforge, decompress the war-file and find the two files in the decompressed folder. Change the following properties in the files.
- db4o.properties:
dbpath_folder - this property should point a the folder in your filesystem for which Tomcat has read/write access and in which Tomcat can store Momo's database files.
- spring-security.xml:
Find the following piece of XML in the file and change the password value.
<user-service> <user name="admin" password="admin" authorities="ROLE_ADMIN" /> </user-service>
- email-config.xml:
Enter the information of the email account you want Momo to use for sending emails.
Optional configuration
By default Momo knows three types of break times (no break, 0.5 hour, 1hour). You can change these times or add other break times in WEB-INF/spring/breakTimes.xml
.
Building
Now, build a war file out of your your decompressed Momo folder (in which you made the changes). On Linux based systems you can do that by for example navigation in your Momo folder (which should contain three subfolders: META-INF, resources, and WEB-INF) and then running the command: jar -cvf momo.war *
. This will pack all the files in your folder into a new war-file.
Deploy
Finally, deploy the newly generated war-file in your Tomcat and restart Tomcat. Note, if you update Momo without restarting Tomcat the database connection (Db4o) might throw exceptions. A restart of Tomcat is necessary.
Note that alternatively you can of course first let Tomcat unpack the Momo war file and then make the necessary configuration changes (if your Tomcat is set to unpacking wars).