Ago control install debian jessie

From ago control wiki
(Difference between revisions)
Jump to: navigation, search
(placeholder while I test the process)
 
 
(One intermediate revision by one user not shown)
Line 1: Line 1:
This page is in testing as of 15 October 2015 and will be online shortly.
+
= NOTE: This page is a work in progress - please be careful when following the instructions since not all of them have been fully tested! =
 +
 
 +
 
 +
= Installing agoControl on Debian Jessie =
 +
 
 +
Please mind that you should set up agoControl on a development system before installing it into production.  We use systemd for smooth process handling.
 +
 
 +
== Installation of agoControl Packages ==
 +
 
 +
=== Install apt Repository Key ===
 +
 
 +
wget -O - http://mirror.at.agocontrol.com/debian/conf/agocontrol.gpg.key | apt-key add -
 +
 
 +
=== Add agoControl Repositories ===
 +
Lastest unstable development packages:
 +
<pre>
 +
echo ' 
 +
# agoControl sources repository
 +
deb http://mirror.at.agocontrol.com/jessie unstable main' >> /etc/apt/sources.list
 +
</pre>
 +
 
 +
=== Install agoControl ===
 +
 
 +
apt-get update
 +
apt-get install agocontrol
 +
 
 +
Optional packages for hardware and extra feature support:
 +
 
 +
* agocontrol-cloud (this package is temporarily unavailable!)      - ago Cloud automation system suport on [http://cloud.agocontrol.com cloud.agocontrol.com]
 +
* agocontrol-owfs        - Device for 1-Wire Hardware
 +
* agocontrol-zwave      - Device for Z-Wave Hardware
 +
* agocontrol-meloware  - Device for Meloware iPhone App
 +
* agocontrol-alert    - Device for to communicate via sms, email, tweet, push notifications
 +
* agocontrol-rrdtool  - Device for RRDtool graphs, plot, and lists of your measuring sensors
 +
 
 +
''' Configuring qpidd  at installation dialog'''
 +
 
 +
During installation, you will be prompted:
 +
 
 +
Please enter the password for the Qpid daemon administrator.
 +
Administrator password: 
 +
 
 +
''' type any password you want '''
 +
 
 +
Establish agoControl as an autostart service on boot:
 +
 
 +
apt-get install systemd systemd-sysv
 +
reboot
 +
 
 +
=== Enable logging ===
 +
 
 +
add this as a new line in the "standard log files" area of the '''/etc/rsyslog.conf''' file:
 +
 
 +
local0.*      /var/log/agocontrol.log
 +
 
 +
== edit config file (optional) ==
 +
The [[System.conf]] file is located here:
 +
/etc/opt/agocontrol/conf.d/system.conf
 +
This page lists all available sections: [[System.conf]]
 +
 
 +
Update your conf files to use the proper device name:
 +
 
 +
<pre>
 +
sudo nano /etc/opt/agocontrol/conf.d/zwave.conf
 +
 
 +
[zwave]
 +
#device=/dev/ttyUSB0
 +
device=/dev/usbzwave
 +
</pre>
 +
 
 +
Same goes for mysensor conf file:
 +
<pre>
 +
sudo nano /etc/opt/agocontrol/conf.d/mysensors.conf
 +
 
 +
[mysensors]
 +
#device=/dev/ttyUSB1
 +
device=/dev/usbmysensor
 +
</pre>
 +
 
 +
== start / stop / autostart services ==
 +
'''Configue service autostart'''
 +
This will enable all services:
 +
<pre>
 +
/opt/agocontrol/bin/agoctrl.sh enable
 +
</pre>
 +
You can also use "systemctl enable <service>" to manually enable specific services.
 +
""Start components""
 +
This will start all installed components:
 +
/opt/agocontrol/bin/agoctrl.sh start
 +
 
 +
== Final steps ==
 +
If you do not have additional hardware like Z-Wave or 1-Wire you can start the '''ago simulator''' to simulate some devices:  [[Simulator]]
 +
 
 +
=== Access the admin interface ===
 +
http://127.0.0.1:8008/
 +
 
 +
'''Hint:''' You may change "127.0.0.1" to your hostname or ip-address.

Latest revision as of 18:58, 16 October 2015

Contents

[edit] NOTE: This page is a work in progress - please be careful when following the instructions since not all of them have been fully tested!

[edit] Installing agoControl on Debian Jessie

Please mind that you should set up agoControl on a development system before installing it into production. We use systemd for smooth process handling.

[edit] Installation of agoControl Packages

[edit] Install apt Repository Key

wget -O - http://mirror.at.agocontrol.com/debian/conf/agocontrol.gpg.key | apt-key add -

[edit] Add agoControl Repositories

Lastest unstable development packages:

echo '  
# agoControl sources repository
deb http://mirror.at.agocontrol.com/jessie unstable main' >> /etc/apt/sources.list

[edit] Install agoControl

apt-get update
apt-get install agocontrol

Optional packages for hardware and extra feature support:

  • agocontrol-cloud (this package is temporarily unavailable!) - ago Cloud automation system suport on cloud.agocontrol.com
  • agocontrol-owfs - Device for 1-Wire Hardware
  • agocontrol-zwave - Device for Z-Wave Hardware
  • agocontrol-meloware - Device for Meloware iPhone App
  • agocontrol-alert - Device for to communicate via sms, email, tweet, push notifications
  • agocontrol-rrdtool - Device for RRDtool graphs, plot, and lists of your measuring sensors

Configuring qpidd at installation dialog

During installation, you will be prompted:

Please enter the password for the Qpid daemon administrator. Administrator password:

type any password you want

Establish agoControl as an autostart service on boot:

apt-get install systemd systemd-sysv
reboot

[edit] Enable logging

add this as a new line in the "standard log files" area of the /etc/rsyslog.conf file:

local0.*       /var/log/agocontrol.log

[edit] edit config file (optional)

The System.conf file is located here:

/etc/opt/agocontrol/conf.d/system.conf

This page lists all available sections: System.conf

Update your conf files to use the proper device name:

sudo nano /etc/opt/agocontrol/conf.d/zwave.conf 

[zwave]
#device=/dev/ttyUSB0
device=/dev/usbzwave

Same goes for mysensor conf file:

sudo nano /etc/opt/agocontrol/conf.d/mysensors.conf 

[mysensors]
#device=/dev/ttyUSB1
device=/dev/usbmysensor

[edit] start / stop / autostart services

Configue service autostart This will enable all services:

/opt/agocontrol/bin/agoctrl.sh enable

You can also use "systemctl enable <service>" to manually enable specific services. ""Start components"" This will start all installed components:

/opt/agocontrol/bin/agoctrl.sh start

[edit] Final steps

If you do not have additional hardware like Z-Wave or 1-Wire you can start the ago simulator to simulate some devices: Simulator

[edit] Access the admin interface

http://127.0.0.1:8008/

Hint: You may change "127.0.0.1" to your hostname or ip-address.

Personal tools