Background documentationarchive_stage Locate this document in the navigation structure

 

To increase your data security, you make one or several copies of the backup files of log backups using backup tools. The system then checks whether the copying was successful.

You can use the options to control whether the copied files should be compared with the original files for security reasons, and whether the original files should be deleted after copying.

Log backups that are created using the automatic log backup function can only be written to files. For archiving, you can use operating system commands to copy the backup files onto other data carriers.

The DBM command archive_stage, on the other hand, enables you to transfer the content of the backup files into pipes, so that they can be read and archived using the backup tools of other providers. The data read from the pipes can then be archived using backup tools, either a single time, or for security reasons, multiple times. These backup tools can also be from different providers. The process also ensures that all the copies of the backup files created in this way are identical, even if the active automatic log backup has meanwhile written more new backup files.

If you want to archive the same backup files multiple times on different data carriers, you call the Database Manager CLI in session mode. You first use the archive_stage command described here plus the KEEP option, entering a data carrier (1) onto which you want to copy the backup files. You then execute the DBM command archive_stage_repeat, entering an additional data carrier (2). Thus the same group of backup files is copied again.

All copies of the backup files are assigned their own external backup IDs and are entered in the backup history.

After you execute the DBM command, the system displays information about the archived backup files.

Prerequisites

  • You have the server authorization Backup.

  • You have backed up the log area in files.

    The backup template for the data carrier is defined for backup type LOG (see medium_put).

Structure

archive_stage <ext_backup_medium> <log_medium> [NOVERIFY] [KEEP] [FNL <list>]

Options

Option

Description

<ext_backup_medium>

Name of the backup template

<log_medium>

Name of the backup template with which the log backup was created

NOVERIFY

The system only performs the standard checks to determine whether the backup was successful. The system displays error messages where appropriate and the output of the backup tools.

If you do not specify this option, then the system additionally compares the content of the archived files with the content of the original files (system default).

KEEP

The original files are archived but are not deleted afterwards.

If you do not specify this option, then the original files are deleted after they have been successfully archived on the data carrier (system default).

FNL

File Number List: keyword for list of files to be archived

Only specify this keyword and the file number list if backup files that you are sure were created are not in the backup history due to an error. This would be the case, for example, if the backup files with the number 10 and 12 are in the backup history, but number 11 is missing.

<list>

File name or area or file names:

You can leave out leading zeros. Separate multiple specifications using commas.

If you do not specify a file list, the system copies all the backup files that exist at the start of the archiving process, that were created using the specified backup template, and that are also in the backup history.

Result

OK

Processed Stage Files <number>

Bytes Processed <number>

Deleted Stage Files <number>

Remaining Stage Files <number>

Values for the Reply Fields

Value

Description

Processed Stage Files

Processed backup files

Bytes Processed

Processed bytes

Deleted Stage Files

Deleted backup files

Remaining Stage Files

Remaining backup files

<number>

Number

Example

Call the Database Manager CLI in session mode, log on as operator OLEG with the password MONDAY, connect to the database instance DEMODB:

>dbmcli -u OLEG,MONDAY -d DEMODB

dbmcli on DEMODB>

Create a single copy of the original backup files 1 and 3-10. They were backed up using the backup template DemoAutoLog and should now be backed up again for archiving purposes using the backup template EXTDATACARRIER_1. The original backup files should not be deleted afterwards:

dbmcli on DEMODB>archive_stage EXTDATACARRIER_1 DemoAutoLog NOVERIFY KEEP FNL 1,3-10

OK

Processed Stage Files 9

Bytes Processed 12845056

Deleted Stage Files 0

Remaining Stage Files 2

More Information

Database Administration, Archiving Backup Files