NetVault 12.3 - CLI Reference Guide

Table 23. nvlibrarymodify — 1
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 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.

Table 24. nvlibrarymodify — 2
Option	Description
-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.

Notes

•

When you add a drive using the nvlibrarymodify utility, the library configuration is changed as follows:

•

If one or more jobs are running, the drive is appended to the existing library configuration without affecting the running jobs.

•

If no jobs are running, the existing library configuration is removed and the library is re-added.

•

This utility cannot be used to modify an existing drive in a library. It can only be used to modify an existing library configuration by adding a drive to it.

•

If you omit the options "-servername", "librarymachine" and "drivemachine" then, by default, the local machine is used as the default for the target server.

Examples

•

Add a drive to a VTL named “NewLibrary” located in the directory “/home/qauser1/” on a Linux-based NetVault BackupServer “tstserver”:

nvlibrarymodify -servername tstserver -libraryname "/home/qauser1/NewLibrary” -librarymachine tstserver -drivemachine tstserver
-drivepath "/home/qauser1/NewLibrary/drives/2” -add "DRIVE 2”

•

Add a drive to a SCSI library “winserver: 2-0.4.0 (SONY LIB-304)” that is connected to a Window-based NetVault Backup Server “winserver”:

nvlibrarymodify -servername winserver -libraryname "2-0.4.0 (SONY LIB-304)”
-librarymachine winserver -drivemachine winserver
-drivepath "2-0.2.0 (SONY SDX-500C)” -add "DRIVE 2”

•

Add a drive to an NDMP filer-attached device. The device name is “Device f880:mc9(OVERLAND LXB)” and the NetVault Backup Server name is “tstserver”:

nvlibrarymodify -servername tstserver
-libraryname "Device f880:mc9(OVERLAND LXB)” -librarymachine tstserver
-drivemachine tstserver -drivepath "Tape f880:nrst17a(HP Ultrium 3-SCSI)”
-add "DRIVE 2”

•

Add a SCSI drive to a Windows-based NetVault Backup Client named “winclient.” The ACSLS library is attached to a Linux-based NetVault Backup Server “tstserver”:

nvlibrarymodify -servername tstserver
-libraryname "ACS0(StorageTek ACSLS/LibStation)”
-librarymachine tstserver -drivemachine winclient
-drivepath "2-0.2.0 (SONY SDX-500C)” -add "DRIVE 2”

•

Add a SCSI drive to a Windows-based NetVault Backup Client named “winclient.” The ACSLS library is attached to a Windows-based NetVault Backup Client “client2” and controlled by NetVault Backup Server “tstserver”:

nvlibrarymodify -servername tstserver
-libraryname "ACS0(StorageTek ACSLS/LibStation)”
-librarymachine client2 -drivemachine winclient
-drivepath "2-0.2.0 (SONY SDX-500C)” -add "DRIVE 2”

nvopendoor

Description

Opens the door of the specified library.

Syntax

nvopendoor [-servername <server name>] -libraryname <library name>

Options

Table 25. nvopendoor
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.

nvopeneeport

Description

Opens the entry/exit port (EEPort).

Syntax

nvopeneeport [-servername <server name>] -libraryname <library name>

Options

Table 26. nvopeneeport
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.

nvremovefiler

Description

Removes filer-attached drives for the specified filer.

Syntax

nvremovefiler [-servername <server name >] -filername <filer name> [-wait]

Options

Table 27. nvremovefiler
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.
-filername	Specifies the name of the target filer.
-wait	Waits until the task has completed.