Getting Started

First, download OpenDAX. See the download page for details on how to get the source code.

If you get the source code from the Subversion repository you will probably have to run the bootstrap.sh file in the root directory of the package to set up autoconf and automake. Otherwise you should be able to simply run...

./configure
make
sudo make install

This should install the program on most operating systems but since OpenDAX is still in the early development stage it is likely that there will be problems. Please help us figure out how to get autoconf and automake to work properly on the system that you are installing on.

OpenDAX has two library dependencies at this point. The readline library is used by the daxc command line module. If it is not there then daxc should still compile but with reduced functionality.

The second dependency is Lua Version 5.1. Lua libraries will likely be a problem. At the moment the only module that needs lua is the daxlua interpreter module but all of the base modules as well as opendax itself will soon use lua as the configuration file language so this dependency will have to be met.

One of the problems with the lua libraries is that different distributions will install the libraries with different names for the libraries and header files. The configure script tries to figure out where they are but you might have to help to get configure to find them.

Configure will look for libraries in the ld search path with these names, liblua, liblua51 and liblua5.1. If your distribution has another name for the libraries please let us know.

Configure will look for the header files, lua.h, luaxlib.h and lualib.h in the directories lua/ lua51/, lua5.1/ and in the normal include directories. If it doesn't find any of these there will likely be compile time errors, when building lua.

OS Specific Notes

Mac OS X

Download the source code file from www.lua.org and uncompress the file somewhere on your hard disk. At the time of this writing the lastet version was 5.1.2.

% tar -xzvf lua-5.1.2.tar.gz

Then it's a simple matter of...

cd lua-5.1.2
make macosx
sudo make install

This is the easiest way that i have found to satisfy the Lua library requirements on OS X. This statically links the library but it's tiny so that shouldn't be too much of an issue. This is good enough for development at this point.

The readline library should already be installed with OS X and shouldn't cause a problem.

Ubuntu Linux

Install the following packages...

% sudo apt-get install liblua5.1-0 liblua5.1-0-dev lua5.1 lua5.1-doc

Lua depends on libreadline as well so once these packages are installed all of the OpenDAX dependencies should be met. This was last tried on Ubuntu 7.10.

FreeBSD

I've had trouble getting the Lua dependencies met with FreeBSD. I can get the libraries installed and configure finds them but the linker doesn't find them when make is run for some reason. I don't know that much about FreeBSD and frankly I don't use it so I had little motivation to work out the problems. I'd love it if someone could figure it out and drop me a line so that I can include those notes here.