nws_ctrl

Langue: en

Version: January 28, 2004 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

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.

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.

SEE ALSO

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