Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

NetVault 12.3 - CLI Reference Guide

Table of Contents

About Quest NetVault Backup About this document Target audience Recommended additional reading

Getting started

About NetVault Backup Command Line Interface Working with command-line utilities

Command syntax CLI help Command exit status Environment variables

Starting or stopping the NetVault Backup Service

Using the command-line utilities

Client-specific utilities

nvclient nvclientaccess nvclientadd nvclientlist nvclientname nvclientremove

Device-specific utilities Media-specific utilities

nvblankmedia nvsetmedia nvbulkblankmedia nvexportmedia nvlabelmedia nvlistblankmedia nvlistmedia nvloadmedia nvmakemedia nvmediadetails nvremovemedia nvreusemedia nvscanmedia nvsyncronizesilomedia nvupdateserialnumber

Job-specific utilities

nvexpiresaveset nvjobabort nvjobcreate nvjobdelete nvjobhold nvjoblist nvjobmodify nvjobresume nvjobstart nvpolicy nvrestore nvsetcreate

Backup Selection Set Restore Selection Set Backup Options Set Schedule Set Backup Target Set Backup Advanced Options Set Restore Advanced Options Set

nvsetdelete nvsetexport nvsetimport nvsetmodify nvtrigger

Log-specific utilities

nvlogdump nvlogpurge nvreadlog

Other utilities

bonedate getmachineid installplugin licenseinstall nvlicenseinfo nvmeddbcheck nvpassword nvpluginpreconfig nvpluginaccess nvpgdbpasswd nvreport nvscheddbcheck nvsendmail nvsendopmsg nvtrace

Using the nvreport utility

About nvreport utility Report classes Plain text template files Formatting the reports

Using the format option Using the sort option Using the include option Using the title option

Creating external report files HTML template files

nvmediadetails

Displays details pertaining to media items and media groups.

nvmediadetails [-label <Media Label>] [-group <Group Label>] [-all]
[-listlabels] [-listgroups] [-version]

Table 44. nvmediadetails
Option	Description
-label	Specifies the media a label for the target media item. You can specify a few initial characters to search for media items with matching labels.
-group	Specifies the media group label of the target media item.
-all	Displays details for all media items.
-listlabels	Displays details for all media items that are assigned a media label. The “-group” option can be used with this option to displays media details for a particular media group.
-listgroups	Lists available media groups.
-version	Displays the build date of the NetVault Backup distribution installed on the machine.

•

Display details for a piece of media labeled “MyTape”:

nvmediadetails -label MyTape

•

Display details of all media items belonging to the Media Group “MyGroup”:

nvmediadetails -group MyGroup -all

nvremovemedia

Deletes all information about a piece of media from NetVault Database.


	NOTE: The target media item must be taken offline before issuing this command.

nvremovemedia [-medialabel <Media Label>] [-displaymedialist] [-version]

Table 45. nvremovemedia
Option	Description
-label	Specifies the media a label for the target media item.
-displaymedialist	Provides a list of media items that have a media label.
-version	Displays the build date of the NetVault Backup distribution installed on the machine.

nvreusemedia

Marks a piece of media for reuse.

nvreusemedia [-servername <Server Name>] -barcode <Barcode> |
-medialabel <Media Label> | -slotspec <Library Name::Slot Number>

Table 46. nvreusemedia
Option	Description
-servername	Specifies the name of the NetVault Backup Server that administers the job. This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.
-barcode	Specifies the barcode of the target media item.
-medialabel	Specifies the label of the target media item. Use this option only when searching by media label. If a media label contains spaces, enclose it within quotation marks (“ ”). Example: “Full DB Backups”
-slotspec	Specifies the name of the library and slot number where the target media item resides. These two values must be separated using a double colon delimiter (“::”). Use this option only when searching by library slot.

•

The indexes for backups stored on the target media item are removed from the NetVault Database when you use this command.

•

This utility does not support the ACSLS/ ADIC DAS library systems.

•

This utility does not support disk-based storage systems such as Quest NetVault SmartDisk, Quest DR Series System, and Data Domain System.

nvscanmedia

Scans media items.

You can use this utility to query all backups stored on a tape and import those backups that are not indexed in the given NetVault Backup Server’s database. You can also use the Scan method to import “foreign” tapes into the NetVault Database.

To import backups to the database, the NetVault Backup Server must have the same NetVault Backup Machine Name as the original server that performed the backups. The amount of time it takes to scan the tapes depends on the number of backups that need to be imported and the size of the backup indexes. The scanning process does not read the data on the tape; this process skips between the start and end of backups to read the index for each backup saveset.

A tape is marked “foreign” when NetVault Backup cannot find any information about that item in the NetVault Database. This issue can occur when a tape is swapped between libraries, removed from the NetVault Backup Server, or loaded on a device controlled by a different NetVault Backup Server. NetVault Backup cannot process data stored in a foreign tape until you scan the tape and import the media information into the NetVault Database. The scanning process retrieves the header information from the tape and adds this information to the NetVault Database.

nvscanmedia [-servername <Server Name>]
-barcode <Barcode> | -medialabel <Media Label> |
-slotspec <Library Name::Slot Number> | -rasdevice <Device name>
-scanall | -force -minlifedays <Minimum Life> [-wait]

Table 47. nvscanmedia

Specifies the name of the NetVault Backup Server that administers the job.

This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.

Scans all the labels and drives of the media item. The machine name of Tape Library/VTLs is mandatory for this option. For example,

nvscanmedia.exe -servername HIPUNP57176 -scanall "HIPUNP57176: C:\vtl".

Specifies the barcode of the target media item.

Specifies the label of the target media item.

Use this option only when searching by media label. If a media label contains spaces, enclose it within quotation marks (“”).

Example: “Full DB Backups”

Specifies the name of the library and slot number where the target media item resides. These two values must be separated using a double colon delimiter (“::”). Use this option only when searching by library slot.

Specifies the name of the disk-based device that you want to scan.

Forces NetVault Backup to run the scan operation for unknown media items. This option cannot be used with disk-based storage devices.

Specifies the minimum life for backups that are imported to the NetVault Database. This option only applies to the backups that are not available in the NetVault Database.

The minimum life setting is specified in number of days.

Depending on the value set for this option, the retirement time for imported backups is modified as follows:

•

If a backup is already retired, its retirement time is set to the specified minimum life. If you specify zero, the retirement time for the retired saveset is set to one hour.

•

If a backup is scheduled to retire before the specified period, its retirement time is set to the specified minimum life.

•

If a backup is scheduled to retire after the specified period, its retirement time remains unchanged. For such backups, the backup life setting determines the retirement time.

NOTE: When a backup stored on a disk-based storage device is retired, that backup is deleted from the device. You cannot import the deleted backup by scanning the device.

Waits until the task has completed.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating

© 2024 Quest Software Inc. ALL RIGHTS RESERVED. Feedback Terms of Use Privacy Cookie Preference Center