Skip to end of metadata
Go to start of metadata

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

Installation

Running the Controller without admin access and Daemon/Service installation

This is not recommended practice.
When run in this manner, without installation as a service/daemon, the controller will not automatically start when your machine reboots.

  1. Make sure the configuration file has the proper values.
  2. 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\bin directory.
  • 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/bin directory
  • 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/bin directory
  • 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:

  1. Backup your 'data' directory (specified in the Controller/bin/config.properties file).
  2. Uninstall previous version.
  3. Install new version
  4. Point the new version to the previous 'data' directory
Labels: