Ubuntu Server Guide

type: mapping, see below default: use “lvm” layout in a single disk system, no default in a multiple disk
system can be interactive: yes
Storage configuration is a complex topic and the description of the desired configuration in the autoinstall
file can necessarily also be complex. The installer supports “layouts”, simple ways of expressing common
configurations.
Supported layouts
The two supported layouts at the time of writing are “lvm” and “direct”.
s t o r a g e :
l a y o u t :
name : lvm
s t o r a g e :
l a y o u t :
name : d i r e c t
By default these will install to the largest disk in a system, but you can supply a match spec (see below) to
indicate which disk to use:
s t o r a g e :
l a y o u t :
name : lvm
match :
s e r i a l : CT*
s t o r a g e :
l a y o u t :
name : d i s k
match :
s s d : y e s
(you can just say “match: {}” to match an arbitrary disk)
The default is to use the lvm layout.
action-based config
For full flexibility, the installer allows storage configuration to be done using a syntax which is a superset of
that supported by curtin, described at https://curtin.readthedocs.io/en/latest/topics/storage.html. As well
as putting the list of actions under the ‘config’ key, the grub and swap curtin config items can be put here.
So a storage section might look like:
s t o r a g e :
swap :
s i z e : 0
c o n f i g :
− type : d i s k
i d : d i s k 0
314

---

s e r i a l : ADATA_SX8200PNP_XXXXXXXXXXX
− type : p a r t i t i o n
. . .
The extensions to the curtin syntax are around disk selection and partition/logical volume sizing.
Disk selection extensions
Curtin supported identifying disks by serial (e.g. Crucial_CT512MX100SSD1_14250C57FECE
) or by path (e.g. /dev/sdc) and the server installer supports this as well. The installer additionally supports
a ‘’match spec” on a disk action that supports more flexible matching.
The actions in the storage config are processed in the order they are in the autoinstall file. Any disk action
is assigned a matching disk – chosen arbitrarily from the set of unassigned disks if there is more than one,
and causing the installation to fail if there is no unassigned matching disk.
A match spec supports the following keys:
• model: foo: matches a disk where ID_VENDOR=foo in udev, supporting globbing
• path: foo: matches a disk where DEVPATH=foo in udev, supporting globbing (the globbing support
distinguishes this from specifying path: foo directly in the disk action)
• serial : foo: matches a disk where ID_SERIAL=foo in udev, supporting globbing (the globbing sup-
port distinguishes this from specifying serial: foo directly in the disk action)
• ssd: yes|no: matches a disk that is or is not an SSD (vs a rotating drive)
• size : largest | smallest: take the largest or smallest disk rather than an arbitrary one if there are
multiple matches (support for smallest added in version 20.06.1)
So for example, to match an arbitrary disk it is simply:
− type : d i s k
i d : d i s k 0
To match the largest ssd:
To match a Seagate drive: