Chat now with support
Chat with Support

NetVault 12.3 - Administration Guide

Introduction Getting started Configuring clients Managing catalog search Configuring storage devices Backing up data Managing policies Restoring data Managing NetVault Backup dashboard Managing jobs Monitoring logs Managing storage devices
Monitoring device activity Managing disk-based storage devices in list view Managing disk-based storage devices in tree view Managing the Snapshot Array Manager Managing tape libraries in list view Managing tape libraries in tree view Managing tape drives in list view Managing tape drives in tree view Adding shared devices
Managing storage media Managing user and group accounts
About user accounts About user and group privileges and presets Creating a user account Modifying a user account Deleting a user account Setting a user policy Using Secure Mode Using Presets User privileges Predefined Presets Integrating Active Directory with NetVault Backup Using Azure Active Directory as an identity provider
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 WebUI default settings 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
Common errors
NetVault Backup Service fails to start on Windows NetVault Backup Service fails to start after the machine is restarted NetVault Backup Service starts, but stops immediately on Linux Login fails after any change in the server IP address Unexpected behavior of NetVault Backup WebUI WebUI does not run in Compatibility View in Internet Explorer NetVault Backup installer fails during push installation VSS-based backup fails Modifying TCP/IP socket buffer size on Windows Restores using Data Copy savesets fail on clients running NetVault Backup 10.0.1 Restore fails on Itanium platforms if the index is larger than 2GB After upgrade, Data Copy and Consolidated backup job on Linux fails After upgrade, console error is displayed on WebUI pages Deployment task hangs on target Linux machine during push installation. Unable to add package store with hostname. Deployment task fails due to network configuration issues. Domain user is unable to login NetVault Backup Server if the workstation attribute is set. Domain user is unable to login NetVault Backup Server on Debian 9. Adding the target machine as a client fails, after successful push installation. Unable to install, uninstall or navigate catalog search page after manually uninstalling NetVault Backup Client Host. Unable to install, uninstall catalog search on client after NetVault Backup Server migration with the same or different server name External Azure AD user cannot add an external Azure AD user to NetVault Backup Server Failed to verify target Windows machine from a Linux-based NetVault Backup server
Safe Mode in NetVault Backup

Setting backup retirement options

1
On the Advanced Options page, click Backup Life, and configure the following settings.

Archive

To create an archive, select this option.

An archive cannot be used as a base for Incremental or Differential backups. When archiving data, you must always select the Full Backup type. If you select Incremental or Differential Backup type, the restore job fails.

Backup

This option is selected by default. To create a backup, use this option.

Backup Life

This option specifies how long a backup is retained.

A backup can be retained indefinitely or retired after a specified period. NetVault Backup supports generation- and time-based retirement methods for backups. For more information about backup retirement methods, see Backup retirement.

You can specify the retirement options in the Backup Advanced Options Set. Alternatively, you can use the Change Expiry method to set or change the expiry date or generation count for existing savesets. For more information about the Change Expiry method, see Configuring saveset expiry options.

To set the Backup Life option, do the following:

Backup life — based on Full Backup count: To configure generation-based retirement, select the Discard After Full Backup Count option. In the associated list, type or select the maximum number Full Backups that you want to retain.
Backup life — based on time: To configure time-based retirement, select the Discard After option. Type or select the period, and in the associated list, select the Days, Weeks, Months, or Years option.
By default, the Backup Life option is set to Discard After and the retirement period is set to three months.

 

Force Expiry: By default, if a backup has any dependent backups, its retirement is deferred until all dependent backups are ready for retirement.
To apply this rule globally to all backups, you can modify the Media Manager settings. For more information, see Configuring retirement rules for dependent backups. If the Retirement Timing Control option is set to Force Always, the Force Expiry is option is used, regardless of state of this check box.
Retain a backup indefinitely: To retain a backup indefinitely, select the Don't Discard based on Full Backup Count and Don't Discard based on Time options.

 

NOTE: If you set both Discard After Full Backup Count and Discard After options for a Full Backup, the backup is retired only when both conditions are met. For example, if you set the Discard After Full Backup Count option to four Full Backups and the Discard After option to 30 days, the backup is retired after five Full Backup counts and 30 days.

Offline Index After

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 the online indexes.

You can use different methods to delete online indexes:

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. This method is described in this section.
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.

To specify the index retention period in the Backup Advanced Options set, select Offline Index After option. Type or select the length of time that you want to retain the index, and in the associated list, select the Days, Weeks, Months, or Years option.

2
Click Set to save the settings and close the dialog box.

Specifying additional options

1
On the Advanced Options page, click Additional Options, and configure the following settings.

Enable Encryption

NetVault Backup provides two encryption plug-ins:

NetVault Backup Plug-in for Standard Encryption (Plug-in for Standard Encryption)
NetVault Backup Plug-in for Advanced Encryption (Plug-in for Advanced Encryption)

These plug-ins provide support for CAST-128, AES-256, and CAST-256 algorithms to meet regulatory backup security requirements. For more information about these plug-ins, see the Quest NetVault Backup Plug-in for Standard Encryption User’s Guide or Quest NetVault Backup Plug-in for Advanced Encryption User’s Guide.

Once the Plug-in for Standard Encryption or Plug-in for Advanced Encryption is installed on a client, you can do either of the following:

The job-level encryption option is useful in the following situations:

To perform job-level encryption for a primary backup, select the Enable Encryption check box. For more information about using job-level encryption for a secondary copy, see Encrypt Secondary Copy Only.

Enable Deduplication

Deduplication is enabled by default. Clear this check box if the target device does not support data deduplication.

When performing backups to devices that support deduplication, we recommend that you clear this check box for the following jobs:

Incremental Backups that you want to consolidate using the Plug-in for Consolidation. By not selecting this option, you eliminate the unnecessary overhead of rehydrating the deduplicated Incremental Backups during the consolidation process. You can enable deduplication while backing up the Consolidated Full Backup.

Verify After Backup

To verify the stream length written to the media and ensure that no blocks were dropped during backup, select this check box.

Backup verification is performed as Phase 2 job after the actual backup is completed. If any dropped blocks are detected, the verification phase reports an error and fails. You must run the backup again if the verification phase fails.

By default, the verification job runs on the NetVault Backup Server. To configure a different client to run the verification phase, see Configuring default settings for Verify Plug‑in.

Use Network Compression

To use network compression while transferring data over the network, select this check box.

The data is compressed on the backup client before being transferred over the network. On the machine to which the target device is attached, the data is decompressed before being written to the media.

Network compression does not work for the following types of jobs:

Backups performed using the NetVault Backup Plug-in for NDMP, NetVault Backup Plug-in for NetWare, and NetVault Bare Metal Recovery products.

Don't Add Saveset Items to the Restore Search Catalog

To exclude a backup with a selected saveset from cataloging, select this check box.

To check the cataloged status (Yes or No) of a saveset, see the ‘Cataloged’ column on the Create Restore Job - Choose Saveset page

2
Click Set to save the settings and close the dialog box.

Creating a Secondary Copy

1
On the Advanced Options page, click Secondary Copy.
2
Click the Create Secondary Copy check box, and configure the following settings.

Copy with

Select the method that you want to use to create the Secondary Copy. The available methods are:

For more information about these methods, see Secondary Copy.

NOTE: On NetVault Backup Server 10.0.5 and later, the Plug-in for Data Copy creates index version 4, which is incompatible with earlier versions of NetVault Backup. A client running NetVault Backup 10.0.1 or an earlier version cannot read these index files. To restore Data Copy savesets generated from NetVault Backup Server 10.0.5 or later, the client must also be running NetVault Backup 10.0.5 or later.

Run copy job on

By default, the secondary copy job runs on the NetVault Backup Server. If you want to run the job on a particular client, select the target client.

You can use this option to perform backups on a client with a locally attached physical or virtual tape device.

IMPORTANT:  

Use Schedule Set

Select an existing Schedule Set, or click Create New, and configure the schedule type and schedule method. For more information, see Creating Schedule Sets.

NOTE: You cannot use the Repeating and Triggered schedule types to run Secondary Copy jobs. A Secondary Copy job can run only after the Phase 1 job completes successfully. The Repeating and Triggered schedule types can cause a situation where a Secondary Copy job is configured to start before the source saveset is available.

Use Target Set

Select an existing Target Set, or click Create New, and configure the target device and media options for the job. For more information, see Creating Target Sets.

Use Source Set

Select an existing Source Set, or click Create New, and configure the source device options for the job. For more information, see Creating Source Sets for backup jobs.

Maximum Streams for Data Copy

Type or select the maximum number of parallel streams that can be generated for the Data Copy job. By default, a single data stream is generated to copy the data items in a sequential manner.

Media Request Timeout

Type or select the amount of time NetVault Backup waits for the backup media. The timeout value is specified in number of minutes. The default value is 10 minutes.

If the required media item is not available within the specified interval, the job is automatically aborted.

If you set the value to zero (0), the Secondary Copy job waits indefinitely until the media is provided or the job is manually aborted.

The maximum timeout period that can be set is 1440 minutes (24 hours), which ensures that current instance is aborted before NetVault Backup runs the next instance of a Daily job.

NOTE: The media request timeout for Phase 1 Data Copy jobs (created using the Plug-in for Data Copy) is controlled by the Media Request Timeout setting in the Backup Options Set; it is not controlled by the Media Request Timeout setting in the Target Set. The media request timeout for Phase 2 (Secondary Copy) Data Copy and Duplicate jobs is controlled by the Media Request Timeout specified in the Backup Advanced Options Set.

Encrypt Secondary Copy Only

To perform job-level encryption for a secondary copy, select the Enable Encryption check box.

This option can only be used with the Data Copy method. To use this option, the Plug-in for Standard Encryption or the Plug‑in for Advanced Encryption must be installed on the client.

Note the following:

If the primary copy is encrypted, the Data Copy method automatically creates an encrypted saveset whether you select the Encrypt Secondary Copy Only check box or not. Therefore, this option is only useful when you want to create an encrypted secondary copy from an unencrypted primary copy.
Encrypted primary backups are not encrypted again if you select the Encrypt Secondary Copy Only check box for a Data Copy.

For more information about using job-level encryption for a primary backup, see Enable Encryption.

Migrate (Discard Original)

To migrate the backup instead of creating a copy, select this check box. After copying the data, NetVault Backup deletes the index for the original backup.

NOTE: When creating copies of the Plug-in for FileSystem backups, the Migrate option can only be selected for Full Backups that do not have any associated Incremental or Differential Backups. If you select this option for a Full Backup that has an associated Incremental or Differential Backup, NetVault Backup creates the secondary copy successfully, but it does not delete the index for the primary or original backup. For such backups, after creating the copy, you must manually retire the primary or original backup.

Allow Streams to Share Media

This check box is not selected by default. You can use this option with the Duplicate a backup method.

When creating a Duplicate of a multi-stream backup, you can use this option to convert multiple data streams into a sequential data stream. If you do not select this check box, each stream is written separately.

If you are using a disk-based device to store the Duplicate backup, multiple streams are recommended. For such jobs, there is no need to select this check box.

If you do not select the Allow Streams to Share Media check box for tape devices, each data stream targets a separate media item. Any tape that is used to write a stream is excluded from the allowable media items. If enough tapes are not available for the job, the job fails. When using tape devices to store the Duplicate backups, you can select this check box to use minimal media items.

Use Optimised Replication Between Devices that Support this Feature

Optimized replication enables transfer of deduplicated data directly from one device to another device of the same type during a Data Copy or Duplicate operation. It provides an efficient method to create secondary copies and offers the following advantages:

The following storage devices support optimized replication:

Quest DR Series systems: To perform optimized replication, both the source and target Quest DR Series systems must be running the same release version of the DR OS. Replication is not supported between systems that run different releases of the OS.
NetVault SmartDisk devices: To perform optimized replication, you require NetVault SmartDisk 2.0 or later.
DD Boost-enabled Data Domain systems: The secondary copy backups between two DD Boost-Enabled Data Domain systems use the managed file-level replication feature provided by DD Boost.

Select Source Media Before Target Media

When you select this check box, NetVault Backup tries to acquire the source media before it attempts to acquire the target media for the Data Copy and Duplicate backups.

Use Life of Original

This option is selected by default. To use the original saveset’s retirement period, leave this option selected.

Discard After

To configure a different retirement period for the Duplicate or Data Copy saveset, select this option.

Type or select the length of time that you want to retain the backup, and in the associated list, select the Days, Weeks, Months, or Years option. You can set only time-based retirement period for the copy.

Force Expiry

This check box is displayed when you select the Discard After option.

By default, if a Secondary Copy has any dependent backups, its retirement is deferred until all dependent backups are ready for retirement.

You can select this check box to retire a Secondary Copy according to its retirement schedule. Forcing this behavior can cause early retirement of dependent Incremental and Differential Backups.

To apply this rule globally to all backups, you can modify the Media Manager settings. For more information, see Configuring retirement rules for dependent backups. If the Retirement Timing Control option is set to Force Always, the Force Expiry option is used, regardless of state of this check box.

5
Click Set to save the settings and close the dialog box.

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.
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.
Linux and UNIX: psmail or psmail_logs
Windows: psmail.bat or psmail_logs.bat
1
On the Advanced Options page of the target client, click Pre & Post Scripts, and configure the following settings.

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, such as 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.

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.

Related Documents