BackBox H4.00 VTC Scripting Option

Detailed description
1 BackBox H4.00 VTC Scripting Option
Detailed description
Backup script
After a virtual volume mounted for output is unloaded, the backup script is executed.
This script typically archives the two disk files representing a virtual volume.
Preliminary cleanup
Before archiving a new virtual volume, the script must first delete previous archive of
the same volume – if the enterprise backup software allows the deletion of archives
at the file level. Multiple archives of the same volume consume storage but may also,
depending on the backup software used, be the causes of various problems at
restore time, for example:
Script interrupted for unexpected prompt to choose the archive
versions.
Repeated restore of all available archives of the same volume image.
If no operational problem has occurred in the previous execution on a specific
volume there should be a single previous archive of the ”.DAT” and “.IND” If the
enterprise backup software does not automatically overwrite an archive with a newer
version then it should be deleted using the environment variables
%BBOX_PREV_PATH%%BBOX_VOLUME%.*.
For the very rare cases where the files “.DAT” and “.IND” were not written in the
same path, an additional cleanup should be done for
%BBOX_PREV_DATA_PATH%%BBOX_VOLUME%.* archives. This additional cleanup
is useful if the Volume Group is configured for auto-scratch and to clean everything
even if there was a severe operational problem during the previous backup on the
volume.
It is suggested to delete also existing archives from the same path as the new
volume %1 and %2 positional parameters, see below.
Positional parameters
The Backup script receives two positional parameters with the name of the disk files
to backup or archive:
• %1 contains the fully qualified file name of the index (file type
.IND).
• %2 contains the fully qualified file name of the data (file type .DAT).
The content of the positional parameters is also available in these named parameters
(see later in this section):
%BBOX_FILE_IND%
%BBOX_FILE_DAT%