NetVault 13.0.2 - CLI Reference Guide

Table 11. nvacslsmedia
Option	Description
-allocate	Allocates specified media items.
-deallocate	De-allocates specified media items.
-eject	Ejects the specified media items through the specified Cartridge Access Port (CAP).
-cap	Specifies the Cartridge Access Port (CAP) through which to eject the media items. Provide the ACS number of the library, LSM number of the robotic unit that controls the library, and physical number of the CAP. Use comma to separate the numeric values. Example: -cap 0,0,0
-medialabel	Specifies the label or barcode of the media items that you want to allocate, de‑allocate, or eject from the library. For multiple labels or barcodes, provide a comma-separated list.
-libraryname	Specifies the name of the target library.
-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.
-range	Specifies a range of media labels or barcode values that correspond to the pieces of media that you want to de-allocate. Use a hyphen (without any spaces) between the values.
-file	Specifies the name of the file that contains a list of media labels or barcodes corresponding to the set of media items that you want to de-allocate. Only one media label or barcode can be specified per line.
-version	Displays build date of the NetVault distribution installed on the machine.

nvaddfiler

Description

Adds an NDMP filer to the NetVault Server.

Syntax

nvaddfiler [-servername <Server Name>] [-clientname <Client Name>]
[-pluginname <Plug-in Name>] -filername <Filer Name> -address <IP address or FQDN> [-port <Port number>] -account <User Name> -password <Password>
[-description <Description>] [-utf8 <Boolean>]

Table 12. nvaddfiler

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.

-clientname

Specifies the name of the NetVault Client to which the filer is added.

This option can be omitted if you want to add the filer to the local machine. If you specify -servername, you must also specify -clientname even if they are the same machine.

-pluginname

Specifies the plug-in name. It can be NDMP Client or NDMP SnapMirror to Tape. The default value is NDMP Client.

-filername

Specifies the filer name.

The filer name must be unique. You can assign the actual name of the filer to easily identify it in the NetVault environment. The filer name cannot be changed once it is configured.

-address

Specifies the IP4 address or FQDN of the filer.

-port

Specifies the listen port for the filer. The default value is 10000.

Unless otherwise required, do not change listener port for the filer.

-account

Specifies the name of the user account that can be used to log on to the filer. The user account must have necessary permissions to perform NDMP backups and restores.

-password

Specifies the password for the user account.

-description

Provides NDMP filer description when filer type needs to be selected. The description must match the corresponding entry in the ndmpversions.cfg file.

-utf8

Specifies whether UTF-8 conversions are required or not.

The default value for this option is FASLSE. Set it to TRUE if you want to correctly display the directory and filenames in the set locale on NetVault WebUI. You can use this option only if the file supports UTF-8 encoding. To use this feature, do the following:

•

Enable UTF-8 conversion on the filer.

•

Set the appropriate language-type on each target volume.

•

Set the configuration option Codepage for UTF-8 Conversions for the Plug-in for NDMP. For more information about this option, see the Quest NetVault Plug-in for NDMP User’s Guide.

Examples

•

Add filer “f740” to the local NetVault machine:

nvaddfiler -filername f740 -address 10.11.22.53 -account root
-password mypassword

•

Add filer “f740” to “Client-A” that is controlled by the local NetVault Server:

nvaddfiler -clientname Client-A-filername f740 -address 10.11.22.53 -account root -password mypassword

•

Add filter “f740” to the remote server named “Win-Server”:

nvaddfiler -servername Win-Server -clientname Win-Server -filername f740
-address 10.11.22.53 -account root -password mypassword

nvcheckdrive

Description

Checks the status of a drive. For example, it can be used to check the status of a drive that was taken offline for some reason. If successful, the specified drive is brought back online so that it is available to NetVault for future jobs.

Syntax

nvcheckdrive -servername <Server Name> [-drivename <Drive Name>]
[-libraryname <Library Name>] [-drivenumber <Drive Number>]

Options

Table 13. nvcheckdrive
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 target library.
-drivename	Specifies the name of the target drive that you want to check.
-drivenumber	Specifies the drive number of the target drive that you want to check.

Notes

•

The option -drivename or -drivenumber must be used with ‑libraryname to specify the target drive.

Examples

•

Check the status of standalone drive “D-1” that is locally attached to the server:

nvcheckdrive -drivename D-1

•

Check the status of “Drive2” in library “NVLibrary” that is locally attached to the client “NVCLIENT1”:

nvcheckdrive -servername NVCLIENT1 -libraryname NVLibrary -drivename Drive2

•

Check the status of drive 2 in library “NVLib2” that is locally attached to the remote server “NVSERVER2”:

nvcheckdrive -servername NVSERVER2 -libraryname NVLib2 -drivenumber 2

nvcleandrive

Description

Cleans a library drive. If the number of cleaning lives has been set for the cleaning tape, it is reduced by one when used for this process.

Syntax

nvcleandrive -libraryname <Library Name> -librarydrivenumber <Drive Number>

Options

Table 14. nvcleandrive
Option	Description
-libraryname	Specifies the name of the target library.
-drivenumber	Specifies the drive number of the target drive that you want to clean.

Examples

•

Clean drive 1 of the library “SONY LIB-162” using predefined cleaning media:

nvcleandrive -libraryname “SONY LIB-162” librarydrivenumber 1

Please select your product:

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

Recommended Solutions for Your Problem

NetVault 13.0.2 - CLI Reference Guide

nvacslsmedia

nvaddfiler

nvcheckdrive

nvcleandrive