This manual page explains the
nws_nameserver
program. Other NWS hosts (
nws_sensor(1),nws_memory(1)
) register their locations and attributes with a
nws_nameserver.
We recommend that NWS users run their own
nws_nameserver.
NWS registrations follow the LDAP model. Each registered object consists
of a set of attributes that are described by name-value pairs. Every
object has a
name
attribute that identifies the object (this attribute should be unique)
and an
objectclass
attribute that specifies what sort of item the object represents.
Here are some of the attributes you can find (see
nws_search(1)
on how to query a
nws_namserver.
Typically objects have some of the following attributes (in addition to
name and objectclass):
timestamp
is the expiration time of the object: it won't show up past this time,
unless the object is re-registered.
host
machine which hosts the daemons in name:port format
memory
nws_memory which holds the measurements related to this object
hostType
kind of NWS process (for example nws_nameserver, nws_memory or sensor)
ipAddress
list of IP addresses associated with this host that are available to NWS
owner
login of the person who started this NWS host
port
port which the host is listening to
OPTIONS
-a addresses
Specified a comma separated list of addresses (IPs or name) that the
sensor will consider be aliases for the localhost. Used for multihomed
machine when DNS doesn't return all the IPs associated with a name.
-n name
Use
name
as hostname. Useful the resolver aren't correctly configured and
gethostname doesn't return a resonable value.
-e file
Save the error messages to
file.
-l file
Save the log messages to
file.
-i file
Write the pid to
file
-m
Enable mirroring code: if we got a nameserver in our registration we try
to sync with it and keep our registration synchronized. See -N.
-N nameserver
Try to read all the registrations from
nameserver
and add to our pool of registrations. If used with -m try to keep the
nameservers in sync.
-f file
Save the registrations to
file.
Remember that
file
whenever a new version of registration is written. The deafult filename is
registrations.
-p port
Listen to port instead of the default for the nws_nameserver (8090).
BUGS
This man page doesn't explain all the possible options that the
nws_nameserver will obey.
NWS is an original idea of Rich Wolski (rich@cs.ucsb.edu). The
nws_nameserver
is been introduced by Jim Hayes (jhayes@cs.ucsd.edu) and is been almost
entirely rewritten by Graziano Obertelli (graziano@cs.ucsb.edu) who
currently maintains NWS.