Chat now with support
Chat with Support

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

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