OLA Debian / Ubuntu

2012-11-29T15:08:45Z

Imlach: /* Logs */ Removed unecesarry cat

Packages are hosted at http://apt.openlighting.org

= Edit sources.list =

Add the relevant line to your /etc/apt/sources.list file

== Debian ==

<pre>
deb http://apt.openlighting.org/debian squeeze main
</pre>

== Raspbian ==

Only the hardware optimized platform is supported (armhf) rather than the soft-float version (armel).

<pre>
deb http://apt.openlighting.org/raspbian wheezy main
</pre>

== Ubuntu Precise 12.04 ==

<pre>
deb http://apt.openlighting.org/ubuntu precise main
</pre>

== Ubuntu Natty 11.04 ==

<pre>
deb http://apt.openlighting.org/ubuntu natty main
</pre>

= Install =

<pre>
apt-get update
apt-get install ola
#Optional:
apt-get install ola-python ola-rdm-tests
</pre>

= Usage =

== OLA daemon ==

Since ola-0.8.23, you can choose to start olad at boot.
The question is asked the first time you install ola.
If you chose 'No', you can change it with:
<pre>sudo dpkg-reconfigure ola</pre>

Since you choose 'Yes', the init script will be active and you will get the advantages below.
Take care, if you start olad manually in a terminal, you will loose these advantages.

*Control the olad process with:
<pre>
sudo /etc/init.d/olad start
sudo /etc/init.d/olad stop
sudo /etc/init.d/olad restart
sudo /etc/init.d/olad status
</pre>

*olad is started by the 'olad' system user (automatically created and added to groups dialout and plugdev).
So olad is ready to use USB devices (thanks to udev rules).

== RDM Test Server ==

Since ola-0.8.25, you can choose to start rdm_test_server at boot.
The question is asked the first time you install ola-rdm-tests.
If you chose 'No', you can change it with:
<pre>sudo dpkg-reconfigure ola-rdm-tests</pre>

Since you choose 'Yes', the init script will be active.

*Control the rdm_test_server process with:
<pre>
sudo /etc/init.d/rdm_test_server start
sudo /etc/init.d/rdm_test_server stop
sudo /etc/init.d/rdm_test_server restart
sudo /etc/init.d/rdm_test_server status
</pre>

= Configuration =

*conf files are in /var/lib/ola/conf/ and owned by 'olad'.
To configure the plugins, you need to add yourself to the olad group.
For example:
<pre>sudo adduser renzo olad</pre>
then logout and login again (you need to do it only once).

You are now able to edit the conf files, for example:
<pre>gedit /var/lib/ola/conf/ola-artnet.conf</pre>

*You can try my bash script to set the plugins easily
<pre>
apt-get update
apt-get install ola-conf-plugins
</pre>

Check the conf path with:
<pre>
sh ola_conf_plugins.sh
---
settings path is:
/var/lib/ola/conf
---
</pre>

If you want to use ftdidmx plugin (for opendmx and so), you need to do:
<pre>
sh ola_conf_plugins.sh disable all
sh ola_conf_plugins.sh enable ftdi
</pre>

= Logs =

*Read the olad logs with:
<pre>grep olad /var/log/syslog</pre>
if you want to see the 20 last lines (including system messages like usb ones):
<pre>tail -n20 /var/log/syslog</pre>

= See Also =

[[Notes on Building Debian Packages]]

wiki.openlighting.org - User contributions [en]

OLA Debian / Ubuntu