nws_ctrl(1)
NAME
nws_ctrl - controls Network Weather Service processes
SYNOPSIS
nws_ctrl [-t seconds][-P password][-f file][-V][-v #][-N host] command host [command-options]
DESCRIPTION
This manual page explains the nws_ctrl program. With nws_ctrl you can
control NWS processes, for example stopping it, or instructing a sensor
to register with a different nameserver, or modifying the clique structure.
The host after the command is the recipient of the message, everything
else after that is options for the specific command.
Here is a list of commands you can specify
- register
- direct the NWS process to register with a new NWS nameserver. The new NWS nameserver is the only command option (has to be present).
- memory
- direct the NWS process to use a new NWS memory to store experiments. The new NWS memory is the only command option (has to be present).
- halt
- directs the NWS process to exit.
- stop
- stop an activity. The only options allowed (a part from the host) is the activity name to stop. If host is a nameserver, query it to find who is responsible for the activity and contact it to stop it.
- start
- start an activity on sensor host. The options here are the usual NWS format <attribute>:<name> and at least name, controlName and skillName have to be present. Others attribute are optional and depends on the particular activity to be started.
- log
- directs the NWS process to suppress or resume error message output. It accepts 1 options that can be error or log that specifies wich diagnostics needs to be toggle. No options meas all diagnostics will be toggle.
- add
- asks a remote sensor to add a new host to a running clique: the clique needs to be already running. The first options is the clique name and the second options is the host to add.
- remove
- asks a remote sensor to remove a new host to a running clique: the clique needs to be already running. The first options is the clique name and the second options is the host to remove.
- fetch
- asks a nws proxy (host) to start autofetching (monitoring) the specific resource (the first option) for all the hosts (all the other options are the hosts).
- fetchClique
- asks a nws proxy (host) to start autofetching (monitoring) for all the hosts belonging to clique (where clique is the first and only option).
- clean
- asks a memory (host) to remove series that have been not update for the past idle seconds. The second parameter is the idle time and the reminders are the series lists.
OPTIONS
- -t timeout
- wait to connect to host for only timeout. seconds
- -f file
- after reading the command line, read file for options.
- -N host
- use host as nws_nameserver(1) to query. Multiple nameserver might be specified (using multiple -N option).
- -V
- print the version number.
- -v level
- specifies the verbosity while issuing NWS commands. level can be up to 5.
EXAMPLES
- To instruct a sensor (A) to register with a different nameserver (B)
- nws_ctrl register A B
- To instruct a sensor (A) to add a sensor (B) to an already running clique named C
- nws_ctrl add A B C
BUGS
Bugs list is at http://nws.cs.ucsb.edu. <http://nws.cs.ucsb.edu>
AUTHOR
NWS is an original idea of Rich Wolski Rich Wolski (rich@cs.ucsb.edu).
Graziano Obertelli (graziano@cs.ucsb.edu) currently maintains NWS and
wrote this man page.