NetVault 13.1.2 - CLI Reference Guide

Table 35. nvsetmedia
Option	Description
-servername	Specifies the name of the NetVault 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 library that contains the target media item.
-drivename	Specifies the name of the drive that contains the target media item.
-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” If the media label is not unique for media in all available devices, use this option with either -libraryname or -drivename.
-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

nvsetmedia allows you to perform various operations like read-only, unusable, usable, and read/write.

•

The -readonly operation marks the media item in read-only mode, and no write operation is permitted. However the media allows you to restore the backup job.

•

The -unusable operation marks the media item as unusable, in case the media is damaged or not suitable for use. It can be viewed but no operations can be performed (read or write).

•

The -usable operation marks the media item as usable.This operation does not change the previous state (readonly or readwrite) of the media.

•

The -readwrite operation marks the media item as read/write and can perform both the operations.

Examples

The media is marked as readonly, with a barcode CHK2Y005 in “Windows_Library” library attached locally to server “VM-WIN2012-R2”.

./nvsetmedia –servername “VM-WIN2012-R2” -readonly -barcode "CHK2Y005"

The media is marked as readwrite, and is labeled with “Media5” in the “TapeLibrary” which is locally attached to the NetVault Server.

./nvsetmedia -readwrite -medialabel "Media5"

The media is marked as usable, in slot 5 of the library ‘VTL’ that is locally attached to the NetVault Server.

nvsetmedia.exe –usable -slotspec “VTL::5”

nvbulkblankmedia

Description

Blanks one or more media items in the specified library.

Syntax

nvbulkblankmedia -libraryname <Library Name> -medialabel <Media Label>
[-allmedia] ‑password <Password> [-wait]

Options

Table 36. nvbulkblankmedia
Option	Description
-libraryname	Specifies the name of the library that contains the target media item.
-barcode	Specifies the barcode of the target media item.
-medialabel	Specifies the label of the target media item. This option supports the wildcard character “” that can be used to represent a string of characters. If a media label contains the character “”, use the backslash character (\) to escape “”. For example, to blank media items with the label “mediastar”, use the ‑medialabel option as follows: -medialabel “media\*star
-allmedia	Blanks all media items in the specified library.
-password	Specifies the password for the NetVault Server. If no password is set for the NetVault Server, provide the system's root or administrator password.
-wait	Waits until the task has completed.

Notes

•

The blanking operation removes the NetVault header from a tape and deletes the media label and removes any group association. After blanking, a tape becomes available to NetVault for storing future backups.

•

The blanking operation deletes or erases the backup data residing on a tape. To purposely destroy the data that is stored on a tape, you must blank it from NetVault and have its data securely removed by tools that are designed for such purposes.

•

The blanking operation removes the indexes for backups stored on the selected tapes from the NetVault Database.

•

This command does work on servers on which security is disabled.

•

The library name and media labels are case-sensitive.

Examples

•

Blank all media that reside in the library “ADICLib_1” and use the label “Full Backup Group 7”:

nvbulkblankmedia -libraryname ADICLib_1 -medialabel “Full Backup Group 7”
-password ServerPwd

•

Blank all media reside in the library “ADICLib_1” and use labels that begin with “C2-Backups”:

nvbulkblankmedia -libraryname ADICLib_1 -medialabel “C2-Backups*”
-password ServerPwd

nvexportmedia

Description

Exports a piece of media from a tape library to its entry/exit port (EEPort).

Syntax

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

Options

Table 37. nvexportmedia
Option	Description
-servername	Specifies the name of the NetVault 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.
-wait	Waits until the task has completed.

nvlabelmedia

Description

Use this utility to label new media items or re-label existing media items.

Syntax

nvlabelmedia [-servername <Server Name>] -barcode <Barcode> |
-medialabel <Media Label> | -slotspec <Library Name::Slot Number>
-newlabelname <New Media Label> [-newgroupname <New Media Group Name>]
[-newoffsitelocation <New Offsite Location Name>] [-wait]

Options

Table 38. nvlabelmedia
Option	Description
-servername	Specifies the name of the NetVault 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.
-newlabelname	Specifies the new label for the selected piece of media. If the new media label contains spaces, use underscores (“_”) in their place. Example: “new_label_1”
-newgroupname	Specifies the new media group for the selected media piece of media. If the media group label contains spaces, use underscores (“_”) in their place. Example: “new_group_1”
-newoffsitelocation	Specifies the new offsite location for the selected piece of media.
-wait	Waits until the task has completed.

Notes

•

To re-label media items that contain existing backups, you first blank it using the nvblankmedia or mark it for reuse using the nvreusemedia command.

•

The offsite location of the media can be changed without blanking the media or marking it for re-use. This property is set or changed using the -newoffsitelocation option.

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

NetVault 13.1.2 - CLI Reference Guide

nvsetmedia

nvbulkblankmedia

nvexportmedia

nvlabelmedia