Chat now with support
Chat with Support

NetVault 13.0.1 - CLI Reference Guide

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

nvlibrarymodify

Description

Use this utility to perform the following tasks:

•
Change the drive status to online or offline
•
Remove a library
•
Map or unmap drives
•
List all library drives
•
Add a drive or shared drive
Syntax
nvlibrarymodify [-servername <server_name>] -libraryname <library_name>
[-online “DRIVE <drive_number>”] [-offline “DRIVE <drive_number>”]
[-remove “DRIVE <drive_number>” ]
[-map “DRIVE <drive_number> <lsm>,<panel>,<drive>” [-name “<Drive_Name>”] ]
[-unmap “DRIVE <drive_number>” ] [-list]
nvlibrarymodify [-servername <server_name>] -libraryname <library_name>
[-librarymachine <library_machine>] [-drivemachine <drive_machine>]
-drivepath <drive_path> -add “DRIVE <drive_number>”
-addshared “DRIVE <drive_number>”
Options

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

 
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.

Notes
•
This command removes only those drives that are idle or offline. After removing a drive, the message “Device removed DRIVE <#>:<Drive Name>” displayed on the screen and the View Logs page on WebUI.
•
Only one attempt is made to remove a filer-attached drive. If the target drive is busy, the message “Failed to delete busy device DRIVE <#>:<Drive Name>” is displayed on the screen and the utility moves on to the next drive.
•
If all drives in a library are removed, the node representing the library arm is also removed.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating