Chat now with support
Chat with Support

NetVault 13.1.2 - CLI Reference Guide

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

nvsetmedia

Select or deselect the media to specify read-only, reusable, and read/write operation.

NOTE: The nvsetmedia command accepts only one operation at a time.
Table 35.  nvsetmedia

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

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.

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

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.

nvbulkblankmedia

Blanks one or more media items in the specified library.

-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 “media*star”, 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.

nvexportmedia

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

Table 37. nvexportmedia

-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

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

Table 38. nvlabelmedia

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

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

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating