You configure the MaxDB software with the aim of connecting the MaxDB database tools for backing up, restoring, unloading, or loading data to the external backup tool NetWorker.
You determine a parameter of the Database Manager in every line in the configuration file. 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> |
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 and the Database Manager:
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 overrides the default value for the expiry date or expiry 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 <option> <option> ::= 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 <option> <option> ::= 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 <option> <option> ::= 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: 10 |
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 that can contain the placeholders <database_name> and/or <node>. When backing up or restoring with NetWorker, the placeholders are replaced with the name of the database instance and/or the database computer. |
Avoiding a NetWorker software error |
NSR_AVOIDPSSIDBUG <option> <option> ::= YES | NO |
A
software error in the MMINFO program when using the option -q
pssid=0
(PSSID bug) is known as of NetWorker 6.0. You can avoid this error by setting this
parameter. |
Date format that is used for analyzing the output of the NetWorker program MMINFO |
NSR_SAVETIMEFORMAT <format> <format> ::= mm/dd/yy HH:MM:SS <option> | mm/dd/yyyy HH:MM:SS <option> <option> ::= AM | PM |
Required if current default value does not correspond to NetWorker output. Default values are mm/dd/yyyy HH:MM:SS AM: For date output from NetWorker that is more than 10 characters long You can configure only one format. This can be a format that differs from the default values as long as the specified syntax elements are used. yy|yyyy year, mm month, dd day, HH hour, MM minute, SS second, AM | PM a.m. or p.m. |
Specifies how the size specification for backups transferred with the NetWorker SAVE program is to be used. |
NSR_SIZEROUNDUP <option> <option> ::= 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 database 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_AVOIDTIMEBUG <value> |
Required if MMINFO from NetWorker does not work without option –t This parameter can be used for the following database 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