Saltboot Formula
The Saltboot formula is used to configure disk images and partitioning for the selected hardware type.
The Saltboot formula is meant to be used as a group formula. Enable and configure Saltboot formula for hardware type groups. |
To apply changes to a terminal, terminal needs to be restarted. Applying highstate does not have any effect on running terminals. |
-
Open the details page for your new hardware type group, and navigate to the
Formulas
tab. -
Select the Saltboot formula and click Save.
-
Navigate to the
tab. -
In the
Disk 1
section, set these parameters:-
In the
Disk symbolic ID
field, enter a custom name for the disk (for example,disk1
). -
In the
Device type
field, selectDISK
. -
In the
Disk device
field, select the device that corresponds to the device name on the target machine (for example,/dev/sda
). -
In the
RAID level
field, leave it empty. -
In the
Disk Label
field, selectgpt
.
-
-
In the
Partition
section, set these parameters forPartition 1
:-
In the
Partition symbolic ID
field, enter a custom name for the partition (for example,p1
). -
In the
Partition size
use value 500. -
In the
Device mount point
use/boot/efi
. -
In the
Filesystem format
usevfat
. -
In the
OS Image to deploy
field, leave it empty. -
In the
Partition encryption password
field, leave it empty. -
In the
Partition flags
useboot
.
-
-
In the
Partition
section, set these parameters forPartition 2
:-
In the
Partition symbolic ID
field, enter a custom name for the partition (for example,p2
). -
In the
Partition size
field, specify a size for the partition in Mebibytes (MiB). -
In the
Device mount point
field, select a location to mount the partition (for example,/data
). -
In the
Filesystem format
field, select your preferred format (for example,xfs
). -
In the
OS Image to deploy
field, leave it empty. -
In the
Partition encryption password
field, enter a password if you want to encrypt the partition. -
In the
Partition flags
field, leave it empty.
-
-
In the
Partition
section, set these parameters forPartition 3
:-
In the
Partition symbolic ID
field, enter a custom name for the partition (for example,p3
). -
In the
Partition size
field, specify a size for the partition in Mebibytes (MiB). -
In the
Device mount point
field, leave it empty. -
In the
Filesystem format
field, selectswap
. -
In the
OS Image to deploy
field, leave it empty. -
In the
Partition encryption password
field, enter a password if you want to encrypt the partition. -
In the
Partition flags
field, selectswap
.
-
-
In the
Partition
section, set these parameters forPartition 4
:-
In the
Partition symbolic ID
field, enter a custom name for the partition (for example,p4
). -
In the
Partition size
field, leave it empty. This will ensure the partition uses up all remaining space. -
In the
Device mount point
field, select/
. -
In the
Filesystem format
field, leave it empty. -
In the
OS Image to deploy
field, enter the name of the image to deploy. -
In the
Image version
field, leave it empty. This will ensure you use the latest available version. -
In the
Partition encryption password
field, enter a password if you want to encrypt the partition. -
In the
Partition flags
field, leave it empty.
-
-
Click Save Formula to save your configuration.
Special Partition Types
The Saltboot formula helps you with setting up special partition types.
For terminal to be able to boot locally, either |
BIOS grub Partition
A BIOS grub partition is needed for local booting from a GPT
disk on non-EFI machines.
For more information, see https://en.wikipedia.org/wiki/BIOS_boot_partition.
In the formula, enter the following options:
Partition Symbolic ID: p1 Partition Size (MiB): 50 Partition Flags: bios_grub
Leave the other fields empty.
EFI Partition
An EFI partition is needed for local booting on EFI machines, Partition Table Type
must be GPT
.
For more information, see https://en.wikipedia.org/wiki/EFI_system_partition.
In the formula, enter the following options:
Partition Symbolic ID: p1 Partition Size (MiB): 500 Device Mount Point: /boot/efi Filesystem Format: vfat Partition Flags: boot
Leave the other fields empty.
Troubleshooting the Saltboot Formula
msdos
Disklabel Limitations
On msdos
disk label it is possible to create maximally 4 primary partitions, extended partitions are not supported.
This limitation is not present on GPT
disk label.
For more information on troubleshooting problems with the Saltboot formula, see administration:tshoot-saltboot.adoc.