hpvmhostrdev(1M)

NAME

hpvmhostrdev — Manages virtual machine access to devices used by the Integrity VM Host system.

SYNOPSIS

hpvmhostrdev [-D | -E | -d | -h | -r | -u]

DESCRIPTION

The hpvmhostrdev command manages virtual machine access to devices — disks and volumes — used by the VM host system. The Integrity VM device-management database (hpvmdevmgmt (1M) provides the capability to restrict virtual machine access to devices used by the VM Host. The hpvmhostrdev command can automatically identify storage used by the VM Host physical system and restrict that storage from being used by virtual machines. This identification is consistent with that of system management tools such as the HP System Management Homepage (HP SMH) and the HP System Administration Manager (HP SAM).

When executed without any options or with the -u option, the hpvmhostrdev command operates as follows:

Any devices previously identified and restricted by the hpvmhostrdev command are removed from the Integrity VM device database if they are no longer used by the VM Host system. Subsequently, such devices become available for use by virtual machines. All device currently used by the VM Host system are identified and restricted by the hpvmhostrdev command.
To restrict a device from use by virtual machines, hpvmhostrdev inserts an entry for that device into the Integrity VM device database as a restricted device with the attribute AUTODEV set to YES (see the hpvmdevmgmt (1M) command).
By default, hpvmhostrdev -u is executed during startup of the Integrity VM software. This startup execution can be enabled or disabled with the -E or -D options, respectively.
Execution of the hpvmhostrdev command without any option causes the VM Host system to rescan its storage devices and might take some time to execute.
NOTE: Do not use the -u option immediately after hardware has been added online (that is, without rebooting the VM Host system to add the hardware).
The hpvmhostrdev command restricts only the user of disks and logical volumes used by the VM Host system for its swap space, file systems, or (in the case of disks), logical volume groups. Any unused devices are ignored (that is, not restricted) by hpvmhostrdev.
When hpvmhostrdev is executed with the -u, the -d, or without any options, it creaets a backup copy of the Integrity VM Host device database. This copy can be recovered using the -r option.




	NOTE: Only a superuser may execute the hpvmhostrdev command.

Options

The hpvmhostrdev command recognizes the following command-line options:

-D

Disables execution of hpvmhostrdev during startup of the Integrity VM software. Subsequent startup of the Integrity VM system (that is, /sbin/init.d/hpvm start), does not automatically identify, update, and restrict use of the VM Host system's storage devices. Note that this option does not remove restricted device entries form the Integrity VM device database.

-E

Enables automatic execution of hpvmhostrdev during startup of the Integrity VM software. Subsequent startup of the Integrity VM system (that is, /sbin/init.d/hpvm start), automatically identifies, updates, and restricts use of the VM Host system's storage devices. Note that execution of hpvmhostrdev -E does not — by itself — add restricted device entries to the Integrity VM device database.

-d

Removes restricted device entries from the Integrity VM device database that were previously added by execution of the hpvmhostrdev command. Such devices are no longer restricted from use by virtual machines.




	NOTE: Any devices explicitly restricted through use of the hpvmdevmgmt `-a` `rdev` command are not removed by execution of the hpvmhostrdev command.

-h

Displays a brief overview of the hpvmhostrdev command.

-r

Restores the Integrity VM device database to the state previous to the last execution of the hpvmhostrdev command without any options or executed with the -u or -d options.

-u

Prevents the rescan and update of the VM Host system's I/O system. Do not use this option immediately after I/O devices are added to the VM Host system online without a reboot. This option provides the best performance.

RETURN VALUES

The hpvmhostrdev command exits with one of the following values:

0: Successful completion.

1: One or more error conditions occurred.

DIAGNOSTICS

The hpvmhostrdev command displays error messages for any of the following conditions:

An invalid option is specified.

Multiple options are specified simultaneously.

EXTERNAL INFLUENCES

hpvmdevmgmt (1M)

The hpvmhostrdev command attaches a special attribute, AUTORDEV, to the entries it makes in the Integrity VM device database. Do not use the hpvmdevmgmt command to add or modify the AUTORDEV attribute of a restricted device entry in the device database. This might cause unexpected results, such as the entry being inadvertently removed or undisturbed by hpvmhostrdev.

EXAMPLES

The following example disables execution of hpvmhostrdev (and restriction of VM Host storage devices from use by virtual machines) at startup of the Integrity VM system.

# hpvmhostrdev -D

The following example removes all restricted devices added by previous execution of the hpvmhostrdev command:

# hpvmdevrdev -d

AUTHORS

The hpvmhostrdev command was developerd by HP.

hpvmhostrdev(1M)

Technical documentation

» Table of Contents

» Glossary

» Index