Chat now with support
Chat with Support

NetVault 11.4.5 - CLI Reference Guide

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

nvacslsmedia

Description

Performs the following functions:

•
Allocates media to an ACSLS Library.
•
De-allocates specified media.
•
Ejects a piece of media
Syntax
nvacslsmedia [-allocate | -deallocate | -eject] [-medialabel <Media Label>]
[-cap <acs>,<lsm>,<cap>] -libraryname <Library Name> [-servername <Server Name>]
[-range <range-media >] [-file <Filename >] [-version]
Options
 
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 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

Description

Adds an NDMP filer to the NetVault Backup 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>]
Options
 
Table 12. nvaddfiler
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.

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

•
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 Backup Plug-in for NDMP User’s Guide.
Examples
•
Add filer “f740” to the local NetVault Backup 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 Backup 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 Backup 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 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.

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

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating