You configure the SAP DB software with the aim of connecting the SAP DB database tools for saving, restoring, unloading, or loading data to the external backup tool NetWorker.
On every line in the configuration file you determine a parameter of the SAP DB adapter program. When you do this, at the beginning of each line you have to specify the keyword for the parameter and then the relevant value(s). Lines that do not begin with keywords are ignored by the system.
<key_string> <value_string>
<key_string> |
Keyword for a parameter; can consist of one or more words |
<value_string> |
Value(s) of the parameter |
You can define the following parameters for connecting NetWorker to the DBM server program:
Parameter |
Syntax |
Description |
Absolute path of the directory where NetWorker is installed |
NSR_HOME <absolute_path> |
The NetWorker programs SAVE, MMINFO, and RECOVER are in this directory. |
Name of the NetWorker server |
NSR_HOST <name> |
|
Name of the NetWorker tape pool |
NSR_POOL <name> |
If you specify a name, it overwrites the default value for the tape pool that was configured in NetWorker. |
Expiration date or period of the backup |
NSR_EXPIRE <value> |
This value is transferred to the NetWorker program SAVE and overwrites the default value for the date or period that was configured in NetWorker. See the NetWorker documentation for the allowed entries. |
Specifies which of the NetWorker programs SAVE and RECOVER is started with the -v option |
NSR_NOTVERBOSE <NONE | SAVE | RECOVER | "SAVE AND RECOVER"> |
This value is required in case the NetWorker programs do not support the –v option.
NONE: Default value SAVE: SAVE is started without and RECOVER is started with the -v option. RECOVER: SAVE is started with and RECOVER is started without the -v option. "SAVE AND RECOVER": SAVE and RECOVER are started without the -v option. |
Specifies whether the output of the NetWorker program SAVE is analyzed when backups take place |
NSR_USEOUTPUT <SAVE | NONE> |
SAVE: Default value NONE: The output of SAVE is not checked for error messages. Only the return code of SAVE is used. Since SAVE can return the value 0 even if errors occur, do not use NONE. |
Error messages of the NetWorker program SAVE that can be ignored |
NSR_IGNOREERROR <error_text> |
All error messages of the form <pipe_name>:<error_text> are ignored. Repeat this parameter definition for each error message that can be ignored. |
Specifies whether the Database Manager uses (for recoveries) the backup times or the NetWorker save set identifiers |
NSR_EBIDTYPE <NSAVETIME | SSID> |
NSAVETIME: Default
value SSID: Backups are identified using the NetWorker Save Set Identifier. |
Waiting time (in seconds) between two SAVE calls during parallel backups |
NSR_SAVEINTERVAL <time> |
Default value: 60 |
Name under which you want to save the backup in NetWorker |
NSR_BACKUPNAME <name> |
Default value: Name of the database instance Any string of characters, which can contain the placeholders <database_name> and <server_node>. When backing up or restoring with NetWorker, the placeholders are replaced with the name of the database instance or the database server. |
Avoiding a NetWorker software error |
NSR_AVOIDPSSIDBUG <YES | NO> |
A software error
in the MMINFO program when using the option
-q pssid=0 (PSSIDBUG) is
known as of NetWorker 6.0. You can avoid this error by setting this
parameter. |
Date format for analyzing the output of the NetWorker program MMINFO |
NSR_SAVETIMEFORMAT <mm/dd/yy HH:MM:SS AM | mm/dd/yyyy HH:MM:SS AM> |
Required if current default value does not correspond to NetWorker output. Only one of the possible values can be configured. mm/dd/yy HH:MM:SS AM: For date output from NetWorker that is more than 8 characters long mm/dd/yyyy HH:MM:SS AM: For date output from NetWorker that is more than 10 characters long yy/yyyy year, mm month, dd day, HH hour, MM minute, SS second, AM a.m. or p.m. |
Specifies how the size specification for backups transferred with the NetWorker SAVE program is to be used. |
NSR_SIZEROUNDUP <NOROUNDUP | FIRSTDECIMAL | NORMAL | LASTINTEGER> |
Required if the size that was transferred by SAVE for the backup is rounded off. This parameter can be used for the following SAP DB versions as of the specified build numbers only: 7.2.05 from build 017, 7.3.00 from build 021, 7.4.03 from build 000. NOROUNDUP: Default value FIRSTDECIMAL: The size specification is increased by 0.1 (For example: Backup size 14 GB is used with 14.1 GB). NORMAL: The size specification is increased by 0.5. LASTINTEGER: The size specification is increased by 1. |
Character string that is used as the value for the MMINFO option –t |
NSR_AVOIDTIMEDEBUG <value> |
Required if MMINFO from NetWorker does not work without option –t This parameter can be used for the following SAP DB versions as of the specified build numbers only: 7.2.05 from build 018, 7.3.00 from build 022, 7.4.02 from build 004, 7.4.03 from build 000. The character
string must match the format expected by MMINFO. If the character string
consists of multiple words, you have to set them in quotation marks. |
See also:
Example of a Configuration File