1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
|
.\"Created by graziano@cs.ucsb.edu
.TH nws_sensor 1 "September 27, 2002" "nws_sensor"
.SH NAME
nws_sensor \- sensor for the Network Weather Service
.SH SYNOPSIS
.B nws_sensor
[-c yes/no][-a addresses][-n name][-N host][-M host][-e file][-l file][-i file][-p port][-v level][-fV][-x port][-m yes/no][-A yes/no][-S yes/no][-P password]
.SH DESCRIPTION
This manual page explains the
.B nws_sensor
program. The
.BR nws_sensor(1)
is part of the Network Weather Service. A
.B nws_sensor
can monitor CPU activity, available memory, network bandwidth and network
latency.
We recommand that the
.B nws_sensor
be registered with a
.B nws_nameserver(1)
and that measurements be recorded by a
.B nws_memory(1)
A
.B nws_sensor
starts measuring CPU activity only when initialized. The network bandwidth
and latentcy measurements apply to a
.B clique
, which is composed of multiple
.B nws_sensors.
See
.B start_activity(1)
for details on how to configure a clique.
Available memory measurements are initiated by
.B start_activity(1)
as well.
.SH OPTIONS
.BI -c\ yes/no
.RS
Specifies whether or not the sensor should immediately begin monitoring
CPU availability for nice 0 processes (the cpuMonitor skill). Default is
yes.
.RE
.BI -A\ yes/no
.RS
Starts the availability monitor right away. Default is no.
.RE
.BI -S\ yes/no
.RS
Starts the start monitor right away. Default is no.
.RE
.BI -m\ yes/no
.RS
Specifies whether or not the sensor should immediately begin monitoring
free memory (the memoryMonitor skill). Default is no.
.RE
.BI -j\ cliquename
.RS
Try to join the running clique
.I cliquename
which is registered with our nameserver. The clique leader needs to be
reachable.
.RE
.BI -a\ addresses
.RS
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. These
addresses will be the first one in the private address list of the
sensor.
.RE
.BI -n\ name
.RS
Use
.I name
as hostname. Useful the resolver aren't correctly configured and
gethostname doesn't return a resonable value.
.RE
.BI -f
.RS
Don't fork to run an experiment. If you specify no-forking the sensor may
become less responsive since it may spend sometime doing experiments
instead of responding to messages.
.RE
.BI -x\ port
.RS
Use
.I port
during network experiment when needed. Usually this is needed when the
buffer requested is of a different sizes than the default and a new port
is required to conduct the experiment: if behind a firewall you can
specify this option and instruct the firewall to open
.I port.
.RE
.BI -e\ file
.RS
Save the error messages to
.I file.
.RE
.BI -l\ file
.RS
Save the log messages to
.I file.
.RE
.BI -i\ file
.RS
Write pid to
.I file
.RE
.BI -M\ nws_memory
.RS
Specifies the
.B nws_memory(1)
that the sensor should use to store its
measurements. This overrides any default value from the environment or
~/.nwsrc.
.RE
.BI -N\ nws_nameserver
.RS
Register this nws_sensor with
.I nws_nameserver
.
.RE
.B -V
.RS
Prints the version.
.RE
.BI -P\ password
.RS
User will need
.I password
to control this sensor.
.RE
.BI -p\ port
.RS
Listen to port instead of the default for the nws_sensos (8060).
.RE
.BI -v\ level
.RS
Set the verbosity in case of error. Value of
.I level
can be 0 to 5 where 5 is the more verbose.
.RE
.SH BUGS
If the machine is behind a firewall (with or without NAT), the
.B nws_sensor
may get confused when talking with other part of the NWS.
.P
Bugs list is at
.UR http://nws.cs.ucsb.edu
http://nws.cs.ucsb.edu.
.UE
.SH AUTHOR
NWS is an original idea of Rich Wolski (rich@cs.ucsb.edu) who wrote the
orignal
.B nws_sensor.
.P
Neil Spring, Jim Hayes (jhayes@cs.ucsd.edu) and Martin Swany maintained
and enhanced it.
.P
Graziano Obertelli (graziano@cs.ucsb.edu) currently maintains NWS and
wrote this man page.
.SH SEE ALSO
.BR nws_memory(1),
.BR nws_search(1),
.BR nws_nameserver(1),
.BR nws_extract(1)
|
