HowTo Build the HAMcast prototype

Requirements

We developed and tested the HAMcast prototype under Ubuntu Linux (10.10) and MacOS X. However, it should compile and run under any other Linux distribution as well - let us know if you encounter any problems. The minimal requirements to install HAMcast on your system are to provide the following tools and libraries:

• build tools (gcc ...)
• automake + libtool
• Boost library (1.42 or higher)
• SSL developer library
• PCAP developer library

Ubuntu or Debian users may use the following shortcuts to install all necessary packages via apt (root access required):

 sudo apt-get install build-essential automake libtool

 sudo apt-get install libboost-all-dev libssl-dev libpcap-dev

Build and run HAMcast on Linux or MacOS

In general it is quite simple to get HAMcast working on UNIX platforms. For a start you only have to download our latest prototype release (LINK) and the build.sh script provided. However, you may also manually compile HAMcast - this is pretty easy, as we use automake to generate configure-scripts and Makefiles. The source code of HAMcast is structured into three main parts, plus some software examples:

• Multicast API (libhamcast/)
• Middleware component (middleware/)
• Technology modules (modules/<technology>)
• Examples (programs/<software>)

Run the following sequence of commands in all subdirectories (libhamcast, middleware ...):

automake -i && ./configure && make

If you have root access, you may also install libhamcast on your system (though we recommend to test it first on a non-productive system) with:

make install

Note for Linux users

If you're getting the error "No CAS for this plattform", then you need to set your hardware architecture by hand using the configure script. run "uname -m" to see your hardware architecture, this should be one of i386, i568, i686 or x86_64, then (re)run the configure script as follows:

./configure CXXFLAGS="-march={YOUR_ARCH}"

where {YOUR_ARCH} is your hardware architecture (note: GCC expects x86-64 instead of x86_64), if you are unsure use native. Continue with make.