nws_nameserver(1)
NAME
nws_nameserver - nameserver for the Network Weather Service
SYNOPSIS
nws_nameserver [-a addresses][-n name][-D][-e file][-l file][-i file][-m][-N nameserver][-f file][-p port]
DESCRIPTION
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.
Bugs list is at http://nws.cs.ucsb.edu. <http://nws.cs.ucsb.edu>
AUTHOR
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.
This man page is been written by Graziano Obertelli
(graziano@cs.ucsb.edu).