Coadunation Version 1.5

This is the latest stable version of Coadunation. It requires:

• JDK 1.5
• 256MB of Memory
• 80MB of disk space.

There are two ways of install Coadunation. One is an easy to use graphical install the second is to compile the source code and than configure it to run.

Note: We suggest the graphical install.

1: Graphical Installer

1. Download Coadunation_Install_1.5.0.B7.jar
2. Run the coadunation install package.
   On Unix:
   
bash# java -jar Coadunation_Install_1.5.0.B7.jar

   In Windows simply double click on the file.
   Note: This requires a graphical display to install

3. The install will prompt for the following instance information:
   • Coadunation Instance Id
     This is the unique ID of this Coadunation instance. It can be the hostname of the box it is being installed on or some other id of the users choosing.

   • Administrator password
     The password for the administrator of this instance.

   • Name Server IP
     This is the IP address of the Server that the internal DNS server will defer to, if the information is not local and if the recurse flag in the configuration is set to true. Our suggestion is to use your ISP's name server IP address.

   • SMTP Relay
     Supply this value if this SMTP server is not directly on the internet, our suggestion is to use your ISP's smtp server name here.
     If it is directly connected to the internet, than the host value for the "HELO" request will have to be correctly set in the DeliverRemote section of the configuration file and this left blank(This must be done after install).
     Note: The server does not support any form of SMTP authentication at this stage.

   • Webmail Domain
     This is the domain that will be used by the Webmail interface when sending messages. There can currently only be one domain per web mail interface.
4. Start Coadunation
   As of version 1.5.0.B7 Coadunation must be started as root or have administrator privaliges. This is because it access low range ports for the DNS and Mail Servers.
   The start script for Coadunation is found in the bin directory of the install.
   • To run it on unix:
     
bash# cd {install dir}/bin
bash# ./run.sh


   • To run it on Windows simply double click on the run.bat file in the bin directory.
5. Launch a web browser and go to the Coadunation frontend. This will be available on port 8080 on the box that the Coadunation instance has been installed on.
   
   Example URL: http://localhost:8080
   

6. For more information on Coadunation visit our Documentation.

2: Compile from Source Code distribution

1. Download CoadunationSource_1.5.0.B7.zip
2. Extact the zip file
3. Run the build script found in build directory.
   To run it on unix:
   
bash# cd {extracted dir}/build
bash# bash ./build.sh

   On Windows simply double click on the build.bat file in the build directory

4. Copy the compiled distribution from the {extracted dir}/build/dist directory to the appropriate location.
5. Edit the Coadunation configuration file found in the etc directory of the compiled distribution, to match the location appropriately.
6. Edit the run file to match the location.
7. Edit the spt webmail property file found in {extracted dir}/build/dist/var/spt/ to match the location.
8. Start Coadunation
   As of version 1.5.0.B7 Coadunation must be started as root or have administrator privaliges. This is because it access low range ports for the DNS and Mail Servers.
   The start script for Coadunation is found in the bin directory of the install.
   • To run it on unix:
     
bash# cd {install dir}/bin
bash# ./run.sh


   • To run it on Windows simply double click on the run.bat file in the bin directory.
9. Launch a web browser and go to the Coadunation frontend. This will be available on port 8080 on the box that the Coadunation instance has been installed on.
   
   Example URL: http://localhost:8080
   

10. For more information on Coadunation visit our Documentation.