GLBD(1M) Domain/OS SysV GLBD(1M)
NAME
glbd - Global Location Broker Daemon
SYNOPSIS
/etc/ncs/glbd [ -create { -first [ -family family_name ] | -from
host_name } ]
[ -change_family family_name ] [ -listen family_list ] [ -version ]
New options in NCS 2.0:
[ -D ] [ -foreground ] [ -background ]
DESCRIPTION
The Global Location Broker Daemon (glbd), part of the Network Computing
System (NCS), helps clients to locate servers on a network or internet.
The glbd maintains and provides access to a global location database that
stores the locations (that is, the network addresses and port numbers)
where server processes are running.
You can run glbd on multiple hosts to replicate the global location
database and increase its availability. (In an internet, at least one
glbd must run in each network.) Each glbd replica keeps a list of all
the other replicas. The drm_admin tool administers the replication of
the global location database and of the replica list.
Currently, glbd supports both the DARPA IP and Domain DDS network
protocols on Domain/OS platforms. On all other platforms, glbd supports
only the DARPA IP protocols. A glbd replica can allow clients to access
its database using the protocols that are supported on the host.
However, when communicating with each other to maintain replication of
the global location database, the replicas should use only one protocol
family. You choose which family the replicas will use. In an internet,
all routing nodes must support this family.
If a set of global location replicas includes any systems other than
Domain/OS, all replicas must use IP protocols to communicate with each
other. A replica running on a Domain/OS system can communicate with
other replicas via IP protocols but still provide lookup and update
services to its clients via both IP and DDS protocols.
Note that glbd contains new options that are available only in NCS 2.0.
OPTIONS
-create Create a replica of the GLB. This option creates a GLB
database in addition to starting a broker process. It must be
used with either -first or -from.
-first This option can be used only with the -create option. Use it to
create the first replica (that is, the very first instance) of
the GLB on your network or internet.
-family family_name
This option can be used only in conjunction with the -first
option. It specifies the address family that the first GLB
replica will use to identify itself on the replica list. Any
subsequently created replicas must use this family to
communicate with this replica. Currently, family_name can be
either dds or ip. If this option is not used, the replica will
be identified on the replica list by its default address
family. The default address family is platform-specific; see
Managing NCS Software or your system Release Document for the
default glbd address family for your system.
-from host_name
This option can be used only with the -create option. Use it to
create additional replicas of the GLB. A replica of the GLB
must exist at host_name. The database and replica list for the
new replica are initialized from those at host_name. The
replica at host_name adds an entry for the new replica to its
replica list and propagates the entry to the other GLB
replicas.
A host_name takes the form family:host, where the host can be
specified either by its name or by its network address. For
example, dds://jeeves, dds:#959a.940f, ip:bertie, and
ip:#192.5.5.5 are acceptable host names.
The new replica will use the same address family as host_name
in identifying itself on the replica list. For example, if
host_name is an IP address, the new replica will be listed by
its IP address on the replica list.
-change_family family_name
Use this option only if network reconfigurations require that
you change the address family of every GLB replica; see the
discussion in the "DESCRIPTION" section. Currently,
family_name can be either dds or ip.
For a procedure to change all of your GLB replicas from one
address family to another, see Managing NCS Software.
-listen family_list
This option restricts the address families on which a GLB
listens. Use it only if you are creating a special
configuration where access to a GLB is restricted to a subset
of hosts in the network or internet.
The family_list is a list of the address families on which the
GLB will listen. Names in this list are separated by spaces.
Possible family names include dds and ip.
The GLB will always listen for requests from the family by
which it is listed on the replica list, even if that family is
not specified in family_list.
If glbd is started without the -listen option, the GLB will
listen on all address families that are supported both by NCS
and by the local host. On Domain/OS systems, this set of
families always includes dds and may also include ip. On most
other systems, ip is currently the only family.
-version Display the version of NCK that this glbd belongs to, but do
not start the daemon.
NEW OPTIONS IN NCS 2.0
-D This option causes glbd to run in the foreground and print
extra debugging information.
-foreground
This option causes glbd to run in the foreground.
-background
This option causes glbd to run in the background. glbd
automatically becomes a background process, unless -D or
-foreground is specified.
EXAMPLES
Managing NCS Software contains commands for starting location daemons on
all supported platforms.
FILES
On Domain/OS systems, glbd writes diagnostic output to the file
`node_data/system_logs/glb_log. On other UNIX systems, the log file is
/etc/ncs/glb_log.
SEE ALSO
drm_admin(1M), lb_admin(1M), llbd(1M), rpcd(1M), glb_obj.txt(4),
glb_site.txt(4)
Managing NCS Software