Logical Domains 1.2 Administration Guide

Examples of Various Lists


Note –

The actual output might vary slightly from what is shown here.


ProcedureShow Software Versions (-V)

  1. View the current software versions installed, and you receive a listing similar to the following.


Example 9–1 Software Versions Installed


primary# ldm -V
 
Logical Domain Manager (v 1.2)
   Hypervisor control protocol v 1.3
   Using Hypervisor MD v 0.1
 
System PROM:
   Hypervisor  v. 1.7.0.    @(#)Hypervisor 1.7.0. 2008/11/19 10:20
   OpenBoot    v. 4.30.0.   @(#)OBP 4.30.0. 2008/11/18 13:44

ProcedureGenerate a Short List

  1. Generate a short list for all domains.


Example 9–2 Short List for All Domains


primary# ldm list
NAME             STATE    FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
primary          active   -t-cv           4     1G       0.5%  3d 21h 7m
ldg1             active   -t---   5000    8     1G        23%  2m

ProcedureGenerate a Long List (-l)

  1. Generate a long list for all domains.


Example 9–3 Long List for All Domains


primary# ldm list -l
NAME             STATE    FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
primary          active   -t-cv           1     768M     0.0%  0s
 
VCPU
    VID    PID    UTIL STRAND
    0      0      0.0%   100%
 
MEMORY
    RA               PA               SIZE
    0x4000000        0x4000000        768M
 
IO
    DEVICE           PSEUDONYM        OPTIONS
    pci@780          bus_a
    pci@7c0          bus_b            bypass=on
 
VCC
    NAME             PORT-RANGE
    vcc0             5000-5100
 
VSW
    NAME             MAC               NET-DEV   DEVICE    MODE
    vsw0             08:00:20:aa:bb:e0 e1000g0   switch@0  prog,promisc
    vsw1             08:00:20:aa:bb:e1                     routed
 
VDS
    NAME             VOLUME         OPTIONS          DEVICE
    vds0             myvol-a        slice            /disk/a
                     myvol-b                         /disk/b
                     myvol-c        ro,slice,excl    /disk/c
    vds1             myvol-d                         /disk/d
 
VDPCS
    NAME
    vdpcs0
    vdpcs1
 
------------------------------------------------------------------------------
NAME             STATE    FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
ldg1             bound    -----   5000    1     512M 
 
VCPU
    VID    PID    UTIL STRAND
    0      1             100%
 
MEMORY
    RA               PA               SIZE
    0x4000000        0x34000000       512M
 
NETWORK
    NAME         SERVICE                     DEVICE       MAC
    mynet-b      vsw0@primary                network@0    08:00:20:ab:9a:12
    mynet-a      vsw0@primary                network@1    08:00:20:ab:9a:11
 
DISK
    NAME             VOLUME                      DEVICE     SERVER
    mydisk-a         myvol-a@vds0                disk@0     primary
    mydisk-b         myvol-b@vds0                disk@1     primary
 
VDPCC
    NAME             SERVICE
    myvdpcc-a        vdpcs0@primary
    myvdpcc-b        vdpcs0@primary
 
VCONS
    NAME             SERVICE                     PORT
    mygroup          vcc0@primary                5000

ProcedureGenerate an Extended List (-e)

  1. Generate an extended list of all domains.


Example 9–4 Extended List for all Domains


primary# ldm list -e
NAME             STATE    FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
primary          active   -t-cv           1     768M     0.0%  0s
 
SOFTSTATE
Solaris running
 
MAC
    00:14:4f:fa:ed:88
 
HOSTID
    0x84faed88
 
CONTROL
    failure-policy=ignore
 
DEPENDENCY
    master=
 
VCPU
    VID    PID    UTIL STRAND
    0      0      0.0%   100%
 
MEMORY
    RA               PA               SIZE
    0x4000000        0x4000000        768M
 
IO
    DEVICE           PSEUDONYM        OPTIONS
    pci@780          bus_a
    pci@7c0          bus_b            bypass=on
 
VLDC
    NAME
    primary
 
VCC
    NAME             PORT-RANGE
    vcc0             5000-5100
 
VSW
    NAME             MAC               NET-DEV   DEVICE    MODE
    vsw0             08:00:20:aa:bb:e0 e1000g0   switch@0  prog,promisc
    vsw1             08:00:20:aa:bb:e1                     routed
 
VDS
    NAME             VOLUME         OPTIONS          DEVICE
    vds0             myvol-a        slice            /disk/a
                     myvol-b                         /disk/b
                     myvol-c        ro,slice,excl    /disk/c
    vds1             myvol-d                         /disk/d
 
VDPCS
    NAME
    vdpcs0
    vdpcs1
 
VLDCC
    NAME             SERVICE                     DESC
    hvctl            primary@primary             hvctl 
    vldcc0           primary@primary             ds 
 
------------------------------------------------------------------------------
NAME             STATE    FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
ldg1             bound    -----   5000    1     512M 
 
VCPU
    VID    PID    UTIL STRAND
    0      1             100%
 
MEMORY
    RA               PA               SIZE 
    0x4000000        0x34000000       512M
 
VLDCC
 NAME             SERVICE                     DESC
 vldcc0           primary@primary             ds 
 
NETWORK
    NAME         SERVICE                     DEVICE       MAC
    mynet-b      vsw0@primary                network@0    08:00:20:ab:9a:12
    mynet-a      vsw0@primary                network@1    08:00:20:ab:9a:11
 
DISK
    NAME             VOLUME                      DEVICE     SERVER 
    mydisk-a         myvol-a@vds0                disk@0     primary 
    mydisk-b         myvol-b@vds0                disk@1     primary 
 
VDPCC
    NAME             SERVICE 
    myvdpcc-a        vdpcs0@primary 
    myvdpcc-b        vdpcs0@primary 
 
VCONS
    NAME             SERVICE                     PORT
    mygroup          vcc0@primary                5000

ProcedureGenerate a Parseable, Machine-Readable List (-p)

  1. Generate a parseable, machine-readable list of all domains.


Example 9–5 Machine-Readable List


primary# ldm list -p
VERSION 1.0
DOMAIN|name=primary|state=active|flags=-t-cv|cons=|ncpu=1|mem=805306368|util=0.0|uptime=0
DOMAIN|name=ldg1|state=bound|flags=-----|cons=5000|ncpu=1|mem=536870912|util=|uptime=

ProcedureGenerate a Subset of a Long List (-o format)

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

    • console - output contains virtual console (vcons) and virtual console concentrator (vcc) service

    • cpu - output contains virtual CPU (vcpu) and physical CPU (pcpu)

    • crypto - cryptographic unit output contains Modular Arithmetic Unit (mau) and any other LDoms-supported cryptographic unit, such as the Control Word Queue (CWQ)

    • disk - output contains virtual disk (vdisk) and virtual disk server (vds)

    • domain - output contains variables (var), host ID (hostid), domain state, flags, 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)

    • serial - output contains virtual logical domain channel (vldc) service, virtual logical domain channel client (vldcc), virtual data plane channel client (vdpcc), virtual data plane channel service (vdpcs)

    • status - output contains status about a domain migration in progress.

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


Example 9–6 List CPU Information for the Control Domain


# ldm list -o cpu primary
NAME
primary
 
VCPU
   VID    PID    UTIL STRAND
   0      0      1.0%   100%
   1      1      0.6%   100%
   2      2      0.2%   100%
   3      3      0.5%   100%


Example 9–7 List Domain Information for a Guest Domain


# ldm list -o domain ldm2
NAME             STATE    FLAGS
ldm2             active   -t---
 
SOFTSTATE
Openboot initializing
 
VARIABLES
   auto-boot?=false
   boot-device=/virtual-devices@100/channel-devices@200/disk@0


Example 9–8 Lists Memory and Network Information for a Guest Domain


# ldm list -o network,memory ldm1
NAME
ldm1
 
MAC
   00:14:4f:f9:dd:ae
 
MEMORY
   RA               PA               SIZE
   0x6800000        0x46800000       1500M
 
NETWORK
NAME           SERVICE               DEVICE     MAC               MODE PVID VID
ldm1-network0  primary-vsw0@primary network@0  00:14:4f:fb:21:0f    1

ProcedureList a Variable

  1. List a variable (for example, boot-device) for a domain (for example, ldg1).


Example 9–9 Variable List for a Domain


primary# ldm list-variable boot-device ldg1
boot-device=/virtual-devices@100/channel-devices@200/disk@0:a

ProcedureList Bindings

  1. List resources that are bound for a domain (for example, ldg1).


Example 9–10 Bindings List for a Domain


primary# ldm list-bindings ldg1
NAME             STATE    FLAGS   CONS    VCPU  MEMORY   UTIL  UPTIME
ldg1             bound    -----   5000    1     512M 
 
VCPU
    VID    PID    UTIL STRAND
    0      1             100%
 
MEMORY
    RA               PA               SIZE
    0x4000000        0x34000000       512M
 
NETWORK
    NAME             SERVICE                   DEVICE     MAC
    mynet-b          vsw0@primary              network@0  08:00:20:ab:9a:12
        PEER                        MAC
        vsw0@primary                08:00:20:aa:bb:e0
        mynet-a@ldg1                08:00:20:ab:9a:11
        mynet-c@ldg2                08:00:20:ab:9a:22
    NAME             SERVICE                   DEVICE     MAC
    mynet-a          vsw0@primary              network@1  08:00:20:ab:9a:11
        PEER                        MAC
        vsw0@primary                08:00:20:aa:bb:e0
        mynet-b@ldg1                08:00:20:ab:9a:12
        mynet-c@ldg2                08:00:20:ab:9a:22
 
DISK
    NAME             VOLUME                      DEVICE     SERVER
    mydisk-a         myvol-a@vds0                disk@0     primary
    mydisk-b         myvol-b@vds0                disk@1     primary
 
VDPCC
    NAME             SERVICE
    myvdpcc-a        vdpcs0@primary
    myvdpcc-b        vdpcs0@primary
 
VCONS
    NAME             SERVICE                     PORT
    mygroup          vcc0@primary                5000

ProcedureList Configurations

  1. List logical domain configurations that have been stored on the SP.


Example 9–11 Configurations List

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

For more information about configurations, see Managing Logical Domains Configurations. For more examples, see the ldm(1M) man page.


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

Meaning of Labels

The labels to the right of the configuration name mean the following:

ProcedureList Devices

  1. List all server resources, bound and unbound.


Example 9–12 List of All Server Resources


primary# ldm list-devices -a
VCPU
    PID  %FREE     PM
    0       0      NO
    1       0      YES
    2       0      YES
    3       0      YES
    4       100    ---
    5       100    ---
    6       100    ---
    7       100    ---
    8       100    ---
    9       100    ---
    10      100    ---
    11      100    ---
    12      100    ---
    13      100    ---
    14      100    ---
    15      100    ---
    16      100    ---
    17      100    ---
    18      100    ---
    19      100    ---
    20      100    ---
    21      100    ---
    22      100    ---
    23      100    ---
    24      100    ---
    25      100    ---
    26      100    ---
    27      100    ---
    28      100    ---
    29      100    ---
    30      100    ---
    31      100    ---
 
MAU
    CPUSET                                  BOUND
    (0, 1, 2, 3)                            ldg2
    (4, 5, 6, 7)
    (8, 9, 10, 11)
    (12, 13, 14, 15)
    (16, 17, 18, 19)
    (20, 21, 22, 23)
    (24, 25, 26, 27)
    (28, 29, 30, 31)
 
MEMORY
    PA                   SIZE            BOUND
    0x0                  512K            _sys_
    0x80000              1536K           _sys_
    0x200000             62M             _sys_
    0x4000000            768M            primary
    0x34000000           512M            ldg1
    0x54000000           8M              _sys_
    0x54800000           2G              ldg2
    0xd4800000           29368M
 
IO
    DEVICE           PSEUDONYM        BOUND   OPTIONS
    pci@780          bus_a            yes 
    pci@7c0          bus_b            yes     bypass=on

ProcedureList Available Memory

  1. List the amount of memory available to be allocated.


    primary# ldm list-devices mem
    MEMORY
        PA                   SIZE
        0x14e000000          2848M

ProcedureList Services

  1. List the services that are available.


Example 9–13 Services List


primary# ldm list-services
VDS
    NAME             VOLUME         OPTIONS          DEVICE
    primary-vds0
VCC
    NAME             PORT-RANGE
    primary-vcc0     5000-5100
VSW
   NAME         MAC               NET-DEV  DEVICE   MODE        
   primary-vsw0 00:14:4f:f9:68:d0 e1000g0  switch@0 prog,promisc