Chat now with support
Chat with Support

NetVault 11.3 - CLI Reference Guide

Introduction Getting started Using the command-line utilities Using the nvreport utility

nvremovemedia

Description

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

* 
NOTE: The target media item must be taken offline before issuing this command.
Syntax
nvremovemedia [-medialabel <Media Label>] [-displaymedialist] [-version]
Options
Table 44. 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

Description

Marks a piece of media for reuse.

Syntax
nvreusemedia [-servername <Server Name>] -barcode <Barcode> |
-medialabel <Media Label> | -slotspec <Library Name::Slot Number>
Options
Table 45. 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.

Notes
•
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, Dell DR Series System, and Data Domain System.

nvscanmedia

Description

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.

You cannot use this utility to scan disk-based storage systems such as Quest NetVault SmartDisk, Dell DR Series System, and Data Domain System.

Syntax
nvscanmedia [-servername <Server Name>]
-barcode <Barcode> | -medialabel <Media Label> |
-slotspec <Library Name::Slot Number> | -rasdevice <Device name>
-scanall | -force -minlifedays <Minimum Life> [-wait]
Options
Table 46. nvscanmedia
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.

-scanall

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".

-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.

-rasdevice

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

-force

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

-minlifedays

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.

-wait

Waits until the task has completed.

nvsyncronizesilomedia

Description

Allocates all the known media in the specified ACSLS library.

Syntax
nvsyncronizesilomedia [-servername <Server Name>] -libraryname <Library Name>
Options
Table 47. nvsyncronizesilomedia
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.

-libraryname

Specifies the name of the target library.

Related Documents