Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
vmoprcmd — perform operator functions on drives
SYNOPSIS
-devmon [pr | ds | hs] [-h device_host] default_operation
-dp [pr | ds | ad] [-h device_host]
-down | -up | -upopr | -reset drive_index [-h device_host]
-downbyname | -upbyname | -upoprbyname | -path drive_path] [-nh ndmp_hostname] [-h device_host]
-resetbyname drive_name [-h device_host]
-assign drive_index mount_request_id [-h device_host]
-assignbyname drive_name mount_request_id [-h device_host]
-deny | -resubmit mount_request_index [-h device_host]
-comment drive_index ["comment"] [-h device_host]
-commentbyname drive_name ["comment"] [-h device_host]
-crawlreleasebyname drive_name [-h EMM_Server]
[-activate_host | -deactivate_host] [-h device_host]
-hoststatus [-h device_host]
On UNIX systems, the directory path to this command is /usr/openv/volmgr/bin/
On Windows systems, the directory path to this command is install_path\Volmgr\bin\
DESCRIPTION
This command lets you perform operator functions on drives. The -h option is not required, but you must choose only one of the following other options.
Non NDMP Windows device paths appear as {p,b,t,l}: where p is the port, b is the bus, t is the target, and l is the LUN. When vmoprcmd is run by using the -path argument, specify the path in the {p,b,t,l} format.
Any authorized user can run this command.
For more information about NetBackup authorization, refer to the NetBackup Security and Encryption Guide.
OPTIONS
- -assign drive_index mount_request_id
Assign a drive to a mount request.
- -assignbyname drive_name mount_request_id
This option is similar to the -assign option, except the drive name specifies the drive instead of the drive index.
The following point applies only to NetBackup server:
The device host is the host where Media Manager is installed.
- -comment drive_index ["comment"]
Add a comment for the drive. The quotes are required if your comment contains any spaces. If you do not specify comment, any existing comments for the drive are deleted.
- -commentbyname drive_name ["comment"]
This option is similar to the -comment option, except the drive name specified the drive instead of drive index.
- -crawlreleasebyname drive_name
This option is only applicable for NetBackup Enterprise Server.
This option forces all hosts (that are registered to use the drive) to issue a SCSI release command to the drive. Issue this option on the host that is the SSO device allocator (DA host) or use the -h option to specify the DA host.
Caution:
Use this option after a PEND status has been seen in Device Monitor. Do not use this option during backups.
- -down | -up | -upopr | -reset drive_index
-down Sets the drive to the DOWN state, if it is not assigned.
-up Sets the drive to the UP position in Automatic Volume Recognition (AVR) mode. This mode is the normal mode for all drives.
-upopr Sets the drive to the UP position in Operator (OPR) mode. This mode is normally used only for security reasons. For a drive in a robot, OPR and AVR are treated identically while the robot daemon or process is running.
-reset Resets the specified drive. Also, it unloads the drive (if not assigned in the EMM database). You can use the unload capability to unload the media that is stuck in the drive.
- -downbyname | -upbyname | -upoprbyname | -resetbyname drive_name
These options are similar to -down, -up, -upopr, and -reset respectively, except the drive name specifies the drive instead of the drive index.
- -deny | -resubmit mount_request_id
-deny Denying a mount request returns an error message to the user.
-resubmit Resubmit a mount request. If a pending action message involves a robot, you must correct the problem and resubmit the request that caused the message.
- -dp [pr | ds | ad]
If none of the following optional display parameters are specified, all information is displayed.
pr - Displays any pending requests.
ds - Displays the status of drives under control of Media Manager.
ad - Displays additional status of drives under control of Media Manager.
- -devmon [pr | ds | hs] default_operation
The -dp command lists all of the drive paths that are configured for a given drive name. If none of the following optional display parameters are specified, all information is displayed.
pr Displays any pending requests.
ds Displays the status of drives under control of Media Manager.
hs Displays additional status of drives under control of Media Manager.
- -h EMM_Server | device host
Name of the Enterprise Media Manager database host where the drives are attached and configured. If no host option is specified, the device host where you run the command is default.
The device host is the host where the device is attached and configured.
- -hoststatus
Displays the current status of the host. The following states can appear:
DEACTIVATED - This state prevents any new jobs from starting on this host.
ACTIVE - The media server is available to run any jobs.
ACTIVE-DISK - The media server is available to run jobs for disk storage units only.
ACTIVE-TAPE - The media server is available to run jobs for tape storage units only.
OFFLINE - The media server is not available to run jobs for either tape storage units or disk storage units. This state occurs because the media server is not active for tape or disk, or because the master server cannot communicate with the media server.
- -nh ndmp_hostname
Specifies the host name of the NDMP server.
- -activate_host
Makes the host available to run jobs.
- -deactivate_host
Makes the host unavailable to run jobs.
- -path drivepath
Specifies the system name for the drive. For example, /dev/rmt/0cbn.
- -setpath drivepath drive_name ndmp_hostname
Specifies the system name and the drive name of the NDMP host.
NOTES
Only limited validation of the option parameters is done.
tpconfig -d, tpconfig -l, and vmoprcmd may truncate long drive names. Use tpconfig -dl to obtain the full drive name.
vmoprcmd may truncate drive names to 20 characters.
EXAMPLES
Example 1 - Set the drive, with a drive index of 0, to UP mode:
# vmoprcmd -up 0
Example 2 - Display the drive status of all drives:
# vmoprcmd -d ds
Example 3 - Display pending requests and the drive status of all drives on the device host named crab:
# vmoprcmd -h crab
Example 4 - Demonstrate how non-NDMP Windows device paths appear.
# vmoprcmd HOST STATUS Host Name Version Host Status ========================================= ======= =========== hamex 600000 ACTIVE PENDING REQUESTS <NONE> DRIVE STATUS Drive Name Label Ready RecMID ExtMID Wr.Enbl. Type Host DrivePath Status =================================================================== IBM.ULTRIUM-TD2.001 No No No hcart2 hamex {3,1,0,2} TLD hamex {3,1,1,2} TLD IBM.ULTRIUM-TD1.004 No No No hcart hamex {3,1,0,7} TLD hamex {3,1,1,7} TLD IBM.ULTRIUM-TD2.005 Yes Yes J945L2 Yes hcart2 hamex {3,1,2,1} TLD IBM.ULTRIUM-TD2.006 No No No hcart2 hamex {3,1,2,2} TLD # vmoprcmd -downbyname IBM.ULTRIUM-TD1.004 -path {3,1,0,7}