Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ glbd — Apollo

Media Vault

Software Library

Restoration Projects

Artifacts Sought



DESCRIPTION
     The Global Location Broker Daemon (glbd), part of the Network Computing
     System (NCS), manages the Global Location Broker (GLB) database.  The GLB
     database stores the locations of NCS-based server programs on a network
     or internet.

     The GLB can be replicated for greater availability of its database.
     Copies of the database can exist on several nodes, with the brokers
     maintaining consistency of the replicated database.  (In an internet, at
     least one glbd must run in each network.) The drm_admin tool administers
     the replication of the GLB database.

     Access to the GLB database by clients is supported on both the DARPA IP
     and the Domain DDS network protocols.  However, GLBs use only the DDS
     protocols to maintain replication of the database.  Thus, on an internet,
     all routing nodes must support DDS.

     A Local Location Broker Daemon (llbd) must be running on the local node
     when glbd is started.  Typically, both brokers are started at boot time
     from the /etc/rc file.

     If glbd is to communicate via IP protocols, a TCP daemon (tcpd) must also
     be running on the local node.  tcpd should be started before llbd.

     See Managing the NCS Location Broker for more information.

     Diagnostic output from glbd is written to the file
     `node_data/system_logs/glb_log.

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 must be used with the -create option. Use it to
               create the first replica (i.e., the very first instance) of the
               GLB on your network or internet.

     -from host_name
               This option must be used 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.  The only currently
               supported family is dds; a host in this family is specified by
               its entry directory or its network address.  For example,
               dds://jeeves and dds:#1234.abcd are acceptable host names.

EXAMPLES
     Initialize and start the first replica of the GLB on this network or
     internet:

     $ /etc/server /etc/ncs/glbd -create -first &


     Start a subsequent replica of the GLB, initializing its database from
     host //jeeves:

     $ /etc/server /etc/ncs/glbd -create -from dds://jeeves &


     Restart an existing replica of the GLB:

     $ /etc/server /etc/ncs/glbd &


     Restart an existing replica of the GLB on remote host //bertie:

     $ crp -on //bertie /etc/server //bertie/etc/ncs/glbd &


SEE ALSO
     drm_admin, lb_admin, llbd,
      Managing the NCS Location Broker.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026