NetVault Backup 12.3 - CLI Reference Guide

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

nvacslsmedia

Performs the following functions:

Table 11. nvacslsmedia

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

-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 Backup distribution installed on the machine.

nvaddfiler

Adds an NDMP filer to the NetVault Backup Server.

Table 12. nvaddfiler

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

-clientname

Specifies the name of the NetVault Backup 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 Backup 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:

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 Backup Plug-in for NDMP User’s Guide.

nvcheckdrive

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 Backup for future jobs.

Table 13. nvcheckdrive

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

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

nvcleandrive

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.

Table 14. nvcleandrive

-libraryname

Specifies the name of the target library.

-drivenumber

Specifies the drive number of the target drive that you want to clean.

Documents connexes