LDOMS & ZONES

HOME LDOM ZONES HOW-TO-DOCS-LDOM HOW-TO-DOCS-ZONES

SPARC LDOM CLI Cheat Sheet

This document is designed to be a a quick platform speci c cheat sheet to help engineers run important LDOM task on a SPARC systems
( SPARC T3,T4,T5,M5,M6 and M10 )

Display Default LDOM services

Action Command

Check ldom #svcs ldmd

manager
(ldmd)
Supported on
SPARC T3/T4/T5
: Yes
Supported on
POWERED BY SPARC M5/M6:
Yes
Supported on
SPARC M10:
Yes

Check vntsd is #svcs vntsd

running
Supported on
SPARC T3/T4/T5
: Yes
Supported on
SPARC M5/M6:
Yes
Supported on
SPARC M10:
Yes

Check Default #ldm list-services primary

Services are
running
Supported on
SPARC T3/T4/T5
: Yes
Supported on
SPARC M5/M6:
Yes
Supported on
SPARC M10:
Yes

Check ldm Usage :ldm -V

software
Example
Supported on
SPARC T3/T4/T5 #ldm -V
: Yes
Logical Domains Manager (v 3.0.0.3)
Supported on Hypervisor control protocol v 1.11
SPARC M5/M6: Using Hypervisor MD v 1.4
Yes
Supported on System PROM:
SPARC M10: Hostconfig v. 1.3.5.c @(#)Hostconfig 1.3.5.c 2014/03/21 19:04
Yes Hypervisor v. 1.12.5.b @(#)Hypervisor 1.12.5.b 2014/02/07 13:52
OpenBoot v. 4.35.5.a @(#)OpenBoot 4.35.5.a 2014/01/31 14:12

[ check ldoms manager package in Solaris 11 ]

Usage: pkg info ldomsmanager

Example
eis@m10-1-syd04-a:~$ pkg info ldomsmanager
Name: system/ldoms/ldomsmanager
Summary: Logical Domains Manager
Description: LDoms Manager - Virtualization for SPARC T-Series
Category: System/Virtualization
State: Installed
Publisher: solaris
Version: 3.1.1.0.5
Build Release: 5.11
Branch: 0.175.2.0.0.34.0
Packaging Date: March 3, 2014 02:18:20 PM
Size: 3.87 MB
FMRI: pkg://solaris/system/ldoms/
ldomsmanager@3.1.1.0.5,5.11-0.175.2.0.0.34.0:20140303T141820Z
eis@m10-1-syd04-a:~$
eis@m10-1-syd04-a:~$

Creating Default LDOM services

Action Command

add virtual Usage: ldm add-vcc port-range=x-

console y <vcc-name> <ldom>
concentrator (vcc)
Example
Supported on
SPARC T3/T4/T5 : #ldm add-vcc port-range=5000-
Yes 5100 primary-vcc0 primary
Supported on
SPARC M5/M6: Yes
Supported on
SPARC M10: Yes

add virtual Usage: ldm add-vsw net-dev=

network switch <device> <vsw-name> <ldom-
(vsw) name>

Example
Supported on
SPARC T3/T4/T5 : #ldm add-vsw net-dev=net0
Yes primary-vsw0 primary
Supported on
SPARC M5/M6: Yes
Supported on
SPARC M10: Yes

add virtual disk Usage ldm add-vds <service-

server (vds) name> <ldom-name>

Example
Supported on
#ldm add-vds primary-vds0
SPARC T3/T4/T5 :
primary
Yes
Supported on
SPARC M5/M6: Yes
Supported on
SPARC M10: Yes

add virtual storage Usage: ldm add-vdsdev <backend>

device to virtual <volume@service>
disk service
where

backend: specify a physical disk

Supported on
path. In addition to a le, you can
SPARC T3/T4/T5 :
specify the path of a disk, disk slice
Yes
etc for the backend.
Supported on
SPARC M5/M6: Yes volume: specify a volume name
Supported on that is unique within the virtual disk
SPARC M10: Yes server

service: specify a virtual disk service

name

Example:

### Primary domain.

### Add zfs lesystem to existing
Guest domain
root@m10-1-syd04-a:~# zfs create
-V 5G rpool/ckt-disk2
root@m10-1-syd04-a:~# ls
/dev/zvol/dsk/rpool
ROOT VARSHARE ckt-disk2
dump export swap

root@m10-1-syd04-a:~# ldm add-

vdsdev /dev/zvol/dsk/rpool/ckt-
disk2 disk2@primary-vds0

In this example a 5G backend zfs

partition is created called ckt-disk2
The volume name is ckt-disk2
The vds is called primary-vds0

Removing Default LDOM services

Action Command

remove virtual Usage: ldm remove-vcc [-f] <vcc_name>

console
concentrator Example
(vcc)
root@m5-32-sca11-a-pdom00:~# ldm list-
services primary
VCC
Supported on
NAME LDOM PORT-RANGE
SPARC T3/T4/T5
primary-vcc0 primary 5000-5100
: Yes
Supported on
root@m5-32-sca11-a-pdom00:~# ldm remove-
SPARC M5/M6:
vcc primary-vcc0
Yes
root@m5-32-sca11-a-pdom00:~# ldm list
Supported on
NAME STATE FLAGS CONS VCPU
SPARC M10:
MEMORY UTIL NORM UPTIME
Yes
primary active -n-c-- UART 192
2047G 0.7% 0.6% 47m
root@m5-32-sca11-a-pdom00:~#

remove virtual Usage: ldm remove-vsw <vsw-service-name>

network
switch (vsw) Example
root@m5-32-sca11-a-pdom00:~# ldm list-
services primary
Supported on VSW
SPARC T3/T4/T5 NAME LDOM MAC NET-
: Yes DEV ID DEVICE LINKPROP DEFAULT-VLAN-ID
Supported on PVID VID MTU MODE INTER-VNET-LINK
SPARC M5/M6: primary-vsw0
Yes primary 00:14:4f:fa:ee:e1 net0 0 switch@0 1
Supported on 1 1500 on
SPARC M10: root@m5-32-sca11-a-pdom00:~# ldm remove-
Yes vsw primary-vsw0
root@m5-32-sca11-a-pdom00:~# ldm list-
services primary

remove virtual Usage: ldm remove-vds <service-name>

disk server
(vds) Example
Supported on root@m5-32-sca11-a-pdom00:~# ldm remove-
SPARC T3/T4/T5 vds primary-vds0
: Yes root@m5-32-sca11-a-pdom00:~# ldm list-
Supported on services primary
SPARC M5/M6: root@m5-32-sca11-a-pdom00:~#
Yes
Supported on
SPARC M10:
Yes

remove virtual Usage: ldm remove-vdsdev [-

storage device f] <volume_name>@<service_name>
to virtual disk
service Example

Supported on root@m5-32-sca11-a-pdom00:~# ldm list-

SPARC T3/T4/T5 services primary
: Yes VDS
Supported on NAME LDOM VOLUME
SPARC M5/M6: OPTIONS MPGROUP DEVICE
Yes primary-vds0 primary dvd-
Supported on iso /home/jack/sol-11_1-
SPARC M10: text-sparc.iso
Yes root@m5-32-sca11-a-pdom00:~# ldm remove-
vdsdev dvd-iso@primary-vds0
root@m5-32-sca11-a-pdom00:~# ldm list-
services primary
VDS
NAME LDOM VOLUME
OPTIONS MPGROUP DEVICE
primary-vds0 primary

root@m5-32-sca11-a-pdom00:~#

Start Default Services

&nbsnbsp;

Action Command

start ldom manager Usage: svcadm enable ldmd

Example
Supported on
SPARC T3/T4/T5 : Yes root@m5-32-sca11-a-pdom00:~#
Supported on SPARC svcs | grep ldmd
M5/M6: Yes online 18:37:13
Supported on SPARC svc:/ldoms/ldmd:default
M10: Yes root@m5-32-sca11-a-pdom00:~#
svcadm disable ldmd
root@m5-32-sca11-a-pdom00:~#
svcs | grep ldmd
root@m5-32-sca11-a-pdom00:~#
root@m5-32-sca11-a-pdom00:~#
svcadm enable ldmd
root@m5-32-sca11-a-pdom00:~#
svcs | grep ldmd
online 19:17:57
svc:/ldoms/ldmd:default
root@m5-32-sca11-a-pdom00:~#

start vntsd Usage: svcadm enable vntsd

Supported on Example
SPARC T3/T4/T5 : Yes
Supported on SPARC jack@m5-32-sca11-a-pdom01:~$
M5/M6: Yes svcs vntsd
Supported on SPARC STATE STIME FMRI
M10: Yes disabled 18:49:36
svc:/ldoms/vntsd:default
jack@m5-32-sca11-a-pdom01:~$
svcadm enable vntsd
jack@m5-32-sca11-a-pdom01:~$
svcs vntsd
STATE STIME FMRI
online 19:23:59
svc:/ldoms/vntsd:default
jack@m5-32-sca11-a-pdom01:~$

Basic Guest Domain Administration

Action Command

list resources binded Usage: ldm list-bindings <ldom-name>

to a Guest Domain
Example
Supported on
SPARC T3/T4/T5 : Yes #ldm list-bindings guestdomain2
Supported on SPARC
M5/M6: Yes
Supported on SPARC
M10: Yes

how to identify if the Usage: $virtinfo -a

current domain?
Example
[Control,Guest,Service
or Root] jack@m5-32-sca11-a-pdom01:~$ virtinfo -a
Domain role: LDoms control I/O service
Supported on
root
SPARC T3/T4/T5 : Yes
Domain name: primary
Supported on SPARC
Domain UUID: 5caf3abe-db20-cb75-8b2c-
M5/M6: Yes
b4a62bef5a5f
Supported on SPARC
Control domain: Unknown
M10: Yes
Chassis serial#: Unknown
jack@m5-32-sca11-a-pdom01:~$

how to check status Usage: ldm list-io

of I/O device
Example
root@m10-1-syd04-a:~# ldm list-io
Supported on NAME TYPE BUS
SPARC T3/T4/T5 : Yes DOMAIN STATUS
Supported on SPARC ---- ---- --- ------ -----
M5/M6: Yes -
Supported on SPARC PCIE0 BUS PCIE0
M10: Yes primary IOV
PCIE1 BUS PCIE1
primary IOV
/SYS/MBU/NET0 PCIE PCIE0
primary OCC
/SYS/PCI0 PCIE PCIE0
primary EMP
/SYS/MBU/SASHBA PCIE PCIE0
primary OCC
/SYS/MBU/NET2 PCIE PCIE1
primary OCC
/SYS/PCI1 PCIE PCIE1
primary EMP
/SYS/PCI2 PCIE PCIE1
primary EMP
root@m10-1-syd04-a:~#
root@m10-1-syd04-a:~#

how to check logical Usage: ldm list-domain -o domain <guest-

domain (ldom) status domain-name>
Supported on
Example
SPARC T3/T4/T5 : Yes
Supported on SPARC root@m10-syd04-a:~# ldm list-domain -o
M5/M6: Yes domain guest-dom1
Supported on SPARC
M10: Yes

list the status of all Usage: ldm list

the guest domains
on the system Example
root@m10-1-syd04-a:~#
Supported on root@m10-1-syd04-a:~# ldm list
SPARC T3/T4/T5 : Yes NAME STATE FLAGS CONS
Supported on SPARC VCPU MEMORY UTIL UPTIME
M5/M6: Yes primary active -n-cv- UART 8
Supported on SPARC 8G 0.1% 13d 14m
M10: Yes ldom1 active -n---- 5000 4
4G 0.0% 19d 23h 21m
ldom2 active -t---- 5001 4 4G
25% 19d 23h 21m
root@m10-1-syd04-a:~#

how to manually list Usage: ldm list-bindings / ldm list-

the LDOM con g on a bindings <ldom-name>
system
Example
Supported on
SPARC T3/T4/T5 : Yes #ldm list-bindings
Supported on SPARC
M5/M6: Yes
Supported on SPARC #ldm list-bindings guestdom2
M10: Yes

list current save Usage: ldm list-spcon g

LDOM con g in
Solaris Example
root@t5-8-sin06-a:~# ldm list-spcon g
factory-default
Supported on guestdom1 [next poweron]
SPARC T3/T4/T5 : Yes root@t5-8-sin06-a:~#
Supported on SPARC
M5/M6: Yes
Supported on SPARC
M10: Yes

when do we need to Usage: ldm start-reconf primary

initiate an LDOM
recon g reboot
Supported on
SPARC T3/T4/T5 : Yes
Supported on SPARC
M5/M6: Yes
Supported on SPARC
M10: Yes
The "start-reconf" needs to be executed
on the primary domain if
changes [ add/remove ] is to be made to
the resources [ cpu,io
and memory] that is currently assigned
to it.
Example

jack@t5-8-sin06-a:~$ ldm list

NAME STATE FLAGS CONS
VCPU MEMORY UTIL NORM UPTIME
primary active -n-c-- UART
1024 2095872M 0.0% 0.0% 1h 8m
jack@t5-8-sin06-a:~$ ldm start-reconf
primary
Initiating a delayed recon guration
operation on the primary domain.
All con guration changes for other
domains are disabled until the primary
domain reboots, at which time the new
con guration for the primary domain
will also take e ect.
jack@t5-8-sin06-a:~$ ldm set-core 4
primary
-------------------------------------------------------------
-----------------
Notice: The primary domain is in the
process of a delayed recon guration.
Any changes made to the primary domain
will only take e ect after it reboots.
-------------------------------------------------------------
-----------------
jack@t5-8-sin06-a:~$ ldm set-memory
128G primary
Cannot enable FILE_DAC_READ privilege
jack@t5-8-sin06-a:~$ su
Password:
Jun 26 16:10:26 t5-8-sin06-a su: 'su root'
succeeded for jack on /dev/console
root@t5-8-sin06-a:~# ldm set-memory
128G primary
-------------------------------------------------------------
-----------------
Notice: The primary domain is in the
process of a delayed recon guration.
Any changes made to the primary domain
will only take e ect after it reboots.
-------------------------------------------------------------
-----------------
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -ndc-- UART 32
128G 0.0% 0.0% 1h 10m
root@t5-8-sin06-a:~#
root@t5-8-sin06-a:~# reboot
Jun 26 16:11:55 t5-8-sin06-a reboot:
initiated by jack on /dev/console
Jun 26 16:12:02 t5-8-sin06-a syslogd: going
down on signal 15
syncing le systems... done

Check CPU activation Usage: ldm list-permits

Supported on
SPARC T3/T4/T5 : No
Supported on SPARC
M5/M6: No
Supported on SPARC
M10: Yes
Example
eis@m10-1-syd04-a:~$ uname -a
SunOS m10-1-syd04-a.au.oracle.com 5.11
11.2 sun4v sparc sun4v
eis@m10-1-syd04-a:~$ su
Password:
root@m10-1-syd04-a:~# ldm list-permits

CPU CORE
PERMITS (PERMANENT) IN USE REST
16 (16) 8 8

Check Usage: svccfg -s ldmd listprop

Autoreplacement ldmd/autoreplacement_policy_cpu
policy for CPU
Example
Supported on
SPARC T3/T4/T5 : No
o display autoreplacement_policy_cpu
Supported on SPARC
property value use the following
M5/M6: No
command:
Supported on SPARC
M10: Yes
#svccfg -s ldmd listprop ldmd listprop
ldmd/autoreplacement_policy_cpu

Example (from M10-1 system)

root@m10-1-syd04-a:~# svccfg -s ldmd
listprop ldmd/autoreplacement_policy_cpu
ldmd/autoreplacement_policy_cpu
integer 1
root@m10-1-syd04-a:~#

Note 1 == replacement policy enabled

0 == replacement policy disabled

Example to change replacement policy

:
#svccfg -s ldmd listprop
ldmd/autoreplacement_policy_cpu
#svcadm disable ldmd
#svccfg -s ldmd setprop
ldmd/autoreplacement_policy_cpu=0
#svcadm refresh ldmd
#svcadm enable ldmd

stop/break/unbind

Action Command

issue send Usage: CTRL+] type “send break”

break followed by return then another
return
Supported on
SPARC T3/T4/T5 :
Example
Yes
Supported on root@t5-8-sin06-a:~# telnet localhost
SPARC M5/M6: 5000
Yes Trying ::1...
Supported on telnet: connect to address ::1:
SPARC M10: Yes Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.

Connecting to console "guestdom1" in

group "guestdom1" ....
Press ~? for control options ..

telnet> send brk

Debugging requested; hardware
watchdog suspended.
c)ontinue, s)ync, r)eset? s

panic[cpu18]/thread=2a1018f1c60:
sync initiated

stop Guest Usage: ldm stop < guest domain name

Domain >

Example
Supported on
SPARC T3/T4/T5 : root@t5-8-sin06-a:~# ldm stop
Yes guestdom2
Supported on LDom guestdom2 stopped
SPARC M5/M6: root@t5-8-sin06-a:~#
Yes
Supported on
SPARC M10: Yes

ubind Guest Usage: ldm unbind <guest-domain-

Domain name>

Supported on Example
SPARC T3/T4/T5 :
Yes root@t5-8-sin06-a:~# ldm unbind
Supported on guest-dom1
SPARC M5/M6:
Yes
Supported on
SPARC M10: Yes

Add/Create/Assign

Action Command

Add Guest Usage :ldm add-domain <guest domain>

Domain

Example
root@t5-8-sin06-a:/dev/dsk# ldm add-domain guestdom1
Supported on root@t5-8-sin06-a:/dev/dsk# ldm ls
SPARC T3/T4/T5 NAME STATE FLAGS CONS VCPU
: Yes Supported MEMORY UTIL NORM UPTIME
on SPARC primary active -n-cv- UART 16 128G 0.2% 0.1%
M5/M6: Yes 40m
Support on guestdom1 inactive ------
SPARC M10: root@t5-8-sin06-a:/dev/dsk#
Yes

assign cpu Usage: ldm add-vcpu <number> <guest-domain-name>

threads to
Guest Domain
Example
Supported on
SPARC T3/T4/T5 jack@m5-32-sca11-a-pdom01:~$
: Yes Supported jack@m5-32-sca11-a-pdom01:~$ ldm list
on SPARC NAME STATE FLAGS CONS VCPU
M5/M6: Yes MEMORY UTIL NORM UPTIME
Support on primary active -n-cv- UART 8 251648M 0.3%
SPARC M10: 0.2% 4h 22m
Yes guest-dom1 active -n---- 5001 8 4G 0.2%
0.2% 4m
&nbnbsp;
jack@m5-32-sca11-a-pdom01:~$ ldm add-vcpu 6 guest-
dom1
jack@m5-32-sca11-a-pdom01:~$ ldm list
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 8 251648M 0.6%
0.5% 4h 23m
guest-dom1 active -n---- 5001 14 4G 1.2%
0.3% 5m
jack@m5-32-sca11-a-pdom01:~$

assign vcpu Usage: ldm add-core, ldm set-core <number> <ldom>

units of cores
Note: CPUs cannot be assigned to an ldom in units of
cores and in units of threads simultaneously.
Supported on
Choose either of these units of assignment for each
SPARC T3/T4/T5
ldom
: Yes Supported
on SPARC
M5/M6: Yes
Supported on
SPARC M10:
Yes

assign Usage: ldm add-memory <number> <guest-domain-name>

memory to ldm set-memory <number> <guest-domain-name>
Guest Domain
Note that the Guest domain OS must be up and running to
Supported on
do memory DR.
SPARC T3/T4/T5
: Yes Supported
Example
on SPARC
M5/M6: Yes root@t5-8-sin06-a:~# ldm ls
Supported on NAME STATE FLAGS CONS VCPU
SPARC M10: MEMORY UTIL NORM UPTIME
Yes primary active -n-cv- UART 32 2G 0.2% 0.1%
15h 3m
guestdomain1 active -n---- 5000 64 8G 0.0%
0.0% 14h 9m
root@t5-8-sin06-a:~# ldm add-memory 4G guestdomain1
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 32 2G 0.2% 0.2%
15h 4m
guestdomain1 active -n---- 5000 64 12G 2.2%
1.0% 14h 10m
root@t5-8-sin06-a:~#

add vnet Usage: ldm add-vnet <if-name> <vsw-name> <ldom-name>

device to
Guest Domain adds a virtual network device to a domain

Example
Supported on
SPARC T3/T4/T5 root@m10-1-syd04-a:~# ldm add-vnet vnet2 primary-vsw0
: Yes Supported ldom1
on SPARC root@m10-1-syd04-a:~# ldm list-bindings ldom1
M5/M6: Yes KPROP
Supported on vnet1 primary-vsw0@primary 0 network@0
SPARC M10: 00:14:4f:f9:bb:ca 1 1500
Yes PEER MAC MODE PVID VID MTU
MAXBW LINKPROP
primary-vsw0@primary 00:14:4f:fa:21:9f 1
1500
vnet0@ldom2 00:14:4f:f9:08:51 1
1500
vnet2@ldom1 00:14:4f:fa:66:56 1
1500
NAME SERVICE ID DEVICE MAC MODE PVID VID
MTU MAXBW LINKPROP
vnet2 primary-vsw0@primary 1 network@1
00:14:4f:fa:66:56 1 1500
PEER MAC MODE PVID VID MTU
MAXBW LINKPROP
primary-vsw0@primary 00:14:4f:fa:21:9f 1
1500
vnet1@ldom1 00:14:4f:f9:bb:ca 1
1500
vnet0@ldom2 00:14:4f:f9:08:51 1
1500

assign disk Usage: ldm add-vdisk [timeout=<seconds>] [id=

resource to <diskid>] <disk_name> <volume_name>@<service_name>
Guest Domain <ldom>

Example
Supported on
SPARC T3/T4/T5 root@t5-8-sin06-a:~# ldm ls -o disk primary
: Yes Supported NAME
on SPARC primary
M5/M6: Yes
Supported on VDS
SPARC M10: NAME VOLUME OPTIONS MPGROUP DEVICE
Yes primary-vds0 S11iso /export/sol-11_1-
text-sparc.iso
guestdom1bootdisk /dev/dsk/c13t4d0s0
guestdom2bootdisk /dev/dsk/c13t4d1s2

root@t5-8-sin06-a:~# ldm ls -o disk guestdom3

NAME
guestdom3

root@t5-8-sin06-a:~#
root@t5-8-sin06-a:~# ldm add-vdisk cdromiso
S11iso@primary-vds0 guestdom3
root@t5-8-sin06-a:~# ldm ls -o disk guestdom3
NAME
guestdom3

DISK
NAME VOLUME TOUT ID DEVICE SERVER
MPGROUP
cdromiso S11iso@primary-vds0 0 disk@0
primary

root@t5-8-sin06-a:~#

Remove/Delete

Action Command

Remove a Usage: ldm remove-domain (-a | <ldom>...)

Guest Domain
Example

Supported on
root@t5-8-sin06-a:~# ldm ls
SPARC T3/T4/T5
NAME STATE FLAGS CONS VCPU
: Yes
MEMORY UTIL NORM UPTIME
Supported on
primary active -n-cv- UART 16
SPARC M5/M6:
128G 0.1% 0.1% 1d 1h 13m
Yes
guestdom1 bound ------ 5000
Supported on
128 128G
SPARC M10:
guestdom2 inactive ------
Yes
32 256G
guestdom3 inactive ------
root@t5-8-sin06-a:~# ldm remove-domain
guestdom3
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 16
128G 0.3% 0.3% 1d 1h 13m
guestdom1 bound ------ 5000
128 128G
guestdom2 inactive ------ 32
256G
root@t5-8-sin06-a:~#

Remove disk Usage: ldm remove-vdisk [-f] <disk_name>

resource from <ldom-name>
Guest Domain

Example
Supported on
SPARC T3/T4/T5 root@m10-1-syd04-a:~# ldm remove-vdisk
: Yes vdisk2 ldom1
Supported on root@m10-1-syd04-a:~# ldm list-bindings
SPARC M5/M6: ldom1
Yes NAME STATE FLAGS CONS VCPU
Supported on MEMORY UTIL UPTIME
SPARC M10: ldom1 active -n---- 5000 4
Yes 6G 1.4% 2h 27m

UUID
537e8abe-6bf5-cac6-b1d6-f2670010a85b

MAC

...

DISK
NAME VOLUME TOUT
ID DEVICE SERVER MPGROUP
vdisk1 vol1@primary-vds0
0 disk@0 primary

VCONS
NAME SERVICE PORT LOGGING
ldom1 primary-vcc0@primary
5000 on

root@m10-1-syd04-a:~#

Remove Usage: ldm remove-vnet [-f] <if_name>

virtual <ldom>
network
device from a Example
Guest Domain
jack@m5-32-sca11-a-pdom01:~$
Supported on jack@m5-32-sca11-a-pdom01:~$ ldm remove-
SPARC T3/T4/T5 vnet vnet2 guest-dom1
: Yes
Supported on
SPARC M5/M6:
Yes
Supported on
SPARC M10:
Yes

Remove CPU Usage: ldm remove-vcpu [-f|--force] [-c|--

threads from core] <number> <ldom-name>
a Giuest
Domain
Example
Supported on root@t5-8-sin06-a:~# ldm ls
SPARC T3/T4/T5 NAME STATE FLAGS CONS VCPU
: Yes MEMORY UTIL NORM UPTIME
Supported on primary active -n-cv- UART 32
SPARC M5/M6: 2G 0.1% 0.1% 15h 8m
Yes guestdomain1 active -n---- 5000 96
Supported on 12G 0.1% 0.0% 14h 14m
SPARC M10: root@t5-8-sin06-a:~# ldm remove-vcpu 32
Yes guestdomain1
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 32
2G 0.2% 0.1% 15h 8m
guestdomain1 active -n---- 5000 64
12G 1.3% 1.2% 14h 14m
root@t5-8-sin06-a:~#

Remove Usage: ldm remove-core [-f|--force]

virtual cpu <number>|cid=<id>[,<id>[,...]] <ldom-name>
units in cores
from a Guest Example
Domain
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
Supported on MEMORY UTIL NORM UPTIME
SPARC T3/T4/T5 primary active -n-cv- UART 16
: Yes 128G 0.3% 0.3% 1d 22h 29m
Supported on guestdom1 bound ------ 5000
SPARC M5/M6: 128 128G
Yes guestdom2 active -n---- 5001 32
Supported on 256G 0.0% 0.0% 21h 3m
SPARC M10: guestdom3 active -t---- 5002 64
Yes 64G 1.6% 1.6% 9m
root@t5-8-sin06-a:~# ldm remove-core 2
guestdom2
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 16
128G 0.2% 0.2% 1d 22h 29m
guestdom1 bound ------ 5000 128
128G
guestdom2 active -n---- 5001 16
256G 0.8% 0.8% 21h 4m
guestdom3 active -t---- 5002 64
64G 1.6% 1.6% 9m
root@t5-8-sin06-a:~#

Remove Usage: ldm remove-memory <number>

memory from <ldom-name>
a Guest
Domain Example

Supported on root@m5-32-sca11-a-pdom01:~# ldm list

SPARC T3/T4/T5 NAME STATE FLAGS CONS VCPU
: Yes MEMORY UTIL NORM UPTIME
Supported on primary active -n-cv- UART 8
SPARC M5/M6: 251648M 1.8% 1.7% 4h 55m
Yes guest-dom1 active -n---- 5001 8
Supported on 12G 1.1% 0.8% 4m
SPARC M10: root@m5-32-sca11-a-pdom01:~# ldm
Yes remove-memory 8G guest-dom1
root@m5-32-sca11-a-pdom01:~# ldm list
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 8
251648M 1.0% 1.1% 4h 58m
guest-dom1 active -n---- 5001 8
4G 0.2% 0.2% 6m
root@m5-32-sca11-a-pdom01:~#

start

Action Command

start a Guest Domain Usage: ldm start (-a | -i < le>

| <ldom>...

Supported on
Example
SPARC T3/T4/T5 : Yes
Supported on SPARC #ldm start guest-dom1
M5/M6: Yes
Supported on SPARC M10:
Yes

Save LDOM Con g

nbsp;

Action Command

save ldom con guration Usage: ldm add-spcon g [-r

to the SP <autosave>] <con g_name>
Supported on
SPARC T3/T4/T5 : Yes
Example
Supported on SPARC
M5/M6: Yes root@t5-8-sin06-a:~# ldm list-
Supported on SPARC M10: spcon g
Yes factory-default
guestdom1 [next poweron]
root@t5-8-sin06-a:~#
root@t5-8-sin06-a:~# ldm
add-spcon g
mynewcon guration
root@t5-8-sin06-a:~# ldm list-
spcon g
factory-default
mynewcon guration [current]
root@t5-8-sin06-a:~#

backup of existing Usage: ldm list-constraints -x

con guration from
the control domain
Supported on
SPARC T3/T4/T5 : Yes
Supported on SPARC
M5/M6: Yes
Supported on SPARC M10:
Yes
> < le.xml >
Example
# ldm list-constraints -x >
/var/tmp/guest-domain-
name.xml
# ldm list-bindings >
/var/tmp/full-bindings
# ldm ls -l > /var/tmp/guest-
domain-list.xml

Resources

Action Command

identitify usage: ldm list-constraints

physical
resources Example
bindings
Supported on
SPARC T3/T4/T5 jack@m5-32-sca11-a-pdom01:~$ ldm list-constraints
DOMAIN
:Yes
primary
Supported on
SPARC M5/M6: UUID
Yes 9d1d44bb-ec6e-41bb-f8e6-c56e8b8621d2
Supported on
SPARC M10: MAC
Yes 00:10:e0:24:6a:b1

HOSTID
0x86246a9d

CONTROL
failure-policy=ignore
extended-mapin-space=on
cpu-arch=native
rc-add-policy=
shutdown-group=0

VCPU
COUNT: 288

MEMORY
SIZE: 3144448M

CONSTRAINT
threading=max-throughput

VARIABLES
boot-device=/pci@700/pci@1/pci@0/pci@c/pci@0/pci@4/scsi@0/disk@w5000cca0162f5cc5,0:a
pm_boot_policy=disabled=0;ttfc=22746;ttmr=0;
use-nvramrc?=true

IO
DEVICE OPTIONS
pci_16
pci_17
pci_18
pci_19
pci_24
pci_25
pci_26
pci_27
pci_20
pci_21
pci_22
pci_23

bind Usage: ldm bind [-f] [-q] (-i < le> | <ldom>)
resources to a
Guest Domain
Example

Supported on root@m5-32-sca11-a-pdom01:~# ldm list

SPARC T3/T4/T5 NAME STATE FLAGS CONS VCPU MEMORY UTIL NORM UPTIME
: Yes primary active -n-cv- UART 8 251648M 2.8% 1.6% 6m
Supported on guest-dom1 inactive ------ 8 4G
SPARC M5/M6: root@m5-32-sca11-a-pdom01:~#
Yes root@m5-32-sca11-a-pdom01:~# ldm bind guest-dom1
Supported on root@m5-32-sca11-a-pdom01:~# ldm list
SPARC M10: NAME STATE FLAGS CONS VCPU MEMORY UTIL NORM UPTIME
Yes primary active -n-cv- UART 8 251648M 2.8% 1.7% 6m
guest-dom1 bound ------ 5001 8 4G

unbind Usage: ldm unbind <ldom-name>

resources to a
Guest Domain
Example
Supported on
SPARC T3/T4/T5 root@t5-8-sin06-a:~# ldm ls
: Yes NAME STATE FLAGS CONS VCPU MEMORY UTIL NORM UPTIME
Supported on primary active -n-cv- UART 16 128G 0.4% 0.4% 22h 43m
SPARC M5/M6: guestdom1 bound ------ 5000 128 256G
Yes guestdom2 bound ------ 5001 8 1G
Supported on root@t5-8-sin06-a:~# ldm unbind guestdom2
SPARC M10: root@t5-8-sin06-a:~# ldm ls
Yes NAME STATE FLAGS CONS VCPU MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 16 128G 1.2% 1.2% 22h 44m
guestdom1 bound ------ 5000 128 256G
guestdom2 inactive ------ 8 1G
root@t5-8-sin06-a:~#

Accessing Guest Domain

Action Command

login to the console Usage: telnet localhost < console

of a Guest Domain port # >

Supported on
Example
SPARC T3/T4/T5 : Yes
Supported on SPARC
M5/M6: Yes root@m10-1-syd04-a:~# ldm list
Supported on SPARC NAME STATE FLAGS
M10: Yes CONS VCPU MEMORY UTIL
UPTIME
primary active -n-cv- UART
8 8G 0.1% 22h 49m
ldom1 active -n---- 5000
4 4G 0.0% 22h 47m
ldom2 active -t---- 5001
4 4G 16% 4s
root@m10-1-syd04-a:~# telnet
localhost 5001
Trying ::1...
telnet: connect to address ::1:
Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.

Connecting to console "ldom2"

in group "ldom2" ....
Press ~? for control options ..

{0} ok
{0} ok
{0} ok
{0} ok

Exit from a Guest Usage: CTRL+] then q

Domain console
Example
Supported on root@t5-8-sin06-a:~# telnet
SPARC T3/T4/T5 : Yes localhost 5001
Supported on SPARC Trying ::1...
M5/M6: Yes telnet: connect to address ::1:
Supported on SPARC Connection refused
M10: Yes Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.

Connecting to console
"guestdom2" in group
"guestdom2" ....
Press ~? for control options ..

{0} ok devalias
vdisk0 /virtual-
devices@100/channel-
devices@200/disk@0
cdromiso /virtual-
devices@100/channel-
devices@200/disk@1
vnet0 /virtual-
devices@100/channel-
devices@200/network@0
net /virtual-
devices@100/channel-
devices@200/network@0
disk /virtual-
devices@100/channel-
devices@200/disk@1
virtual-console /virtual-
devices/console@1
name aliases
{0} ok boot vdisk0
Boot device: /virtual-
devices@100/channel-
devices@200/disk@0 File
and args:
SunOS Release 5.11 Version 11.1
64-bit
Copyright (c) 1983, 2012, Oracle
and/or its a liates. All rights
reserved.
Hostname: guestdom2

guestdom2 console login:

telnet> quit
Connection to localhost closed.
root@t5-8-sin06-a:~#

Enable/Disable usage: ldm set-vcons log=o |

console loggging on <ldom-name>
function for a Guest ldm ls - o console < guest
Domain domain >

Note: OVM 3.0

required
The guest gomain console log
Supported on will be stored in the following
SPARC T3/T4/T5 : Yes directory
Supported on SPARC
M5/M6: Yes /var/log/vntsd
Supported on SPARC
M10: Yes

Display current usage: ldm list -o console <ldom-

console settings of a name>
Guest Domain
Example

Supported on root@m10-1-syd04-a:~# ldm list

SPARC T3/T4/T5 : Yes -o console ldom1
Supported on SPARC NAME
M5/M6: Yes ldom1
Supported on SPARC
M10: Yes VCONS
NAME SERVICE
PORT LOGGING
ldom1 primary-
vcc0@primary 5000
on

root@m10-1-syd04-a:~# ldm list

-o console
NAME
primary

VCC
NAME PORT-RANGE
primary-vcc0 5000-5100

VCONS
NAME SERVICE
PORT LOGGING
UART

------------------------------------------------
------------------------------
NAME
ldom1

VCONS
NAME SERVICE
PORT LOGGING
ldom1 primary-
vcc0@primary 5000
on

------------------------------------------------
------------------------------
NAME
ldom2

VCONS
NAME SERVICE
PORT LOGGING
ldom2 primary-
vcc0@primary 5001
on

root@m10-1-syd04-a:~#

Support Data Collection

Explorer

Action Command

Collect System T3,T4,T5 and

information via M10 : #/usr/sbin/explorer -w
Explorer default
command
Mx-32 PDOM (primary) :
Supported on #/usr/sbin/explorer -w
SPARC T3/T4/T5 : Yes default,\!ipmi -timeout 900
Supported on SPARC
M5/M6: Yes
Supported on SPARC
M10: Yes

SP snapshot

Action KM Document

Data collection SPARC M5-32 Servers: M5-32

from SPARC snapshot using ILOM 3.2.1.3.b and
M5/M6 SP beyond [Doc ID
(service 1538200.1]
processor)

Data collection Fujitsu M10 Servers (Doc ID

from SPARC M10 1540225.1)
SP (service
processor)

Data collection Collect ILOM snapshot on T3-x and

from SPARC T4-x systems without an active
T3/T4/T5 SP network management connection
(service (Doc ID 1518044.1)
processor)
Troubleshooting data needed for T3-
x, T4-x & T5-x servers (Doc ID
1470580.1)

display LDOM Info

Action Command

list all Service Usage: ldm ls [-e] [-l] [-S] [-o <format>] [-p] [<ldom>...]
Domains in the
platform format' is one or more of:
from console,core,cpu,crypto,disk,domain,memory,network,physio,resmgmt,serial,status
Solaris
Example:

Supported on
SPARC T3/T4/T5 root@m10-1-syd04-a:~# ldm ls -o console,network,disk
: Yes
Supported on
SPARC M5/M6:
Yes
Supported on
SPARC M10: Yes

list all LDOM Usage: [T3/T4/t5] show /HOST/domain/con gs date_created -t

con g from SP
with Note: For SPARC T3/T4 and T5 "/HOST/domain/con gs" will list all the saved con gurations and "/HOST/bootmode con g
timestamp and active con g.

Supported on Example T3/T4/T5

SPARC T3/T4/T5
-> show /HOST/domain/configs date_created -t
: Yes Target | Property | Value
Supported on ---------------------------------+--------------+---------------------
SPARC M5/M6: /HOST/domain/configs/mydomain | date_created | 2013-11-13 12:50:27
Yes /HOST/domain/configs/guestdom1 | date_created | 2013-11-18 15:26:58
Supported on
SPARC M10: No ->

Usage [M5/M6] show/HOSTx/domain/con gs date_created -t [where x=0..3 ]

Note: For SPARC M5/M6 "/HOSTx/domain/con gs" will list all the saved con gurations and "/HOSTx/bootmode con g" fo
and active con g.

Example M5/M6
> show /HOST0/domain/con gs date_created -t
Target | Property | Value
-------------+-----------------+-----------------------------------
/HOST0/domain/con gs/beba | date_created | 2014-02-27 06:56:13
/HOST0/domain/con gs/101113 | date_created | 2013-11-10 05:09:55
/HOST0/domain/con gs/ nal1 | date_created | 2014-01-13 22:39:04

list current Usage [ T3/T4/T5] show /HOST/domain/con g -t

LDOM con g
from SP Example T3/T4/T5
-> show /HOST/bootmode config -t
Target | Property | Value
Supported on
--------------------------+------------------+--------------------
SPARC T3/T4/T5 /HOST/bootmode | config | guestdom1
: Yes
Supported on ->
SPARC M5/M6:
Yes
Supported on Usage [M5/M6] show/HOSTx/domain/con gs -t [where x=0..3 ]
SPARC M10: Yes
Example M5/M6
-> show /HOST0/domain/con gs -t
Target | Property | Value
------------------+--------------------+------------------------------------
/HOST0/domain/con gs/101113 | date_created | 2013-11-10 05:09:55
/HOST0/domain/con gs/101113 | domains | 2

Check Usage: virtinfo -a

virtualization
info The virtinfo utility provides current domain information

Primary domain output

eis@m10-1-syd04-a:~$ virtinfo -a
Supported on Domain role: LDoms control I/O service root
SPARC T3/T4/T5 Domain name: primary
: Yes Domain UUID: 78b8eb2a-6a60-4ce7-a383-4fd27aafeac5
Supported on Control domain: Unknown
SPARC M5/M6: Chassis serial#: Unknown
Yes eis@m10-1-syd04-a:~$
Supported on
SPARC M10: Yes
Guest domain output
root@bookable-10-187-57-211:~# virtinfo -a
Domain role: LDoms guest
Domain name: ldom1
Domain UUID: 53066220-e871-6998-ed41-e13d7aa79745
Control domain: m10-1-syd04-a
Chassis serial#: PZ31341009

Crashdump:

Control Domain

Action Example

SPARC Usage: set /HOST/send_break_action=dumpcore

T3/T4/T5
Control
Domain
from
ILOM
SPARC Usage: set /HOSTn/send_break_action=dumpcore
M5/M6 where n=0 ...3
Control
Domain Example
from
-> pwd
ILOM Current default target: /HOST0

-> set send_break_action=dumpcore

Set 'send_break_action' to 'dumpcore'

-> start /HOST0/console

Are you sure you want to start /HOST0/console (y/n)? y

Serial console started. To stop, type #.

panic[cpu508]/thread=2a108c77c60: sync initiated

sched: trap type = 0x0

pid=0, pc=0x0, sp=0x0, tstate=0x0, context=0x0
o0-o7: 0, 0, 0, 0, 0, 0, 0, 0

SPARC Usage: XSCF>reset -p <ppar_id> -g primary panic

M10
Control
Domain
XSCF

Guest Domain

Action Command

Crash a guest Usage: ldm panic-domain <ldom-name>

domain from
the control Example
domain eis@m10-1-syd04-a:~$ ldm panic-domain ldom2
eis@m10-1-syd04-a:~$ ldm list
Supported on
NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME
SPARC T3/T4/T5 primary active -n-cv- UART 8 8G 0.6% 27d 1h 13m
: Yes ldom1 active -n---- 5000 4 6G 0.0% 11d 18h 57m
Supported on ldom2 active -t---- 5001 4 4G 100% 13d 21h 48m
SPARC M5/M6: eis@m10-1-syd04-a:~$ telnet localhost 5001
Yes Trying ::1...
Supported on telnet: connect to address ::1: Connection refused
SPARC M10: Trying 127.0.0.1...
Yes Connected to localhost.
Escape character is '^]'.

Connecting to console "ldom2" in group "ldom2" ....

Press ~? for control options ..

bookable-10.187-57-212.au.oracle.com console login:

Jul 9 12:41:57 10.187-57-212.au.oracle.com savecore:Decompress the crash dump with
Jul 9 12:41:57 10.187-57-212.au.oracle.com 'savecore -vf /var/crash/vmdump.0'

Crash Guesdt Usage: reset [ [-q] -{y|n}] -p ppar_id -g domainname sir

Domain from reset [ [-q] -{y|n}] -p ppar_id -g domainname panic
Service
Processor where ppar_id =0 ...15
domainname = guest domain name
Supported on
sir = resets ldom
SPARC T3/T4/T5
panic = crashes the guest domain
: No
Supported on Example
SPARC M5/M6:
No XSCF> reset -p 0 -g ldom2 panic
PPAR-ID :00
Supported on
GuestDomain to panic : ldom2
SPARC M10: Be sure to execute "ldm add-spconfig" before using this
Yes command when you have changed the ldm configuration.
Otherwise, an unexpected domain might be reset.
Continue? [y|n] :y
00 ldom2 : Resetting
Note: Use XSCF command "showdomainstatus" to check result of panic.

Guest Domain Console

#
# uname -a
SunOS 10.187-57-212.au.oracle.com 5.10 Generic_147147-26 sun4v sparc sun4v
#
panic[cpu0]/thread=2a10001fc80: Panic - Generated at user request
000002a10001f6a0 unix:process_nonresumable_error+2d8 (2a10001f890,0,ff,40,5,40)
%l0-3: 0000000000000100 0000000003000000 0000000000000001000000000180c600
%l4-7: 0000000000000000 0000000100000000 00000000ffffffff0000000000000000
000002a10001f7e0 unix:ktl0+64 (0,1,0,100,1010101,12)
%l0-3: 000000000180c000 0000000000000000 00000000110014040000000001029aa4
%l4-7: 0000000000000000 0000000000000000 0000000000000000000002a10001f890
000002a10001f930 unix:cpu_halt+f4 (180c000, 0, 19dd9b8,19dd888, 180c000, 0)
%l0-3: 00000000019d73a4 0000000000000001 00000000000000160000000000000000
%l4-7: 0000000000000000 0000000000000002 000000000180c1780000000000000001
000002a10001f9e0 unix:idle+128 (1866c00, 4, 180c000,ffffffffffffffff,1,1865800)
%l0-3: 00000000019d7380 000000000000001b 0000000000000000ffffffffffffffff
%l4-7: 0000000000000001 0000000001a6ec00 000000000180c1780000000001045bac

syncing file systems... done

dumping to /dev/zvol/dsk/rpool/dump, offset 65536, content:kernel
0:17 100% done
100% done: 62437 pages dumped, dump succeeded
rebooting...
Resetting...

SPARC M10-1, No Keyboard

Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
OpenBoot 4.34.0, 4096 MB memory available, Serial #xxxx1300.
[ 1.24.0 ]
Ethernet address x:xx:xx:xx:96:24, Host ID: xxxxx624.

Checked for failed components (CPU/Memory)

Action Command

to check failed cpu or memory Usage:

components from Control Domain ldm list-domain -l
-S

Supported on SPARC T3/T4/T5 : Yes ldm list-devices -S

Supported on SPARC M5/M6: Yes mem cpu
Supported on SPARC M10: Yes

&

SPARC LDOM CLI Cheat Sheet

This document is designed to be a a quick platform speci c cheat sheet to help engineers run important LDOM task on a SPARC systems
( SPARC T3,T4,T5,M5,M6 and M10 )

Display Default LDOM services

Action Command

Check ldom #svcs ldmd

manager
(ldmd)
Supported on
SPARC T3/T4/T5
: Yes
Supported on
SPARC M5/M6:
Yes
Supported on
SPARC M10:
Yes
#svcs vntsd
Check vntsd is
running
Supported on
SPARC T3/T4/T5
: Yes
Supported on
SPARC M5/M6:
Yes
Supported on
SPARC M10:
Yes
#ldm list-services primary
Check Default
Services are
running
Supported on
SPARC T3/T4/T5
: Yes
Supported on
SPARC M5/M6:
Yes
Supported on
SPARC M10:
Yes

Check ldm Usage :ldm -V

software
Example
Supported on
SPARC T3/T4/T5 #ldm -V
: Yes
Logical Domains Manager (v 3.0.0.3)
Supported on Hypervisor control protocol v 1.11
SPARC M5/M6: Using Hypervisor MD v 1.4
Yes
Supported on System PROM:
SPARC M10: Hostconfig v. 1.3.5.c @(#)Hostconfig 1.3.5.c 2014/03/21 19:04
Yes Hypervisor v. 1.12.5.b @(#)Hypervisor 1.12.5.b 2014/02/07 13:52
OpenBoot v. 4.35.5.a @(#)OpenBoot 4.35.5.a 2014/01/31 14:12

[ check ldoms manager package in Solaris 11 ]

Usage: pkg info ldomsmanager

Example
eis@m10-1-syd04-a:~$ pkg info ldomsmanager
Name: system/ldoms/ldomsmanager
Summary: Logical Domains Manager
Description: LDoms Manager - Virtualization for SPARC T-Series
Category: System/Virtualization
State: Installed
Publisher: solaris
Version: 3.1.1.0.5
Build Release: 5.11
Branch: 0.175.2.0.0.34.0
Packaging Date: March 3, 2014 02:18:20 PM
Size: 3.87 MB
FMRI: pkg://solaris/system/ldoms/
ldomsmanager@3.1.1.0.5,5.11-0.175.2.0.0.34.0:20140303T141820Z
eis@m10-1-syd04-a:~$
eis@m10-1-syd04-a:~$

Creating Default LDOM services

Action Command

Usage: ldm add-vcc port-range=x-

add virtual
y <vcc-name> <ldom>
console
concentrator (vcc)
Example
Supported on
SPARC T3/T4/T5 : #ldm add-vcc port-range=5000-
Yes 5100 primary-vcc0 primary
Supported on
SPARC M5/M6: Yes
Supported on
SPARC M10: Yes

add virtual Usage: ldm add-vsw net-dev=

network switch <device> <vsw-name> <ldom-
(vsw) name>

Supported on Example
SPARC T3/T4/T5 : #ldm add-vsw net-dev=net0
Yes primary-vsw0 primary
Supported on
SPARC M5/M6: Yes
Supported on
SPARC M10: Yes

Usage ldm add-vds <service-

add virtual disk
name> <ldom-name>
server (vds)

Example

Supported on
#ldm add-vds primary-vds0
SPARC T3/T4/T5 :
primary
Yes
Supported on
SPARC M5/M6: Yes
Supported on
SPARC M10: Yes

add virtual storage Usage: ldm add-vdsdev <backend>

device to virtual <volume@service>
disk service
where

Supported on backend: specify a physical disk

SPARC T3/T4/T5 : path. In addition to a le, you can
Yes specify the path of a disk, disk slice
Supported on etc for the backend.
SPARC M5/M6: Yes
volume: specify a volume name
Supported on
that is unique within the virtual disk
SPARC M10: Yes
server

service: specify a virtual disk service

name

Example:

### Primary domain.

### Add zfs lesystem to existing
Guest domain
root@m10-1-syd04-a:~# zfs create
-V 5G rpool/ckt-disk2
root@m10-1-syd04-a:~# ls
/dev/zvol/dsk/rpool
ROOT VARSHARE ckt-disk2
dump export swap

root@m10-1-syd04-a:~# ldm add-

vdsdev /dev/zvol/dsk/rpool/ckt-
disk2 disk2@primary-vds0

In this example a 5G backend zfs

partition is created called ckt-disk2
The volume name is ckt-disk2
The vds is called primary-vds0

Removing Default LDOM services

Action Command

Usage: ldm remove-vcc [-f] <vcc_name>

remove virtual
console
Example
concentrator
(vcc)
root@m5-32-sca11-a-pdom00:~# ldm list-
services primary
VCC
Supported on
NAME LDOM PORT-RANGE
SPARC T3/T4/T5
primary-vcc0 primary 5000-5100
: Yes
Supported on
root@m5-32-sca11-a-pdom00:~# ldm remove-
SPARC M5/M6:
vcc primary-vcc0
Yes
root@m5-32-sca11-a-pdom00:~# ldm list
Supported on
NAME STATE FLAGS CONS VCPU
SPARC M10:
MEMORY UTIL NORM UPTIME
Yes
primary active -n-c-- UART 192
2047G 0.7% 0.6% 47m
root@m5-32-sca11-a-pdom00:~#

remove virtual Usage: ldm remove-vsw <vsw-service-name>

network
switch (vsw) Example
root@m5-32-sca11-a-pdom00:~# ldm list-
services primary
Supported on VSW
SPARC T3/T4/T5 NAME LDOM MAC NET-
: Yes DEV ID DEVICE LINKPROP DEFAULT-VLAN-ID
Supported on PVID VID MTU MODE INTER-VNET-LINK
SPARC M5/M6: primary-vsw0
Yes primary 00:14:4f:fa:ee:e1 net0 0 switch@0 1
Supported on 1 1500 on
SPARC M10: root@m5-32-sca11-a-pdom00:~# ldm remove-
Yes vsw primary-vsw0
root@m5-32-sca11-a-pdom00:~# ldm list-
services primary

remove virtual Usage: ldm remove-vds <service-name>

disk server
(vds) Example
Supported on root@m5-32-sca11-a-pdom00:~# ldm remove-
SPARC T3/T4/T5 vds primary-vds0
: Yes root@m5-32-sca11-a-pdom00:~# ldm list-
Supported on services primary
SPARC M5/M6: root@m5-32-sca11-a-pdom00:~#
Yes
Supported on
SPARC M10:
Yes

Usage: ldm remove-vdsdev [-

remove virtual
f] <volume_name>@<service_name>
storage device
to virtual disk
Example
service
Supported on root@m5-32-sca11-a-pdom00:~# ldm list-
SPARC T3/T4/T5 services primary
: Yes VDS
Supported on NAME LDOM VOLUME
SPARC M5/M6: OPTIONS MPGROUP DEVICE
Yes primary-vds0 primary dvd-
Supported on iso /home/jack/sol-11_1-
SPARC M10: text-sparc.iso
Yes root@m5-32-sca11-a-pdom00:~# ldm remove-
vdsdev dvd-iso@primary-vds0
root@m5-32-sca11-a-pdom00:~# ldm list-
services primary
VDS
NAME LDOM VOLUME
OPTIONS MPGROUP DEVICE
primary-vds0 primary

root@m5-32-sca11-a-pdom00:~#

Start Default Services

&nbsnbsp;

Action Command

Usage: svcadm enable ldmd

start ldom manager

Example
Supported on
SPARC T3/T4/T5 : Yes root@m5-32-sca11-a-pdom00:~#
Supported on SPARC svcs | grep ldmd
M5/M6: Yes online 18:37:13
Supported on SPARC svc:/ldoms/ldmd:default
M10: Yes root@m5-32-sca11-a-pdom00:~#
svcadm disable ldmd
root@m5-32-sca11-a-pdom00:~#
svcs | grep ldmd
root@m5-32-sca11-a-pdom00:~#
root@m5-32-sca11-a-pdom00:~#
svcadm enable ldmd
root@m5-32-sca11-a-pdom00:~#
svcs | grep ldmd
online 19:17:57
svc:/ldoms/ldmd:default
root@m5-32-sca11-a-pdom00:~#

Usage: svcadm enable vntsd

start vntsd
Supported on Example
SPARC T3/T4/T5 : Yes
Supported on SPARC jack@m5-32-sca11-a-pdom01:~$
M5/M6: Yes svcs vntsd
Supported on SPARC STATE STIME FMRI
M10: Yes disabled 18:49:36
svc:/ldoms/vntsd:default
jack@m5-32-sca11-a-pdom01:~$
svcadm enable vntsd
jack@m5-32-sca11-a-pdom01:~$
svcs vntsd
STATE STIME FMRI
online 19:23:59
svc:/ldoms/vntsd:default
jack@m5-32-sca11-a-pdom01:~$

Basic Guest Domain Administration

Action Command

list resources binded Usage: ldm list-bindings <ldom-name>

to a Guest Domain
Supported on Example
SPARC T3/T4/T5 : Yes #ldm list-bindings guestdomain2
Supported on SPARC
M5/M6: Yes
Supported on SPARC
M10: Yes

Usage: $virtinfo -a
how to identify if the
current domain?
Example
[Control,Guest,Service
or Root] jack@m5-32-sca11-a-pdom01:~$ virtinfo -a
Domain role: LDoms control I/O service
Supported on
root
SPARC T3/T4/T5 : Yes
Domain name: primary
Supported on SPARC
Domain UUID: 5caf3abe-db20-cb75-8b2c-
M5/M6: Yes
b4a62bef5a5f
Supported on SPARC
Control domain: Unknown
M10: Yes
Chassis serial#: Unknown
jack@m5-32-sca11-a-pdom01:~$

how to check status Usage: ldm list-io

of I/O device
Example
root@m10-1-syd04-a:~# ldm list-io
Supported on NAME TYPE BUS
SPARC T3/T4/T5 : Yes DOMAIN STATUS
Supported on SPARC ---- ---- --- ------ -----
M5/M6: Yes -
Supported on SPARC PCIE0 BUS PCIE0
M10: Yes primary IOV
PCIE1 BUS PCIE1
primary IOV
/SYS/MBU/NET0 PCIE PCIE0
primary OCC
/SYS/PCI0 PCIE PCIE0
primary EMP
/SYS/MBU/SASHBA PCIE PCIE0
primary OCC
/SYS/MBU/NET2 PCIE PCIE1
primary OCC
/SYS/PCI1 PCIE PCIE1
primary EMP
/SYS/PCI2 PCIE PCIE1
primary EMP
root@m10-1-syd04-a:~#
root@m10-1-syd04-a:~#

how to check logical Usage: ldm list-domain -o domain <guest-

domain (ldom) status domain-name>
Supported on
SPARC T3/T4/T5 : Yes Example
Supported on SPARC root@m10-syd04-a:~# ldm list-domain -o
M5/M6: Yes domain guest-dom1
Supported on SPARC
M10: Yes

list the status of all Usage: ldm list

the guest domains
on the system Example
root@m10-1-syd04-a:~#
Supported on root@m10-1-syd04-a:~# ldm list
SPARC T3/T4/T5 : Yes NAME STATE FLAGS CONS
Supported on SPARC VCPU MEMORY UTIL UPTIME
M5/M6: Yes primary active -n-cv- UART 8
Supported on SPARC 8G 0.1% 13d 14m
M10: Yes ldom1 active -n---- 5000 4
4G 0.0% 19d 23h 21m
ldom2 active -t---- 5001 4 4G
25% 19d 23h 21m
root@m10-1-syd04-a:~#

how to manually list Usage: ldm list-bindings / ldm list-

the LDOM con g on a bindings <ldom-name>
system
Supported on Example
SPARC T3/T4/T5 : Yes #ldm list-bindings
Supported on SPARC
M5/M6: Yes
Supported on SPARC #ldm list-bindings guestdom2
M10: Yes

list current save Usage: ldm list-spcon g

LDOM con g in
Solaris Example
root@t5-8-sin06-a:~# ldm list-spcon g
factory-default
Supported on guestdom1 [next poweron]
SPARC T3/T4/T5 : Yes root@t5-8-sin06-a:~#
Supported on SPARC
M5/M6: Yes
Supported on SPARC
M10: Yes

when do we need to Usage: ldm start-reconf primary

initiate an LDOM
recon g reboot The "start-reconf" needs to be executed
on the primary domain if
Supported on
changes [ add/remove ] is to be made to
SPARC T3/T4/T5 : Yes
the resources [ cpu,io
Supported on SPARC
and memory] that is currently assigned
M5/M6: Yes
to it.
Supported on SPARC
M10: Yes
Example

jack@t5-8-sin06-a:~$ ldm list

NAME STATE FLAGS CONS
VCPU MEMORY UTIL NORM UPTIME
primary active -n-c-- UART
1024 2095872M 0.0% 0.0% 1h 8m
jack@t5-8-sin06-a:~$ ldm start-reconf
primary
Initiating a delayed recon guration
operation on the primary domain.
All con guration changes for other
domains are disabled until the primary
domain reboots, at which time the new
con guration for the primary domain
will also take e ect.
jack@t5-8-sin06-a:~$ ldm set-core 4
primary
-------------------------------------------------------------
-----------------
Notice: The primary domain is in the
process of a delayed recon guration.
Any changes made to the primary domain
will only take e ect after it reboots.
-------------------------------------------------------------
-----------------
jack@t5-8-sin06-a:~$ ldm set-memory
128G primary
Cannot enable FILE_DAC_READ privilege
jack@t5-8-sin06-a:~$ su
Password:
Jun 26 16:10:26 t5-8-sin06-a su: 'su root'
succeeded for jack on /dev/console
root@t5-8-sin06-a:~# ldm set-memory
128G primary
-------------------------------------------------------------
-----------------
Notice: The primary domain is in the
process of a delayed recon guration.
Any changes made to the primary domain
will only take e ect after it reboots.
-------------------------------------------------------------
-----------------
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -ndc-- UART 32
128G 0.0% 0.0% 1h 10m
root@t5-8-sin06-a:~#
root@t5-8-sin06-a:~# reboot
Jun 26 16:11:55 t5-8-sin06-a reboot:
initiated by jack on /dev/console
Jun 26 16:12:02 t5-8-sin06-a syslogd: going
down on signal 15
syncing le systems... done

Check CPU activation Usage: ldm list-permits

Supported on
SPARC T3/T4/T5 : No
Supported on SPARC
M5/M6: No
Supported on SPARC
M10: Yes
Example
eis@m10-1-syd04-a:~$ uname -a
SunOS m10-1-syd04-a.au.oracle.com 5.11
11.2 sun4v sparc sun4v
eis@m10-1-syd04-a:~$ su
Password:
root@m10-1-syd04-a:~# ldm list-permits

CPU CORE
PERMITS (PERMANENT) IN USE REST
16 (16) 8 8

Check Usage: svccfg -s ldmd listprop

Autoreplacement ldmd/autoreplacement_policy_cpu
policy for CPU
Supported on Example
SPARC T3/T4/T5 : No
Supported on SPARC o display autoreplacement_policy_cpu
M5/M6: No property value use the following
Supported on SPARC command:
M10: Yes
#svccfg -s ldmd listprop ldmd listprop
ldmd/autoreplacement_policy_cpu

Example (from M10-1 system)

root@m10-1-syd04-a:~# svccfg -s ldmd
listprop ldmd/autoreplacement_policy_cpu
ldmd/autoreplacement_policy_cpu
integer 1
root@m10-1-syd04-a:~#

Note 1 == replacement policy enabled

0 == replacement policy disabled

Example to change replacement policy

:
#svccfg -s ldmd listprop
ldmd/autoreplacement_policy_cpu
#svcadm disable ldmd
#svccfg -s ldmd setprop
ldmd/autoreplacement_policy_cpu=0
#svcadm refresh ldmd
#svcadm enable ldmd

stop/break/unbind

Action Command

issue send Usage: CTRL+] type “send break”

break followed by return then another
Supported on return
SPARC T3/T4/T5 :
Yes Example
Supported on root@t5-8-sin06-a:~# telnet localhost
SPARC M5/M6: 5000
Yes Trying ::1...
Supported on telnet: connect to address ::1:
SPARC M10: Yes Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.

Connecting to console "guestdom1" in

group "guestdom1" ....
Press ~? for control options ..

telnet> send brk

Debugging requested; hardware
watchdog suspended.
c)ontinue, s)ync, r)eset? s

panic[cpu18]/thread=2a1018f1c60:
sync initiated

stop Guest Usage: ldm stop < guest domain name

Domain >

Supported on Example
SPARC T3/T4/T5 : root@t5-8-sin06-a:~# ldm stop
Yes guestdom2
Supported on LDom guestdom2 stopped
SPARC M5/M6: root@t5-8-sin06-a:~#
Yes
Supported on
SPARC M10: Yes

ubind Guest Usage: ldm unbind <guest-domain-

Domain name>

Supported on
Example
SPARC T3/T4/T5 :
Yes root@t5-8-sin06-a:~# ldm unbind
Supported on guest-dom1
SPARC M5/M6:
Yes
Supported on
SPARC M10: Yes

Add/Create/Assign

Action Command

Add Guest Usage :ldm add-domain <guest domain>

Domain

Example
root@t5-8-sin06-a:/dev/dsk# ldm add-domain guestdom1
Supported on root@t5-8-sin06-a:/dev/dsk# ldm ls
SPARC T3/T4/T5 NAME STATE FLAGS CONS VCPU
: Yes Supported MEMORY UTIL NORM UPTIME
on SPARC primary active -n-cv- UART 16 128G 0.2% 0.1%
M5/M6: Yes 40m
Support on guestdom1 inactive ------
SPARC M10: root@t5-8-sin06-a:/dev/dsk#
Yes

assign cpu Usage: ldm add-vcpu <number> <guest-domain-name>

threads to
Guest Domain
Example
Supported on
SPARC T3/T4/T5 jack@m5-32-sca11-a-pdom01:~$
: Yes Supported jack@m5-32-sca11-a-pdom01:~$ ldm list
on SPARC NAME STATE FLAGS CONS VCPU
M5/M6: Yes MEMORY UTIL NORM UPTIME
Support on primary active -n-cv- UART 8 251648M 0.3%
SPARC M10: 0.2% 4h 22m
Yes guest-dom1 active -n---- 5001 8 4G 0.2%
0.2% 4m
&nbnbsp;
jack@m5-32-sca11-a-pdom01:~$ ldm add-vcpu 6 guest-
dom1
jack@m5-32-sca11-a-pdom01:~$ ldm list
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 8 251648M 0.6%
0.5% 4h 23m
guest-dom1 active -n---- 5001 14 4G 1.2%
0.3% 5m
jack@m5-32-sca11-a-pdom01:~$

assign vcpu Usage: ldm add-core, ldm set-core <number> <ldom>

units of cores
Note: CPUs cannot be assigned to an ldom in units of
Supported on cores and in units of threads simultaneously.
SPARC T3/T4/T5 Choose either of these units of assignment for each
: Yes Supported ldom
on SPARC
M5/M6: Yes
Supported on
SPARC M10:
Yes

assign Usage: ldm add-memory <number> <guest-domain-name>

memory to ldm set-memory <number> <guest-domain-name>
Guest Domain
Supported on Note that the Guest domain OS must be up and running to
SPARC T3/T4/T5 do memory DR.
: Yes Supported
on SPARC Example
M5/M6: Yes root@t5-8-sin06-a:~# ldm ls
Supported on NAME STATE FLAGS CONS VCPU
SPARC M10: MEMORY UTIL NORM UPTIME
Yes primary active -n-cv- UART 32 2G 0.2% 0.1%
15h 3m
guestdomain1 active -n---- 5000 64 8G 0.0%
0.0% 14h 9m
root@t5-8-sin06-a:~# ldm add-memory 4G guestdomain1
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 32 2G 0.2% 0.2%
15h 4m
guestdomain1 active -n---- 5000 64 12G 2.2%
1.0% 14h 10m
root@t5-8-sin06-a:~#

add vnet Usage: ldm add-vnet <if-name> <vsw-name> <ldom-name>

device to
Guest Domain adds a virtual network device to a domain

Example
Supported on
SPARC T3/T4/T5 root@m10-1-syd04-a:~# ldm add-vnet vnet2 primary-vsw0
: Yes Supported ldom1
on SPARC root@m10-1-syd04-a:~# ldm list-bindings ldom1
M5/M6: Yes KPROP
Supported on vnet1 primary-vsw0@primary 0 network@0
SPARC M10: 00:14:4f:f9:bb:ca 1 1500
Yes PEER MAC MODE PVID VID MTU
MAXBW LINKPROP
primary-vsw0@primary 00:14:4f:fa:21:9f 1
1500
vnet0@ldom2 00:14:4f:f9:08:51 1
1500
vnet2@ldom1 00:14:4f:fa:66:56 1
1500
NAME SERVICE ID DEVICE MAC MODE PVID VID
MTU MAXBW LINKPROP
vnet2 primary-vsw0@primary 1 network@1
00:14:4f:fa:66:56 1 1500
PEER MAC MODE PVID VID MTU
MAXBW LINKPROP
primary-vsw0@primary 00:14:4f:fa:21:9f 1
1500
vnet1@ldom1 00:14:4f:f9:bb:ca 1
1500
vnet0@ldom2 00:14:4f:f9:08:51 1
1500

Usage: ldm add-vdisk [timeout=<seconds>] [id=

assign disk
<diskid>] <disk_name> <volume_name>@<service_name>
resource to
<ldom>
Guest Domain

Example
Supported on
SPARC T3/T4/T5 root@t5-8-sin06-a:~# ldm ls -o disk primary
: Yes Supported NAME
on SPARC primary
M5/M6: Yes
Supported on VDS
SPARC M10: NAME VOLUME OPTIONS MPGROUP DEVICE
Yes primary-vds0 S11iso /export/sol-11_1-
text-sparc.iso
guestdom1bootdisk /dev/dsk/c13t4d0s0
guestdom2bootdisk /dev/dsk/c13t4d1s2

root@t5-8-sin06-a:~# ldm ls -o disk guestdom3

NAME
guestdom3

root@t5-8-sin06-a:~#
root@t5-8-sin06-a:~# ldm add-vdisk cdromiso
S11iso@primary-vds0 guestdom3
root@t5-8-sin06-a:~# ldm ls -o disk guestdom3
NAME
guestdom3

DISK
NAME VOLUME TOUT ID DEVICE SERVER
MPGROUP
cdromiso S11iso@primary-vds0 0 disk@0
primary

root@t5-8-sin06-a:~#

Remove/Delete

Action Command

Usage: ldm remove-domain (-a | <ldom>...)

Remove a
Guest Domain
Example

Supported on
SPARC T3/T4/T5 root@t5-8-sin06-a:~# ldm ls
: Yes NAME STATE FLAGS CONS VCPU
Supported on MEMORY UTIL NORM UPTIME
SPARC M5/M6: primary active -n-cv- UART 16
Yes 128G 0.1% 0.1% 1d 1h 13m
Supported on guestdom1 bound ------ 5000
SPARC M10: 128 128G
Yes guestdom2 inactive ------
32 256G
guestdom3 inactive ------
root@t5-8-sin06-a:~# ldm remove-domain
guestdom3
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 16
128G 0.3% 0.3% 1d 1h 13m
guestdom1 bound ------ 5000
128 128G
guestdom2 inactive ------ 32
256G
root@t5-8-sin06-a:~#

Usage: ldm remove-vdisk [-f] <disk_name>

Remove disk
<ldom-name>
resource from
Guest Domain

Example
Supported on
SPARC T3/T4/T5 root@m10-1-syd04-a:~# ldm remove-vdisk
: Yes vdisk2 ldom1
Supported on root@m10-1-syd04-a:~# ldm list-bindings
SPARC M5/M6: ldom1
Yes NAME STATE FLAGS CONS VCPU
Supported on MEMORY UTIL UPTIME
SPARC M10: ldom1 active -n---- 5000 4
Yes 6G 1.4% 2h 27m

UUID
537e8abe-6bf5-cac6-b1d6-f2670010a85b

MAC

...

DISK
NAME VOLUME TOUT
ID DEVICE SERVER MPGROUP
vdisk1 vol1@primary-vds0
0 disk@0 primary

VCONS
NAME SERVICE PORT LOGGING
ldom1 primary-vcc0@primary
5000 on

root@m10-1-syd04-a:~#

Usage: ldm remove-vnet [-f] <if_name>

Remove
<ldom>
virtual
network
Example
device from a
Guest Domain
jack@m5-32-sca11-a-pdom01:~$
Supported on jack@m5-32-sca11-a-pdom01:~$ ldm remove-
SPARC T3/T4/T5 vnet vnet2 guest-dom1
: Yes
Supported on
SPARC M5/M6:
Yes
Supported on
SPARC M10:
Yes

Remove CPU Usage: ldm remove-vcpu [-f|--force] [-c|--

threads from core] <number> <ldom-name>
a Giuest
Domain
Example
Supported on root@t5-8-sin06-a:~# ldm ls
SPARC T3/T4/T5 NAME STATE FLAGS CONS VCPU
: Yes MEMORY UTIL NORM UPTIME
Supported on primary active -n-cv- UART 32
SPARC M5/M6: 2G 0.1% 0.1% 15h 8m
Yes guestdomain1 active -n---- 5000 96
Supported on 12G 0.1% 0.0% 14h 14m
SPARC M10: root@t5-8-sin06-a:~# ldm remove-vcpu 32
Yes guestdomain1
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 32
2G 0.2% 0.1% 15h 8m
guestdomain1 active -n---- 5000 64
12G 1.3% 1.2% 14h 14m
root@t5-8-sin06-a:~#

Remove Usage: ldm remove-core [-f|--force]

virtual cpu <number>|cid=<id>[,<id>[,...]] <ldom-name>
units in cores
from a Guest Example
Domain root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
Supported on MEMORY UTIL NORM UPTIME
SPARC T3/T4/T5 primary active -n-cv- UART 16
: Yes 128G 0.3% 0.3% 1d 22h 29m
Supported on guestdom1 bound ------ 5000
SPARC M5/M6: 128 128G
Yes guestdom2 active -n---- 5001 32
Supported on 256G 0.0% 0.0% 21h 3m
SPARC M10: guestdom3 active -t---- 5002 64
Yes 64G 1.6% 1.6% 9m
root@t5-8-sin06-a:~# ldm remove-core 2
guestdom2
root@t5-8-sin06-a:~# ldm ls
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 16
128G 0.2% 0.2% 1d 22h 29m
guestdom1 bound ------ 5000 128
128G
guestdom2 active -n---- 5001 16
256G 0.8% 0.8% 21h 4m
guestdom3 active -t---- 5002 64
64G 1.6% 1.6% 9m
root@t5-8-sin06-a:~#

Usage: ldm remove-memory <number>

Remove
<ldom-name>
memory from
a Guest
Example
Domain
Supported on root@m5-32-sca11-a-pdom01:~# ldm list
SPARC T3/T4/T5 NAME STATE FLAGS CONS VCPU
: Yes MEMORY UTIL NORM UPTIME
Supported on primary active -n-cv- UART 8
SPARC M5/M6: 251648M 1.8% 1.7% 4h 55m
Yes guest-dom1 active -n---- 5001 8
Supported on 12G 1.1% 0.8% 4m
SPARC M10: root@m5-32-sca11-a-pdom01:~# ldm
Yes remove-memory 8G guest-dom1
root@m5-32-sca11-a-pdom01:~# ldm list
NAME STATE FLAGS CONS VCPU
MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 8
251648M 1.0% 1.1% 4h 58m
guest-dom1 active -n---- 5001 8
4G 0.2% 0.2% 6m
root@m5-32-sca11-a-pdom01:~#

start

Action Command

start a Guest Domain Usage: ldm start (-a | -i < le>

| <ldom>...

Supported on
SPARC T3/T4/T5 : Yes Example
Supported on SPARC #ldm start guest-dom1
M5/M6: Yes
Supported on SPARC M10:
Yes

Save LDOM Con g

nbsp;

Action Command

save ldom con guration Usage: ldm add-spcon g [-r

to the SP <autosave>] <con g_name>
Supported on
SPARC T3/T4/T5 : Yes
Supported on SPARC Example
M5/M6: Yes root@t5-8-sin06-a:~# ldm list-
Supported on SPARC M10: spcon g
Yes factory-default
guestdom1 [next poweron]
root@t5-8-sin06-a:~#
root@t5-8-sin06-a:~# ldm
add-spcon g
mynewcon guration
root@t5-8-sin06-a:~# ldm list-
spcon g
factory-default
mynewcon guration [current]
root@t5-8-sin06-a:~#

backup of existing Usage: ldm list-constraints -x

con guration from
the control domain
Supported on
SPARC T3/T4/T5 : Yes
Supported on SPARC
M5/M6: Yes
Supported on SPARC M10:
Yes
> < le.xml >
Example
# ldm list-constraints -x >
/var/tmp/guest-domain-
name.xml
# ldm list-bindings >
/var/tmp/full-bindings
# ldm ls -l > /var/tmp/guest-
domain-list.xml

Resources

Action Command

identitify usage: ldm list-constraints

physical
resources Example
bindings
Supported on
SPARC T3/T4/T5 jack@m5-32-sca11-a-pdom01:~$ ldm list-constraints
DOMAIN
:Yes
primary
Supported on
SPARC M5/M6: UUID
Yes 9d1d44bb-ec6e-41bb-f8e6-c56e8b8621d2
Supported on
SPARC M10: MAC
Yes 00:10:e0:24:6a:b1

HOSTID
0x86246a9d

CONTROL
failure-policy=ignore
extended-mapin-space=on
cpu-arch=native
rc-add-policy=
shutdown-group=0

VCPU
COUNT: 288

MEMORY
SIZE: 3144448M

CONSTRAINT
threading=max-throughput

VARIABLES
boot-device=/pci@700/pci@1/pci@0/pci@c/pci@0/pci@4/scsi@0/disk@w5000cca0162f5cc5,0:a
pm_boot_policy=disabled=0;ttfc=22746;ttmr=0;
use-nvramrc?=true

IO
DEVICE OPTIONS
pci_16
pci_17
pci_18
pci_19
pci_24
pci_25
pci_26
pci_27
pci_20
pci_21
pci_22
pci_23

Usage: ldm bind [-f] [-q] (-i < le> | <ldom>)

bind
resources to a
Guest Domain
Example

Supported on root@m5-32-sca11-a-pdom01:~# ldm list

SPARC T3/T4/T5 NAME STATE FLAGS CONS VCPU MEMORY UTIL NORM UPTIME
: Yes primary active -n-cv- UART 8 251648M 2.8% 1.6% 6m
Supported on guest-dom1 inactive ------ 8 4G
SPARC M5/M6: root@m5-32-sca11-a-pdom01:~#
Yes root@m5-32-sca11-a-pdom01:~# ldm bind guest-dom1
Supported on root@m5-32-sca11-a-pdom01:~# ldm list
SPARC M10: NAME STATE FLAGS CONS VCPU MEMORY UTIL NORM UPTIME
Yes primary active -n-cv- UART 8 251648M 2.8% 1.7% 6m
guest-dom1 bound ------ 5001 8 4G

Usage: ldm unbind <ldom-name>

unbind
resources to a
Guest Domain
Example
Supported on
SPARC T3/T4/T5 root@t5-8-sin06-a:~# ldm ls
: Yes NAME STATE FLAGS CONS VCPU MEMORY UTIL NORM UPTIME
Supported on primary active -n-cv- UART 16 128G 0.4% 0.4% 22h 43m
SPARC M5/M6: guestdom1 bound ------ 5000 128 256G
Yes guestdom2 bound ------ 5001 8 1G
Supported on root@t5-8-sin06-a:~# ldm unbind guestdom2
SPARC M10: root@t5-8-sin06-a:~# ldm ls
Yes NAME STATE FLAGS CONS VCPU MEMORY UTIL NORM UPTIME
primary active -n-cv- UART 16 128G 1.2% 1.2% 22h 44m
guestdom1 bound ------ 5000 128 256G
guestdom2 inactive ------ 8 1G
root@t5-8-sin06-a:~#

Accessing Guest Domain

Action Command

login to the console Usage: telnet localhost < console

of a Guest Domain port # >

Supported on
SPARC T3/T4/T5 : Yes Example
Supported on SPARC
M5/M6: Yes root@m10-1-syd04-a:~# ldm list
Supported on SPARC NAME STATE FLAGS
M10: Yes CONS VCPU MEMORY UTIL
UPTIME
primary active -n-cv- UART
8 8G 0.1% 22h 49m
ldom1 active -n---- 5000
4 4G 0.0% 22h 47m
ldom2 active -t---- 5001
4 4G 16% 4s
root@m10-1-syd04-a:~# telnet
localhost 5001
Trying ::1...
telnet: connect to address ::1:
Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.

Connecting to console "ldom2"

in group "ldom2" ....
Press ~? for control options ..

{0} ok
{0} ok
{0} ok
{0} ok

Exit from a Guest Usage: CTRL+] then q

Domain console
Example
Supported on root@t5-8-sin06-a:~# telnet
SPARC T3/T4/T5 : Yes localhost 5001
Supported on SPARC Trying ::1...
M5/M6: Yes telnet: connect to address ::1:
Supported on SPARC Connection refused
M10: Yes Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.

Connecting to console
"guestdom2" in group
"guestdom2" ....
Press ~? for control options ..

{0} ok devalias
vdisk0 /virtual-
devices@100/channel-
devices@200/disk@0
cdromiso /virtual-
devices@100/channel-
devices@200/disk@1
vnet0 /virtual-
devices@100/channel-
devices@200/network@0
net /virtual-
devices@100/channel-
devices@200/network@0
disk /virtual-
devices@100/channel-
devices@200/disk@1
virtual-console /virtual-
devices/console@1
name aliases
{0} ok boot vdisk0
Boot device: /virtual-
devices@100/channel-
devices@200/disk@0 File
and args:
SunOS Release 5.11 Version 11.1
64-bit
Copyright (c) 1983, 2012, Oracle
and/or its a liates. All rights
reserved.
Hostname: guestdom2

guestdom2 console login:

telnet> quit
Connection to localhost closed.
root@t5-8-sin06-a:~#

Enable/Disable usage: ldm set-vcons log=o |

console loggging on <ldom-name>
function for a Guest ldm ls - o console < guest
Domain domain >

Note: OVM 3.0

required
The guest gomain console log
Supported on
will be stored in the following
SPARC T3/T4/T5 : Yes
directory
Supported on SPARC
M5/M6: Yes /var/log/vntsd
Supported on SPARC
M10: Yes

usage: ldm list -o console <ldom-

Display current
name>
console settings of a
Guest Domain
Example

Supported on root@m10-1-syd04-a:~# ldm list

SPARC T3/T4/T5 : Yes -o console ldom1
Supported on SPARC NAME
M5/M6: Yes ldom1
Supported on SPARC
M10: Yes VCONS
NAME SERVICE
PORT LOGGING
ldom1 primary-
vcc0@primary 5000
on

root@m10-1-syd04-a:~# ldm list

-o console
NAME
primary

VCC
NAME PORT-RANGE
primary-vcc0 5000-5100

VCONS
NAME SERVICE
PORT LOGGING
UART

------------------------------------------------
------------------------------
NAME
ldom1

VCONS
NAME SERVICE
PORT LOGGING
ldom1 primary-
vcc0@primary 5000
on

------------------------------------------------
------------------------------
NAME
ldom2

VCONS
NAME SERVICE
PORT LOGGING
ldom2 primary-
vcc0@primary 5001
on

root@m10-1-syd04-a:~#

Support Data Collection

Explorer

Action Command

T3,T4,T5 and
Collect System
M10 : #/usr/sbin/explorer -w
information via
default
Explorer
command
Mx-32 PDOM (primary) :
Supported on #/usr/sbin/explorer -w
SPARC T3/T4/T5 : Yes default,\!ipmi -timeout 900
Supported on SPARC
M5/M6: Yes
Supported on SPARC
M10: Yes

SP snapshot

Action KM Document

SPARC M5-32 Servers: M5-32

Data collection
snapshot using ILOM 3.2.1.3.b and
from SPARC
beyond [Doc ID
M5/M6 SP
1538200.1]
(service
processor)

Fujitsu M10 Servers (Doc ID

Data collection
1540225.1)
from SPARC M10
SP (service
processor)

Data collection Collect ILOM snapshot on T3-x and

from SPARC T4-x systems without an active
T3/T4/T5 SP network management connection
(service (Doc ID 1518044.1)
processor)
Troubleshooting data needed for T3-
x, T4-x & T5-x servers (Doc ID
1470580.1)

display LDOM Info

Action Command

list all Service Usage: ldm ls [-e] [-l] [-S] [-o <format>] [-p] [<ldom>...]
Domains in the
platform format' is one or more of:
from console,core,cpu,crypto,disk,domain,memory,network,physio,resmgmt,serial,status
Solaris

Example:

Supported on
SPARC T3/T4/T5 root@m10-1-syd04-a:~# ldm ls -o console,network,disk
: Yes
Supported on
SPARC M5/M6:
Yes
Supported on
SPARC M10: Yes

list all LDOM Usage: [T3/T4/t5] show /HOST/domain/con gs date_created -t

con g from SP
with Note: For SPARC T3/T4 and T5 "/HOST/domain/con gs" will list all the saved con gurations and "/HOST/bootmode con g
timestamp and active con g.

Supported on Example T3/T4/T5

SPARC T3/T4/T5
-> show /HOST/domain/configs date_created -t
: Yes Target | Property | Value
Supported on ---------------------------------+--------------+---------------------
SPARC M5/M6: /HOST/domain/configs/mydomain | date_created | 2013-11-13 12:50:27
Yes /HOST/domain/configs/guestdom1 | date_created | 2013-11-18 15:26:58
Supported on
SPARC M10: No ->

Usage [M5/M6] show/HOSTx/domain/con gs date_created -t [where x=0..3 ]

Note: For SPARC M5/M6 "/HOSTx/domain/con gs" will list all the saved con gurations and "/HOSTx/bootmode con g" fo
and active con g.

Example M5/M6
> show /HOST0/domain/con gs date_created -t
Target | Property | Value
-------------+-----------------+-----------------------------------
/HOST0/domain/con gs/beba | date_created | 2014-02-27 06:56:13
/HOST0/domain/con gs/101113 | date_created | 2013-11-10 05:09:55
/HOST0/domain/con gs/ nal1 | date_created | 2014-01-13 22:39:04

list current Usage [ T3/T4/T5] show /HOST/domain/con g -t

LDOM con g
from SP Example T3/T4/T5
-> show /HOST/bootmode config -t
Target | Property | Value
Supported on
--------------------------+------------------+--------------------
SPARC T3/T4/T5 /HOST/bootmode | config | guestdom1
: Yes
Supported on ->
SPARC M5/M6:
Yes
Supported on Usage [M5/M6] show/HOSTx/domain/con gs -t [where x=0..3 ]
SPARC M10: Yes
Example M5/M6
-> show /HOST0/domain/con gs -t
Target | Property | Value
------------------+--------------------+------------------------------------
/HOST0/domain/con gs/101113 | date_created | 2013-11-10 05:09:55
/HOST0/domain/con gs/101113 | domains | 2

Check Usage: virtinfo -a

virtualization
info The virtinfo utility provides current domain information

Primary domain output

eis@m10-1-syd04-a:~$ virtinfo -a
Supported on Domain role: LDoms control I/O service root
SPARC T3/T4/T5 Domain name: primary
: Yes Domain UUID: 78b8eb2a-6a60-4ce7-a383-4fd27aafeac5
Supported on Control domain: Unknown
SPARC M5/M6: Chassis serial#: Unknown
Yes eis@m10-1-syd04-a:~$
Supported on
SPARC M10: Yes
Guest domain output
root@bookable-10-187-57-211:~# virtinfo -a
Domain role: LDoms guest
Domain name: ldom1
Domain UUID: 53066220-e871-6998-ed41-e13d7aa79745
Control domain: m10-1-syd04-a
Chassis serial#: PZ31341009

Crashdump:

Control Domain

Action Example

SPARC
Usage: set /HOST/send_break_action=dumpcore
T3/T4/T5
Control
Domain
from
ILOM
SPARC
Usage: set /HOSTn/send_break_action=dumpcore
M5/M6
where n=0 ...3
Control
Domain Example
from
-> pwd
ILOM Current default target: /HOST0

-> set send_break_action=dumpcore

Set 'send_break_action' to 'dumpcore'

-> start /HOST0/console

Are you sure you want to start /HOST0/console (y/n)? y

Serial console started. To stop, type #.

panic[cpu508]/thread=2a108c77c60: sync initiated

sched: trap type = 0x0

pid=0, pc=0x0, sp=0x0, tstate=0x0, context=0x0
o0-o7: 0, 0, 0, 0, 0, 0, 0, 0

SPARC
Usage: XSCF>reset -p <ppar_id> -g primary panic
M10
Control
Domain
XSCF

Guest Domain

Action Command

Crash a guest Usage: ldm panic-domain <ldom-name>

domain from
the control Example
domain eis@m10-1-syd04-a:~$ ldm panic-domain ldom2
eis@m10-1-syd04-a:~$ ldm list
Supported on
NAME STATE FLAGS CONS VCPU MEMORY UTIL UPTIME
SPARC T3/T4/T5 primary active -n-cv- UART 8 8G 0.6% 27d 1h 13m
: Yes ldom1 active -n---- 5000 4 6G 0.0% 11d 18h 57m
Supported on ldom2 active -t---- 5001 4 4G 100% 13d 21h 48m
SPARC M5/M6: eis@m10-1-syd04-a:~$ telnet localhost 5001
Yes Trying ::1...
Supported on telnet: connect to address ::1: Connection refused
SPARC M10: Trying 127.0.0.1...
Yes Connected to localhost.
Escape character is '^]'.

Connecting to console "ldom2" in group "ldom2" ....

Press ~? for control options ..

bookable-10.187-57-212.au.oracle.com console login:

Jul 9 12:41:57 10.187-57-212.au.oracle.com savecore:Decompress the crash dump with
Jul 9 12:41:57 10.187-57-212.au.oracle.com 'savecore -vf /var/crash/vmdump.0'

Crash Guesdt Usage: reset [ [-q] -{y|n}] -p ppar_id -g domainname sir

Domain from reset [ [-q] -{y|n}] -p ppar_id -g domainname panic
Service
Processor where ppar_id =0 ...15
Supported on domainname = guest domain name
SPARC T3/T4/T5 sir = resets ldom
: No panic = crashes the guest domain
Supported on
Example
SPARC M5/M6:
No XSCF> reset -p 0 -g ldom2 panic
PPAR-ID :00
Supported on
GuestDomain to panic : ldom2
SPARC M10: Be sure to execute "ldm add-spconfig" before using this
Yes command when you have changed the ldm configuration.
Otherwise, an unexpected domain might be reset.
Continue? [y|n] :y
00 ldom2 : Resetting
Note: Use XSCF command "showdomainstatus" to check result of panic.

Guest Domain Console

#
# uname -a
SunOS 10.187-57-212.au.oracle.com 5.10 Generic_147147-26 sun4v sparc sun4v
#
panic[cpu0]/thread=2a10001fc80: Panic - Generated at user request
000002a10001f6a0 unix:process_nonresumable_error+2d8 (2a10001f890,0,ff,40,5,40)
%l0-3: 0000000000000100 0000000003000000 0000000000000001000000000180c600
%l4-7: 0000000000000000 0000000100000000 00000000ffffffff0000000000000000
000002a10001f7e0 unix:ktl0+64 (0,1,0,100,1010101,12)
%l0-3: 000000000180c000 0000000000000000 00000000110014040000000001029aa4
%l4-7: 0000000000000000 0000000000000000 0000000000000000000002a10001f890
000002a10001f930 unix:cpu_halt+f4 (180c000, 0, 19dd9b8,19dd888, 180c000, 0)
%l0-3: 00000000019d73a4 0000000000000001 00000000000000160000000000000000
%l4-7: 0000000000000000 0000000000000002 000000000180c1780000000000000001
000002a10001f9e0 unix:idle+128 (1866c00, 4, 180c000,ffffffffffffffff,1,1865800)
%l0-3: 00000000019d7380 000000000000001b 0000000000000000ffffffffffffffff
%l4-7: 0000000000000001 0000000001a6ec00 000000000180c1780000000001045bac

syncing file systems... done

dumping to /dev/zvol/dsk/rpool/dump, offset 65536, content:kernel
0:17 100% done
100% done: 62437 pages dumped, dump succeeded
rebooting...
Resetting...

SPARC M10-1, No Keyboard

Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved.
OpenBoot 4.34.0, 4096 MB memory available, Serial #xxxx1300.
[ 1.24.0 ]
Ethernet address x:xx:xx:xx:96:24, Host ID: xxxxx624.

Checked for failed components (CPU/Memory)

Action Command

Usage:
to check failed cpu or memory
ldm list-domain -l
components from Control Domain
-S

Supported on SPARC T3/T4/T5 : Yes ldm list-devices -S

Supported on SPARC M5/M6: Yes mem cpu
Supported on SPARC M10: Yes