Readme1st

From ago control wiki
(Difference between revisions)
Jump to: navigation, search
(Debugging)
(Startup)
Line 9: Line 9:
 
  systemctl start agoresolver.service
 
  systemctl start agoresolver.service
 
  systemctl start agoadmin.service
 
  systemctl start agoadmin.service
 +
You can also enable and start all installed components with this small helper script:
 +
/opt/agocontrol/bin/agoctrl.sh enable
 +
/opt/agocontrol/bin/agoctrl.sh start
 +
 
= Debugging =
 
= Debugging =
 
The output from the components is logged to syslog. To watch the messages on the broker use "agodrain.py":
 
The output from the components is logged to syslog. To watch the messages on the broker use "agodrain.py":

Revision as of 10:09, 7 December 2012

Contents

Basics

ago control uses AMQP as underlying communication protocol. It uses the Apache QPID broker to pass messages. The components communicate over a topic queue "agocontrol". The Resolver component tracks device announcement events to build an inventory. It also enriches the inventory with devicename and room information and provides the device schema. This can be used by user interfaces as it defines the supported commands for each device type.

Installation

We provide packages for Debian Wheezy and Fedora 17. You should install at least the agocontrol and the agocontrol-admin package. You probably also want to install other components for device support.

Configuration

The global configuration is set in the config.ini file residing in /etc/opt/agocontrol. Here you can specify an installation uuid, the host, username and password for the broker configuration and settings for device interfaces like the USB com port to use for the Z-Wave interface device.

Startup

The packages contain systemd service definitions. You can use systemctl to start ago control components, e.g.:

systemctl start agoresolver.service
systemctl start agoadmin.service

You can also enable and start all installed components with this small helper script:

/opt/agocontrol/bin/agoctrl.sh enable
/opt/agocontrol/bin/agoctrl.sh start

Debugging

The output from the components is logged to syslog. To watch the messages on the broker use "agodrain.py":

python /opt/agocontrol/bin/agodrain.py

What next?

Now connect to the ago control administration interface. You can get more information here: AgoAdmin

Personal tools