NWINSTCREATE(8)NWINSTCREATE(8)NAME
nwinstcreate - Create a file containing NetWorker instance information
SYNOPSIS
nwinstcreate [ -i ] [ -x ] [ -f output-file ] [ -n NetWorker-instance-
name ] [ -d NetWorker-instance-ID ] [ -p private-key-file
[ -c certificate-file ] ]
DESCRIPTION
The nwinstcreate command is used to create NetWorker instance informa‐
tion. This data is essential for using GSS EMC v1 authentication. In
most cases, the user should let NetWorker create this information. The
nwinstcreate program can be used to override the NetWorker defaults in
the few cases where it is necessary.
The NetWorker instance information includes the NetWorker instance
name, NetWorker instance ID, private key, and certificate. This infor‐
mation will be used on every NetWorker server, client and storage node.
The NetWorker instance ID is the identity of the instance of NetWorker.
The NetWorker instance name is a shorthand for the NetWorker instance
ID and will be what you enter in various access control lists. The
private key and certificate are used to verify the identity of a Net‐
Worker instance.
It is best to run nwinstcreate before starting NetWorker for the first
time. Then if the default output-file name was used, then NetWorker
will pick up the information from the file without any further action
from the user. Otherwise, the user must import the information after
running nwinstcreate (see nsr_la(5) ).
OPTIONS-i Use interactive mode. The user will be asked to provide infor‐
mation for non-expert mode items whose values are not specified
on the command line. The non-expert mode items include: the
NetWorker instance name (which can be specified via the -n
option), and the output file name (which can be specified via
the -f option).
-x Use expert mode. Use with caution. The user will be asked to
provide information on the expert mode items as well as the non-
expert mode items whose values are not specified on the command
line. The expert mode items are: the NetWorker instance ID
(which can be specified via the -d option), the private key file
(which can be specified via the -p option), and the certificate
file (which can be specified via the -c option).
-f output-file
Specify the file in which the NetWorker instance information
should be stored. The default value is the file: IDinitialize
and it will be created in the /nsr/res directory (or the res
directory under the base NetWorker install directory in Win‐
dows). If the default file name is used and the file was cre‐
ated before NetWorker was first started up, then NetWorker will
automatically import in the information from this file and
delete the file.
-n NetWorker-instance-name
Specify the NetWorker instance name that should be used for the
NetWorker installation. This name is a shorthand for the Net‐
Worker instance ID. The NetWorker instance name is the value
that should be entered in access control lists if one wishes to
limit access to users who are using GSS EMC v1 authentication
and are from a certain instance of NetWorker. The NetWorker
instance name should be unique through out the data zone.
-d NetWorker-instance-ID
Specify the NetWorker instance ID that should be used for the
NetWorker installation. This ID will identify the NetWorker
installation. It will be used whenever two NetWorker programs
want to talk to each other. It should be unique through out the
data zone. It is highly recommended to let NetWorker choose
this value unless there is a reason that the default is not
valid.
-p private-key-file
Specify a file containing the private key that will be used by
the NetWorker instance. The file is expected to be in PEM for‐
mat.
-c certificate-file
Specify a file containing the certificate that will be used by
the NetWorker instance. The certificate must correspond to the
private key given with the -p option. That is, the certificate
must contain the public key which corresponds to the private
key. The file is expected to be in PEM format. The -c option
is not allowed if the -p option is not also given.
SEE ALSOnsr_la(5), nsr_service(5).
DIAGNOSTICS
The following exit status values are meaningful:
0 The program exited normally.
1 There was a usage or other error when attempting to create the
output file.
10 There was a problem with the command line arguments.
NetWorker 7.3.2 Aug 23, 06 NWINSTCREATE(8)