The file lsregistrationdaemon.conf is used to define what gets registered into the lookup service. The file allows a degree of flexibility in what is manually defined versus what is automatically discovered. In most cases, the defaults of this file will be suitable and you should not need to make any changes. Some situations where you might want to edit this file though are (this is not an exhaustive list):
- You have a private lookup service and would like to only register to that service. See ls_instance Directive
- You have a host with multiple network interfaces and would like to choose the interface on which a particular service or set of services run
- You are not running a Toolkit (and thus don’t have the web UI) and would like to set location information, community tags or other values
- You wish to override the auto-discovered defaults for one reason or another (e.g. maybe they are not correct or you would like to provide more detail)
The basic structure of the file is as follows:
- A collection of top-level directives to control things like lookup service communication and how the daemon process runs
- A list of site directives that group together elements with a common set of parameters
- A list of host directives within those sites that represent the host to be registered. If the host in question is the host on which the LS Registration Daemon is running, than many of the values can be auto-discovered.
- A list of service directives within those hosts that represent the services to be registered.
The lsregistrationdaemon.conf has the feature that almost any directive can be defined at a higher level in the configuration hierarchy and be inherited by all the descendents. For example, one can define the latitude and longitude directives at the top-level of the file. All registered hosts and services will in turn inherit these properties. In contrast, you can define them directly in each host directive if you want each individual host to have different values. You can even define both and have the more specific values in the host directive override the ones defined at a higher level in the hierarchy.
With these items in mind the remainder of this section contains a full reference of the options available in the lsregistrationdaemon.conf file.