{% extends "layout.html" %} {% from "_partials/page_description.html" import page_description %} {% block title %}Live env - pixie{% endblock %} {% block subnav %} {% endblock %} {% block content %} {{ page_description('boombox', 'The pixie live env that the pixie-flash-once / pixie-flash-always / pixie-inventory / pixie-tui boot modes boot into. It is a fetched disk image (the pixie-live-env catalog entry) booted over ephemeral nbdboot: select it here by content sha. Until an image is selected and fetched, those boot modes fall back to an "unavailable" iPXE plan.') }} {% if flash_error %}
{{ flash_error }}
{% endif %} {# ---- Live-env image (the nbdboot selector) ---------------------- #}

Live-env image

{% if live_env_image_sha.effective %} selected {% else %} none selected {% endif %}

Fetch the pixie-live-env image on the Catalog page, then paste its content_sha256 here. The pixie-inventory / pixie-tui / pixie-flash-* modes boot it over ephemeral nbdboot (a RO NBD lower + tmpfs overlay); dracut brings the NIC up where the retired live-boot squashfs hung in the initramfs on some boards. The on-target pixie CLI phones home so inventory / flash work as before.

A fetched disk-image's content_sha256 (64 hex), plus its netboot bundle (via the entry's netboot_src), must both be fetched. Blank falls back to {{ live_env_image_sha.env }} then unset, in which case the live-env boot modes render the unavailable plan. Effective: {% if live_env_image_sha.effective %}{{ live_env_image_sha.effective }}{% else %}(none){% endif %}. {% if live_env_image_sha.updated_at %}
Last updated: {{ live_env_image_sha.updated_at | fmt_ts }}.{% endif %}
Takes effect on the NEXT GET /pxe/<mac>; a target already mid-boot must be power-cycled.
{# ---- Options (config) ------------------------------------------- #}
Options
Tokens appended verbatim to the pixie-live-env kernel cmdline (after pixie.mac= / bty.mac=, so last-token-wins on any conflict). Whitespace-separated; single line. Blank falls back to {{ live_env_extra_cmdline.env }} then no append. A machine with its own extra_cmdline binding overrides this global. Effective: {% if live_env_extra_cmdline.effective %}{{ live_env_extra_cmdline.effective }}{% else %}(none){% endif %}. Known-good values per hardware in docs/hardware-quirks.md. {% if live_env_extra_cmdline.updated_at %}
Last updated: {{ live_env_extra_cmdline.updated_at | fmt_ts }}.{% endif %}
Takes effect on the NEXT GET /pxe/<mac>; a target already mid-boot must be power-cycled.
{% endblock %}