Requirement Notes:

• at least j2sdk-1.4.1
• james-2.2.0 we will refer to this location as {JAMES_HOME}
• dithaka-base-0.7.tar.gz
• dithaka-james-0.7.tar.gz

Deploy Notes: Binary Distribution

1. The system has been tested and written to run under the james-2.2.0 mail server.
2. Extract the contents of the dithaka-base-0.7.tar.gz and dithaka-james-0.7.tar.gz. From now forward this document will refer to the location of the extracted files as {RESOURCES_HOME}.
3. You must first include some third party jar and Dithaka jar files into the James deployment. Copy {RESOURCES_HOME}/lib/*.jar to {JAMES_HOME}/lib.
4. Extract the james.sar file in {JAMES_HOME}/apps to {JAMES_HOME}/lib.
5. Setup your database and include the JDBC jar in the {JAMES_HOME}/lib directory so James can see it in its classpath.
6. You must Make sure that your hibernate.properties is setup to reference the database that you setup in the last step. A sample hibernate.properties can be found in the root directory of this installation. Five properties must be changed:
   hibernate.connection.username={username_for_your_db}
   
   hibernate.connection.password={password_for_your_db}
   
   hibernate.dialect={hibernate_dialect_for_your_db}
   
   hibernate.connection.driver_class={driver_class_for_your_db}
   
   hibernate.connection.url={jdbc_url_for_your_db}
   The other properties can stay unchanged.
7. Once your hibernate.properties file is correct you must make a jar file that contains the file. To make a jar do:
   
   'jar cvf hibernateProperties.jar hibernate.properties'
   
   You must then place the jar file you created into the {JAMES_HOME}/lib directory.
8. The next thing you must do is setup the config.xml file for James.
   
   NOTE: James only creates some files and directories during the first time it run. Therefore you should startup James (as a priveledged user since it runs on a port below 1000) to see the directory structures we are talking about in the next statements.
   
   You must change one configuration setting in the {RESOURCE_HOME}/config.xml file. Find the gateway property, there is text that reads, {YOUR_GATEWAY_GOES_HERE}. Replace this text with your networks gateway. Modify the gatewayPort if yours is not port 25. Next copy the {RESOURCE_HOME}/config.xml to {JAMES_HOME}/apps/james/SAR-INF/config.xml, this file has some coefficient specific mailet and matchers.
   
   NOTE: There are configurations for James that are outside the scope of Dithaka that you may wish to set. Please see the James documentation for details.
9. Start james.
10. You should be done. Use the Dithaka-Tapestry component pages to create a forum or use the Coefficient-MailForum module.
11. Enjoy!

Building from source

Coming soon......