Chat now with support
Chat with Support

NetVault 13.0.2 - CLI Reference Guide

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

nvrda

Description

Adds or removes a Quest DR Series system.

Syntax
nvrda --add --host <Host name or IP Address> [--force]
[--server <NetVault Server Name>] --user <username> --password <password>
--lsu <Container name> [--blocksize <blocksize>]
--storage-group <storage group name>
[--stream-limit <stream limit count>]
--update --device <name> --user <name> --password <password>
[--blocksize <blocksize>] [--server <name>]
[--stream-limit <stream limit count>]
nvrda --remove --device <name> [--force] [--server <name>]
Options
 
Table 19. nvrda
Option
Description

--add

Adds a Quest DR Series system. Use the following options with --add.

•
--host: Specifies the DNS name or IP address of the Quest DR Series system.
The device is not added if the NetVault Server is unable to resolve the host name.
•
--force: Adds a Quest DR Series system even if the device is already added to another NetVault Server with the same name.
This option can be useful if you have performed a disaster recovery to rebuild the NetVault Server.
•
--server: Specifies the name of the NetVault Server to which you want to add the Quest DR Series system.
This option is not required if you are running the command on the server.

 
•
--user: Specifies the user account that can be used to log on to the device.
On the Quest DR Series system, only one user account exists, and the user ID for that account is backup_user.
•
--password: Specifies the password for the user account.
•
--lsu: Specifies the name of the storage container.
Ensure that the container is created before you add the device. The device is not added if the specified container does not exist on the device.
Each Quest DR Series system added to NetVault represents a storage container.
•
--storage-group: Specifies storage group name where the container resides. This option is mandatory for add operation.
When a new container is added and if it is the first container from DR, that DR is also attached to the NetVault.
•
--blocksize: Specifies the block size for data transfers. The block size is specified in number of bytes. The default value for this option is 512KiB.
•
--stream-limit: The default value for this option is 256 streams. This setting applies to all NetVault Servers to which the container is added. If the number of data streams exceeds the defined limit for the container, the Media Manager reports an error (“Device has too many streams”).
You can set the soft stream limit to any value between 1 and 512.
If the container is added to more than one NetVault Server, set the same soft stream limit on all servers.

--update

Modifies the settings for an existing Quest DR Series system. Use the following options with --update.

•
--device: Specifies the device name.
•
--user: Specifies the user account that can be used to log on to the device.
On the Quest DR Series system, only one user account exists, and the user ID for that account is backup_user. You can only change the password for this account; you cannot create an account or delete the existing account.
•
--password: Specifies the password for the user account.
•
--blocksize: Specifies the block size for data transfers. The block size in specified in number of bytes. The default value for this option is 512KiB.
•
--server: Specifies the name of the NetVault Server to which you want to add the Quest DR Series system.
This option is not required if you are running the command on the server.

 
•
--stream-limit: The default value for this option is 256 streams. This setting applies to all NetVault Servers to which the container is added. If the number of data streams exceeds the defined limit for the container, the Media Manager reports an error (“Device has too many streams”).
You can set the soft stream limit to any value between 1 and 512.
If the container is added to more than one NetVault Server, set the same soft stream limit on all servers.

--remove

Removes a Quest DR Series system. Use the following options with --remove.

•
--device: Specifies the name of the Quest DR Series system as it appears in the NetVault WebUI, CLI, and reports.
•
--force: Removes a Quest DR Series system even if the device cannot be contacted or some other errors block the removal.
•
--server: Specifies the name of the NetVault Server which you want to remove from the Quest DR Series system.

nvddboost

Description

Adds or removes an EMC Data Domain System.

Syntax
nvddboost --add --host <Host name or IP Address> [--force] [--user <username>]
[--password <password] [--lsu <LSU name>] [--blocksize <Block size>]
[--server <Server Name>]
nvddboost --remove --device <name> [--force] [--server <name>]
Options
 
Table 20. nvddboost
Option
Description

--add

Adds a Data Domain system. Use the following options with -add.

•
--host: Specifies the DNS name or IP address of the Data Domain system.
The device is not added if the NetVault Server is unable to resolve the host name.
•
--force: Adds a Data Domain system even if the device is already added to another NetVault Server with the same name.
This option can be useful if you have performed a disaster recovery to rebuild the NetVault Server.
•
--user: Specifies the DD Boost user account that can be used to log on to the device for backups and restores.
Ensure that the user account is created on the Data Domain system before the device is added to the server.
•
--password: Specifies the password for the user account.

 
•
--lsu: Specifies the name of the container for the Data Domain system. If the specified container does not exist on the Data Domain system, NetVault automatically creates it when you add the device to the server. You can configure multiple containers on a single Data Domain system.
Each Data Domain system added to NetVault represents a container.
The default value for this option is “NV.”
•
--blocksize: Specifies the block size for data transfers. The block size in specified in number of bytes. The default value for this option is 131,072 bytes.
•
--server: Specifies the name of the NetVault Server to which you want to add the Data Domain system. This option is not required if you are running the command on the server.

--remove

Removes a Data Domain system. Use the following options with -remove.

•
--device: Specifies the name of the Data Domain system as it appears in the NetVault WebUI, CLI, and reports.
•
--force: Removes a Data Domain system even if the device cannot be contacted or some other errors block the removal.
Notes
•
When you add a Data Domain system, NetVault creates several metadata files on the device. Each NetVault Server (to which you add the Data Domain system) creates is its own set of metadata files. NetVault also writes the data transfer statistics to the stats.stnz file. The nvstatsmngr process uses this file and requires that it is regularly updated. However, frequent updates can have a significant performance impact on the system. By default, NetVault updates the file after every 5 seconds or 10 blocks of data transfer. To change the default setting, see the Quest NetVault Administrator’s Guide.

nvdevice

Description

Performs the following tasks:

•
Checks drives
•
Cleans drives
•
Ejects media
•
Brings a drive online
•
Takes a drive offline
Syntax
nvdevice [-status] [-library <Library Name>] -drive <Drive Name>]
nvdevice [-status] [-check] [-clean] [-eject] [-online] [-offline]
[-library <Library Name>] -drive <Drive Name>
nvdevice -version
Options
 
Table 21. nvdevice
Option
Description

-status

Shows the status of the specified drive. Use the ‑library and -drive options to specify the target drive.

If you do not specify the library and drive, the command displays the status of all devices attached to the machine.

-check

Checks status of the specified drive. For example, it can be used to check the status of a drive that was taken offline for some reason. If successful, the specified drive is brought back online so that it is available to NetVault for future jobs. Use the ‑library and -drive options to specify the target drive.

-clean

Sends request for cleaning the specified drive. If the number of cleaning lives has been set for the cleaning tape, it is reduced by one when used for this process. Use the ‑library and -drive options to specify the target drive.

-eject

Ejects a piece of media from the specified drive. Use the -library and -drive options to specify the target drive.

-online

Brings a drive back online. Use the -library and -drive options to specify the target drive.

-offline

Takes a drive offline. Use the ‑library and -drive options to specify the target drive.

-library

Specifies the name of the target library.

-drive

Specifies the drive name of the target drive.

-version

Displays the version number of the CLI tools.

Use the -library and -drive options to specify the target drive while performing -offline, -online, and -check operations on a drive unless the drive is a standalone drive.

Notes
•
For Tape library/VTLs, Library Name is mandatory for nvdevice -online, -offline, and -check parameters.

nvdeviceeject

Description

Ejects a piece of media from the specified drive.

Syntax
nvdeviceeject -devicename <Device Name> [-servername <Server Name>]
[-librarydrivenumber <Drive Number>] [-wait]
Options
 
Table 22. nvdeviceeject
Option
Description

-devicename

Specifies the name of the target device or library.

-servername

Specifies the name of the NetVault Server to which the device is added.

When you run this command on the server, this option can be omitted.

The server name is case-sensitive.

-librarydrivenumber

Drive number of the target drive in the library

-wait

Waits until the task has completed.

Notes
•
The option -librarydrivenumber must be used with -devicename to specify the target drive.
•
The device names can be ascertained by inspecting the logs for the backup job.
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating