Go to main content

Oracle® VM Server for SPARC 3.6 Administration Guide

Exit Print View

Updated: September 2019
 
 

Listing Domain Resources

This section shows the syntax usage for the ldm subcommands, defines some output terms, such as flags and utilization statistics, and provides examples that are similar to what appears as output.

Machine-Readable Output

If you are creating scripts that use ldm list command output, always use the –p option to produce the machine-readable form of the output.

To view syntax usage for all ldm subcommands, use the following command:

primary# ldm --help

For more information about the ldm subcommands, see the ldm(8) man page.

Flag Definitions

The following flags can be shown in the output for a domain (ldm list). If you use the long, parseable options (–l –p) for the command, the flags are spelled out for example, flags=normal,control,vio-service. If not, you see the letter abbreviation, for example -n-cv-. The list flag values are position dependent. The following values can appear in each of the six columns from left to right.

    Column 1 – Starting or stopping domains

  • s Starting or stopping

    Column 2 – Domain status

  • n Normal

  • t Transition

  • d Degraded domain that cannot be started due to missing resources

    Column 3 – Reconfiguration status

  • d Delayed reconfiguration

  • r Memory dynamic reconfiguration

    Column 4 – Control domain

  • c Control domain

    Column 5 – Service domain

  • v Virtual I/O service domain

    Column 6 – Migration status

  • s Source domain in a migration

  • t Target domain in a migration

  • e Error occurred during a migration

Utilization Statistic Definition

The per virtual CPU utilization statistic (UTIL) is shown by the ldm list -l command. The statistic is the percentage of time that the virtual CPU spends executing on behalf of the guest domain OS. A virtual CPU is considered to be executing on behalf of the guest domain OS except when the virtual CPU yields to the hypervisor.


Note - The CPU utilization (UTIL) for an active domain that has a single CPU is 100% regardless of load.

The utilization statistic reported for a logical domain is the average of the virtual CPU utilizations for the virtual CPUs in the domain. The normalized utilization statistic (NORM) is the percentage of time the virtual CPU spends executing on behalf of the guest domain OS. This value reflects the effect of CPUs running at lower frequency due to power management. Normalized virtualization is only available when your system runs at least version 8.2.0 of the system firmware.

When CPU power management is enabled, the utilization of CPUs is monitored and the effective frequency is adjusted in response to the workload. A guest domain that does not yield to the hypervisor and uses its full CPU cycles to run at full frequency has a normalized utilization of 100%. A guest domain that has a lower workload still uses its CPUs, but they run at a lower effective frequency. The normalized utilization of such a guest domain reports a lower percentage. Thus, normalized utilization is processor-dependent and can vary on different platforms. Use the ldm list or ldm list -l command to show normalized utilization for both virtual CPUs and the guest domain OS.

Viewing Various Lists

  • To view the current software versions installed:

    primary# ldm -V
  • To generate a short list for all domains:

    primary# ldm list
  • To generate a long list for all domains:

    primary# ldm list -l
  • To generate an extended list of all domains:

    primary# ldm list -e
  • To generate a parseable, machine-readable list of all domains:

    primary# ldm list -p
  • You can generate output as a subset of resources by entering one or more of the following format options. If you specify more than one format, delimit the items by a comma with no spaces.

    primary# ldm list -o resource[,resource...] domain-name
    • console Output contains virtual console (vcons) and virtual console concentrator (vcc) service

    • core Output contains information about domains that have whole cores allocated

    • cpu Output contains information about the virtual CPU (vcpu), physical CPU (pcpu), and core ID

    • disk Output contains virtual disk (vdisk) and virtual disk server (vds)

    • domain-name Output contains variables (var), host ID (hostid), domain state, flags, UUID, and software state

    • memory Output contains memory

    • network Output contains media access control (mac) address , virtual network switch (vsw), and virtual network (vnet) device

    • physio Physical input/output contains peripheral component interconnect (pci) and network interface unit (niu)

    • resmgmt – Output contains dynamic resource management (DRM) policy information, indicates which policy is currently running, and lists constraints related to whole-core configuration

    • serial Output contains virtual logical domain channel (vldc) service and virtual logical domain channel client (vldcc))

    • stats Output contains statistics that are related to resource management policies

    • status Output contains status about a domain migration in progress

      The following examples show various subsets of output that you can specify.

    • To list CPU information for the control domain:

      primary# ldm list -o cpu primary
    • To list domain information for a guest domain:

      primary# ldm list -o domain ldm2
    • To list memory and network information for a guest domain:

      primary# ldm list -o network,memory ldm1
    • To list DRM policy information for a guest domain:

      primary# ldm list -o resmgmt,stats ldm1
  • To show a variable and its value for a domain:

    primary# ldm list-variable variable-name domain-name

    For example, the following command shows the value for the boot-device variable on the ldg1 domain:

    primary# ldm list-variable boot-device ldg1
    boot-device=/virtual-devices@100/channel-devices@200/disk@0:a
  • To list the resources that are bound to a domain:

    primary# ldm list-bindings domain-name
  • To list SP configurations that have been stored on the SP:

    The ldm list-spconfig command lists the SP configurations that are stored on the service processor. When used with the –r option, this command lists those SP configurations for which autosave files exist on the control domain.

    For more information about SP configurations, see Managing SP Configurations. For more examples, see the ldm(8) man page.

    primary# ldm list-spconfig
    factory-default
    3guests
    foo [next poweron]
    primary
    reconfig-primary

      The labels next to the SP configuration name mean the following:

    • [current] Last booted SP configuration, only as long as it matches the currently running SP configuration; that is, until you initiate a reconfiguration. After the reconfiguration, the annotation changes to [next poweron].

    • [next poweron] SP configuration to be used at the next power cycle.

    • [degraded] SP configuration is a degraded version of the previously booted SP configuration.

  • To list all server resources, bound and unbound:

    primary# ldm list-devices -a
  • To list the amount of memory available to be allocated:

    primary# ldm list-devices mem
    MEMORY
        PA                   SIZE
        0x14e000000          2848M
  • To determine which portions of memory are unavailable for logical domains:

    primary# ldm list-devices -a mem
    MEMORY
        PA                   SIZE            BOUND
        0x0                  57M             _sys_
        0x3900000            32M             _sys_
        0x5900000            94M             _sys_
        0xb700000            393M            _sys_
        0x24000000           192M            _sys_
        0x30000000           255G            primary
        0x3ff0000000         64M             _sys_
        0x3ff4000000         64M             _sys_
        0x3ff8000000         128M            _sys_
        0x80000000000        2G              ldg1
        0x80080000000        2G              ldg2
        0x80100000000        2G              ldg3
        0x80180000000        2G              ldg4
        0x80200000000        103G
        0x81bc0000000        145G            primary
  • To list the services that are available:

    primary# ldm list-services

Listing Constraints


Note - While a DRM policy is actively running, the virtual CPU constraints are dynamic. Before you save the XML list of constraints, disable the running DRM policy so that these constraints become static.

    To the Logical Domains Manager, constraints are one or more resources you want to have assigned to a particular domain. You either receive all the resources you ask to be added to a domain or you get none of them, depending upon the available resources. The list-constraints subcommand lists those resources you requested assigned to the domain.

  • To list constraints for one domain:

    # ldm list-constraints domain-name
  • To list constraints in XML format for a particular domain:

    # ldm list-constraints -x domain-name
  • To list constraints for all domains in a parseable format:

    # ldm list-constraints -p

Listing Resource Group Information

You can use the ldm list-rsrc-group command to show information about resource groups.

The following command shows information about all the resource groups:

primary# ldm list-rsrc-group
NAME                        CORE MEMORY IO
/SYS/CMU4                   12   256G   4
/SYS/CMU5                   12   256G   4
/SYS/CMU6                   12   128G   4
/SYS/CMU7                   12   128G   4

Like the other ldm list-* commands, you can specify options to show parseable output, detailed output, and information about particular resource groups and domains. For more information, see the ldm(8) man page.

The following example uses the –l option to show detailed information about the /SYS/CMU5 resource group.

primary# ldm list-rsrc-group -l /SYS/CMU5
NAME                                    CORE   MEMORY    IO
/SYS/CMU5                               12     256G      4

CORE
    CID                                             BOUND
    192, 194, 196, 198, 200, 202, 208, 210          primary
    212, 214, 216, 218                              primary

MEMORY

    PA              SIZE              BOUND
    0xc0000000000   228M              ldg1
    0xc0030000000   127G              primary
    0xc1ffc000000   64M               _sys_
    0xd0000000000   130816M           primary
    0xd1ffc000000   64M               _sys_

IO
    DEVICE          PSEUDONYM         BOUND
    pci@900         pci_24            primary
    pci@940         pci_25            primary
    pci@980         pci_26            primary
    pci@9c0         pci_27            primary