NetVault 12.3 - Administration Guide

By default, the nvjobstart command returns either 0 or 1 (0 to indicate success, and 1 to indicate failure). You can configure the utility to return enhanced job completion status codes and messages that indicate the way in which a job failed.

To configure default settings for the nvjobstart utility:

In the Navigation pane, click Change Settings.

To configure default settings for the NetVault Backup Server, click Server Settings.

— or —

To configure default settings for a NetVault Backup Client, click Client Settings. In the NetVault Backup Clients table, select the client, and click Next.

Under Plugins, click Plugin Options. In the Plugin Options dialog box, under CLI, configure the following setting:

•

nvjobstart Enhanced Job Completion Status: By default, the nvjobstart utility returns the following messages depending on the job exit codes.

Table 116. Default job exit codes and status messages

Exit code

Status message

Job completed successfully

Job failed with error: ‘Job Failed’

This message is returned for the following job completion states:

•

Job failed

•

Job completed with warnings

•

Job aborted

•

Job stopped

•

Job died

If you select the nvjobstart Enhanced Job Completion Status check box, the utility returns the following codes and messages.

Table 117. Enhanced job exit codes and status messages
Exit code	Status message
0	Job completed successfully
1	Job Failed
2	Job Completed with Warnings
3	Job Aborted
4	Job Stopped
5	Job Died
-1	Job Failed with Undefined Error


	NOTE: You must configure this option on the NetVault Backup machine on which you run the nvjobstart utility.

Click Apply to apply the new settings and close the dialog box.

Configuring default settings for post-scripts

Configuring default settings for post‑scripts

By default, the execution of a post-script is terminated when a backup or restore job is aborted. You can modify the configuration setting for post-scripts to change this behavior.

To change the default setting for post-scripts:

In the Navigation pane, click Change Settings.

To configure default settings for the NetVault Backup Server, click Server Settings.

— or —

To configure default settings for a NetVault Backup Client, click Client Settings. In the NetVault Backup Clients table, select the client, and click Next.

Under Plugins, click Script. In the Script dialog box, configure the following setting:

•

Terminate running script on Job Abort: This check box is selected by default. If you want to continue script execution even when the associated job is aborted, clear this check box.

This setting applies to all post-scripts defined for the backup, restore, and report jobs performed on the given NetVault Backup Client.

Click Apply to apply the new settings and close the dialog box.

Configuring default settings for Verify Plug-in

Configuring default settings for Verify Plug‑in

With a backup job, you can choose to run the verification phase to check the correctness and completeness of a backup at the end of data transfer. NetVault Backup uses the built-in Verify plug-in to perform the verification phase. The Verify plug-in verifies the stream length written to the media and ensures that no blocks were dropped during backup. While the actual backup runs as Phase 1, backup verification runs as Phase 2 of the backup job.

By default, the backup verification job runs on the NetVault Backup Server. You can modify the configuration settings for the plug-in to run the verification on an alternate client or locally on specified clients.

To configure default settings for the Verify Plug-in:

In the Navigation pane, click Change Settings.

On the Configuration page, click Server Settings.

Under Plugins, click Verify. In the Verify dialog box, configure the following settings.

Table 118. Default settings for Verify plug-in
Setting	Description
Always run Verify locally	By default, the verification phase runs on the NetVault Backup Server. To avoid data transfers over the network, you can choose to run verification locally on the clients to which the device used for backup is attached. This option is globally applied to all clients. It does not work for clients that do not have a locally attached backup device.
Comma separated list of clients that verify locally	If your backup jobs are distributed across multiple client-attached devices, use this setting to specify a comma-separated list of clients that can run the verification phase locally.
Default client to run Verify	To configure an alternate client to run all verification jobs, specify the client name. This setting is useful if you use a client-attached device for your backups. It allows you to select the same client to run backup verification jobs.