Difference between revisions of "OLA on OS X"

Revision as of 20:39, 23 July 2011

There are at least 4 ways to install OLA on a mac, which one you choose depends on your system, the level of control and speed of updates you prefer. Avoid mixing the methods as odd behavior can result.

Use a Mac Installer

This is the easiest for new users but tends to lag behind the main released. It can be downloaded here (look for the .dmg file). The installer only supports 10.6 and intel macs.

Use Mac Ports

This is a good middle-of-the-road option. It gives you some control over how OLA is configured as well as relatively frequent updates. It should support all platforms and OS X versions.

Install from tarball

This is similar to using mac ports but you get a bit more control. You can also access programs that aren't installed normally like the RDM testing code.

Install from the git repo

This is the bleeding edge and recommended for power users and developers. May break at any time.

Install With Mac Ports

This can take a while as you need to download & install Xcode as well as all the OLA dependancies.

• Install Xcode . Xcode comes in two versions: XCode 4 which you need to pay for and XCode 3 which is free. XCode 3 works just fine.
• Install MacPorts
• Install OLA and all the dependancies by running

$ sudo port install ola

Install from tarball or git repo

• Install Xcode . Xcode comes in two versions: XCode 4 which you need to pay for and XCode 3 which is free. XCode 3 works just fine.
• Install MacPorts, we use this to install all the OLA dependancies.

Use MacPorts to install dependencies

$  sudo port install pkgconfig cppunit protobuf-cpp unittest-cpp libmicrohttpd libusb

If you intend to use git install it now

 $ sudo port install git

Set some environment variables

set $PATH to point to something sane:

export PKG_CONFIG_PATH="/opt/local/lib/pkgconfig:$PKG_CONFIG_PATH"
export CPPFLAGS="-I/opt/local/include"
export LDFLAGS="-L/opt/local/lib"
export PYTHONPATH=/usr/local/lib/python2.6/site-packages/:/opt/local/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/site-packages

You may need to tweak the PYTHONPATH depending on where protobuf-python was installed

Checkout OLA or Download the tarball

 git clone http://git.opendmx.net/ola
 cd ola

or

 wget $ola_url
 tar -zxf $ola_file
 cd lla

Run autoreconf

If this is the first time run with -i to install the missing files

autoreconf -i

Do the usual steps

./configure
make
make check
sudo make install

Common Problems

Architectures

Snow Leopard builds binaries as 64-bit by default. If you need to build as 32-bit use the following to configure:

 CPPFLAGS="-arch i386"  LDFLAGS=" -arch i386" ./configure

Then, build using:

 make CPPFLAGS="-arch i386"  LDFLAGS="-arch i386"

Note you'll need to do the same when you run make check:

 make CPPFLAGS="-arch i386"  LDFLAGS="-arch i386" check

Mac OS X Version 10.4

If you're building for 10.4 you need to run configure with MACOSX_DEPLOYMENT_TARGET:

 ./configure  MACOSX_DEPLOYMENT_TARGET=10.4

otherwise you'll get errors in the form

/Developer/usr/bin/ld: multiple definitions of symbol _create  ../plugins/stageprofi/.libs/libolastageprofi.dylib(single module) definition of _create