Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Virtual Partitions Administrator’s Guide > Chapter 5 vPars Monitor and Shell Commands

vPars Monitor: Using vPars Monitor Commands

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

You can use the following vPars Monitor commands at the vPars Monitor prompt for booting and basic troubleshooting. However, most vPars operations should be performed using the vPars shell commands.

Note the following for the vPars Monitor commands:

  • Unless specifically stated, all operations occur only on the boot disk from which the vPars Monitor was booted. Usually, this is the boot disk of the primary path entry in system-wide stable storage.

    Further, the vPars Monitor can traverse only HFS file systems. Usually, the only HFS file system is /stand.

  • Except for the vparload command, an alternate disk device cannot be specified using the vPars Monitor commands.

  • The following vPars Monitor commands are disabled when one or more virtual partitions are up:

    • getauto, lifls, and readdb.

  • The following vPars Monitor commands are disabled when the virtual partition that owns the disk from which the vPars Monitor was booted, usually the primary path, is up:

    • ls and cat.

NOTE: You can see all the latest vPars Monitor commands and options from the vpmon(5) manpage.

Not all vPars Monitor commands are available on all platforms. The following common vPars Monitor commands are not available on Integrity systems: cat, cbuf, getauto, lifls, and ls. Refer to the vpmon(5) manpage for a complete list.

Booting

  • readdbfilename  reads an alternate partition database filename for partition configuration information

    filename must be an absolute path and reside on a HFS file system.

    Example:

    • If you have a backup copy of the partition database in the file /stand/vpdb.backup, you can read the database configuration information using:

      MON> readdb /stand/vpdb.backup

    Notes:

    • This command can only be used when the vPars Monitor /stand/vpmon is booted and the default partition database (/stand/vpdb) does not exist, the alternate partition database as specified in the -D option of /stand/vpmon does not exist, or the database file read is corrupt. For more information on the -p option, see “vPars Monitor: Booting the vPars Monitor”.

      Integrity only: If you issue readdb /stand/vpdb.backup, the file that is actually read is at /stand/boot.sys/stand/vpdb.backup. The vparcreate command transparently creates the soft link from /stand/boot.sys/stand/file to /stand/file. Therefore, if you backup the database file using the Unix cp command, the ln -s command also should be executed to create the soft link. Otherwise, it will not be possible to boot from the backup database file.

  • vparload -all

    vparload -auto

    vparload -p partition_name -b kernelpath -o boot_options -B hardware_path [-D disk_index] [-E disk_index]

    boots the virtual partition partition_name; this command is similar to the vPars Unix shell command vparboot.

    -all

    Boots all virtual partitions, regardless of the autoboot or autosearch attributes. For more information on the autoboot or autosearch attributes, see the vparcreate(1M) or vparmodify(1M) manpages.

    -auto

    Boots all virtual partitions that have their autoboot attribute flag set to AUTO.

    -b kernelpath

    Boots the virtual partition using the kernel kernelpath instead of the default kernel

    -o boot_options

    Boots the virtual partition using the options boot_options, such as -is for single-user mode or -lm for LVM maintenance mode.

    -B hardware_path

    Boots the virtual partition using the disk device at the hardware_path

    -D disk_index

    (Integrity only) Supported by vPars A.05.02 and later. Launches the install kernel from the CD or DVD media specified by disk_index. If the disk_index specified is “X” the install kernel is launched from the disk “fsX:”. If installable media is not present at the index specified, the virtual partition will be shut down and the user must select a different disk_index.
    -E disk_index

    (Integrity only) Launches the vPars boot helper EFI application from the disk specified by the disk_index. The EFI boot helper prints the EFI paths of all the bootable disks belonging to the target virtual partition and prompts the user to select a disk to boot from.

    Under vPars A.05.02 and later, if the disk selected is a CD or DVD device, then the install kernel from the media is launched instead of the regular kernel and any boot options specified on the command line are ignored.

    Examples:

    • To boot the partition winona2 into single-user mode:

      MON> vparload -p winona2 -o "-is"
    • To boot the partition winona2 using the kernel /stand/vmunix.prev:

      MON> vparload -p winona2 -b /stand/vmunix.prev
    • To boot the partition winona2 using the disk device at 0/8/0/0.2.0:

      MON> vparload -p winona2 -B 0.8.0.0.2.0

    Note:

    • -b kernelpath allows you to change the target kernel for only the next boot of partition_name. If you wish to make a permanent change to the partition database, use the vparmodify command.

      For example, to change the partition database information so that winona2 always boots using /stand/vmunix.other:

      # vparmodify -p winona2 -b /stand/vmunix.other

      See the vparmodify(1M) manpage for more information on modifying the partition database.

      (vPars A.04.01) For 11i v2 (11.23) systems, alternate kernels are in the directory /stand/alternate_config/.

      Also, when a virtual partition is booted, there may be a pause in the console output. For more information, see “Booting a Virtual Partition”.

      Finally, when there is a pending Reboot for Reconfiguration for the involved nPartition, the target virtual partitions will not be booted until all the virtual partitions within the nPartition have been shut down and the vPars Monitor rebooted. For more information see “Shutting Down or Rebooting the nPartition (Or Rebooting the vPars Monitor)”.

  • bootpath  displays the device from which the vPars Monitor (/stand/vpmon) was booted

    Example:

    MON>bootpath disk(0.0.2.0.6.0)

  • reboot [mode]  reboots the entire hard partition. Other hard partitions are not affected.

    mode sets the mode for the next reboot and has the value of either nPars or vPars. This is applicable on only Integrity systems.

    NOTE: You should shut down each virtual partition (using the Unix shutdown command) prior to executing the vPars Monitor reboot command. A confirmation prompt is provided, but if you accept confirmation of the reboot while any virtual partitions are running, the reboot brings the running partitions down ungracefully. For more information, see “Shutting Down or Rebooting the nPartition (Or Rebooting the vPars Monitor)”.

Displaying Information

  • cat filename [openonly]  displays the contents of filename. When openonly is specified, this command only prints "open succeeded" if the vPars Monitor was able to open the filename. This command is similar to the Unix cat command.

    filename must be a text file on an HFS file system.

    /stand is the default directory

    Example:

    • To display the file /stand/notes.txt

      MON> cat notes.txt 10/13/2001: built new kernel today. if problems arise, revert to saved kernel vmunix.original

  • cbufpartition_name  displays the contents of the console buffer of partition_name

  • clear_pending  clears a pending Reboot for Reconfiguration. If there is a pending Reboot for Reconfiguration within the nPartition, no virtual partitions can be rebooted until all the virtual partitions within the given nPartition are shut down and the involved vPars Monitor is rebooted. If Reboot for Reconfiguration has been set in error, the clear_pending command clears it, enabling virtual partition boots.

  • help  help or ? lists all vPars Monitor commands

  • lifls  lists the files in the LIF area

  • getauto  displays the contents of the AUTO file in the LIF area

    Example:

    • MON> getauto hpux /stand/vpmon

  • log  displays the contents, including warning and error messages, of the vPars Monitor log. The vPars Monitor log holds up to 16 KB of information in a circular log buffer. The information is displayed in chronological order.

  • ls [-alniFH] [directory]  lists the contents of directory. This command is similar to the Unix ls command.

    directory must be on a HFS file system. /stand is the default directory

    The ls command-line options are the same as the Unix shell lsoptions. For detailed explanations, see the ls(1M) manpage. In brief:

    -aall entries
    -llong listing
    -nnumerical UIDs and GIDs
    -iinode
    -Fappends a character after the entry, depending on the file type, such as a / (slash) for a directory

    For example, to view the listing of files in winona2’s /stand directory:

    MON> ls /stand lost+found ioconfig bootconf system system.d vmunix dlkm.vmunix.prevbuild kernrel rootconf vpdb vpmon.dmp vmunix.backup system.prev vmunix.prev dlkm vpdb.backup vpmon
  • monadmin  controls the vPars flexible administrative capability feature, as described in Chapter 11: “vPars Flexible Administrative Capability”. For usage information, see monadmin.

  • scan  lists all hardware discovered by the vPars Monitor and indicates which virtual partition owns each device.

  • settime [MM DD YYYY hh mm ss]  sets the system's real time clock. Acceptable date range is 1-1-1970 00:00:00 to 12-31-2034 23:59:59.

  • threads  controls the use of hyperthreading on servers with dual core Intel Itanium processors. For usage information, see “CPU: Hyperthreading ON/OFF (HT ON/OFF)”.

  • time  displays system real time clock and OS time of all the virtual partitions in GMT (Greenwich Mean Time). The OS time displayed will consider the RTC and clock drift for the virtual partition. However, if the partition is up, there may be difference in the OS time displayed.

  • toddriftreset  resets the drifts of the real-time clock. Use this command if you reset the real-time clock of the hard partition at the BCH prompt. For brief information, see “Real-time clock (RTC)”.

  • vparinfo[partition_name]  This command is for HP internal use only.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2008 Hewlett-Packard Development Company, L.P.