Pre & post backup programs, Pre & post snapshot programs – Storix Software SBAdmin TSM Edition Users Guide User Manual

Page 36

Advertising
background image

Pre & Post Backup Programs

When a backup job using a profile containing client pre-backup or post-backup programs is run, the system
will attempt to execute the specified program on each client before or after that client backup is performed.
If the program does not exist on any client or is not executable, it will be ignored. Otherwise, it will be
executed and one of the following actions will be taken depending on the exit code of the program:

Storix System Backup Administrator

36

Version 8.2 TSM Edition User Guide

Pre-backup Program

Post-backup Program

Exit code 0

Client will be backed up and the job will
continue normally.

Job will continue normally.

Exit code 1

Client will not be backed up and the
backup job will be terminated with an
error message

Job will terminate with an error.

Exit code 2

Client will not be backed up. If there
are other clients to backup, the job will
continue normally. However the job will
complete with warning messages.

Job will continue normally. However, the job will
complete with warning messages.

Exit code 3
or higher

Client will be backed up and the job will
continue normally. However, the job
will complete with warning messages.

Job will continue normally. However, the job will
complete with warning messages.

A post-backup program will be executed even if the backup command that precedes
it fails. This is necessary in case the post-backup program must record information
about the backup or restart processes that were stopped by the pre-backup program.

Pre & Post Snapshot Programs

When a backup job using a profile containing pre-snapshot and post-snapshot programs is run, the system
will attempt to execute the specified program on each client before and/or after each snapshot is created.

The program will only be executed for the storage containers to be included in the backup, and if

Snapshot

Backups

have been configured and the

Backup Job

is configured to perform snapshot backups.

The program names provided will be executed before a snapshot is created for each
logical volume/filesystem

. Therefore, the program must be intelligent enough to

recognize the name of the logical volume or filesystem the snapshot is being created
for at that time and act accordingly (or do nothing). Refer to

Creating Pre and Post

Backup Programs

below for more information.


If the specified program does not exist on any client or is not executable, it will be ignored. Otherwise, it will
be executed and one of the following actions will be taken depending on the exit code of the program:

Pre-snapshot Program

Post-snapshot Program

Exit code 0

The snapshot of the logical volume will
be created and the backup will
continue.

Backup will continue normally.

Exit code 1

The snapshot will not be created for the
logical volume and the backup will
terminate.

The backup will terminate with an error.

Exit code 2

The snapshot will not be created for the
logical volume, and the backup will
continue using the active (online) data.

The backup will terminate with an error.

Exit code 3
or higher

A warning message will appear, but the
snapshot will be created and the
backup will continue normally.

The backup will terminate with an error.

Advertising