Operational Procedures Template

Operational Procedures Fragment

Metadata

Description

Module Name

Snap Creator 3.x Plug-in for MaxDB

Document Type

Operational Procedures

Date

2012-01-02

Authors

Dietmar Ebert

Fragment Version

Notes

For instructions on using the template, refer to the Modular Architecture Authoring Guidelines.

NOTES REGARDING THE OPERATIONAL PROCEDURES TEMPLATE:

The “Overview” section is mandatory.

The “Guidelines” and “Additional Information” sections are optional.

Test

Test

Snap Creator 3.x Plug-in for MaxDB

Use Case

Procedure

Create a backup of a database

Back up a MaxDB database using the CLI

Back up a MaxDB database using the GUI

Restore a backup of a database

Restore a MaxDB database using the CLI

Restore a MaxDB database using the GUI

Recover a database

Recover a MaxDB database using the CLI

Recover a MaxDB database using the GUI

Clone a database

Clone a MaxDB database using the CLI

Clone a MaxDB database using the GUI

Activate automatic log backup mode

Activate automatic log backup mode using the CLI

Back up MaxDB Database Using the CLI

To back up a MaxDB database by using the Snap Creator CLI, complete the following steps:

1. Make sure the database is online.

1. Back up the database using Snap Creator.

snapcreator --profile [--config ] --action snap --policy --verbose

Where:

is the name of the profile where the configuration file is located.

is the name of the configuration file if the name is different from .conf.

is one of the policies specified in the configuration file.

Back up MaxDB Database Using the GUI

To back up a MaxDB database by using the Snap Creator GUI, complete the following steps:

1. Make sure the database is online.

1. Make sure the Snap Creator Framework GUI is started.

1. Log in to the GUI.

1. In the Backup Profiles pane, expand the profile and mark the configuration. The configuration context is loaded and displayed in the Configuration Context pane.

1. Select the button (Actions menu), and then select Snapshot.

1. Specify additional parameters: policy and user-defined variables. Click Ok.

1. This process starts the backup operation; the output displays in the Console pane.

Restore MaxDB Database Using the CLI

To restore a MaxDB database from a previous backup by using the Snap Creator CLI, complete the following steps:

1. Make sure the database is offline or in admin mode.

1. Restore the database from a previous backup.

snapcreator --profile [--config ] --action restore --policy

Where:

is the name of the profile where the configuration file is located.

is the name of the configuration file if the name is different from the conf.

is one of the policies specified in the configuration file.

1. Go to the procedure to Recover MaxDB Database Using the CLI or Recover MaxDB Database Using the MaxDB GUI.

Restore MaxDB Database Using the GUI

To restore a MaxDB database from a previous backup by using the Snap Creator GUI, complete the following steps:

1. Make sure the database is online.

1. Make sure the Snap Creator Framework GUI is started.

1. Log in to the GUI.

1. In the Backup Profiles pane, expand the profile and mark the configuration. The configuration context is loaded and displayed in the Configuration Context pane.

1. Press the Actions button and select Restore.

1. The Snap Creator Framework Wizard is launched. Click Next.

1. Provide details for the restore operation. Select controller, volume name, policy, restore Snapshot name, and restore type from the drop-down lists. The example shows the Restore Details page with Volume Restore being selected. Click Next.

1. Review the information presented in the Summary page and verify that it is correct. Click Finish to initiate the restore operation.

1. On the Volume Restore pane, click Yes to accept the warning regarding the potential data loss.

1. After a short time, a progress bar displays indicating the progress of the selected restore operation. When the restore operation finishes, the following message displays. Click Ok.

1. Repeat the restore operation for each volume or file that is part of the backup and that is needed for the subsequent recovery procedure.

1. Go to the procedure to Recover MaxDB Database Using the CLI or Recover MaxDB Database Using the MaxDB GUI.

Recover MaxDB Database Using the CLI

To recover a MaxDB database by using the Snap Creator CLI, complete the following steps:

1. Make sure all of the archive logs are in place if the database is configured to create archive logs and to perform a point-in-time recovery.

1. Place the database in admin mode.

dbmcli -d -u , db_admin

Where:

is the name/identifier of the MaxDB database.

is the user name of the MaxDB database manager.

is the password of the MaxDB database manager user.

1. Verify whether the database is restartable.

dbmcli –d -u , db_restartinfo

This command returns recovery meta information.

OK

Used LOG Page 1284693

First LOG Page 0

Restartable 1

Id Restart Record amdlinux2:PAX_20080118_121057

Id LOG Info amdlinux2:PAX_20080118_121057

Consistent 1

Log Volume Enabled 1

Log Auto Overwrite 0

Master Servernode AMDLINUX2

Converter Version 27349

Oldest Compatible Version 7.8.01.16

Queue Count 2

Repository Imports NO

The Restartable field indicates whether the database is restartable (1) or not restartable (0). The Consistent field indicates whether the database is consistent (1) or inconsistent (1). When these fields are used in combination, the database can immediately restart in online mode; otherwise, an archive log backup restore must first be performed.

1. If the database is restartable and consistent (both values are set to 1), the database can be restarted using the following command.

dbmcli –d -u , db_restart

For additional options using this command, refer to the MaxDB documentation.

1. If the database is not restartable and is inconsistent (both values are set to 0), perform an archive log restore. Depending on the MaxDB version, use either autorecover, or, if not available, use recover_start in combination with recover_replace to loop through the archived logs. Both methodologies recover the database to a specific point in time, as well as to the latest point in time.

1. When the recovery is finished, the database is returned to online mode.

Recover MaxDB Database Using the MaxDB GUI

To recover a MaxDB database by using the Snap Creator GUI, complete the following step:

1. Depending on the MaxDB version, use MaxDB Database Manager GUI or MaxDB Database Studio to perform a database recovery.

For more information about the preferred GUI, refer to the MaxDB documentation.

Clone MaxDB Database Using the CLI

To clone a MaxDB database by using the Snap Creator CLI, complete the following steps:

1. Make sure the following are properly configured:

The source database is online.

The configuration parameter SC_CLONE_TARGET is set.

The Snap Creator agent specified in SC_CLONE_TARGET is running.

1. Clone the database using Snap Creator.

snapcreator --profile [--config ] --action clone_vol --policy --verbose

Where:

is the name of the profile where the configuration file is located.

is the name of the configuration file if the name is different from .conf.

is one of the policies specified in the configuration file.

Clone MaxDB Database Using the GUI

To clone a MaxDB database by using the Snap Creator GUI, complete the following steps:

1. Make sure the source database is online.

1. Make sure the Snap Creator Framework GUI is presented, and then log in.

1. In the Backup Profiles pane, expand the profile and mark the configuration. The configuration context is loaded and displayed in the Configuration Context pane.

1. Select the button (Actions menu), and then select Volume Clone.

1. Specify additional parameters: policy and user-defined variables. Click Ok.

1. This process asynchronously starts the clone operation. The current progress displays in the Console pane.

Activate Automatic Log Backup Mode Using the CLI

To activate an an automatic log backup by using the Snap Creator CLI, complete the following steps:

1. Make sure there is at least one complete data backup for the database instance.

1. Create a backup template type as FILE and a backup type as AUTO.

dbmcli -d -u , medium_put

Where:

is the backup template identifier.

is the file (full qualified) for the log backups. This has a version number appended to it.

is the type of the backup template.

is the type of backup.

1. Activate the automatic log backup.

dbmcli -d -u , autolog_on

1. Archive backup files on a regular base. For example, use the Snap Creator Framework or OS commands.