Coadunation OS Install

This is the latest version of Coadunation OS (if you require the older Coadunation Server click here of if you wish to upgrade an older version of Coadunation OS visit the Patches Section). It requires:

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

There are two ways of install Coadunation OS. 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. As the source code version does not come with all the applications nor do all the packages get compiled by the automated build script as they require GWT(A platform dependent library) and other dependencies are met.

1: Graphical Installer

1. Download CoadunationOS_Install_R1.0.B2.jar
2. Run the install package.
   On Unix:
   
bash# java -jar CoadunationOS_Install_1.0.B2.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 OS
   Coadunation OS must be started as root or have administrator privileges. This is because it access low range ports for the DNS and Mail Servers.
   The start script 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 you desktop. This will be available on port 8080 on the box that the instance has been installed on.
   
   Example URL: http://localhost:8080
   

   At this point in time you will be asked for a username and a password. Default admin user name is simply admin the password will be the one provided during installation. Once this information is provided the user will be presented with the Coadunation Desktop.

      

6. For more information on Coadunation OS visit our Documentation.

2: Compile from Source Code distribution
Note: not recommended unless you wish to make modifications to the Coadunation OS.

Compile the daemons and backend

1. Download CoadunationOsSource_R1.0.B2.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

Compile the web applications

The easiest way to do this is through the use of an IDE such as Netbeans. Open the following projects in the id and resolve their missing dependencies.

• CoadunationAdmin uses GWT 1.4 or later.
• CoadunationDesktop uses GWT 1.5, GWM and GWT widgets.
• FileManager

Once the dependencies are solved they can be compiled and placed in the deploy directory of the distribution build in the previous step.

Setup

1. Copy the compiled distribution from the {extracted dir}/build/dist directory to the appropriate location.
2. Edit the Coadunation configuration file found in the etc directory of the compiled distribution, to match the location appropriately.
3. Edit the run file to match the location.
4. Edit the spt webmail property file found in {extracted dir}/build/dist/var/spt/ to match the location.
5. Start Coadunation
   Coadunation OS 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.
6. Launch a web browser and go to the desktop. This will be available on port 8080 on the box that the instance has been installed on.
   
   Example URL: http://localhost:8080
   

7. For more information on Coadunation visit our Documentation.