Customizing the Simplified Provisioner ISO

Fedora IoT provides a generic Simplified Provisioning ISO that is by default configured to install to a virtual disk (/dev/vda). This can be customized for your device depending on what hardware you have (nvme0, sda, mmcblk0) and configuration option you would like to leverage - FDO or Ignition.

Prerrequisitos

Crear un Proveedor Simplificado personal

Con el uso de la herramienta mkksiso es posible crear un instalador personalizado que pueda ser utilizado para instalar y configurar muchos dispositivos.

Ejemplo con Dispositivo FIDO de a bordo

Este ejemplo:

  • Uses the --cmdline option to add the fdo.manufacturing_server_url to specify the FDO Manufacturing server to be used during the installation. NOTE: Replace the URL with that of your FDO Manufacturing server url.

  • Utiliza la opción --replace para actualizar el dispositivo de instalación y retira la opción quiet desde los argumentos del kernel tal que el mensaje de arranque son mostrados en la pantalla

  • Utiliza la ISO genérica - Fedora-IoT-provisioner-42-20250618.0.x86_64.iso creando un ISO nuevo llamdado Fedora-IoT-provisioner-FDO-42-20250618.0.x86_64.iso

sudo mkksiso --cmdline "fdo.manufacturing_server_url=http://192.168.1.26:8080 fdo.diun_pub_key_insecure=true" \
	--replace quiet "" \
	--replace vda sda \
Fedora-IoT-provisioner-42-20250618.0.x86_64.iso Fedora-IoT-provisioner-FDO-42-20250618.0.x86_64.iso

Ejemplo con Ignition

Este ejemplo:

  • Utiliza la opción --cmdline para añadir ignition.config.url y especificar el lugar del archivo de configuración de Ignition. NOTA: Sustituye la URL por la de tu archivo de Ignition.

  • Utiliza la opción --replace para actualizar el dispositivo de instalación para usar nvme0

  • Utiliza la ISO genérica: Fedora-IoT-provisioner-42-20250618.0.x86_64.iso creando una nueva ISO llamada Fedora-IoT-provisioner-IGN-42-20250618.0.x86_64.iso

sudo mkksiso --cmdline "coreos.inst.append=ignition.config.url=http://192.168.1.25/configs/ignition/config.ign" \
	--replace vda nvme0 \
Fedora-IoT-provisioner-42-20250618.0.x86_64.iso Fedora-IoT-provisioner-IGN-42-20250618.0.x86_64.iso

Solución de problemas

Al solucionar problemas con el Simplified-Provisioner, puede ser útil usar la opción `coreos.inst.skip_reboot` para evitar el reinicio automático tras que se complete la instalación.

Want to help? Learn how to contribute to Fedora Docs ›