AccessGrid.org

Installing Multicast Beacon

Beacon is a useful tool to help you debug your multicasting problems. It provides useful information regarding a particular multicasting group’s connection activity.

Installation

The following guide demonstrates how to configure your node for the ASIA-PACIFIC Aarnet beacon server. For UK nodes please use http://ulcc.beacon.ja.net/ag/ and other Global nodes, please use http://beacon.dast.nlanr.net/

  • The easiest way to install the beacon software is to use the yum package manager which is included with Fedora. The beacon software is now included within the Access Grid repository for Fedora 12.
  • Start up "Terminal" and switch to superuser.
  • Issue the command:
yum install beacon

  • It will proceed to install the beacon server package. It will ask "Is this ok [y/n]" at some point. Just hit "y" to continue. This should only take a minute.
  • After installing the beacon software, the configuration file for beacon will require some changes to work correctly with the Aarnet beacon server (or any other beaconserver). This configuration file informs beacon where to look for the server, locations of files, contact details and various other types of information.
  • Edit the file /etc/beacon.conf. The following lines within the configuration files are listed below that requires modification. You may also be required to uncomment any lines that are currently commented out.:
GROUP = 233.70.142.1
CONTACTNAME = Insert Your Name Here
CONTACTINFO = Insert Your Phone No. Here
CONTACTLOCATION = Insert Your Location Here
NOTIFYEMAIL = Insert Your Email Address Here
OUTPUTDIR = /var/lib/beacon
CENTRALSERVERNAME = beacon2.aarnet.net.au

You must also comment out the last line, STOPME.

Now save and exit beacon.conf.

  • You should now be able to run the beacon software. As super-user type ‘service beacon start’ in the terminal. This should start up the software as a service.
  • To ensure the beacon is started upon "boot-up", issue the command chkconfig beacon on
  • To check that the beacon service had been added, issue the command chkconfig --list beacon. The service should be "on" for 2,3,4 and 5.

Starting, Stopping and Restarting the Beacon Service

  • To start the beacon service, simply issue the command:
service beacon start

  • To restart the beacon service, simply issue the command:
service beacon restart

  • To stop the beacon service, simply issue the command:
service beacon stop

Running multiple instances of beacon

The following beacon.sh script can be used to start multiple instances of beacon.

#!/bin/sh
#
# Start/stop/restart the multicast beacons
# Assume backgrounding has been enabled in configuration file

BEACON_HOME=/home/beacon/outputfiles
GRANGENET_HOME=/home/beacon/grangenet

beacon_start() {
# DAST beacon
#
cd ${BEACON_HOME} && /usr/bin/beacon --outputdir ${BEACON_HOME} \
--group 233.4.200.18 \
--centralservername beacon.dast.nlanr.net

# Grangenet beacon
#
cd ${GRANGENET_HOME} && /usr/bin/beacon --outputdir ${GRANGENET_HOME} \
--group 233.70.142.1 --port 10002 \
--centralservername beacon2.aarnet.net.au
}

beacon_stop() {
cd ${BEACON_HOME} && kill -HUP `cat multicastbeacon.PID`
cd ${GRANGENET_HOME} && kill -HUP `cat multicastbeacon.PID`
}

beacon_restart() {
beacon_stop
sleep 1
beacon_start
}

case "$1" in
'start')
beacon_start
;;
'stop')
beacon_stop
;;
'restart')
beacon_restart
;;
*)
echo "usage $0 start|stop|restart"
esac

# End of beacon startup script

You will notice that the an instance of beacon will connect to both the "DAST beaconsever" and the "GRANGENET beaconserver".

You could change the --outputdir, --group and --centralservername variable to which ever server you wish to connect to.

To ensure you can execute the newly created shell scripts, execute the following command:

chmod a+x beacon.sh

Special thanks to Chris Willing (UQ) who orginally supplied the script file.

Conclusion

Special thanks to Douglas Kosovic (UQ) and Greg Wickham (Ex Aarnet) who helped to create the init.d scripts and adding the beacon software to the Access Grid repository.

This ends this installation guide to beacon v1.3. For more information on beacon software, please visit this website http://beacon.dast.nlanr.net/.

login or register to post comments