dbeacon - Distributed IPv4/IPv6 multicast beacon
dbeacon -a MAIL -b BEACON_ADDR[/
PORT]
[
-i INTFNAME] [
-n NAME] [
-S
[
GROUP_ADDR[/
PORT]] [
-s ADDR] [
-d
[
FILE]] [
-I NUMBER] [
-W type$url] [
-L
program] [
-C CC] [
-4] [
-6]
[
-v] [
-P] [
-U] [
-V] [
-F flag] [
-O] [
-B ADDR]
dbeacon is a network level management tool aiming at getting various
statistics about multicast connectivity. Its first usage is to check out if
you can send/receive toward/from an IPv4/IPv6 multicast network. Its second
usage is to gather various statistics by using a known multicast ASM group,
for example TTL between each multicast peers, loss or jitter figures. Theses
statistics are kept internally but can be dumped periodically in a file in xml
format for latter processing. Statistics gathering is completetly distributed
and rely on the powerful nature of ASM. No server is required, but maybe a
http server for accessing the statistics and build an adjacency matrix of the
peers.
-
-n NAME, -name NAME
- The name identifying you on the dbeacon session. If not
specified, dbeacon will use the hostname of the running machine.
-
-a MAIL
- Administrative contact. This is an e-mail used for join
you, for example to notify you that something is wrong is your multicast
connectivity
-
-i IN, -interface IN
- Use IN instead of the default interface for multicast.
-
-b BEACON_ADDR/PORT
- This is the IPv4/IPv6 address of the ASM group used by
dbeacon to gather statistics. It can be specified as a DNS name too.
-
-S GROUP_ADDR/PORT
- Enables SSM reception/sending on optional
GROUP_ADDR/PORT
- -O
- This option enable SSM data sending in addition to ASM
data. It can be used to check if people can reach you via SSM.
-
-B ADDR
- This allows you to bootstrap from an ADDR that is already
in the matrix. This option is useful when you ASM connectivity is broken
but SSM connectivity works.
-
-P, -ssmping
- Enable SSM Ping server capability.
-
-s ADDR
- Bind to local address. This allow you to specify the
multicast source of the packets sent by your beacon.
-
-d FILE
- Dump periodic reports to dump.xml or specified file. This
file may be latter processed by any XML compliant script. On a http
server, you can process the dump to create a nice adjacency matrix.
-
-I NUMBER, -interval
NUMBER
- Interval between refresh of the dump file. Defaults to 5
secs if not specified
-
-W URL, -website URL
- Specify a website to announce.
-
-Wm URL, -matrix URL
- Specify your matrix URL.
-
-Wl URL, -lg URL
- Specify your looking glass URL.
-
-C CC
- Specify your two letter Country Code.
-
-L program
- Launch program after each dump. The first argument will be
the dump filename.
-
-F flag
- Specify a flag to announce. For example to announce that
your host is running a ssmpingd deamon, use 'ssmping' as a flag.
-
-4, -ipv4
- Force IPv4 usage (Default is IPv6).
-
-6, -ipv6
- Force IPv6 usage
- -v
- verbose mode (use several for more verbosity)
- -U
- Dump periodic bandwidth usage reports to stdout
-
-D, -daemon
- fork to the background (daemonize)
-
-pidfile FILE
- Path to the PID file to write to.
- -syslog
- Outputs using syslog facility.
-
-c FILE
- Specifies the configuration file to use. Each of the above
command-line parameters can be defined there.
-
-V, -version
- Outputs version information and leaves
Should be reported to the core developer Hugo Santos <
[email protected]>.
dbeacon is a joint work of Hugo Santos, Sebastien Chaumontet and Mickael
Hoerdt. It has been done in the early days of the m6bone, when nobody knew if
the SPTs or RPTs were being used between hosts and also to evaluate the
performance and deployment of SSM.