vltrun

vltrun — Run a NetBackup Vault session

SYNOPSIS

<nbu_dir_path>vltrun -haltdups -vjobs vault_jobid [profile | robot/vault/profile] [-preview] [-verbose | -v] [-version]

On Windows systems, <nbu_dir_path> is <install_path>\NetBackup\bin\

DESCRIPTION

vltrun drives a NetBackup Vault session by issuing a sequence of calls to the vault engine. Optionally, the session can include callouts to user-provided notify scripts.

OPTIONS

profile | robot/vault/profile: Specifies the name of a profile or a nested robot number, vault, and profile in the vault parameter file. If profile is used without robot and vault, the profile must be unique within the vault parameter file. This option is required.
-vjob vault_jobid: Specifies the job ID of an active vault job that is currently duplicated.
-haltdups: Terminates all associated, active vault duplication jobs.
-preview: Generates the preview list of images to be vaulted in a vault session. The results go to the file preview.list in the session directory.
-verbose | -v: Reports verbosely on the session in the vault debug log.
-version: Displays the vltrun version and exit.

USAGE

The vltrun session follows this sequence:

Run the vlt_start_notify script.
Inventory media.
Initialize Media Manager database for the vault media that is returned to the robot.
Generate the list of preview images to be vaulted.
Duplicate images.
Inventory Media Manager database (first time).
Assign media for the NetBackup catalog backup.
Inventory Media Manager database (second time).
Inventory images.
Suspend media.
Run the vlt_end_notify script.
Re-inventory images.
Assign slot IDs.
Back up the NetBackup catalog.
Inventory the Media Manager database (third and final time).
Run the vlt_ejectlist_notify script.
Generate the eject list.
Run the vlt_starteject_notify script.
Eject and report.
Run the vlt_end_notify script.

vltrun can be run in any of the following ways:

Directly from the command line
By NetBackup policy scheduling. In this case, the policy must consist of type Vault, and the policy's file list must consist of a vltrun command.
By running the command Start Session for a profile in the Vault GUI or vltadm

vltrun uses the option profile|robot/vault/profile to run a vault session. You can use the profile form of the option if there is no other profile with the same name in your vault configuration. In this case, the profile name is sufficient to uniquely identify the configuration information.

If there is more than one profile with the same name, then use the robot/vault/profile form to uniquely identify the configuration.

Do not modify your vault configuration while a vault session is running.

When the session starts, it creates a directory to hold the files that vltrun and the vault engine create during the session.

The vault session uses the following directory:

Windows systems: 
install_path\NetBackup\vault\sessions\vault_name\sidxxx

The xxx variable is an integer uniquely assigned to this session. For each vault name, session identifiers are sequentially assigned, starting with 1.

If you have configured an email address in your vault properties, then email is sent to this address at the end of the session. The email reports the results. By default, email is sent to root.

vltrun produces an overview of the session, called summary.log, in the session directory.

Control the vault process at several points in the session by installing notify scripts in the directory for NetBackup binaries, /usr/openv/netbackup/bin. Refer to the NetBackup Vault Administrator's Guide for more information on notify scripts.

You can monitor the progress of your vltrun session in the NetBackup Activity Monitor.

The Operation field on the main Activity Monitor window shows the progress of your vault session by using the following statuses:

Choosing Images.
Duplicating Images.
Choosing Media.
Catalog Backup..
Eject and Report.
Done.

If you create the following directory with public-write access, vltrun creates a daily debug log on this directory:

Windows systems: install_path\netbackup\logs\vault

The log is called log.DDMMYY (where DDMMYY is the current date). You then can use this file that for troubleshooting.

Public-write access is needed because not all executables that write to this file run as administrator or root.

You can adjust the level of logging information that is provided in this log file by adjusting the following: the vault logging level parameter on the Logging page of the master server's properties through Host Properties on the NetBackup Console.

You can terminate active vault duplication jobs by using the vltrun -haltdups command. Initiate a -haltdups script that sends a SIGUSR2 signal to the main vault job (currently at the duplication step). It then automatically propagates the signal to all of the vault duplication instances without waiting for any current duplication job instance to finish. After this step completes, the main vault job proceeds with the remaining steps.

After the SIGUSR2 signal is received, the job details of the following message of the terminated vault duplication job appears: termination requested by administrator (150)

You must have administrator privileges to run this command.

EXAMPLES

EXAMPLE 1

To vault the profile my_profile, enter:

# vltrun my_profile

EXAMPLE 2

The following command vaults the images for robot 0, vault 
Financials, and profile Weekly:
# vltrun 0/Financials/Weekly

EXAMPLE 3

To terminate an active vault duplication job with the ID of 1, enter:

# vltrun -haltdups -vjob 1

RETURN VALUES

On UNIX and Linux systems, vault may exit with a status code greater than 255. For these extended exit status codes, the status that is returned to the system is 252. The actual exit status is written to stderr in the format, EXIT status = exit status

The extended exit status values are documented in the NetBackup Troubleshooting Guide and in the NetBackup Troubleshooting Wizard.

FILES

Windows systems:

install_path\NetBackup\vault
install_path\NetBackup\bp.conf
install_path\NetBackup\logs\bpbrmvlt\mmddyy.log
install_path\NetBackup\logs\bpcd\mmddyy.log
install_path\NetBackup\logs\vault\mmddyy.log
install_path\NetBackup\db\vault\vault.xml
install_path\NetBackup\vault\sessions\vault_name\sidxxx
install_path\NetBackup\vault\sessions\vault_name\sidxxx\summ
ary.log
install_path\NetBackup\vault\sessions\vault_name\sidxxx\deta
il.log