wiki.openlighting.org - User contributions [en]

Configuring OLA as a Artnet Node in Ubuntu

2012-07-20T21:48:41Z

Karsten: added to tutorials category

[[Category:Tutorials]]
Written by Karsten Wolf. 19/7/2012

My current personal requirements were for OLA to be a stand alone stage-side Node which would receive Artnet3 data from Luminosus (http://Luminosus.org) and Artnet1 data from Freestyler (http://Freestylerdmx.be) then output it to a DMXKing.com UltraDMX box.

My computer is an old laptop (with the screen torn off). With this setup, the setup steps are: connect the USB, Ethernet and power then hit the power button and walk away.

See the Guide for installing OLA on ubuntu here: [[The_Newbie_Guide_for_OLA_on_Ubuntu]]

__TOC__

==Setting up OLA to start on startup==

In the top menu bar on the right-most button (power logo) click it to bring up a drop-down menu. Select ‘Startup Applications’.

Click ‘Add’. Name it whatever you like. For the ‘command’ field input type:

olad -l 3

Note: The ‘-l’ is ‘-L’ but lowercase, not the number one. ‘3’ is the logging level, ‘0’ logs nothing, ‘4’ is debug logging, ‘3’ is log level info.

Next you may want to also set the computer to not lock while it’s running. I’m not sure of lock equates to what I understand as ‘sleep’ but I’d rather not have my computer do anything besides turn off the screen.

In the top menu bar on the right-most button (ubuntu logo) click it to bring up a drop-down menu. Select ‘System Settings’. Then select ‘Brightness and Lock’.

Set the brightness and ‘Dim screen to save power’ to whatever you like. Then switch ‘lock’ to ‘OFF’ to disable Ubuntu from locking up (and requiring a password). I tested it and OLA does still receive/transmit when Ubuntu is locked up, so if the computer is accessible to unauthorized personnel, lock may be a security option to have enabled.

At this point restart the system and test OLA with the Web client, if the web client comes up it works.

http://localhost:9090

==Configuring OLA and Artnet==

===OLA Web Client===

OLA is configured through a web browser client. On the Ubuntu machine you can access it in mozilla or any web browser via:

http://localhost:9090

From another computer or mobile device on the same network, type:

http://$IP:9090

example: http://192.168.0.2:9090

To find the IP address in Ubuntu click on the network Icon on the top menu bar. For LAN it’s two arrows, for Wifi it is the radiating antenna Icon. Click it then find ‘Connection Information’ in the drop down menu.

Alternatively you can access the IP in terminal via (ethernet only):

/sbin/ifconfig eth0

===Artnet Config===

To setup a new Universe within the web client click ‘Add Universe’ on the home page.

Devices are listed by name and direction. Direction determines whether it’s input or output. Select the Artnet Input and your USB Device Output.

For the most basic implementation setting the ‘Universe Id’ to ‘0’ should be fine.

Name the Universe with the ‘Universe Name’.

This should now be a functioning ArtNet3 Node.

===Setting up Artnet1 compatibility===

''Note: These steps will also works for other plugins, just replace with the appropriate file names.''

You can view the artnet plugin information in the Web Client by selecting ‘Plugins’ on the left and selecting ‘Artnet’.

Alternatively you can use Terminal. To view Plugin list:

ola_plugin_info

Artnet is default Plugin 2, so to see its info.

ola_plugin_info -p 2

Both methods will show you the same thing.

In order to get Artnet1 supported the config files needs to be edited. It is found at ''~/.ola/ola-artnet.conf''

This file is hidden, to open it using terminal type:

gedit ~/.ola/ola-artnet.conf

alternatively:

xdg-open ~/.ola/ola-artnet.conf

alternatively:

gnome-open ~/.ola/ola-artnet.conf

This will open the file in a text editor.

To enable Artnet1 to work change "''''always_broadcast = false''''" to "''''always_broadcast = true''''". Change any other settings you might need. Then save and close.

Go to the web client and on the home page click ‘reload plugins’.

==The Princess is another Castle==

Done, the computer should now be working as a stand alone Artnet to DMX Node.

The Newbie Guide for OLA on Ubuntu

2012-07-20T21:48:04Z

Karsten: added to tutorials category

[[Category:Tutorials]]
Written by Karsten Wolf. 19/7/2012

This guide is written to recount the steps and lessons learned while I attempted to configure Ubuntu to as a stand alone ArtNet Node. This tutorial is split into two guides both tailored towards absolute linux beginners. The first covers installation and configuring of OLA on ubuntu, the second covers configuring of the system to run as a stand alone Artnet Node with a general overview of Plugins and OLA configuration and use.

Prior to this I had no practical linux experience and this guide is written for other users with no practical experience. I found the other information on the wiki either hard to find or over my head due to my inexperience. This guide was written for complete beginners, it incorporates information from almost all the other guides on this wiki, so credit where credit is due.

Also see the guide to configure OLA as a Artnet Node in Ubuntu for some more helpful hints. [[Configuring_OLA_as_a_Artnet_Node_in_Ubuntu]]

__TOC__

===Some important newbie information===

A quick rundown of how some things I learned the hard way.

* ‘sudo’ stands for ‘super user’ and ‘do’. It runs a command with Super User Permission. Usually requires entry of a password.
* If a folder name is preceeded by a ‘.’ such as ‘/.ola’ or ‘/.mozilla’. That file is hidden.
* Ctrl + Alt + T opens a new Terminal.
* Case Sensitivity is important.
* In this How-to anything preceeded by ‘$’ needs to replaced to match your setup. So $USER is a stand in for your Ubuntu username. $IP, $FILENAME, $FILEPATH
* ‘~’ means your home folder. So ‘~/Documents’ is the same as ‘/home/$USER/Documents’
* If you are using lights to test output, be sure to make sure they’re connected properly :)

==Installing Ubuntu==

Your choice here, Pull the latest version from the ubuntu site and install however you like. This guide uses Ubuntu 12.04. Installation is very straight forward and there are plenty of sites out there with how-to’s on this. The most straightforward and simple way to do this is with a LiveCD or LiveUSB key. You should be safe putting ubuntu onto a 5-10gig partition if OLA is all the installation will be used for.

==Installing OLA==

===Dependencies===

====The Easy Way====
To run OLA you need certain bits of software, this command will pull all the needed software, you will need an internet connection. This is by far the easier route.

Enter this text into Terminal.

sudo apt-get install libcppunit-dev libcppunit-1.12-1 uuid-dev pkg-config libncurses5-dev git libtool autoconf automake g++ libmicrohttpd-dev libmicrohttpd5 protobuf-c-compiler libprotobuf-lite6 python-protobuf libprotobuf-dev zlib1g-dev bison flex make

Note: More recent distributions may offer libprotobuf-lite7 instead of libprotobuf-lite6, which is an acceptable substitution.

====Dependancy Hell====
The above is recommended, but if it does not work (ie: no direct internet connection), you can also download and install the packages manually.

# Google for the package.
# Download the archive. ($FILENAME.tar.gz)
# Extract the contents. (Documents folder makes sense)
# Open Terminal. (Ctrl + Alt + T)
# Type "''''cd $FILEPATH''''" then hit ENTER. (Example: “''cd /home/tux/Documents/bison-2.5''”)
# Type "''''./configure''''" then hit ENTER. Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.

Do this for all dependancies.

cppunit

uuid or ossp uuid

pkg-config

curses

lex (or flex)

yacc (or bison)

the protocol buffers library http://code.google.com/p/protobuf/ (version 2.3.0 or later)

microhttpd ftp://ftp.gnu.org/gnu/libmicrohttpd/ (if you want the web UI). You need version >= 0.4.0 of microhttpd

If you're building from git you'll also need the following:

libtool

automake

autoconf

After you’ve installed all the of the dependencies run ''ldconfig''. This will make the new libraries usable.

sudo ldconfig

===Installing OLA===

Good now that you have all the dependancies you can install OLA. There are several ways to do this. [http://www.opendmx.net/index.php/OLA_on_Linux#Checkout_or_Download_an_Archive]

The way I did this was to download the Ubuntu packages from (http://imaginux.com/lighting/) or (http://www.opendmx.net/index.php/Download_%26_Install_OLA#Linux).
Ubuntu 12.04 uses the ‘precise’ packages. Download the appropriate packages and just install.

Another way to install OLA is to build it from the tarball :
http://code.google.com/p/open-lighting/downloads/list

# Open Terminal. (Ctrl + Alt + T)
# Go to the extracted files. Type "''''cd $FILEPATH''''". (Example: “cd /home/tux/Documents/ola-0.8.20”
# If this is the first time run "''''autoreconf -i''''", else run "''''autoreconf''''". Wait for it to finish.
# Type "''''./configure''''" then hit ENTER. There are additional options available through "''''./configure --help''''". Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo ldconfig''''" then hit ENTER.

OLA should now be installed.

You can start it with the commands

cd
olad -l 3

Test it by opening up a web Browser and go to

http://localhost:9090

If the OLA web gui opens it works.

==Device Setup==

This is where the fun begins. These steps apply to Ubuntu 12.04, other versions may vary. Because OLA cannot run as root, it can not access the USB device on some systems. Two ways to do it, both methods take a different means to the same end. One route may be preferential to advanced users, but for a simple setup either way works.

===Option 1===

Suggested by RenZo

Add a udev rule (and it will work with hotplug):

sudo gedit /etc/udev/rules.d/my_dmx_usb.rules

a blank page will appears, write this line:

KERNEL=="ttyUSB*", MODE="0666"

Save and close the editor, then replug your usb device and it should
work forever.

===Option 2===

Suggested by Simon Newton

Add the username to the permissions groups dialout and plugdev. In Ubuntu ‘plugdev’ should be a default group. Be sure to replace $USER with your username.

In terminal check what groups your user is part of already

cat /etc/group | grep $USER

If your user is not a part of plugdev or dialout run these commands

sudo adduser $USER dialout
sudo adduser $USER plugdev

This should give OLA access to the usb device.

The Newbie Guide for OLA on Ubuntu

2012-07-20T04:56:57Z

Karsten: /* Dependancy Hell */

Written by Karsten Wolf. 19/7/2012

This guide is written to recount the steps and lessons learned while I attempted to configure Ubuntu to as a stand alone ArtNet Node. This tutorial is split into two guides both tailored towards absolute linux beginners. The first covers installation and configuring of OLA on ubuntu, the second covers configuring of the system to run as a stand alone Artnet Node with a general overview of Plugins and OLA configuration and use.

Prior to this I had no practical linux experience and this guide is written for other users with no practical experience. I found the other information on the wiki either hard to find or over my head due to my inexperience. This guide was written for complete beginners, it incorporates information from almost all the other guides on this wiki, so credit where credit is due.

Also see the guide to configure OLA as a Artnet Node in Ubuntu for some more helpful hints. [[Configuring_OLA_as_a_Artnet_Node_in_Ubuntu]]

__TOC__

===Some important newbie information===

A quick rundown of how some things I learned the hard way.

* ‘sudo’ stands for ‘super user’ and ‘do’. It runs a command with Super User Permission. Usually requires entry of a password.
* If a folder name is preceeded by a ‘.’ such as ‘/.ola’ or ‘/.mozilla’. That file is hidden.
* Ctrl + Alt + T opens a new Terminal.
* Case Sensitivity is important.
* In this How-to anything preceeded by ‘$’ needs to replaced to match your setup. So $USER is a stand in for your Ubuntu username. $IP, $FILENAME, $FILEPATH
* ‘~’ means your home folder. So ‘~/Documents’ is the same as ‘/home/$USER/Documents’
* If you are using lights to test output, be sure to make sure they’re connected properly :)

==Installing Ubuntu==

Your choice here, Pull the latest version from the ubuntu site and install however you like. This guide uses Ubuntu 12.04. Installation is very straight forward and there are plenty of sites out there with how-to’s on this. The most straightforward and simple way to do this is with a LiveCD or LiveUSB key. You should be safe putting ubuntu onto a 5-10gig partition if OLA is all the installation will be used for.

==Installing OLA==

===Dependencies===

====The Easy Way====
To run OLA you need certain bits of software, this command will pull all the needed software, you will need an internet connection. This is by far the easier route.

Enter this text into Terminal.

sudo apt-get install libcppunit-dev libcppunit-1.12-1 uuid-dev pkg-config libncurses5-dev git libtool autoconf automake g++ libmicrohttpd-dev libmicrohttpd5 protobuf-c-compiler libprotobuf-lite6 python-protobuf libprotobuf-dev zlib1g-dev bison flex make

Note: More recent distributions may offer libprotobuf-lite7 instead of libprotobuf-lite6, which is an acceptable substitution.

====Dependancy Hell====
The above is recommended, but if it does not work (ie: no direct internet connection), you can also download and install the packages manually.

# Google for the package.
# Download the archive. ($FILENAME.tar.gz)
# Extract the contents. (Documents folder makes sense)
# Open Terminal. (Ctrl + Alt + T)
# Type "''''cd $FILEPATH''''" then hit ENTER. (Example: “''cd /home/tux/Documents/bison-2.5''”)
# Type "''''./configure''''" then hit ENTER. Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.

Do this for all dependancies.

cppunit

uuid or ossp uuid

pkg-config

curses

lex (or flex)

yacc (or bison)

the protocol buffers library http://code.google.com/p/protobuf/ (version 2.3.0 or later)

microhttpd ftp://ftp.gnu.org/gnu/libmicrohttpd/ (if you want the web UI). You need version >= 0.4.0 of microhttpd

If you're building from git you'll also need the following:

libtool

automake

autoconf

After you’ve installed all the of the dependencies run ''ldconfig''. This will make the new libraries usable.

sudo ldconfig

===Installing OLA===

Good now that you have all the dependancies you can install OLA. There are several ways to do this. [http://www.opendmx.net/index.php/OLA_on_Linux#Checkout_or_Download_an_Archive]

The way I did this was to download the Ubuntu packages from (http://imaginux.com/lighting/) or (http://www.opendmx.net/index.php/Download_%26_Install_OLA#Linux).
Ubuntu 12.04 uses the ‘precise’ packages. Download the appropriate packages and just install.

Another way to install OLA is to build it from the tarball :
http://code.google.com/p/open-lighting/downloads/list

# Open Terminal. (Ctrl + Alt + T)
# Go to the extracted files. Type "''''cd $FILEPATH''''". (Example: “cd /home/tux/Documents/ola-0.8.20”
# If this is the first time run "''''autoreconf -i''''", else run "''''autoreconf''''". Wait for it to finish.
# Type "''''./configure''''" then hit ENTER. There are additional options available through "''''./configure --help''''". Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo ldconfig''''" then hit ENTER.

OLA should now be installed.

You can start it with the commands

cd
olad -l 3

Test it by opening up a web Browser and go to

http://localhost:9090

If the OLA web gui opens it works.

==Device Setup==

This is where the fun begins. These steps apply to Ubuntu 12.04, other versions may vary. Because OLA cannot run as root, it can not access the USB device on some systems. Two ways to do it, both methods take a different means to the same end. One route may be preferential to advanced users, but for a simple setup either way works.

===Option 1===

Suggested by RenZo

Add a udev rule (and it will work with hotplug):

sudo gedit /etc/udev/rules.d/my_dmx_usb.rules

a blank page will appears, write this line:

KERNEL=="ttyUSB*", MODE="0666"

Save and close the editor, then replug your usb device and it should
work forever.

===Option 2===

Suggested by Simon Newton

Add the username to the permissions groups dialout and plugdev. In Ubuntu ‘plugdev’ should be a default group. Be sure to replace $USER with your username.

In terminal check what groups your user is part of already

cat /etc/group | grep $USER

If your user is not a part of plugdev or dialout run these commands

sudo adduser $USER dialout
sudo adduser $USER plugdev

This should give OLA access to the usb device.

The Newbie Guide for OLA on Ubuntu

2012-07-20T03:00:17Z

Karsten: /* Installing OLA */

Written by Karsten Wolf. 19/7/2012

This guide is written to recount the steps and lessons learned while I attempted to configure Ubuntu to as a stand alone ArtNet Node. This tutorial is split into two guides both tailored towards absolute linux beginners. The first covers installation and configuring of OLA on ubuntu, the second covers configuring of the system to run as a stand alone Artnet Node with a general overview of Plugins and OLA configuration and use.

Prior to this I had no practical linux experience and this guide is written for other users with no practical experience. I found the other information on the wiki either hard to find or over my head due to my inexperience. This guide was written for complete beginners, it incorporates information from almost all the other guides on this wiki, so credit where credit is due.

Also see the guide to configure OLA as a Artnet Node in Ubuntu for some more helpful hints. [[Configuring_OLA_as_a_Artnet_Node_in_Ubuntu]]

__TOC__

===Some important newbie information===

A quick rundown of how some things I learned the hard way.

* ‘sudo’ stands for ‘super user’ and ‘do’. It runs a command with Super User Permission. Usually requires entry of a password.
* If a folder name is preceeded by a ‘.’ such as ‘/.ola’ or ‘/.mozilla’. That file is hidden.
* Ctrl + Alt + T opens a new Terminal.
* Case Sensitivity is important.
* In this How-to anything preceeded by ‘$’ needs to replaced to match your setup. So $USER is a stand in for your Ubuntu username. $IP, $FILENAME, $FILEPATH
* ‘~’ means your home folder. So ‘~/Documents’ is the same as ‘/home/$USER/Documents’
* If you are using lights to test output, be sure to make sure they’re connected properly :)

==Installing Ubuntu==

Your choice here, Pull the latest version from the ubuntu site and install however you like. This guide uses Ubuntu 12.04. Installation is very straight forward and there are plenty of sites out there with how-to’s on this. The most straightforward and simple way to do this is with a LiveCD or LiveUSB key. You should be safe putting ubuntu onto a 5-10gig partition if OLA is all the installation will be used for.

==Installing OLA==

===Dependencies===

====The Easy Way====
To run OLA you need certain bits of software, this command will pull all the needed software, you will need an internet connection. This is by far the easier route.

Enter this text into Terminal.

sudo apt-get install libcppunit-dev libcppunit-1.12-1 uuid-dev pkg-config libncurses5-dev git libtool autoconf automake g++ libmicrohttpd-dev libmicrohttpd5 protobuf-c-compiler libprotobuf-lite6 python-protobuf libprotobuf-dev zlib1g-dev bison flex make

Note: More recent distributions may offer libprotobuf-lite7 instead of libprotobuf-lite6, which is an acceptable substitution.

====Dependancy Hell====
You can also download and install the packages manually. (As I did, being unaware of the above command)

# Google for the package.
# Download the archive. ($FILENAME.tar.gz)
# Extract the contents. (Documents folder makes sense)
# Open Terminal. (Ctrl + Alt + T)
# Type "''''cd $FILEPATH''''" then hit ENTER. (Example: “''cd /home/tux/Documents/bison-2.5''”)
# Type "''''./configure''''" then hit ENTER. Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.

Do this for all dependancies.

cppunit

uuid or ossp uuid

pkg-config

curses

lex (or flex)

yacc (or bison)

the protocol buffers library http://code.google.com/p/protobuf/ (version 2.3.0 or later)

microhttpd ftp://ftp.gnu.org/gnu/libmicrohttpd/ (if you want the web UI). You need version >= 0.4.0 of microhttpd

If you're building from git you'll also need the following:

libtool

automake

autoconf

After you’ve installed all the of the dependencies run ''ldconfig''. This will make the new libraries usable.

sudo ldconfig

===Installing OLA===

Good now that you have all the dependancies you can install OLA. There are several ways to do this. [http://www.opendmx.net/index.php/OLA_on_Linux#Checkout_or_Download_an_Archive]

The way I did this was to download the Ubuntu packages from (http://imaginux.com/lighting/packages/) or (http://www.opendmx.net/index.php/Download_%26_Install_OLA#Linux).
Ubuntu 12.04 uses the ‘precise’ packages. Download the appropriate packages and extract the files.

# Open Terminal. (Ctrl + Alt + T)
# Go to the extracted files. Type "''''cd $FILEPATH''''". (Example: “cd /home/tux/Documents/ola-0.8.20”
# If this is the first time run "''''autoreconf -i''''", else run "''''autoreconf''''". Wait for it to finish.
# Type "''''./configure''''" then hit ENTER. There are additional options available through "''''./configure --help''''". Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo ldconfig''''" then hit ENTER.

OLA should now be installed.

You can start it with the commands

cd
olad -l 3

Test it by opening up a web Browser and go to

http://localhost:9090

If the OLA web gui opens it works.

==Device Setup==

This is where the fun begins. These steps apply to Ubuntu 12.04, other versions may vary. Because OLA cannot run as root, it can not access the USB device on some systems. Two ways to do it, both methods take a different means to the same end. One route may be preferential to advanced users, but for a simple setup either way works.

===Option 1===

Suggested by RenZo

Add a udev rule (and it will work with hotplug):

sudo gedit /etc/udev/rules.d/my_dmx_usb.rules

a blank page will appears, write this line:

KERNEL=="ttyUSB*", MODE="0666"

Save and close the editor, then replug your usb device and it should
work forever.

===Option 2===

Suggested by Simon Newton

Add the username to the permissions groups dialout and plugdev. In Ubuntu ‘plugdev’ should be a default group. Be sure to replace $USER with your username.

In terminal check what groups your user is part of already

cat /etc/group | grep $USER

If your user is not a part of plugdev or dialout run these commands

sudo adduser $USER dialout
sudo adduser $USER plugdev

This should give OLA access to the usb device.

Configuring OLA as a Artnet Node in Ubuntu

2012-07-20T02:57:42Z

Karsten:

Written by Karsten Wolf. 19/7/2012

My current personal requirements were for OLA to be a stand alone stage-side Node which would receive Artnet3 data from Luminosus (http://Luminosus.org) and Artnet1 data from Freestyler (http://Freestylerdmx.be) then output it to a DMXKing.com UltraDMX box.

My computer is an old laptop (with the screen torn off). With this setup, the setup steps are: connect the USB, Ethernet and power then hit the power button and walk away.

See the Guide for installing OLA on ubuntu here: [[The_Newbie_Guide_for_OLA_on_Ubuntu]]

__TOC__

==Setting up OLA to start on startup==

In the top menu bar on the right-most button (power logo) click it to bring up a drop-down menu. Select ‘Startup Applications’.

Click ‘Add’. Name it whatever you like. For the ‘command’ field input type:

olad -l 3

Note: The ‘-l’ is ‘-L’ but lowercase, not the number one. ‘3’ is the logging level, ‘0’ logs nothing, ‘4’ is debug logging, ‘3’ is log level info.

Next you may want to also set the computer to not lock while it’s running. I’m not sure of lock equates to what I understand as ‘sleep’ but I’d rather not have my computer do anything besides turn off the screen.

In the top menu bar on the right-most button (ubuntu logo) click it to bring up a drop-down menu. Select ‘System Settings’. Then select ‘Brightness and Lock’.

Set the brightness and ‘Dim screen to save power’ to whatever you like. Then switch ‘lock’ to ‘OFF’ to disable Ubuntu from locking up (and requiring a password). I tested it and OLA does still receive/transmit when Ubuntu is locked up, so if the computer is accessible to unauthorized personnel, lock may be a security option to have enabled.

At this point restart the system and test OLA with the Web client, if the web client comes up it works.

http://localhost:9090

==Configuring OLA and Artnet==

===OLA Web Client===

OLA is configured through a web browser client. On the Ubuntu machine you can access it in mozilla or any web browser via:

http://localhost:9090

From another computer or mobile device on the same network, type:

http://$IP:9090

example: http://192.168.0.2:9090

To find the IP address in Ubuntu click on the network Icon on the top menu bar. For LAN it’s two arrows, for Wifi it is the radiating antenna Icon. Click it then find ‘Connection Information’ in the drop down menu.

Alternatively you can access the IP in terminal via (ethernet only):

/sbin/ifconfig eth0

===Artnet Config===

To setup a new Universe within the web client click ‘Add Universe’ on the home page.

Devices are listed by name and direction. Direction determines whether it’s input or output. Select the Artnet Input and your USB Device Output.

For the most basic implementation setting the ‘Universe Id’ to ‘0’ should be fine.

Name the Universe with the ‘Universe Name’.

This should now be a functioning ArtNet3 Node.

===Setting up Artnet1 compatibility===

''Note: These steps will also works for other plugins, just replace with the appropriate file names.''

You can view the artnet plugin information in the Web Client by selecting ‘Plugins’ on the left and selecting ‘Artnet’.

Alternatively you can use Terminal. To view Plugin list:

ola_plugin_info

Artnet is default Plugin 2, so to see its info.

ola_plugin_info -p 2

Both methods will show you the same thing.

In order to get Artnet1 supported the config files needs to be edited. It is found at ''~/.ola/ola-artnet.conf''

This file is hidden, to open it using terminal type:

gedit ~/.ola/ola-artnet.conf

alternatively:

xdg-open ~/.ola/ola-artnet.conf

alternatively:

gnome-open ~/.ola/ola-artnet.conf

This will open the file in a text editor.

To enable Artnet1 to work change "''''always_broadcast = false''''" to "''''always_broadcast = true''''". Change any other settings you might need. Then save and close.

Go to the web client and on the home page click ‘reload plugins’.

==The Princess is another Castle==

Done, the computer should now be working as a stand alone Artnet to DMX Node.

Configuring OLA as a Artnet Node in Ubuntu

2012-07-20T02:56:50Z

Karsten:

Configuring OLA as a Artnet Node in Ubuntu

2012-07-20T02:55:53Z

Karsten: added link

Written by Karsten Wolf. 19/7/2012

My current personal requirements were for OLA to be a stand alone stage-side Node which would receive Artnet3 data from Luminosus (http://Luminosus.org) and Artnet1 data from Freestyler (http://Freestylerdmx.be) then output it to a DMXKing.com UltraDMX box.

My computer is an old laptop (with the screen torn off). With this setup, the setup steps are: connect the USB, Ethernet and power then hit the power button and walk away.

See the Guide for installing OLA on ubuntu here: [[The_Newbie_Guide_for_OLA_on_Ubuntu]]

__TOC__

==Setting up OLA to start on startup==

In the top menu bar on the right-most button (power logo) click it to bring up a drop-down menu. Select ‘Startup Applications’.

Click ‘Add’. Name it whatever you like. For the ‘command’ field input type:

olad -l 3

Note: The ‘-l’ is ‘-L’ but lowercase, not the number one. ‘3’ is the logging level, ‘0’ logs nothing, ‘4’ is debug logging, ‘3’ is log level info.

Next you may want to also set the computer to not lock while it’s running. I’m not sure of lock equates to what I understand as ‘sleep’ but I’d rather not have my computer do anything besides turn off the screen.

In the top menu bar on the right-most button (ubuntu logo) click it to bring up a drop-down menu. Select ‘System Settings’. Then select ‘Brightness and Lock’.

Set the brightness and ‘Dim screen to save power’ to whatever you like. Then switch ‘lock’ to ‘OFF’ to disable Ubuntu from locking up (and requiring a password). I tested it and OLA does still receive/transmit when Ubuntu is locked up, so if the computer is accessible to unauthorized personnel, lock may be a security option to have enabled.

At this point restart the system and test OLA with the Web client, if the web client comes up it works.

http://localhost:9090

==Configuring OLA and Artnet==

===OLA Web Client===

OLA is configured through a web browser client. On the Ubuntu machine you can access it in mozilla or any web browser via:

http://localhost:9090

From another computer or mobile device on the same network, type:

http://$IP:9090

example: http://192.168.0.2:9090

To find the IP address in Ubuntu click on the network Icon on the top menu bar. For LAN it’s two arrows, for Wifi it is the radiating antenna Icon. Click it then find ‘Connection Information’ in the drop down menu.

Alternatively you can access the IP in terminal via (ethernet only):

/sbin/ifconfig eth0

===Artnet Config===

To setup a new Universe within the web client click ‘Add Universe’ on the home page.

Devices are listed by name and direction. Direction determines whether it’s input or output. Select the Artnet Input and your USB Device Output.

For the most basic implementation setting the ‘Universe Id’ to ‘0’ should be fine.

Name the Universe with the ‘Universe Name’.

This should now be a functioning ArtNet3 Node.

===Setting up Artnet1 compatibility===

‘’Note: These steps will also works for other plugins, just replace with the appropriate file names.’’

You can view the artnet plugin information in the Web Client by selecting ‘Plugins’ on the left and selecting ‘Artnet’.

Alternatively you can use Terminal. To view Plugin list:

ola_plugin_info

Artnet is default Plugin 2, so to see its info.

ola_plugin_info -p 2

Both methods will show you the same thing.

In order to get Artnet1 supported the config files needs to be edited. It is found at ''~/.ola/ola-artnet.conf''

This file is hidden, to open it using terminal type:

gedit ~/.ola/ola-artnet.conf

alternatively:

xdg-open ~/.ola/ola-artnet.conf

alternatively:

gnome-open ~/.ola/ola-artnet.conf

This will open the file in a text editor.

To enable Artnet1 to work change "''''always_broadcast = false''''" to "''''always_broadcast = true''''". Change any other settings you might need. Then save and close.

Go to the web client and on the home page click ‘reload plugins’.

==The Princess is another Castle==

Done, the computer should now be working as a stand alone Artnet to DMX Node.

The Newbie Guide for OLA on Ubuntu

2012-07-20T02:55:14Z

Karsten: added link, removed uneccesary header

Written by Karsten Wolf. 19/7/2012

This guide is written to recount the steps and lessons learned while I attempted to configure Ubuntu to as a stand alone ArtNet Node. This tutorial is split into two guides both tailored towards absolute linux beginners. The first covers installation and configuring of OLA on ubuntu, the second covers configuring of the system to run as a stand alone Artnet Node with a general overview of Plugins and OLA configuration and use.

Prior to this I had no practical linux experience and this guide is written for other users with no practical experience. I found the other information on the wiki either hard to find or over my head due to my inexperience. This guide was written for complete beginners, it incorporates information from almost all the other guides on this wiki, so credit where credit is due.

Also see the guide to configure OLA as a Artnet Node in Ubuntu for some more helpful hints. [[Configuring_OLA_as_a_Artnet_Node_in_Ubuntu]]

__TOC__

===Some important newbie information===

A quick rundown of how some things I learned the hard way.

* ‘sudo’ stands for ‘super user’ and ‘do’. It runs a command with Super User Permission. Usually requires entry of a password.
* If a folder name is preceeded by a ‘.’ such as ‘/.ola’ or ‘/.mozilla’. That file is hidden.
* Ctrl + Alt + T opens a new Terminal.
* Case Sensitivity is important.
* In this How-to anything preceeded by ‘$’ needs to replaced to match your setup. So $USER is a stand in for your Ubuntu username. $IP, $FILENAME, $FILEPATH
* ‘~’ means your home folder. So ‘~/Documents’ is the same as ‘/home/$USER/Documents’
* If you are using lights to test output, be sure to make sure they’re connected properly :)

==Installing Ubuntu==

Your choice here, Pull the latest version from the ubuntu site and install however you like. This guide uses Ubuntu 12.04. Installation is very straight forward and there are plenty of sites out there with how-to’s on this. The most straightforward and simple way to do this is with a LiveCD or LiveUSB key. You should be safe putting ubuntu onto a 5-10gig partition if OLA is all the installation will be used for.

==Installing OLA==

===Dependencies===

====The Easy Way====
To run OLA you need certain bits of software, this command will pull all the needed software, you will need an internet connection. This is by far the easier route.

Enter this text into Terminal.

sudo apt-get install libcppunit-dev libcppunit-1.12-1 uuid-dev pkg-config libncurses5-dev git libtool autoconf automake g++ libmicrohttpd-dev libmicrohttpd5 protobuf-c-compiler libprotobuf-lite6 python-protobuf libprotobuf-dev zlib1g-dev bison flex make

Note: More recent distributions may offer libprotobuf-lite7 instead of libprotobuf-lite6, which is an acceptable substitution.

====Dependancy Hell====
You can also download and install the packages manually. (As I did, being unaware of the above command)

# Google for the package.
# Download the archive. ($FILENAME.tar.gz)
# Extract the contents. (Documents folder makes sense)
# Open Terminal. (Ctrl + Alt + T)
# Type "''''cd $FILEPATH''''" then hit ENTER. (Example: “''cd /home/tux/Documents/bison-2.5''”)
# Type "''''./configure''''" then hit ENTER. Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.

Do this for all dependancies.

cppunit

uuid or ossp uuid

pkg-config

curses

lex (or flex)

yacc (or bison)

the protocol buffers library http://code.google.com/p/protobuf/ (version 2.3.0 or later)

microhttpd ftp://ftp.gnu.org/gnu/libmicrohttpd/ (if you want the web UI). You need version >= 0.4.0 of microhttpd

If you're building from git you'll also need the following:

libtool

automake

autoconf

After you’ve installed all the of the dependencies run ''ldconfig''. This will make the new libraries usable.

sudo ldconfig

===Installing OLA===

Good now that you have all the dependancies you can install OLA. There are several ways to do this. [http://www.opendmx.net/index.php/OLA_on_Linux#Checkout_or_Download_an_Archive]

The way I did this was to download the Ubuntu packages from (http://imaginux.com/lighting/packages/) or (http://www.opendmx.net/index.php/Download_%26_Install_OLA#Linux) for updated Ubuntu options.
Ubuntu 12.04 uses the ‘precise’ packages. Download the appropriate packages and extract the files.

# Open Terminal. (Ctrl + Alt + T)
# Go to the extracted files. Type "''''cd $FILEPATH''''". (Example: “cd /home/tux/Documents/ola-0.8.20”
# If this is the first time run "''''autoreconf -i''''", else run "''''autoreconf''''". Wait for it to finish.
# Type "''''./configure''''" then hit ENTER. There are additional options available through "''''./configure --help''''". Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo ldconfig''''" then hit ENTER.

OLA should now be installed.

You can start it with the commands

cd
olad -l 3

Test it by opening up a web Browser and go to

http://localhost:9090

If the OLA web gui opens it works.

==Device Setup==

This is where the fun begins. These steps apply to Ubuntu 12.04, other versions may vary. Because OLA cannot run as root, it can not access the USB device on some systems. Two ways to do it, both methods take a different means to the same end. One route may be preferential to advanced users, but for a simple setup either way works.

===Option 1===

Suggested by RenZo

Add a udev rule (and it will work with hotplug):

sudo gedit /etc/udev/rules.d/my_dmx_usb.rules

a blank page will appears, write this line:

KERNEL=="ttyUSB*", MODE="0666"

Save and close the editor, then replug your usb device and it should
work forever.

===Option 2===

Suggested by Simon Newton

Add the username to the permissions groups dialout and plugdev. In Ubuntu ‘plugdev’ should be a default group. Be sure to replace $USER with your username.

In terminal check what groups your user is part of already

cat /etc/group | grep $USER

If your user is not a part of plugdev or dialout run these commands

sudo adduser $USER dialout
sudo adduser $USER plugdev

This should give OLA access to the usb device.

Configuring OLA as a Artnet Node in Ubuntu

2012-07-20T02:53:33Z

Karsten: created

Written by Karsten Wolf. 19/7/2012

My current personal requirements were for OLA to be a stand alone stage-side Node which would receive Artnet3 data from Luminosus (http://Luminosus.org) and Artnet1 data from Freestyler (http://Freestylerdmx.be) then output it to a DMXKing.com UltraDMX box.

My computer is an old laptop (with the screen torn off). With this setup, the setup steps are: connect the USB, Ethernet and power then hit the power button and walk away.

See the Guide for installing OLA on ubuntu here: [LINK]

__TOC__

==Setting up OLA to start on startup==

In the top menu bar on the right-most button (power logo) click it to bring up a drop-down menu. Select ‘Startup Applications’.

Click ‘Add’. Name it whatever you like. For the ‘command’ field input type:

olad -l 3

Note: The ‘-l’ is ‘-L’ but lowercase, not the number one. ‘3’ is the logging level, ‘0’ logs nothing, ‘4’ is debug logging, ‘3’ is log level info.

Next you may want to also set the computer to not lock while it’s running. I’m not sure of lock equates to what I understand as ‘sleep’ but I’d rather not have my computer do anything besides turn off the screen.

In the top menu bar on the right-most button (ubuntu logo) click it to bring up a drop-down menu. Select ‘System Settings’. Then select ‘Brightness and Lock’.

Set the brightness and ‘Dim screen to save power’ to whatever you like. Then switch ‘lock’ to ‘OFF’ to disable Ubuntu from locking up (and requiring a password). I tested it and OLA does still receive/transmit when Ubuntu is locked up, so if the computer is accessible to unauthorized personnel, lock may be a security option to have enabled.

At this point restart the system and test OLA with the Web client, if the web client comes up it works.

http://localhost:9090

==Configuring OLA and Artnet==

===OLA Web Client===

OLA is configured through a web browser client. On the Ubuntu machine you can access it in mozilla or any web browser via:

http://localhost:9090

From another computer or mobile device on the same network, type:

http://$IP:9090

example: http://192.168.0.2:9090

To find the IP address in Ubuntu click on the network Icon on the top menu bar. For LAN it’s two arrows, for Wifi it is the radiating antenna Icon. Click it then find ‘Connection Information’ in the drop down menu.

Alternatively you can access the IP in terminal via (ethernet only):

/sbin/ifconfig eth0

===Artnet Config===

To setup a new Universe within the web client click ‘Add Universe’ on the home page.

Devices are listed by name and direction. Direction determines whether it’s input or output. Select the Artnet Input and your USB Device Output.

For the most basic implementation setting the ‘Universe Id’ to ‘0’ should be fine.

Name the Universe with the ‘Universe Name’.

This should now be a functioning ArtNet3 Node.

===Setting up Artnet1 compatibility===

‘’Note: These steps will also works for other plugins, just replace with the appropriate file names.’’

You can view the artnet plugin information in the Web Client by selecting ‘Plugins’ on the left and selecting ‘Artnet’.

Alternatively you can use Terminal. To view Plugin list:

ola_plugin_info

Artnet is default Plugin 2, so to see its info.

ola_plugin_info -p 2

Both methods will show you the same thing.

In order to get Artnet1 supported the config files needs to be edited. It is found at ''~/.ola/ola-artnet.conf''

This file is hidden, to open it using terminal type:

gedit ~/.ola/ola-artnet.conf

alternatively:

xdg-open ~/.ola/ola-artnet.conf

alternatively:

gnome-open ~/.ola/ola-artnet.conf

This will open the file in a text editor.

To enable Artnet1 to work change "''''always_broadcast = false''''" to "''''always_broadcast = true''''". Change any other settings you might need. Then save and close.

Go to the web client and on the home page click ‘reload plugins’.

==The Princess is another Castle==

Done, the computer should now be working as a stand alone Artnet to DMX Node.

The Newbie Guide for OLA on Ubuntu

2012-07-20T02:51:21Z

Karsten:

==The Newbie Guide for OLA on Ubuntu==

Written by Karsten Wolf. 19/7/2012

This guide is written to recount the steps and lessons learned while I attempted to configure Ubuntu to as a stand alone ArtNet Node. This tutorial is split into two guides both tailored towards absolute linux beginners. The first covers installation and configuring of OLA on ubuntu, the second covers configuring of the system to run as a stand alone Artnet Node with a general overview of Plugins and OLA configuration and use.

Prior to this I had no practical linux experience and this guide is written for other users with no practical experience. I found the other information on the wiki either hard to find or over my head due to my inexperience. This guide was written for complete beginners, it incorporates information from almost all the other guides on this wiki, so credit where credit is due.

Also see the guide to configure OLA as a Artnet Node in Ubuntu for some more helpful hints.

__TOC__

===Some important newbie information===

A quick rundown of how some things I learned the hard way.

* ‘sudo’ stands for ‘super user’ and ‘do’. It runs a command with Super User Permission. Usually requires entry of a password.
* If a folder name is preceeded by a ‘.’ such as ‘/.ola’ or ‘/.mozilla’. That file is hidden.
* Ctrl + Alt + T opens a new Terminal.
* Case Sensitivity is important.
* In this How-to anything preceeded by ‘$’ needs to replaced to match your setup. So $USER is a stand in for your Ubuntu username. $IP, $FILENAME, $FILEPATH
* ‘~’ means your home folder. So ‘~/Documents’ is the same as ‘/home/$USER/Documents’
* If you are using lights to test output, be sure to make sure they’re connected properly :)

==Installing Ubuntu==

Your choice here, Pull the latest version from the ubuntu site and install however you like. This guide uses Ubuntu 12.04. Installation is very straight forward and there are plenty of sites out there with how-to’s on this. The most straightforward and simple way to do this is with a LiveCD or LiveUSB key. You should be safe putting ubuntu onto a 5-10gig partition if OLA is all the installation will be used for.

==Installing OLA==

===Dependencies===

====The Easy Way====
To run OLA you need certain bits of software, this command will pull all the needed software, you will need an internet connection. This is by far the easier route.

Enter this text into Terminal.

sudo apt-get install libcppunit-dev libcppunit-1.12-1 uuid-dev pkg-config libncurses5-dev git libtool autoconf automake g++ libmicrohttpd-dev libmicrohttpd5 protobuf-c-compiler libprotobuf-lite6 python-protobuf libprotobuf-dev zlib1g-dev bison flex make

Note: More recent distributions may offer libprotobuf-lite7 instead of libprotobuf-lite6, which is an acceptable substitution.

====Dependancy Hell====
You can also download and install the packages manually. (As I did, being unaware of the above command)

# Google for the package.
# Download the archive. ($FILENAME.tar.gz)
# Extract the contents. (Documents folder makes sense)
# Open Terminal. (Ctrl + Alt + T)
# Type "''''cd $FILEPATH''''" then hit ENTER. (Example: “''cd /home/tux/Documents/bison-2.5''”)
# Type "''''./configure''''" then hit ENTER. Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.

Do this for all dependancies.

cppunit

uuid or ossp uuid

pkg-config

curses

lex (or flex)

yacc (or bison)

the protocol buffers library http://code.google.com/p/protobuf/ (version 2.3.0 or later)

microhttpd ftp://ftp.gnu.org/gnu/libmicrohttpd/ (if you want the web UI). You need version >= 0.4.0 of microhttpd

If you're building from git you'll also need the following:

libtool

automake

autoconf

After you’ve installed all the of the dependencies run ''ldconfig''. This will make the new libraries usable.

sudo ldconfig

===Installing OLA===

Good now that you have all the dependancies you can install OLA. There are several ways to do this. [http://www.opendmx.net/index.php/OLA_on_Linux#Checkout_or_Download_an_Archive]

The way I did this was to download the Ubuntu packages from (http://imaginux.com/lighting/packages/) or (http://www.opendmx.net/index.php/Download_%26_Install_OLA#Linux) for updated Ubuntu options.
Ubuntu 12.04 uses the ‘precise’ packages. Download the appropriate packages and extract the files.

# Open Terminal. (Ctrl + Alt + T)
# Go to the extracted files. Type "''''cd $FILEPATH''''". (Example: “cd /home/tux/Documents/ola-0.8.20”
# If this is the first time run "''''autoreconf -i''''", else run "''''autoreconf''''". Wait for it to finish.
# Type "''''./configure''''" then hit ENTER. There are additional options available through "''''./configure --help''''". Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo ldconfig''''" then hit ENTER.

OLA should now be installed.

You can start it with the commands

cd
olad -l 3

Test it by opening up a web Browser and go to

http://localhost:9090

If the OLA web gui opens it works.

==Device Setup==

This is where the fun begins. These steps apply to Ubuntu 12.04, other versions may vary. Because OLA cannot run as root, it can not access the USB device on some systems. Two ways to do it, both methods take a different means to the same end. One route may be preferential to advanced users, but for a simple setup either way works.

===Option 1===

Suggested by RenZo

Add a udev rule (and it will work with hotplug):

sudo gedit /etc/udev/rules.d/my_dmx_usb.rules

a blank page will appears, write this line:

KERNEL=="ttyUSB*", MODE="0666"

Save and close the editor, then replug your usb device and it should
work forever.

===Option 2===

Suggested by Simon Newton

Add the username to the permissions groups dialout and plugdev. In Ubuntu ‘plugdev’ should be a default group. Be sure to replace $USER with your username.

In terminal check what groups your user is part of already

cat /etc/group | grep $USER

If your user is not a part of plugdev or dialout run these commands

sudo adduser $USER dialout
sudo adduser $USER plugdev

This should give OLA access to the usb device.

The Newbie Guide for OLA on Ubuntu

2012-07-20T02:50:19Z

Karsten: /* Dependancy Hell */

==The Newbie Guide for OLA on Ubuntu==

Written by Karsten Wolf. 19/7/2012

This guide is written to recount the steps and lessons learned while I attempted to configure Ubuntu to as a stand alone ArtNet Node. This tutorial is split into two guides both tailored towards absolute linux beginners. The first covers installation and configuring of OLA on ubuntu, the second covers configuring of the system to run as a stand alone Artnet Node with a general overview of Plugins and OLA configuration and use.

Prior to this I had no practical linux experience and this guide is written for other users with no practical experience. I found the other information on the wiki either hard to find or over my head due to my inexperience. This guide was written for complete beginners, it incorporates information from almost all the other guides on this wiki, so credit where credit is due.

Also see the guide to configure OLA as a Artnet Node in Ubuntu for some more helpful hints.

__TOC__

===Some important newbie information===

A quick rundown of how some things I learned the hard way.

* ‘sudo’ stands for ‘super user’ and ‘do’. It runs a command with Super User Permission
* If a folder name is preceeded by a ‘.’ such as ‘/.ola’ or ‘/.mozilla’. That file is hidden.
* Ctrl + Alt + T opens a new Terminal.
* Case Sensitivity is important.
* In this How-to anything preceeded by ‘$’ needs to replaced to match your setup. So $USER is a stand in for your Ubuntu username. $IP, $FILENAME, $FILEPATH
* ‘~’ means your home folder. So ‘~/Documents’ is the same as ‘/home/$USER/Documents’
* If you are using lights to test output, be sure to make sure they’re connected properly :)

==Installing Ubuntu==

Your choice here, Pull the latest version from the ubuntu site and install however you like. This guide uses Ubuntu 12.04. Installation is very straight forward and there are plenty of sites out there with how-to’s on this. The most straightforward and simple way to do this is with a LiveCD or LiveUSB key. You should be safe putting ubuntu onto a 5-10gig partition if OLA is all the installation will be used for.

==Installing OLA==

===Dependencies===

====The Easy Way====
To run OLA you need certain bits of software, this command will pull all the needed software, you will need an internet connection. This is by far the easier route.

Enter this text into Terminal.

sudo apt-get install libcppunit-dev libcppunit-1.12-1 uuid-dev pkg-config libncurses5-dev git libtool autoconf automake g++ libmicrohttpd-dev libmicrohttpd5 protobuf-c-compiler libprotobuf-lite6 python-protobuf libprotobuf-dev zlib1g-dev bison flex make

Note: More recent distributions may offer libprotobuf-lite7 instead of libprotobuf-lite6, which is an acceptable substitution.

====Dependancy Hell====
You can also download and install the packages manually. (As I did, being unaware of the above command)

# Google for the package.
# Download the archive. ($FILENAME.tar.gz)
# Extract the contents. (Documents folder makes sense)
# Open Terminal. (Ctrl + Alt + T)
# Type "''''cd $FILEPATH''''" then hit ENTER. (Example: “''cd /home/tux/Documents/bison-2.5''”)
# Type "''''./configure''''" then hit ENTER. Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.

Do this for all dependancies.

cppunit

uuid or ossp uuid

pkg-config

curses

lex (or flex)

yacc (or bison)

the protocol buffers library http://code.google.com/p/protobuf/ (version 2.3.0 or later)

microhttpd ftp://ftp.gnu.org/gnu/libmicrohttpd/ (if you want the web UI). You need version >= 0.4.0 of microhttpd

If you're building from git you'll also need the following:

libtool

automake

autoconf

After you’ve installed all the of the dependencies run ''ldconfig''. This will make the new libraries usable.

sudo ldconfig

===Installing OLA===

Good now that you have all the dependancies you can install OLA. There are several ways to do this. [http://www.opendmx.net/index.php/OLA_on_Linux#Checkout_or_Download_an_Archive]

The way I did this was to download the Ubuntu packages from (http://imaginux.com/lighting/packages/) or (http://www.opendmx.net/index.php/Download_%26_Install_OLA#Linux) for updated Ubuntu options.
Ubuntu 12.04 uses the ‘precise’ packages. Download the appropriate packages and extract the files.

# Open Terminal. (Ctrl + Alt + T)
# Go to the extracted files. Type "''''cd $FILEPATH''''". (Example: “cd /home/tux/Documents/ola-0.8.20”
# If this is the first time run "''''autoreconf -i''''", else run "''''autoreconf''''". Wait for it to finish.
# Type "''''./configure''''" then hit ENTER. There are additional options available through "''''./configure --help''''". Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo ldconfig''''" then hit ENTER.

OLA should now be installed.

You can start it with the commands

cd
olad -l 3

Test it by opening up a web Browser and go to

http://localhost:9090

If the OLA web gui opens it works.

==Device Setup==

This is where the fun begins. These steps apply to Ubuntu 12.04, other versions may vary. Because OLA cannot run as root, it can not access the USB device on some systems. Two ways to do it, both methods take a different means to the same end. One route may be preferential to advanced users, but for a simple setup either way works.

===Option 1===

Suggested by RenZo

Add a udev rule (and it will work with hotplug):

sudo gedit /etc/udev/rules.d/my_dmx_usb.rules

a blank page will appears, write this line:

KERNEL=="ttyUSB*", MODE="0666"

Save and close the editor, then replug your usb device and it should
work forever.

===Option 2===

Suggested by Simon Newton

Add the username to the permissions groups dialout and plugdev. In Ubuntu ‘plugdev’ should be a default group. Be sure to replace $USER with your username.

In terminal check what groups your user is part of already

cat /etc/group | grep $USER

If your user is not a part of plugdev or dialout run these commands

sudo adduser $USER dialout
sudo adduser $USER plugdev

This should give OLA access to the usb device.

The Newbie Guide for OLA on Ubuntu

2012-07-20T02:49:35Z

Karsten:

==The Newbie Guide for OLA on Ubuntu==

Written by Karsten Wolf. 19/7/2012

This guide is written to recount the steps and lessons learned while I attempted to configure Ubuntu to as a stand alone ArtNet Node. This tutorial is split into two guides both tailored towards absolute linux beginners. The first covers installation and configuring of OLA on ubuntu, the second covers configuring of the system to run as a stand alone Artnet Node with a general overview of Plugins and OLA configuration and use.

Prior to this I had no practical linux experience and this guide is written for other users with no practical experience. I found the other information on the wiki either hard to find or over my head due to my inexperience. This guide was written for complete beginners, it incorporates information from almost all the other guides on this wiki, so credit where credit is due.

Also see the guide to configure OLA as a Artnet Node in Ubuntu for some more helpful hints.

__TOC__

===Some important newbie information===

A quick rundown of how some things I learned the hard way.

* ‘sudo’ stands for ‘super user’ and ‘do’. It runs a command with Super User Permission
* If a folder name is preceeded by a ‘.’ such as ‘/.ola’ or ‘/.mozilla’. That file is hidden.
* Ctrl + Alt + T opens a new Terminal.
* Case Sensitivity is important.
* In this How-to anything preceeded by ‘$’ needs to replaced to match your setup. So $USER is a stand in for your Ubuntu username. $IP, $FILENAME, $FILEPATH
* ‘~’ means your home folder. So ‘~/Documents’ is the same as ‘/home/$USER/Documents’
* If you are using lights to test output, be sure to make sure they’re connected properly :)

==Installing Ubuntu==

Your choice here, Pull the latest version from the ubuntu site and install however you like. This guide uses Ubuntu 12.04. Installation is very straight forward and there are plenty of sites out there with how-to’s on this. The most straightforward and simple way to do this is with a LiveCD or LiveUSB key. You should be safe putting ubuntu onto a 5-10gig partition if OLA is all the installation will be used for.

==Installing OLA==

===Dependencies===

====The Easy Way====
To run OLA you need certain bits of software, this command will pull all the needed software, you will need an internet connection. This is by far the easier route.

Enter this text into Terminal.

sudo apt-get install libcppunit-dev libcppunit-1.12-1 uuid-dev pkg-config libncurses5-dev git libtool autoconf automake g++ libmicrohttpd-dev libmicrohttpd5 protobuf-c-compiler libprotobuf-lite6 python-protobuf libprotobuf-dev zlib1g-dev bison flex make

Note: More recent distributions may offer libprotobuf-lite7 instead of libprotobuf-lite6, which is an acceptable substitution.

====Dependancy Hell====
You can also download and install the packages manually. (As I did, being unaware of the above command)

# Google for the package.
# Download the archive. ($FILENAME.tar.gz)
# Extract the contents. (Documents folder makes sense)
# Open Terminal. (Ctrl + Alt + T)
# Type "''''cd $FILEPATH''''" then hit ENTER. (Example: “''cd /home/tux/Documents/bison-2.5''”)
# Type "''''./configure''''" then hit ENTER. Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.

Do this for all dependancies.

cppunit

uuid or ossp uuid

pkg-config

curses

lex (or flex)

yacc (or bison)

the protocol buffers library http://code.google.com/p/protobuf/ (version 2.3.0 or later)
microhttpd ftp://ftp.gnu.org/gnu/libmicrohttpd/ (if you want the web UI). You need version >= 0.4.0 of microhttpd

If you're building from git you'll also need the following:

libtool

automake

autoconf

After you’ve installed all the of the dependencies run ''ldconfig''. This will make the new libraries usable.

sudo ldconfig

===Installing OLA===

Good now that you have all the dependancies you can install OLA. There are several ways to do this. [http://www.opendmx.net/index.php/OLA_on_Linux#Checkout_or_Download_an_Archive]

The way I did this was to download the Ubuntu packages from (http://imaginux.com/lighting/packages/) or (http://www.opendmx.net/index.php/Download_%26_Install_OLA#Linux) for updated Ubuntu options.
Ubuntu 12.04 uses the ‘precise’ packages. Download the appropriate packages and extract the files.

# Open Terminal. (Ctrl + Alt + T)
# Go to the extracted files. Type "''''cd $FILEPATH''''". (Example: “cd /home/tux/Documents/ola-0.8.20”
# If this is the first time run "''''autoreconf -i''''", else run "''''autoreconf''''". Wait for it to finish.
# Type "''''./configure''''" then hit ENTER. There are additional options available through "''''./configure --help''''". Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo ldconfig''''" then hit ENTER.

OLA should now be installed.

You can start it with the commands

cd
olad -l 3

Test it by opening up a web Browser and go to

http://localhost:9090

If the OLA web gui opens it works.

==Device Setup==

This is where the fun begins. These steps apply to Ubuntu 12.04, other versions may vary. Because OLA cannot run as root, it can not access the USB device on some systems. Two ways to do it, both methods take a different means to the same end. One route may be preferential to advanced users, but for a simple setup either way works.

===Option 1===

Suggested by RenZo

Add a udev rule (and it will work with hotplug):

sudo gedit /etc/udev/rules.d/my_dmx_usb.rules

a blank page will appears, write this line:

KERNEL=="ttyUSB*", MODE="0666"

Save and close the editor, then replug your usb device and it should
work forever.

===Option 2===

Suggested by Simon Newton

Add the username to the permissions groups dialout and plugdev. In Ubuntu ‘plugdev’ should be a default group. Be sure to replace $USER with your username.

In terminal check what groups your user is part of already

cat /etc/group | grep $USER

If your user is not a part of plugdev or dialout run these commands

sudo adduser $USER dialout
sudo adduser $USER plugdev

This should give OLA access to the usb device.

The Newbie Guide for OLA on Ubuntu

2012-07-20T02:48:25Z

Karsten: created page

==The Newbie Guide for OLA on Ubuntu==

Written by Karsten Wolf. 19/7/2012

This guide is written to recount the steps and lessons learned while I attempted to configure Ubuntu to as a stand alone ArtNet Node. This tutorial is split into two guides both tailored towards absolute linux beginners. The first covers installation and configuring of OLA on ubuntu, the second covers configuring of the system to run as a stand alone Artnet Node with a general overview of Plugins and OLA configuration and use.

Prior to this I had no practical linux experience and this guide is written for other users with no practical experience. I found the other information on the wiki either hard to find or over my head due to my inexperience. This guide was written for complete beginners, it incorporates information from almost all the other guides on this wiki, so credit where credit is due.

Also see the guide to configure OLA as a Artnet Node in Ubuntu for some more helpful hints.

__TOC__

===Some important newbie information===

A quick rundown of how some things I learned the hard way.

* ‘sudo’ stands for ‘super user’ and ‘do’. It runs a command with Super User Permission
* If a folder name is preceeded by a ‘.’ such as ‘/.ola’ or ‘/.mozilla’. That file is hidden.
* Ctrl + Alt + T opens a new Terminal.
* Case Sensitivity is important.
* In this How-to anything preceeded by ‘$’ needs to replaced to match your setup. So $USER is a stand in for your Ubuntu username. $IP, $FILENAME, $FILEPATH
* ‘~’ means your home folder. So ‘~/Documents’ is the same as ‘/home/$USER/Documents’
* If you are using lights to test output, be sure to make sure they’re connected properly :)

==Installing Ubuntu==

Your choice here, Pull the latest version from the ubuntu site and install however you like. This guide uses Ubuntu 12.04. Installation is very straight forward and there are plenty of sites out there with how-to’s on this. The most straightforward and simple way to do this is with a LiveCD or LiveUSB key. You should be safe putting ubuntu onto a 5-10gig partition if OLA is all the installation will be used for.

==Installing OLA==

===Dependencies===

====The Easy Way====
To run OLA you need certain bits of software, this command will pull all the needed software, you will need an internet connection. This is by far the easier route.

sudo apt-get install libcppunit-dev libcppunit-1.12-1 uuid-dev pkg-config libncurses5-dev git libtool autoconf automake g++ libmicrohttpd-dev libmicrohttpd5 protobuf-c-compiler libprotobuf-lite6 python-protobuf libprotobuf-dev zlib1g-dev bison flex make

Note: More recent distributions may offer libprotobuf-lite7 instead of libprotobuf-lite6, which is an acceptable substitution.

====Dependancy Hell====
You can also download and install the packages manually. (As I did, being unaware of the above command)

# Google for the package.
# Download the archive. ($FILENAME.tar.gz)
# Extract the contents. (Documents folder makes sense)
# Open Terminal. (Ctrl + Alt + T)
# Type "''''cd $FILEPATH''''" then hit ENTER. (Example: “''cd /home/tux/Documents/bison-2.5''”)
# Type "''''./configure''''" then hit ENTER. Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.

Do this for all dependancies.

cppunit

uuid or ossp uuid

pkg-config

curses

lex (or flex)

yacc (or bison)

the protocol buffers library http://code.google.com/p/protobuf/ (version 2.3.0 or later)
microhttpd ftp://ftp.gnu.org/gnu/libmicrohttpd/ (if you want the web UI). You need version >= 0.4.0 of microhttpd

If you're building from git you'll also need the following:

libtool

automake

autoconf

After you’ve installed all the of the dependencies run ''ldconfig''. This will make the new libraries usable.

sudo ldconfig

===Installing OLA===

Good now that you have all the dependancies you can install OLA. There are several ways to do this. [http://www.opendmx.net/index.php/OLA_on_Linux#Checkout_or_Download_an_Archive]

The way I did this was to download the Ubuntu packages from (http://imaginux.com/lighting/packages/) or (http://www.opendmx.net/index.php/Download_%26_Install_OLA#Linux) for updated Ubuntu options.
Ubuntu 12.04 uses the ‘precise’ packages. Download the appropriate packages and extract the files.

# Open Terminal. (Ctrl + Alt + T)
# Go to the extracted files. Type "''''cd $FILEPATH''''". (Example: “cd /home/tux/Documents/ola-0.8.20”
# If this is the first time run "''''autoreconf -i''''", else run "''''autoreconf''''". Wait for it to finish.
# Type "''''./configure''''" then hit ENTER. There are additional options available through "''''./configure --help''''". Wait for it to finish.
# Type "''''make''''" then hit ENTER. Wait for it to finish.
# Type "''''make check''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo make install''''" then hit ENTER. Wait for it to finish.
# Type "''''sudo ldconfig''''" then hit ENTER.

OLA should now be installed.

You can start it with the commands

cd
olad -l 3

Test it by opening up a web Browser and go to

http://localhost:9090

If the OLA web gui opens it works.

==Device Setup==

This is where the fun begins. These steps apply to Ubuntu 12.04, other versions may vary. Because OLA cannot run as root, it can not access the USB device on some systems. Two ways to do it, both methods take a different means to the same end. One route may be preferential to advanced users, but for a simple setup either way works.

===Option 1===

Suggested by RenZo

Add a udev rule (and it will work with hotplug):

sudo gedit /etc/udev/rules.d/my_dmx_usb.rules

a blank page will appears, write this line:

KERNEL=="ttyUSB*", MODE="0666"

Save and close the editor, then replug your usb device and it should
work forever.

===Option 2===

Suggested by Simon Newton

Add the username to the permissions groups dialout and plugdev. In Ubuntu ‘plugdev’ should be a default group. Be sure to replace $USER with your username.

In terminal check what groups your user is part of already

cat /etc/group | grep $USER

If your user is not a part of plugdev or dialout run these commands

sudo adduser $USER dialout
sudo adduser $USER plugdev

This should give OLA access to the usb device.