PXE Formula
The PXE formula is used to configure PXE booting on the branch server.
-
In the SUSE Manager Web UI, open the details page for the branch server, and navigate to the
Formulas
tab. -
Select the
Pxe
formula, and clickSave
. -
Navigate to the
tab, and set these parameters:-
In the
Kernel Filename
field, keep the default value. -
In the
Initrd Filename
field, keep the default value. -
If the terminals connecting to this branch server are running ARM64 architecture, check the
Enable ARM64 UEFI boot
box. Leave unchecked for x86-64. -
In the
Kernel Filename for ARM64
field, keep the default value. -
In the
Initrd Filename for ARM64
field, keep the default value. -
In the
Kernel Command Line Parameters
field, keep the default value. For more information about possible values, see Saltboot Kernel Command Line Parameters. -
In the
PXE root directory
field, enter the path to the Saltboot directory (for example,/srv/saltboot
).
-
-
Click
Save Formula
to save your configuration. -
Apply the highstate.
1. Saltboot Kernel Command Line Parameters
Saltboot supports common kernel parameters and Saltboot-specific kernel parameters. All the parameters can be entered in the Kernel Command Line Parameters
field of the PXE formula.
kiwidebug=1
-
Starts a shell on tty2 during boot and enables debug logging in Salt.
Do not use this parameter in a production environment as it creates a major security hole. This parameter should be used only in a development environment for debug purposes.
MASTER
-
Overrides auto-detection of the Salt master. For example:
MASTER=myproxy.domain.com
SALT_TIMEOUT
-
Overrides the local boot fallback timeout if the Salt master does not apply the Saltboot state within this timeout (default: 60 seconds). For example:
SALT_TIMEOUT=300
DISABLE_HOSTNAME_ID
-
If the terminal has a hostname assigned by DHCP, it is by default used as a minion ID. Setting this option to
1
disables this mechanism, and SMBios information will be used as a minion ID. DISABLE_UNIQUE_SUFFIX
-
Setting this option to
1
disables adding random generated suffix to terminal minion ID.If you set this parameter make sure your terminal has either a unique hostname provided by DHCP and DNS, or the terminal hardware comes with a unique serial number stored in its SMBios memory. Otherwise there is a risk of terminal minion ID duplicity, and bootstrapping the minion will fail.
The following parameters (MINION_ID_PREFIX
, salt_device
, root
) are usually autoconfigured and should be used only in specific conditions such as debugging or development:
MINION_ID_PREFIX
-
Branch ID set in the Branch Network formula form.
salt_device
-
Device that contains the Salt configuration.
root
-
Device that contains the already deployed root file system. Used for falling back to local boot.