Chat now with support
Chat with Support

NetVault 11.4.5 - 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 Txtconfig
Diagnostic tracing Managing diagnostic data Using the deviceconfig utility NetVault Backup processes Environment variables Network ports used by NetVault Backup Troubleshooting

Configuring pre- and post -scripts for restore 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 job completion status to the specified email addresses.
•
psmail_logs: Use this script to send job completion status and job logs to the specified email addresses.
On Linux and UNIX, the predefined scripts do not 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.
Table 46. Pre and post script options for restore jobs
 
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 -restore 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 restore processing, such as 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.
Table 47. Script execution and restore job status
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

Fail

Restore job

Success

Success

Fail

Does not run

Does not run

Does not run

Post script

Success

Fail

Success

Success

Not configured

Fail

Overall job status

Job completes successfully

Job completes, but a post -script error is reported

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

Job fails, and a pre -script error is reported, but post -script runs

Job fails, and a pre -script error is reported

Job fails. Pre -script and post -script errors are reported

Configuring user-defined events for restore jobs

When creating a restore 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 Restore 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 restore job:
1
On the Advanced Options page, click Events, and configure the following settings.
 
Table 48. User-defined event types for restore jobs
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 online backup indexes

This section includes the following topics:

•
About managing online indexes
•
Manually deleting online indexes
•
Loading offline indexes
•
Manually compressing online indexes
•
Uncompressing online indexes

About managing online indexes

Online backup indexes allow you to quickly scan through the contents of a saveset without loading the media. However, these indexes can increase the overall size of the NetVault Database. To manage the database size, you can delete or compress the online indexes.

The following sections provide a brief description of the methods that are available for deleting and compressing online indexes:

•
Deleting online indexes
•
Compressing online indexes
Deleting online indexes

You can use the following methods to delete the online indexes for backups:

•
You can configure the Offline Index After option in the Backup Advanced Options Set to automatically delete the online index for a backup after the specified period. For more information, see Setting backup retirement options.
•
You can use the Days of inactivity before an index is offlined setting to configure a global policy for deleting online indexes after a specified period of inactivity. For more information, see Configuring Media Manager settings for backup indexes.
•
You manually delete the online indexes for one or more backups from the Manage Backup Indexes page. For more information, see Manually deleting online indexes.

The indexes for the savesets can be loaded from the backup media if required.

 
* 
NOTE: Deleting a backup index is not the same as retiring a backup.

When a backup is retired, NetVault Backup discards all information about it from the NetVault Database. When you scan the media to retrieve the index for a retired saveset, it is loaded as a new index in the NetVault Database. When the online indexes are deleted, NetVault Backup still retains some information about the saveset. This information allows NetVault Backup to quickly reload the saveset index from the backup media.

Compressing online indexes

Online indexes are automatically compressed after 30 days of inactivity. You can modify the Days of inactivity before an index is compressed setting to customize this policy. For more information, see Configuring Media Manager settings for backup indexes.

You can also manually compress the online indexes for one or more backups from the Manage Backup Indexes page. For more information, see Manually compressing online indexes.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating