NetVault 11.4.5 - CLI Reference Guide

--host: Specifies the DNS name or IP address of the host on which the Quest NetVault SmartDisk is installed. You must configure this option even if the device is deployed on the NetVault Backup Server. The device is not added if the NetVault Server is unable to resolve the host name.

•

--force: Adds a Quest NetVault SmartDisk even if the device is already added to another NetVault Backup Server with the same name. This option can be useful if you have performed a disaster recovery to rebuild the NetVault Backup Server.

•

--port: Specifies the port for communicating with the Quest NetVault SmartDisk instance. This option is only required if device is configured to use a non-default port.

•

--server: Specifies the name of the NetVault Backup Server to which you want to add the device. This option is not required if you are running the command on the server.

--remove

Removes a Quest NetVault SmartDisk. Use the following options with -remove.

•

--device: Specifies the name of the Quest NetVault SmartDisk as it appears in the NetVault WebUI, CLI, and reports.

•

--force: Removes a Quest NetVault SmartDisk even if the device cannot be contacted or some other errors block the removal.

--list

Lists the machine names of all Quest NetVault SmartDisk instances added to the NetVault Backup Server.

Media-specific utilities

•

•

•

•

•

•

•

•

•

nvsyncronizesilomedia

•

•

•

•

•

•

To identify a piece of media in a CLI command, you can use its barcode, media label, or slot position within a library.

•

If a media label contains spaces, enclose it within quotation marks (“”).

•

Various operating systems do not support special characters such as the following in a media label:

: ! @ # $ % ^ & * ( ) > < \ [ ] { } “ ”

Therefore, if a CLI command is issued to call out a piece of media whose label contains one of these characters, the command may fail with an error message. Media labels that include any of these characters can only be managed from the WebUI.

nvblankmedia

Description

Blanks a piece of media.

Syntax

nvblankmedia [-servername <Server Name>] [-libraryname <Library Name>]
-barcode <Barcode> | -medialabel <Media Label> |
-slotspec <Library Name::Slot Number> [-drivename <Standalone Drive Name>] [-wait]

Options

Table 33. nvblankmedia
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 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. 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.
-drivename	Specifies the name of the drive that contains the target media item. This option is ignored when the target media is already loaded in a drive; the media item is blanked even if you specify an incorrect drive.
-wait	Waits until the task has completed.

Notes

•

The blanking operation removes the NetVault Backup header from a tape and deletes the media label and removes any group association. After blanking, a tape becomes available to NetVault Backup 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 Backup 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.

•

When an incorrect library and media pair is specified, the following error message is displayed:

Blank request failed! - 'Unable to identify media'

Examples

•

Blank a piece of media in slot 21 of the library “NV_Library_Large” that is locally attached to a client “NVCLIENT1”:

nvblankmedia -servername NVCLIENT1 -slotspec 21::“NV_Library_Large”

•

Blank a piece of media labeled “DB-Backup” in library “Lib-2” that is connected a client named “NVCLIENT2”:

nvblankmedia -libraryname "NVCLIENT2: Lib-2" -medialabel "DB-Backup"

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 34. 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 Backup Server. If no password is set for the NetVault Backup Server, provide the system's root or administrator password.
-wait	Waits until the task has completed.