LDOMCTL(8) | System Manager's Manual (sparc64) | LDOMCTL(8) |
ldomctl
— Logical
Domain management interface
ldomctl |
command [argument ...] |
The ldomctl
program is used to manage
logical domains on sun4v systems. It can be used to assign resources to the
primary and guest domains, start and stop guest domains from the primary
domain, and to display information about domains running on the system.
The following commands are available:
create-vdisk
-s
size
fileconsole
domaindelete
configurationdownload
directoryinit-system
command. The download is aborted if a
configuration with the same name already exists.dump
init-system
filelist
list-io
panic
domainselect
configurationstart
domainstatus
[domain]stop
domainA system using factory defaults has a single "factory-default" configuration:
# ldomctl list factory-default [current]
Create a new configuration based on the defaults:
# mkdir factory-default # cd factory-default # ldomctl dump # cd .. # cp -R factory-default openbsd # cd openbsd
A file describing the desired configuration must be created - see ldom.conf(5).
Generate a set of configuration files and download to non-volatile storage. If a configuration with the same name already exists, it must be removed first:
# ldomctl init-system ldom.conf # cd .. # ldomctl delete openbsd # ldomctl download openbsd # ldomctl list factory-default [current] openbsd [next]
Create a virtual disk image for each guest domain:
# ldomctl create-vdisk -s 8G /home/puffy/vdisk0 # ldomctl create-vdisk -s 8G /home/salmah/vdisk0
The minirootfs install media can be used to boot guest domains:
# cp miniroot56.fs /home/puffy/vdisk1 # cp miniroot56.fs /home/salmah/vdisk1
To have ldomctl
enabled at boot time, use
“rcctl enable ldomd”, which sets
ldomd_flags=""
in rc.conf.local(8).
Halt the primary domain and reset the hardware:
# halt sc> reset -c # ALOM -> reset /SYS # ILOM
The machine will now reset and boot into the new configuration. The primary domain should have less CPUs and memory, since they are now assigned to the guest domains:
# ldomctl status primary - running OpenBSD running 1% puffy ttyV0 running OpenBoot Primary Boot Loader 8% salmah ttyV1 running OpenBoot Primary Boot Loader 12%
Configure the vnet(4) interfaces for the guest domains. This example bridges guest domains into the physical network:
# ifconfig vnet0 up # ifconfig vnet1 up # ifconfig bridge0 create # ifconfig bridge0 add em0 add vnet0 add vnet1 up
Access the console of the first domain and boot it:
# ldomctl console puffy ok boot disk1
The ldomctl
program first appeared in
OpenBSD 5.3.
The ldomctl
program was written by
Mark Kettenis
<kettenis@openbsd.org>.
December 6, 2019 | OpenBSD-current |