nsrwatch(8)
nsrwatch(8)
NAME
nsrwatch - command for character-based display of NetWorker status
SYNOPSIS
nsrwatch [ -s server ] [ -p polltime ]
DESCRIPTION
The nsrwatch command displays a NetWorker server's status. The
server's name is specified by the optional -s server argument. If no
server is specified, it defaults to the same server that would be used
by a command, such as recover(8) in the current directory. If there is
no NetWorker service on the selected machine, the command issues an
error message. The polling interval is specified by the optional -p
polltime argument (in seconds). The default is two seconds.
Users can run nsrwatch from any terminal that has enough termcap(5)
capabilities for cursor positioning; it does not require any particular
window system. The nsrwatch program gets its information via remote
procedure calls to the specified server. This way it can be used from
any machine that can access the server through the network.
By default the nsrwatch display is divided into a status summary fol-
lowed by five subwindows: the DEVICES window, the GROUPS window, the
SESSIONS window, the MESSAGES window, and the PENDING window. Subwin-
dow sizes are adjusted depending on the size of the terminal or window
being used. A subwindow can be brought into focus by using the Tab key.
Once a subwindow is in focus, its content can be scrolled using the
arrow keys. Visibility of the subwindows can be toggled using the d, g,
s, m and p keys for the DEVICES, GROUPS, SESSIONS, MESSAGES and PENDING
subwindows respectively.
The status summary displays the name of the server, NetWorker version,
the server's start time, approximate response time of the server, and
save and recover session totals.
The DEVICES window displays the devices known to the current server.
For each device, the panel displays its name, the device type, the name
of the mounted volume, or (unmounted) if no volume is mounted, the pool
the volume belongs to and device status. The name may be followed by
(J) if the device is configured as part of a jukebox device. Read-only
devices can be hidden by pressing the r key. The GROUPS window lists
active save groups running on the server. The SESSIONS window provides
current save set information for each active session (saving, recover-
ing, or browsing). The MESSAGES window displays a history of messages
of general interest to the operator. Finally, the PENDING messages
window displays messages that require operator intervention.
Additional subwindows can be toggled using their corresponding key. The
list of available subwindows is as follows:
d or D Toggle DEVICES window.
h or H Toggle HELP window.
m or M Toggle MESSAGES window.
p or P Toggle PENDING messages window.
s or S Toggle SESSIONS window.
t or T Toggle active TUNNEL connections window.
The nsrwatch program runs continuously until quit, stopped, or inter-
rupted (Control-C, for example). Typing the q character quits the pro-
gram, the Control-L forces a screen clear and redraw, while any other
character forces the status to be updated.
The nsrwatch program checks for new devices at a slower rate than the
polling rate, so it might take up to a minute after a new device is
added before the device is noticed. To recognize the devices immedi-
ately, either restart the program or press Control-L. Deleted devices
may cause a 'resource does not exist' message temporarily, but other-
wise they are noticed immediately.
The nsrwatch program adapts to changes in the screen size, if supported
by the underlying environment. For example, if a window terminal emula-
tor is resized, the size of each field may change to match the window.
If the window is too small, all the devices, sessions, and messages,
might not be displayed. For best results, use a window of at least 30
lines.
OPTIONS
-s server
Sets the current NetWorker server to server.
-p polltime
Sets the polling interval to be polltime seconds.
SEE ALSO
termcap(5), nsr_notification(5), nsr_device(5), nsr_service(5),
recover(8), nsradmin(8), nsr(8), nsrd(8).
NetWorker 8.0.1 Dec 02, 12 nsrwatch(8)