NetVault Backup 12.3 - CLI Reference Guide

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

nvlibrarymodify

Use this utility to perform the following tasks:

To change the drive status, map or unmap drives, display library drives, and remove a library, use the following options.

-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 library that you want to modify. The library name is mandatory.

-online

Brings a drive back online. Use the “DRIVE <drive_number>” option to specify the target drive.

-offline

Takes a drive offline. Use the “DRIVE <drive_number>” option to specify the target drive.

-remove

Removes a drive. Use the “DRIVE <drive_number>” option to specify the target drive.

-map

Maps a drive to the appropriate LSM, Panel and Drive. Use the “DRIVE <drive_number>” option to specify the target drive. You can also use the optional ‑name option can be used to specify a drive name.

Example:

-name “ACSLS_Drive-1”

-unmap

Unmaps a drive. Use the “DRIVE <drive_number>” option to specify the target drive.

-list

Displays all drives in the specified library.

To add a drive or shared drive to an existing library configuration, use the following options.

-servername

Specifies the name of the target server.

-libraryname

Specifies the name library that you want to modify.

-librarymachine

Specifies the name of the NetVault Backup Server or Client on which the library resides. It can be any NetVault Backup machine, not necessarily the server. It can also be a NetVault Backup Client with ACSLS drives attached to a third machine.

-drivemachine

Specifies the name of the NetVault Backup Server or Client on which the drive resides. In an ACSLS environment, the drives can reside on a client; the NetVault Backup Server or Client does not control the ACSLS library.

-drivepath

Specifies the name or path of the drive that you want to add. Depending on the drive type, the drive path can be a VTL directory or SCSI target.

You can use the nvscandrives utility to obtain a list of available drives on a local or remote NetVault Backup Client. The output of this command provides the drive path as it appears in the NetVault WebUI. For more information, see nvscandrives.

-add

Adds a drive. Use the “DRIVE <drive_number>” option to specify the target drive.

-addshared

Adds a shared drive. Use the “DRIVE <drive_number>” option to specify the target drive.

When you add a drive using the nvlibrarymodify utility, the library configuration is changed as follows:
If you omit the options "-servername", "librarymachine" and "drivemachine" then, by default, the local machine is used as the default for the target server.

nvopendoor

Opens the door of the specified library.

Table 25. nvopendoor

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

nvopeneeport

Opens the entry/exit port (EEPort).

Table 26. nvopeneeport

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

nvremovefiler

Removes filer-attached drives for the specified filer.

Table 27. nvremovefiler

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

-filername

Specifies the name of the target filer.

-wait

Waits until the task has completed.

Documents connexes