NSRADMIN(8)NSRADMIN(8)NAMEnsradmin - NetWorker administrative program
SYNOPSISnsradmin [ -c ] [ -i file ] [ -s server ]
[ -p {prognum | progname} ]
[ -v version ] [ query ]
nsradmin [ -c ] [ -i file ] [ -d resdir ... ] [ -t typefile ] [ query ]
nsradmin [ -c ] [ -i file ] [ -f resfile ... ] [ -t typefile ] [ query
]
DESCRIPTION
The nsradmin command is a command-line based administrative program for
the NetWorker system. Normally nsradmin monitors and modifies Net‐
Worker resources over the network. Commands are entered on standard
input, and output is produced on standard output.
If nsradmin is started without a query argument, it uses a default
query. If the daemon being administered is nsrd, then all resources
will be selected by default; for all other daemons, no resources will
be selected by default.
OPTIONS-c Uses the termcap(5) and curses(3) packages to implement a full-
screen display mode, just like the visual command described
below. (UNIX Only)
-d resdir
Uses the NetWorker resource database resdir instead of opening a
network connection. The database resdir must be in directory
format. This should be used sparingly, and only when the Net‐
Worker server is not running. Multiple -d and resdir arguments
can be used to start nsradmin with access to more than one data‐
base at a time.
-f resfile
Similar to the -d resdir option except that it opens an existing
resource file, rather than a resource directory. Some configu‐
ration databases are stored in file format, others in directory
format.
-i file
Takes input commands from file instead of from standard input.
In this mode, the interactive prompt will not be printed.
-s server
Opens a connection to the named NetWorker server instead of
allowing administration of all servers. Useful to limit the num‐
ber of resources if there are many servers, or to administer
when the RAP location service is not working.
-p {prognum | progname}
Use the given RPC program number or name instead of the default
program number of 390103 - which refers to nsrd. Other suitable
program arguments include, but are not limited to:
NetWorker Remote Execution Daemon:
390113 or nsrexecd
Host Agent Daemon:
390427 or hagentd
-t typefile
Uses the alternate file typefile to define RAP types.
-v version
Binds to the NetWorker RAP service with the given version num‐
ber. The default is 2. This option is generally used only for
debugging.
query If a query is specified (in the form of an attribute list), the
edit operation is performed on the results of the query. See
COMMANDS for more information on how the edit command works.
RESOURCES
Each NetWorker resource is made up of a list of named attributes. Each
attribute can have zero or more values. The attribute names and values
are all represented by printable strings. Upper and lower case is not
distinguished on comparisons, and spaces are ignored except inside the
names and values.
The format for specifying attributes and attribute lists is:
attribute ::= name [ : value [ , value ]* ]
An attribute is a name optionally followed by a colon, followed
by zero or more values, with values separated by commas. A
comma at the end of a line continues the line.
attribute list ::= attribute [ ; attribute ]*
An attribute list is one or more attributes separated by semi‐
colons. A semicolon at the end of a line continues the line.
The list is ended by a newline that is not preceded by a comma
or semi-colon.
Here is an example of an attribute list:
name: mars;
type: NSR client;
remote access: mars, venus, jupiter;
For more information on attributes, attribute lists and the NetWorker
resource types, see the resource(5), and nsr_resource(5), manual pages.
COMMANDS
At each input prompt, nsradmin expects a command name and some optional
arguments. Command names can be shortened to the smallest unique string
(for example, p for print). Command arguments are always specified in
the form of an attribute list. Most commands operate on a set of
resources returned by a query. The query is specified as an attribute
list which is used to match resources with the following rules:
1) The resource must match all the given attributes.
2) If more than one value is specified the resource can match
any one of the values.
3) If an attribute is specified with no value the resource must
contain an attribute of that name.
Thus, a query:
type:NSR device;
name:mars, venus;
test
will match all resources that have a type attribute with the value NSR
device and a name attribute with a value of either mars or venus, and
an attribute test with any value.
If the query has only one name and no values (for example, if there is
no semi-colon or colon in it), then the program tries to guess a more
reasonable query. If the name is a host name, then the query will
select all the resources on the given host. Otherwise, the name will
be interpreted as a type name, and all resources of that given type
will be selected.
bind [query]
Bind to the service that owns the resource described by query.
If no query is specified, queries are sent to the RAP Resource
Directory, and update, create, and delete commands to the ser‐
vice that owns the resource being changed. On failure, the pre‐
vious service will continue to be used.
create attribute list
Create a resource with the given attributes. One of the
attributes must be type to specify a NetWorker type that can be
created. The types command can be used to find out which Net‐
Worker types a server supports. Note that the RAP types are
case sensitive and must be used exactly as shown by the types
command. For example, NSR group is a valid type, whereas nsr
group is not.
delete [query]
Delete the resources that match the current query. If a query
is specified, it becomes the current query.
edit [query]
Edit the resources that match the current query. If a query is
specified, it becomes the current query. If the environment
variable EDITOR is set, then that editor will be invoked, other‐
wise vi(1) will be started. When the editor exits, nsradmin
applies update, delete and create operations based on the
changes to the resources. Be careful to not edit the resource
identifier attribute, and to write the file out before exiting
the editor. (UNIX Only)
help [command]
Print a message describing a command. If no command name is
given a synopsis of all of the commands is printed.
option [list]
This command enables some options to change the display of
resources. With no arguments it displays the current options;
with a list of options it turns the specified ones on. The
options are: Dynamic displays all dynamic attributes, even the
normally hidden ones. Hidden displays all attributes, even the
normally hidden ones. Resource ID displays the resource identi‐
fier on each resource, a number that is used internally to pro‐
vide sequencing and uniqueness.
print [query]
Print the resources that match the current query. If a query is
specified, it becomes the current query. If a name has been
specified for the the current show list, only the attributes for
the specified name in the show list will be displayed.
quit
Exits nsradmin.
server [servername]
Bind to the given NetWorker server name. If no server is speci‐
fied, the RAP location service will be used. On failure, the
previous server will continue to be used.
show [name; ...]
If a name list (really an attribute list with no values) is
specified, add those names to the show list. Only these
attributes will be displayed in subsequent print commands. If
no name list is given the show list is cleared, resulting in all
attributes being shown.
types Print a list of all known types.
unset [list]
This command turns off the specified option.
update attributes
Update the resources given by the current query to match
attributes.
visual [query]
Enter a full-screen mode using the curses(3) package to step
through commands in a perhaps more user-friendly manner than the
command line interface. You can get this mode directly using
the -c command line argument. (UNIX Only)
. [query]
If a query is specified, this command will set the current query
without printing the results of the query. Otherwise, it will
display the current query, show list, server binding, and
options.
? [command]
Same as the help command above.
EXAMPLES
print type:NSR device
Print all resources of type NSR device and make this the current
query.
show type; name
Set the show list to display only the attributes type and name.
delete
Delete all resources that match the current query.
delete type:NSR device; hostname: mars
Delete the resource with attributes: type: NSR device and hostname:
mars.
edit type:NSR notification
Edit all resources of type NSR notification.
SEE ALSOed(1), vi(1), curses(3), nsr_resource(5), termcap(5), nsr(8).
NOTES
If the backslash ("\") character is contained in a value that is
entered for an attribute value when you create or update a RAP
resource, it is treated as a marker that indicates that it may be com‐
bined with the following character to produce a special character.
(This is similar behavior to that seen in various UNIX shells.)
If you wish your attribute value to contain an actual backslash charac‐
ter, then you should enter two backslashes in succession - e.g.
C:\\dir_one\\dir_two
DIAGNOSTICS
The following exit status values are meaningful:
0 Interactive mode exited normally.
1 There was a usage or other non-query related error.
2 When reading input from a file (-i file), one or more RAP opera‐
tions failed. This status is never returned interactively.
NetWorker 7.3.2 Aug 23, 06 NSRADMIN(8)
