Entering content frame

 Creating the Configuration File for NetWorker 

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.

Procedure

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.

Syntax

<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 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 and RECOVER are started with the
-v option.

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
The output of SAVE is checked for error messages.

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
Backups are identified by their backup time.
This is the recommended value since no particular authorization is required for the operating system user by the NetWorker program RECOVER.

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.
NO: Default value
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)

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/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

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
The size specification is used unchanged.

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.
Note that backups that are not within the time span specified by the character string are regarded by MaxDB as no longer available for a restore.

See also:

Example of a Configuration File

 

Leaving content frame