vmoprcmd

vmoprcmd — perform operator functions on drives

SYNOPSIS

<volmgr_dir_path>vmoprcmd -devmon [pr | ds | hs] [-h device_host] default_operation

<volmgr_dir_path>vmoprcmd -dp [pr | ds | ad] [-h device_host]

<volmgr_dir_path>vmoprcmd -down | -up | -upopr | -reset drive_index [-h device_host]

<volmgr_dir_path>vmoprcmd -downbyname | -upbyname | -upoprbyname | -path drive_path] [-nh ndmp_hostname] [-h device_host]

<volmgr_dir_path>vmoprcmd -resetbyname drive_name [-h device_host]

<volmgr_dir_path>vmoprcmd -assign drive_index mount_request_id [-h device_host]

<volmgr_dir_path>vmoprcmd -assignbyname drive_name mount_request_id [-h device_host]

<volmgr_dir_path>vmoprcmd -deny | -resubmit mount_request_index [-h device_host]

<volmgr_dir_path>vmoprcmd -comment drive_index ["comment"] [-h device_host]

<volmgr_dir_path>vmoprcmd -commentbyname drive_name ["comment"] [-h device_host]

<volmgr_dir_path>vmoprcmd -crawlreleasebyname drive_name [-h EMM_Server]

<volmgr_dir_path>vmoprcmd [-activate_host | -deactivate_host] [-h device_host]

<volmgr_dir_path>vmoprcmd -hoststatus [-h device_host]

On Windows systems, <volmgr_dir_path> is <install_path>\Volmgr\bin\

DESCRIPTION

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 hostname 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. Please use tpconfig -dl to obtain the full drive name.

vmoprcmd may truncate drive names to 20 characters.

EXAMPLES

EXAMPLE 1

The following command sets the drive, with a drive index of 0, to UP mode:

# vmoprcmd -up 0

EXAMPLE 2

The following command displays the drive status of all drives:

# vmoprcmd -d ds

EXAMPLE 3

The following command displays pending requests and the drive status of all drives on the device host named crab:

# vmoprcmd -h crab

EXAMPLE 4

The following command demonstrates 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}