NetVault 13.1.2 - CLI Reference Guide

Table 23. nvlibrarymodify — 1
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 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 Server or Client on which the library resides. It can be any NetVault machine, not necessarily the server. It can also be a NetVault Client with ACSLS drives attached to a third machine.
-drivemachine	Specifies the name of the NetVault Server or Client on which the drive resides. In an ACSLS environment, the drives can reside on a client; the NetVault 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 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 Server “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 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 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 Client named “winclient.” The ACSLS library is attached to a Linux-based NetVault 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 Client named “winclient.” The ACSLS library is attached to a Windows-based NetVault Client “client2” and controlled by NetVault 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 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 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 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.