You configure the MaxDB software with the aim of connecting the MaxDB database tools for backing up, restoring, unloading, or loading data to an external backup tool.
You use the configuration file for Backint for MaxDB to inform the Database Manager where the Backint for MaxDB program is located, and how to communicate with it.
If you want to use an external backup tool with a Backint for Oracle interface for a MaxDB database system, you first have to configure the connection between the MaxDB and the Backint for Oracle program (see Configuring the Backint for Oracle Connection). Creating the configuration file for the Backint for MaxDB is one of the required steps for this configuration.
(See also: How the MaxDB Adapter Program Works.)
If you want to use an external backup tool with a Backint for MaxDB interface for a MaxDB database system, you have to create a configuration file. For the most part, this corresponds to the configuration file in case 1. The differences are explained in the following description.
It is assumed that the Backint for MaxDB interface of the third-party vendor meets the Backint for MaxDB specification (see also the documentation Backint for MaxDB).
On every line in the configuration file you specify a parameter of the Database Manager. 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 Backint for MaxDB to the Database Manager:
Parameter |
Syntax |
Description |
Absolute path and name of the Backint program |
BACKINT <absolute_path>/<file_name> |
Case
1: Connecting to a Backint for Oracle interface by using a MaxDB adapter
program Case
2: Connecting to the Backint for MaxDB interface of an external backup tool
(third-party vendor) |
Absolute path and name of the standard input file |
INPUT <absolute_path>/<file_name> |
The Database Manager creates these files temporarily and uses them for standard input, output, and error output for Backint for MaxDB. |
Absolute path and name of the standard output file |
OUTPUT <absolute_path>/<file_name> |
|
Absolute path and name of the standard error output file |
ERROROUTPUT <absolute_path>/<file_name> |
|
Absolute path and name of the configuration file of the Backint for MaxDB program |
PARAMETERFILE <absolute_path>/<file_name> |
Case
1: Connecting to a Backint for Oracle interface by using a MaxDB adapter
program Case
2: Connecting to the Backint for MaxDB interface of an external backup tool
(third-party vendor) |
Time in seconds, Time after which the backup tool exits, after the database kernel has copied all data successfully |
TIMEOUT_SUCCESS <number> |
Default value: 300 Case 1 - Connecting to a Backint for Oracle interface by using a MaxDB adapter program: Make sure that you allow enough time so that the backup tool can save all copied data to a tape. The number of temporary files and their configured sizes are the most important factors here. Case 2 - Connecting to the Backint for MaxDB interface of an external backup tool (third-party vendor): Period of time after which the Database Manager terminates the backup tool, if all data has been copied to the pipes. Note that the backup tool always exits after this defined period, whether all data copied from the database kernel has been backed up by the backup tool or not. |
Time in seconds, Time after which the backup tool exits, if the database kernel has stopped the backup due to an error. |
TIMEOUT_FAILURE <number> |
Default value: 300 Make sure that you allow enough time so that the backup tool can save all data copied by the database kernel. This is because the backup tool always exits when this timeout is reached, even if not all of the copied data has been saved yet. On the other hand, do not specify too much time. Otherwise, you risk a situation where a backup stopped by the database kernel blocks other backups (such as automatic backups at night) from being started. |
Absolute path of the run directory of the source database |
ORIGINAL_RUNDIRECTORY <absolute_path> |
Default value: Run directory of the current database instance Specify this parameter only for a migration. Pay attention to upper- and lowercase spelling when you specify this value. |
See also:
Example of a Configuration File for Backint for MaxDB