HowTo Run the HAMcast prototype

---

Middleware

Before you can start any other software, that uses HAMcast API and stack, you must configure and start the HAMcast middleware. To configure the HAMcast middleware see here. The middleware requires a middleware.ini and libhamcast at runtime. If you have not installed libhamcast to standard folders, e.g. /usr/lib/, you must specifiy the environment variable LD_LIBRARY_PATH pointing to libhamcast path. If middleware.ini is not in the same directory as the middleware you can specifiy a path with option -i <path/middleware.ini>.

To run middleware, use one of the following commands:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<path-to-libhamcast>
./middleware

or

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<path-to-libhamcast>
./middleware -i <path/middleware.ini>

Check the REAMDE file for further information.

---

Programs and Tools

All software based on the common multicast API and network stack provided by HAMcast need its library (libhamcast) and a running middleware (see above). If you have not installed libhamcast to standard folders, e.g. /usr/lib/, you must specifiy the environment variable LD_LIBRARY_PATH pointing to libhamcast path.

To do so, run:

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<path-to-libhamcast>
./<program>

or

LD_LIBRARY_PATH=<path-to-libhamcast> ./<program>

Also check the README file of the program for further information on requirements and instructions. Most of our tools provide usage and help infos, run ./<program> -h.

---