nws_ctrl - controls Network Weather Service processes

nws_ctrl [-t seconds][-P password][-f file][-V][-v #][-N host] command host [command-options]

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.

-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.

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 list is at http://nws.cs.ucsb.edu.

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.

nws_sensor(1), nws_search(1), nws_nameserver(1), nws_extract(1)