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

nvsvtlgrow

Description

Performs the following functions:

•

Displays status and usage details of a specific SVTL or all SVTLs on the current system.

•

Performs a test or dummy expansion of an SVTL by a given number of media items of a given size.

•

Performs an actual expansion of an SVTL by a given number of media items of a given size.

This utility is located in the <NetVault Backup home>\bin directory.

Syntax

nvsvtlgrow display [-device <SVTL Device>]

nvsvtlgrow test -device <SVTL Device> -size <Media Size> -count <Media Count>

nvsvtlgrow grow -device <SVTL Device> -size <Media Size> -count <Media Count>

Table 33. nvsvtlgrow

Displays all SVTLs on the machine.

To display the status of a single SVTL on the machine, use the following command:

nvsvtlgrow display -device <svtl-device>

test

Performs a test expansion. Use the following options with test.

•

-device: Specifies the name of the target SVTL.

•

-size: Specifies the size of the media (for example, 800m for 800MB, 40g for 40GB, 2t for 2TB).

•

-count: Specifies the number of media items that you want to add.

The utility checks these values against the available space and reports whether it would be possible to create these media items. No changes are made to the SVTL.

grow

Expands the SVTL capacity. Use the following options with grow.

•

-device: Specifies the name of the target SVTL.

•

-size: Specifies the size of the media (for example, 800m for 800MB, 40g for 40GB, 2t for 2TB).

•

-count: Specifies the number of media items that you want to add.

The nvsvtlgrow utility checks the options and on confirmation from the user adds new media items to expand the SVTL size. Re-add the SVTL or restart the NetVault Backup Service to use the added media.

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