The opsipxeconfd Service

The opsipxeconfd service centrally manages the PXE boot configuration for all clients that start via PXE boot (see also DHCP Server/PXE Boot). The required configuration files are stored in the /tftpboot/opsi/cfg directory and are automatically generated by opsipxeconfd based on templates and individual settings.

Currently, GRUB2 is used as the bootloader for both UEFI and BIOS-based devices. The template for the GRUB configuration can be found at /usr/share/opsipxeconfd/grub.cfg.

From this template, the service creates the general configuration file /tftpboot/opsi/cfg/grub.cfg, which is used whenever no client-specific configuration exists. As soon as an action for a netboot product is set for a client, opsipxeconfd automatically generates an individual configuration file. This is stored in the same directory under the name <System-UUID>.cfg or <MAC-Address>.cfg.

Configuration

The configuration of opsipxeconfd can be done in three ways: via the file /etc/opsi/opsipxeconfd.conf, via environment variables, or directly via command line parameters at startup. The order of priority is as follows:

  1. Entries in the configuration file override the default settings.

  2. Environment variables override entries in the configuration file.

  3. Command line parameters override environment variables.

A complete overview of all configuration options is available with the following command:

opsipxeconfd --help

Each command line parameter has a corresponding environment variable (in uppercase). All parameters are documented in detail in the configuration file.

Changes to the configuration can usually be applied directly during operation with the command opsipxeconfd reload.

Status and Troubleshooting

To display the current status of the service and the client-specific boot configurations, use:

opsipxeconfd status

Check the log file at /var/log/opsi/opsipxeconfd/opsipxeconfd.log for possible errors or hints. You can adjust the log level in the configuration file.