Configuration File (NetWorker) 

To be able to use the external backup tool NetWorker, you must create a configuration file as a step of the Configuration of the NetWorker Connection.

Procedure

You can define a parameter in the format <key_word> <value> in each line of the configuration file.

If you want to avoid a certain parameter being set by the configuration file, you must completely remove the corresponding line with the format <key_word> <value> from the configuration file.

You can use the following keywords to define parameters:

Keyword

Value

NSR_HOME

Absolute path of the directory in which NetWorker is installed. The NetWorker programs SAVE; MMINFO and RECOVER are stored in this directory.

NSR_HOST

Name of the NetWorker server to be used.

NSR_POOL

Name of the NetWorker tape pool to be used
This parameter is optional.
If you use the environment variable
NSR_POOL Setting Environment Variables), the tape pool specified in this environment variable is used and the parameter specified in the configuration file is ignored.

NSR_EXPIRE

Expiry date or expiry period for the backup
This value is transferred to the NetWorker SAVE program. The permissible
<value> entries are described in the NetWorker documentation.
The parameter
NSR_EXPIRE <value> is optional.
If you use the environment variable
NSR_EXPIRE Setting Environment Variables), the date or period specified in this environment variable is used and the parameter specified in the configuration file is ignored.

NSR_FULL

Specifies the assignment of NetWorker levels to complete backups with/without checkpoint.
Note the information in the section
Parameter NSR_FULL <value> about the use of this parameter.
The following
<value> specifications are permissible:
"DATA MIGRATION": Default setting. Complete backups with checkpoints have the level full. Complete backups without checkpoints have the level 3
"DATA RECOVERY": Complete backups without checkpoints have the level full. Complete backups with checkpoints have the level 3
"DATA RECOVERY": All complete backups (with and without checkpoints) have the level full.

NSR_NOTVERBOSE

Specifies whether the NetWorker programs SAVE and RECOVER are started with the -v option.
The following
<value> specifications are permissible:
NONE: Default setting. The NetWorker programs SAVE and RECOVER are started with the -v option.
SAVE: The NetWorker SAVE program is started without the –v option, the NetWorker RECOVER program is started with the -v option.
RECOVER: The NetWorker SAVE program is started with the –v option, the NetWorker RECOVER program is started without the -v option.
"SAVE AND RECOVER": The Networker SAVE and RECOVER programs are started without the -v option.

NSR_USEOUTPUT

Specifies if the output of the NetWorker SAVE program should be analyzed during backups.
The following
<value> specifications are permissible:
SAVE: Default setting. The output of the NetWorker SAVE program is checked for error messages.
NONE: The output of the NetWorker SAVE program is not checked for error messages. Only the return code of SAVE is used. As the SAVE program can return the return code 0 even if an error has occurred, you should not use the parameter NSR_USEOUTPUT NONE.

NSR_IGNOREERROR

Character string <error_text>
All error messages of the NetWorker SAVE program with the format
<pipe_name>:<error_text> are ignored.
You must make an
NSR_IGNOREERROR entry for every error message that is to be ignored.

NSR_EBIDTYPE

Specifies whether restores should be performed with the Database Manager using the backup times as numbers or through the NetWorker Save Set Identifier
The following
<value> specifications are permissible:
NSAVETIME: Default setting. Backups are identified using their backup time. This procedure has the advantage that the Networker RECOVER program does not require any operating system user rights. You should use this procedure.
SSID: Backups are identified using the NetWorker Save Set Identifier. You should not use this procedure. If necessary, contact SAP for more information.

NSR_SAVEINTERVAL

Specifies how many seconds the system should wait between SAVE calls during parallel backups.
Default setting: 60 seconds

NSR_BACKUPNAME

Name under which the backup is to be stored in NetWorker
You can specify a character string of your choice in which the placeholders
<database_name> and/or <server_node> can be used. When backing up/restoring with NetWorker, the placeholders are automatically replaced with the name of the database instance and/or the database host.
Default setting: Database instance name

NSR_AVOIDPSSIDBUG

NO/YES
A software error in the MMINFO program when using the option
-q pssid=0 (PSSIDBUG) is known as of NetWorker 6.0. This error can be avoided if the parameter NSR_AVOIDPSSIDBUG is set appropriately.
NO: Default setting. Calls the NetWorker MMINFO program with the option -q pssid=0
YES: Avoids the software error in the MMINFO program (only NetWorker versions as of 6.0)

NSR_SAVETIMEFORMAT

Specifies a date format that is used for the analysis of the output of the NetWorker MMINFO program.
Default setting:
mm/dd/yy HH:MM:SS AM (for NetWorker date output that is 8 characters long)
and
Default setting:
mm/dd/yyyy HH:MM:SS AM (for NetWorker date output that is 10 characters long)
yy/yyyy years, mm months, dd days, HH hours, MM minutes, SS seconds, AM AM or PM
You can only configure one date format.

NSR_SIZEROUNDUP

Specifies how the size specification for backups transferred with the NetWorker SAVE program is to be used.
NOROUNDUP: Default setting. The size specification transferred by SAVE is used unchanged.
FIRSTDECIMAL: The size specification transferred by SAVE is to be increased by 0.1 (For example: Backup size 14 GB is used with 14.1 GB).
NORMAL: The size specification transferred by SAVE is increased by 0.5.
LASTINTEGER: The size specification transferred by SAVE is increased by 1.
This specification can be used as of the following SAP DB versions: 7.2.05.017, 7.3.00.021, 7.4.03.000

NSR_AVOIDTIMEDEBUG

Specifies a character string that is used as the value for the MMINFO option –t. In this way, you can use MMINFO versions that cannot be used without the –t version.
The character string must match the format expected by MMINFO. If the character string consists of multiple values, place these in quotation marks.
Note that backups that are not within the time span specified by the character string are regarded by SAP DB as no longer available for a restore.
This specification can be used from the following SAP DB versions: 7.2.05.018, 7.3.00.022, 7.4.02.004, 7.4.03.000

See also:

Example configuration file