Introduction

The first release of the Hackystat Service Manager has the features of starting and stopping the local Hackystat services trough one graphical user interface. These services are monitored, failure gets detected and fixed. The GUI is providing the status of the Hackystat service. In further releases the Hackystat Service Manager will have more monitoring features, fault detection and automatic recovery features. The architecture is designed to control the Hackystat services wherever they are located, therefore the REST URL has to be changed, which is not yet implemented in the Graphical User Interface, one need to change the configuration and re-compile the system.

Here is an overview of the Hackystat Service Manager concept.

For a full overview of the architecture please refer to the Architecture page in the Wiki

Installation Steps

1. First of all make sure you have Hackystat binary service distribution correctly installed on your local machine. To install Hackystat please follow the Hackystat Installation Guide. Make sure that the services are working correctly.

HSM assumes that the environment variable HACKYSTAT_SERVICE_DIST and directory was correctly configured during the the installation procedure (example of usage: $HACKYSTAT_SERVICE_DIST/hackystat-sensorbase-uh/sensorbase.jar).

The standard ports of the services should not be changed during the installation for using the ALPHA 1 version of HSM . Ports of the Hackystat Services are assumed to be as following:

• Sensorbase: 9876
• DailyProjectData: 9877
• Telemetry : 9878
• ProjectBrowser:9879

2. Download the Hackystat Service Manager from the Download section. For each Hackystat service their is an agent shipped for it in the Hackystat Service Manager distribution. The download contains following executable Java JAR Files:

• hsm.jar - The main Hackystat Service Manager. This is all you need to manage your a local Hackystat distribution.

The other JAR Files are not needed for trying out the system, but its the first step for managing distributed services:

• hsm-agent-sensorbare - This is the Agent for the Sensorbase service, it has to be installed on the same machine that hosts the Sensorbase Service
• hsm-agent-dpd - This is the Agent for the DailyProjectData (DPD) service, it has to be installed on the same machine that hosts the DailyProjectData (DPD) service.
• hsm-agent-telemetry - This is the Agent for the Telemetry service, it has to be installed on the same machine that hosts the Telemetry service.
• hsm-agent-projectbrowser - This is the Agent for the ProjectBrowser service, it has to be installed on the same machine that hosts the ProjectBrowser service.
• hsm-agent-tickertape - This is the Agent for the TickerTape service, it has to be installed on the same machine that hosts the TickerTape service.

3. Execute the hsm.jar by double-click on the file or by executing the command: java -jar hsm.jar. A window will open that looks like this:

To manage the Hackystat service, firstly click simply on Start Agents locally. All Agents get started locally in the background. If you have set up the Hackystat system correctly and completely you can launch all the service by clicking on Start All Service. You can also start and stop the single service individual, but make sure to launch them in the correct order, because the services are depending on each other in the order as they are listed in the Graphical User Interface. For a running service you can start and stop the autonomic behavior by clicking on Enable Autonomy. The services will be monitored every 30sec in the background and the status of the service gets updated.

The Agents are automatically started on following ports:

• SensorBase Agent: 8000
• DailyProjectData Agent: 8001
• Telemetry Agent: 8002
• ProjectBrowser: 8003
• Tickertape: 8004

When closing the window, please make sure all services are shutdown properly because of consistency issues. The HSM tries to force the shutdown hook on the service when quitting anyway, but you will not be notified if it fails. You can check the for the services in your operating system process monitor.

Note:Over the three layers is a strict communication protocol (HTTP). The HSM defines the ports of the Agents and Services, these should not be changed without adopting and re-compiling the system. Each Hackystat service has a well defined port that is used by the HSM.