Using Monitor Commands

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

Note the following for the monitor commands:

Unless specifically stated, all operations occur only on the boot disk from which the monitor was booted. Usually, this is the boot disk of the primary path entry in system-wide stable storage.
Further, the 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 monitor commands.
The following monitor commands are disabled when one or more virtual partitions are up:
- getauto, lifls, and readdb.
The following monitor commands are disabled when the partition that owns the disk from which the monitor was booted, usually the primary path, is up:
- ls and cat.

Booting

readdb filename
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
Note:
- This command can only be used when the monitor /stand/vpmon is booted and the default partition database (/stand/vpdb) does not exist, the alternate partition database as specified in the -p option of /stand/vpmon does not exist, or the database file read is corrupt. For information on when the monitor is booted, see “Boot Sequence”. For more information on the -p option, see “Booting the vPars Monitor”.

vparload -all
vparload -auto
vparload -ppartition_name [-bkernelpath][-oboot_options][-Bhardware_path]

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 attribute. For more information on the autoboot attribute, 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`, such as `/stand/vmunix.prev`, instead of the default kernel `/stand/vmunix`.
`-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`

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.other:
- 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:

-bkernelpath 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.

reboot
reboots the entire computer.




	NOTE: You should shut down each partition (using the Unix shutdown command) prior to executing the 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 Computer”.

Displaying Information

cat filename [openonly]
displays the contents of filename. When openonly is specified, this command only prints "open succeeded" if the 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
cbuf partition_name
displays the contents of the console buffer of partition_name
help
help or ? lists all 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 monitor log. The monitor log holds up to 16KB 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:

-`a`	all entries
-`l`	long listing
-`n`	numerical UIDs and GIDs
-`i`	inode
-`F`	appends 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

scan
lists all hardware discovered by the monitor and indicates which partition owns each device.
toddriftreset
resets the drifts of the real-time clock. Use this command if you reset the real-time clock of the computer at the BCH prompt. For brief information, see ???.
vparinfo [partition_name]
when no partition_name is given, vparinfo displays all unassigned resources and the names of all existing partitions; when partition_name is given, vparinfo displays the resources assigned to partition_name.

Using Monitor Commands

Technical documentation

» Table of Contents

» Glossary

» Index

Booting

Displaying Information