Concepts Guide
Man Pages for Lbmrd

Help for the lbmrd command line can be obtained by entering "lbmrd -h". Brief help for the lbmrd configuration file can be obtained by entering "lbmrd -d", which prints the DTD contents.

For more information on UDP-based TR, see UDP-Based Topic Resolution Details. For more information on Topic Resolution general, see Topic Resolution Description.

There are two executables for the lbmrd, each with it's own man page:


Lbmrd Man Page  <-

The lbmrd executable can be run interactively from a command prompt or from a script/batch file. For use as a Windows Service, see Lbmrds Man Page.

UMResolver daemon
Usage: lbmrd [options] [config-file]
Available options:
-a, --activity=IVL interval between client activity checks (in milliseconds)(default 60000)
-d, --dump-dtd dump the configuration DTD to stdout and exit
-h, --help display this help and exit
-i, --interface=ADDR listen for unicast topic resolution messages on interface ADDR
ADDR accepts CIDR eg:10.0.0.0/8, Quoted device name eg:"eth0", DNS Host name eg:host.mydomain.com/24.
-L, --logfile=FILE use FILE as the log file
-p, --port=PORT use UDP port PORT for topic resolution messages (default 15380)
-t, --ttl=TTL use client time-to-live of TTL seconds (default 60)
-r, --rcv-buf=SIZE set the receive buffer to SIZE bytes.
-s, --snd-buf=SIZE set the send buffer to SIZE bytes.
-v, --validate validate config-file then exit
Description
Unicast UDP-based resolver services for UM messaging products are provided by lbmrd.
The -i and -p (or --interface and --port) options identify the network interface IP address and port that lbmrd opens to listen for unicast topic resolution traffic. The defaults are INADDR_ANY and 15380, respectively. See Specifying Interfaces for methods of specifying the interface.
The -a and -t (or --activity and --ttl) options interact to detect and remove "dead" clients, i.e., UMS/UME client applications that are in the lbmrd active client list, but have stopped sending topic resolution queries, advertisements, or keepalives, usually due to early termination or looping. These are described in detail below.
Option -t describes the length of time (in seconds), during which no messages have been received from a given client, that will cause that client to be marked "dead" and removed from the active client list. Ultra Messaging recommends a value at least 5 seconds longer than the longest network outage you wish to tolerate.
Option -a describes a repeating time interval (in milliseconds) after which lbmrd checks for these "dead" clients. Ultra Messaging recommends a value not larger than -t * 1000.
Even clients that send no topic resolution advertisements or queries will still send keepalive messages to lbmrd every 5 seconds. This value is hard-coded and not configurable.
The -s option sets the send socket buffer size in bytes.
The -r option sets the receive socket buffer size in bytes.
The output is written to a log file if either -L or --logfile is supplied.
The DTD used to validate a configuration file will be dumped to standard output with the -d or --dump-dtd option. After dumping the DTD, lbmrd exits immediately.
config-file is the XML configuration file. It will be validated against the DTD if either the -v or --validate options are given. After attempting validation, lbmrd exits immediately. The exit status will be 0 for a configuration file validated by the DTD and non-zero otherwise.
Command line help is available with -h or --help.
Exit Status
The exit status from lbmrd is 0 for success and some non-zero value for failure.


Lbmrds Man Page  <-

The lbmrds executable is for use as a Windows Service. The service can be installed as a service by the Windows package installer.

Alternatively, the lbmrds executable can be run interactively from a command prompt to install the service or to change certain configuration elements. See UM Daemons as Windows Services for more details.

UMResolver service
Usage: lbmrds [options] [config-file]
Available options:
-h, --help display this help and exit
-S, --service=install install the service passing configfile
-S, --service=remove delete/remove the service
-S, --service=config update configfile info to use configfile passed
-e, --event-log-level Update/set service logging level. This is the minimum logging
level to send to the Windows event log. Valid values are:
NONE - Send no events
INFO
WARN - default
ERROR
configfile XML config file (if not present, looks in registry)
Description
Unicast UDP-based resolver services for UM messaging products are provided by lbmrd.
The config-file parameter is used interactively to configure the lbmrds's XML configuration file.
The -S is used interactively to control the installation of the Windows service. The -e is used interactively to configure the logging threshold for writing to the Windows Event Log. See UM Daemons as Windows Services for more details.
The -h option prints the above usage page. After printing, the SRS exits.
Exit Status
The exit status from lbmrd is 0 for success and some non-zero value for failure.