Chat now with support
Chat with Support

NetVault 11.3 - Administration Guide

Introduction Getting started Configuring clients Configuring storage devices Backing up data Managing policies Restoring data Managing jobs Monitoring logs Managing storage devices
Monitoring device activity Managing disk-based storage devices in table view Managing disk-based storage devices in tree view Managing tape libraries in table view Managing tape libraries in tree view Managing tape drives in table view Managing tape drives in tree view Adding shared devices
Managing storage media Managing user accounts Monitoring events and configuring notifications Reporting in NetVault Backup Working with client clusters Configuring default settings for NetVault Backup
About configuring default settings Configuring encryption settings Configuring plug-in options Configuring default settings for post-scripts Configuring default settings for Verify Plug-in Configuring Deployment Manager Settings Configuring Job Manager settings Configuring Logging Daemon settings Configuring Media Manager settings Configuring Network Manager settings Configuring Process Manager settings Configuring RAS device settings Configuring Schedule Manager settings Configuring Web Service settings Configuring Auditor Daemon settings Configuring firewall settings Configuring general settings Configuring security settings Synchronizing NetVault Time Configuring default settings for global notification methods Configuring the reporting utility Configuring NetVault Backup to use a specific VSS provider Configuring default settings using NetVault Configurator Configuring default settings using Txtconfig
Diagnostic tracing Using the deviceconfig utility NetVault Backup processes Environment variables Network ports used by NetVault Backup Troubleshooting

Configuring pre- and post-script options for backup jobs

You can use the pre- and post-script options to run user-defined scripts before a job starts or after a job completes. You can use these scripts to perform tasks such as dismounting or shutting down a database before the job starts or mounting or starting the database after the job completes.

Before configuring pre- or post-scripts, review the following information:

•
The script should be an executable file, for example, “.bat” files on Windows and “.sh” files on Linux.
•
The script file should reside on the target client. It should be available in the scripts directory under the NetVault Backup installation directory.
•
The pre- and post-scripts can contain run-time parameters. These parameters are stored in the environment variable NV_USER_ARG. You can also use other NetVault Backup environment variables in the scripts. For a list of available environment variables, see Environment variables in NetVault Backup.
•
NetVault Backup provides two predefined script files that can be used as post-scripts:
•
psmail: Use this script to send the job completion status to the specified email addresses.
•
psmail_logs: Use this script to send the job completion status and job logs to the specified email addresses.
On Linux and UNIX, the predefined scripts do not have any filename extension. On Windows, the scripts have the filename extension “.bat.”
To run these scripts, specify the following in the Post Script box:
•
Linux and UNIX: psmail or psmail_logs
•
Windows: psmail.bat or psmail_logs.bat
To specify pre- and post-scripts:
1
On the Advanced Options page, click Pre & Post Scripts, and configure the following settings.
Option
Description

Pre Script

This option allows you to run a user-defined script before a job starts. You can use this script to perform any pre-backup preparation, like dismounting or shutting down a database.

To run a pre-script, do the following:

•
In the Pre Script box, specify the script filename.
•
In the User Parameter box, provide the values for the run-time parameters. The value should be valid and conform to its usage in the script. NetVault Backup does not perform any validity checks for the user parameters.

Post Script

This option allows you to run a user-defined script after a job completes. You can use this script to perform any post-backup processing, like mounting or starting a database after a job completes.

To run a post-script, do the following:

•
In the Post Script box, specify the script filename.
•
In the User Parameter box, provide the values for the run-time parameters. The value should be valid and conform to its usage in the script. NetVault Backup does not perform any validity checks for the user parameters.
2
Click Set to save the settings and close the dialog box.
The following table illustrates the effect of script exit status on the overall execution and job status.
Process
Result

Pre script

Success

Success

Success

Fail

Fail

Backup job

Success

Success

Fail

Does not run

Does not run

Post script

Success

Fail

Success

Success

Fail

Overall job status

Job completes successfully.

Job completes, but a post-script error is reported.

Job fails, but the post-script runs. An error is reported.

Job fails, and a pre-script error is reported.

Job fails; pre‑ and post-script errors are reported.

Configuring user-defined events for backup jobs

When creating a backup job, NetVault Backup lets you configure user-defined events that can be raised when the job completes successfully, completes with warnings, or fails. You can use these options when you want to be notified about the completion status of individual jobs.

* 
NOTE: NetVault Backup includes several predefined events, which are raised for significant occurrences within the system. For more information, see About NetVault Backup events and Events types.

You can also raise user-defined events for individual backup jobs, restore jobs, report jobs, policies, and log messages. You can use various notification methods to receive notifications when the predefined or user‑defined events occur in NetVault Backup. For more information, see Using global notification methods.

You can configure the user-defined events in the Backup Advanced Options Set. Once you create a user‑defined event, you can raise it for any job or backup policy. NetVault Backup adds the user-defined events to the event class Jobs — User defined. You can then set up one or more notification methods for the event to receive notifications when the event is raised.

To raise user-defined events for a backup job:
1
On the Advanced Options page, click Events, and configure the following settings.
Option
Description

Job is Successful

Type or select the event that you want to raise when the job completes successfully.

Job has Warnings

Type or select the event that you want to raise when the job completes with warnings.

Job Fails

Type or select the event that you want to raise when the job fails.

2
Click Set to save the settings and close the dialog box.
3
To receive a notification when an event occurs, set up a notification method for the event. For more information, see the Setting up a global notification method.

Managing sets

This section includes the following topics:

•
Modifying a set
•
Copying a set
•
Deleting a set

Modifying a set

You can modify the data selections or various job options stored in an existing set. When saving the changes, you can choose to overwrite the set or save the selections to a new set.

* 
NOTE: When you edit a set, it affects the existing jobs that use the set.
To modify a set:
1
In the Navigation pane, click Manage Sets.
2
In the Set Type list, select the type of set that you want to modify.
3
In the list of available sets, select the applicable set, and click Edit.
4
Modify the data selections or job options.
5
Click Save. In the Edit Set dialog box, click Save to overwrite the existing set. Alternatively, type a new name, and click Save to save the selections to a new set.
Related Documents