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 Reference > v

vparstatus(1M)

HP-UX 11i Version 1: September 2005
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

NAME

vparstatus — display information about one or more virtual partitions

SYNOPSIS

vparstatus [-v | -M] [-V] [-p vp_name]... [-D db_file]

vparstatus -A [-M] [-V] [-p vp_name]

vparstatus -w [-M] [-V]

vparstatus -e [-V]

vparstatus -R [-V] [-p vp_name]

vparstatus -m [-M]

DESCRIPTION

The various forms of the vparstatus command display:

  • The attributes and hardware resources associated with one or more virtual partitions (vPars) in either summary (the default) or detailed format. The -M option presents the same data in machine-readable format.

  • Resources currently available, that is, not assigned to any virtual partition. The -M option presents the same data in machine-readable format.

  • The name of the local virtual partition, that is, the virtual partition from which the command is run. The -M option displays only the name. Otherwise a full sentence that includes the name is displayed.

  • The virtual partition monitor's event log.

  • Processor Information Module (PIM) data from the most recent resetting of a virtual partition.

  • The version number of the vparstatus output format.

Only a superuser can execute the vparstatus command.

If no arguments are supplied, vparstatus displays a summary format of all attributes and resources of all virtual partitions in the monitor database. One or more virtual partitions may be specified explicitly in order to restrict the output to information about the selected virtual partitions. The -D option lists similar information from an alternate database file, but with a major difference. See the description of the -D option for further details.

There are three major listing formats. The format chosen depends on command options and forms:

  • The summary format lists name, attributes, and resource totals. It is displayed if neither the -v nor -M option is used.

  • The detailed format lists name, attributes, and detailed resource assignments, one per line with annotative headings. The -v option produces this format.

  • The machine readable format displays the same information as the detailed format, except that field descriptive headers are omitted, and the information is all on one line. Individual fields are separated from each other by four delimiters. These are all described below.

Four additional formats are provided for the -w, -e, -R, and -V options.

Information displayed by vparstatus includes the following:

  • The version of the command output format (only if -V has been specified).

  • The name of the virtual partition (limited to 30 characters in summary format)

  • The state of the virtual partition, from the list below:

    Up: The virtual partition has notified the monitor that it is up. This is the normal state of a running virtual partition, however it does not necessarily mean that the virtual partition has completed its initialization and is fully operational.

    Down: The virtual partition is fully halted. This could be the result of a normal /etc/shutdown -h command, or a vparreset of a partition with its autoboot attribute set to manual. It is also the initial state of a virtual partition immediately after the virtual partition monitor is started.

    Load: The monitor is loading the kernel image of the virtual partition. This state precedes the Boot state.

    Boot: The virtual partition has been launched, but has not completely booted.

    Crash: The virtual partition is shutting down ungracefully (due to either a panic or a reset)

    Shut: The virtual partition is shutting down gracefully

    Hung: The virtual partition has stopped sending heartbeat messages to the monitor.

    N/A: The virtual partition is in an alternate database file that is not active, and so has no state.

  • The static/dynamic resource attribute

  • The auto/manual boot attribute

  • The search/nosearch boot attribute

  • The path to the kernel (limited to 23 characters in summary format)

  • The boot options (limited to 5 characters in summary format)

  • Summary or detailed CPU, I/O, and memory resource allocations

    Unbound (or floating) CPUs may be assigned to or de-assigned from a running vPar. This process, termed "CPU migration", requires a certain amount of time, especially if a CPU is being deleted from a vPar. A CPU being added is immediately assigned to its target vPar. A CPU being deleted remains assigned to its vPar and does not appear in a vparstatus -A display until migration has completely finished.

    Migrating CPUs are indicated in the various displays as follows:

  • Summary format: A "p" in the column following the Unbound CPU count indicates that one or more CPUs are migrating in or out of a vPar.

  • Detail format: Any CPU that is migrating in or out is indicated by the additional string "(migration pending)"

  • Machine readable format: A separate list of migrating CPUs is added to the display following the list of unbound CPUs. If no CPU is migrating, this list is empty.

    Refer to the EXAMPLES section below.

    Virtual partitions may be configured on a partitionable platform such as the HP Superdome. Configuration changes made to the underlying hard partition do NOT become effective until all virtual partitions on that hard partition have been shut down and the virtual partition monitor has been rebooted.

    If a configuration change is pending, the command displays a message to that effect following any summary or detailed display (but not for other output formats). Refer to "Performing a Reboot for Reconfig for an nPartition" in the HP Systems Partitions Guide for more information. If the -M option has been specified for either the configured resources or available resources, an additional field is appended to the machine-readable output instead. Refer to the description of the -M option.

Options

vparstatus recognizes the following command line options and arguments:

-p vp_name

Restricts the command display to information about vp_name. By default, information about all virtual partitions in the monitor database or specified alternate partition database is displayed. Multiple vp_names may be specified, except when used to display PIM data or available resources.

-D db_file

Displays information from the alternate partition database file db_file rather than from the monitor database.

The attributes and resources of a vPar in an alternate database file were specified in either the vparcreate or vparmodify command, but have not necessarily been checked for existence on a running system. They are referred to as "requested" information. Existence of the attributes and resources of a vPar in the live monitor database have been verified; they are referred to as "effective" information.

-v

Presents a detailed display, one attribute or resource per line. Each attribute and resource type is identified.

CPU resources are identified by path when path information is available. Some CPU resources may not be known when displaying the status of alternate database vPars or vPars in the Down state. In this case, "<no path>" is displayed.

-A

Displays information about available resources (that is, those not assigned to any virtual partition) in the virtual partition monitor's database. The monitor must be running. Resources are displayed one per line.

If the -p option is not specified, "Available CPUs:" displays the total number of CPUs which are not assigned to any virtual partition. If the -p option is specified, "Available CPUs:" displays the number of unbound CPUs which can be assigned to the specified virtual partition; this number may be less than the above total. These CPUs were all active and available (unassigned) when the local virtual partition was booted. Other CPUs which may be activated or become available after boot time, due to deallocation from another virtual partition or removal of a virtual partition, are not included in this number. These other CPUs cannot be allocated to the specified virtual partition until that virtual partition is either halted or rebooted.

Note that you may get a different number on each specified vPar if a different subset of CPUs was available when that vPar was booted.

Even those CPUs shown as Available may not be assignable to any vPar for an indeterminate period. Refer to the vparcreate(1M) or vparmodify(1M) manpage for further details.

-M

Displays attribute and resource information in a machine readable format, or restricts output of the -w option to the name of the local virtual partition. The rest of this description applies only to the attribute and resource display.

Individual fields are separated by one of four delimiters:

  • The colon (:) separates each field and resource type. For example, the state, attribute information, and kernel path would be displayed as:

    Up:Static,Autoboot:/stand/vmunix

  • The semicolon (;) separates subfields of a resource type. For example, CPU resources are shown as:

    5/10;33,37;51,53,55;<>,<>,<>;

    where the first subfield shows the minimum and maximum CPUs configured for the virtual partition; the second subfield lists the bound, or specified path, CPUs specifically configured by the user; the third subfield lists the remaining bound CPUs, which are assigned by the monitor; the fourth subfield lists the unbound, or floating, CPUs; and the final subfield lists any of the floating CPUs which are migrating in or out of a vPar.

    In the example above, the paths of the unbound CPUs are not known. This could be the case because the example vPar is in an alternate database, or the vPar is in a Down state for which unbound CPUs are not assigned. In this case, "<>" is displayed in place of the path.

  • The comma (,) separates individual items in a list of similar items, such as the fixed path CPUs in the previous example.

  • The slash (/) separates all other related items, such as the CPU minimum and maximum in the same example.

The need to reboot the underlying hard partition on a partitionable platform is indicated by a Y in the final field (for example, :Y). Otherwise the field contains :N. The information in all the remaining fields is the same as in other displays.

-w

Displays the local virtual partition (the one in which the command is executed) in a full sentence. The -M option restricts the display to just the name of the virtual partition. The monitor must be running.

-e

Displays the monitor's event log, a circular file roughly 4K bytes long. Once the file is full, new entries overlay old ones to the nearest character. As a result, the first entry displayed may be missing some leading characters. The monitor must be running.

-R

Displays Processor Information Module (PIM) data from the most recent reset of the specified virtual partition. If a virtual partition is not specified, PIM data from the local virtual partition, that is, the one in which the command is executed, is displayed.

If the virtual partition has not been reset, or if PIM data has been cleared since then, no PIM data is available so a message to that effect is displayed.

The monitor must be running.

-m

Displays the console path, hardware path from which the monitor was booted, the file system path of the monitor, the vPars database file system path that is being used by the monitor and the vPars release version information.

-V

Displays the version number of the vparstatus output format. If no other option is specified, only the version number is displayed. If this option is combined with other options, the version number is displayed first, followed by the display specified by the other option(s).

RETURN VALUE

The vparstatus command exits with one of the following values:

0

Successful completion.

1

Syntax error or invalid option.

EXAMPLES

These examples assume the existence of an N-class hardware system, Europe, on which the virtual partition database Norway is currently loaded in the virtual partition monitor. Norway has two configured virtual partitions: Oslo, and Bergen. The vparstatus command is run from Oslo.

Europe" has eight CPUs, two System Bus Adapters (SBAs), each with six Local Bus Adapters (LBAs), and 2 Gbytes of main memory. These resources are allocated among Oslo and Bergen as follows:

Oslo:

  • Two bound CPUs at hardware paths 33 and 37. The CPU at 33 was specified by the user with the -a cpu:path resource specification. The CPU at 37 was assigned by the monitor from the pool of CPUs available when Oslo was booted.

  • One floating (unbound) CPU at hardware path 41. It is being migrated into the vPar.

  • One SCSI boot disk at SBA/LBA/path 0/0/2/0.6.0.

  • One terminal at 0/0/4/0.

  • One LBA (0/4) to which are attached several LAN adapters.

  • Specific memory addresses 0x4000000 to 0xc000000 (Range = 64 MB) and 0x20000000 to 0x40000000 (Range = 128 MB). These specific ranges are part of a total memory allocation of 704 MB.

  • Autosearch attribute set.

Bergen:

  • Two bound CPUs at hardware path 97 and 101, both assigned by the monitor.

  • Two unbound CPUs at hardware paths 93 and 99. The CPU at 99 is migrating out of the vPar.

  • One SCSI boot disk at 1/4/0/0.5.0.

  • One LBA (1/10) to which are attached several LAN adapters

  • Specific memory 0x44000000 to 0x50000000 (Range = 192 MB) and 0x60000000 to 0x80000000 (Range = 512 MB). These specific ranges are part of a total memory allocation of 768 MB.

Display a summary format of all attributes and resources in all virtual partitions:

# vparstatus [Virtual Partition] Boot Virtual Partition Name State Attributes Kernel Path Opts ============================== ===== ============= ======================= ==== Oslo Up Stat,Auto,Asr /stand/vmunix Bergen Up Dyn,Manl,Nsr /stand/vmunix [Virtual Partition Resource Summary] CPU Num Memory (MB) CPU Bound/ IO # Ranges/ Virtual Partition Name Min/Max Unbound devs Total MB Total MB ============================== ================ ==== ==================== Oslo 2/ 4 2 1p 3 2/640 704 Bergen 2/ 4 2 2p 2 2/704 768

Display the version, then detailed attributes and resources of partition Oslo:

# vparstatus -p Oslo -v -V Version 1.1 [Virtual Partition Details] Name: Oslo State: Up Attributes: Static,Autoboot,Autosearch Kernel Path: /stand/vmunix Boot Opts: [CPU Details] Min/Max: 2/4 Bound by User [Path]: 33 Bound by Monitor [Path]: 37 Unbound [Path]: 41 (migration pending) [IO Details] 0.0.2.0.6.0 BOOT 0.0.4.0 0.4 [Memory Details] Specified [Base /Range]: 0x4000000/64 (bytes) (MB) 0x20000000/128 Total Memory (MB): 704

Display Bergen's CPU resources in machine-readable format:

# vparstatus -p Bergen -M Bergen:Up:Dynamic,Manual,Autosearch:/stand/vmunix::2/4;;97,101;93,99: 1.4.0.0.5.0 BOOT,1.10:0x44000000/192,0x60000000/512;768:N

Display the local virtual partition:

# vparstatus -w The current virtual partition is Oslo.

Display only the name of the local virtual partition:

# vparstatus -w -M Oslo

Display the monitor information regarding the console path, boot path, monitor boot file name, database file being used and vPars release version:

#vparstatus -m Console path: 0.0.2.0 Monitor Boot disk path: 0.0.1.0 Monitor Boot filename: /stand/vpmon Database filename: /stand/vpdb.mine vPars release version: A.03.03

#vparstatus -m -M 0.0.2.0:0.0.1.0:/stand/vpmon:/stand/vpdb.mine:A.03.03

AUTHOR

vparstatus was developed by the Hewlett-Packard Company.

SEE ALSO

vparadmin(1M), vparboot(1M), vparcreate(1M), vparmodify(1M), vparremove(1M), vparreset(1M), vparresources(5), vpartition(5), vpmon(5).



vparreset
  		 


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