diff options
author | Domen Kožar <domen@dev.si> | 2016-04-29 10:41:13 +0100 |
---|---|---|
committer | Domen Kožar <domen@dev.si> | 2016-04-29 10:42:45 +0100 |
commit | 90d7041ce4d270bbcf0efefd1d1e42c097c1335d (patch) | |
tree | d86a77b402c73dae942d1c7f10f018f7b252851d /nixos/doc/manual/installation | |
parent | 83c0aca062369aa43d5e692f22ff22e8d2e787a1 (diff) | |
download | nixpkgs-90d7041ce4d270bbcf0efefd1d1e42c097c1335d.tar nixpkgs-90d7041ce4d270bbcf0efefd1d1e42c097c1335d.tar.gz nixpkgs-90d7041ce4d270bbcf0efefd1d1e42c097c1335d.tar.bz2 nixpkgs-90d7041ce4d270bbcf0efefd1d1e42c097c1335d.tar.lz nixpkgs-90d7041ce4d270bbcf0efefd1d1e42c097c1335d.tar.xz nixpkgs-90d7041ce4d270bbcf0efefd1d1e42c097c1335d.tar.zst nixpkgs-90d7041ce4d270bbcf0efefd1d1e42c097c1335d.zip |
PXE boot: add manual section and note in changelog
Diffstat (limited to 'nixos/doc/manual/installation')
-rw-r--r-- | nixos/doc/manual/installation/installing-pxe.xml | 48 | ||||
-rw-r--r-- | nixos/doc/manual/installation/installing.xml | 1 |
2 files changed, 49 insertions, 0 deletions
diff --git a/nixos/doc/manual/installation/installing-pxe.xml b/nixos/doc/manual/installation/installing-pxe.xml new file mode 100644 index 00000000000..7b7597c9162 --- /dev/null +++ b/nixos/doc/manual/installation/installing-pxe.xml @@ -0,0 +1,48 @@ +<section xmlns="http://docbook.org/ns/docbook" + xmlns:xlink="http://www.w3.org/1999/xlink" + xmlns:xi="http://www.w3.org/2001/XInclude" + version="5.0" + xml:id="sec-booting-from-pxe"> + +<title>Booting from the <quote>netboot</quote> media (PXE)</title> +<para> + Advanced users may wish to install NixOS using an existing PXE or + iPXE setup. +</para> +<para> + These instructions assume that you have an existing PXE or iPXE + infrastructure and simply want to add the NixOS installer as another + option. To build the necessary files from a recent version of + nixpkgs, you can run: +</para> +<programlisting> +nix-build -A netboot nixos/release.nix +</programlisting> +<para> + This will create a <literal>result</literal> directory containing: * + <literal>bzImage</literal> – the Linux kernel * + <literal>initrd</literal> – the initrd file * + <literal>netboot.ipxe</literal> – an example ipxe script + demonstrating the appropriate kernel command line arguments for this + image +</para> +<para> + If you’re using plain PXE, configure your boot loader to use the + <literal>bzImage</literal> and <literal>initrd</literal> files and + have it provide the same kernel command line arguments found in + <literal>netboot.ipxe</literal>. +</para> +<para> + If you’re using iPXE, depending on how your HTTP/FTP/etc. server is + configured you may be able to use <literal>netboot.ipxe</literal> + unmodified, or you may need to update the paths to the files to + match your server’s directory layout +</para> +<para> + In the future we may begin making these files available as build + products from hydra at which point we will update this documentation + with instructions on how to obtain them either for placing on a + dedicated TFTP server or to boot them directly over the internet. +</para> + +</section> diff --git a/nixos/doc/manual/installation/installing.xml b/nixos/doc/manual/installation/installing.xml index 4a0b3fee7c1..3e53062c3e8 100644 --- a/nixos/doc/manual/installation/installing.xml +++ b/nixos/doc/manual/installation/installing.xml @@ -270,5 +270,6 @@ $ reboot</screen> <xi:include href="installing-uefi.xml" /> <xi:include href="installing-usb.xml" /> +<xi:include href="installing-pxe.xml" /> </chapter> |