System Requirements
- Java 6
- For Windows 64 bit users only: You need a 32 bit installation of Java 6 to run the controller service. Linux/Mac/Solaris users can use 64 bit version though.
Before Installation
Edit the Controller Configuration file and ensure it has the right values.
Installation
Running the Controller without admin access and Daemon/Service installation
This is not recommended practice. |
- Make sure the configuration file has the proper values.
- Go to the bin directory of the controller in a command line and run:
java -jar controller.jar <absolute path to config.properties file>
Installation as Daemon/Service
Windows
Install
- Browse to the
Controller\bindirectory. - Right click on
installService.bat. - Select 'Run as Administrator'
Check state
After the service is installed, you can change its properties by running bin/ChrononControllerw.exe in 'Administrator' mode.
Note: In case you have multiple version of java installed and need to point the controller to a java 6 version, make sure its a 32 bit jre (not 64 bit).
Uninstall
To uninstall, run removeService.bat as 'Admininstrator'.
Linux/Mac/Solaris
Before you begin
Make sure that your /usr/bin directory contains a soft link to the java executable or the java executable itself.
Thus doing which java on the terminal should print /usr/bin/java.
You should be able to type java -version on the command line and it should execute and print the correct jvm version you want the controller to run under (Java 6).
Install
In a console window:
- cd to the
Controller/bindirectory - execute
chmod a+x *.sh - execute
sudo installDaemon.sh - execute
sudo startDaemon.sh
The next time your system boots the Controller daemon will start automatically without the need to run startDaemon.sh.
Check state
To query the state of the Controller daemon run Controller/bin/queryDaemon.sh
Uninstall
In a console window:
- cd to the
Controller/bindirectory - execute
sudo stopDaemon.sh - execute
sudo uninstallDaemon.sh
On a Mac, you might need to restart after executing the uninstall script to 'truly' uninstall.
Upgrading
To upgrade your existing Controller installation:
- Backup your 'data' directory (specified in the
Controller/bin/config.propertiesfile). - Uninstall previous version.
- Install new version
- Point the new version to the previous 'data' directory