diff options
author | Bobby Rong <rjl931189261@126.com> | 2021-07-02 22:50:58 +0800 |
---|---|---|
committer | Bobby Rong <rjl931189261@126.com> | 2021-07-02 22:50:58 +0800 |
commit | f6a42c131ad6d2d0604d90deee86d371a639a43d (patch) | |
tree | 9babe641699a8e7636604eceb008ea275672eb17 /nixos/doc/manual/from_md/installation/installing-pxe.section.xml | |
parent | 5f0e1822e8533a266ef56607d305f657b98f58cd (diff) | |
download | nixpkgs-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar nixpkgs-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.gz nixpkgs-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.bz2 nixpkgs-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.lz nixpkgs-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.xz nixpkgs-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.zst nixpkgs-f6a42c131ad6d2d0604d90deee86d371a639a43d.zip |
nixos: nixos/doc/manual/installation/installing-pxe.xml to CommonMark
Diffstat (limited to 'nixos/doc/manual/from_md/installation/installing-pxe.section.xml')
-rw-r--r-- | nixos/doc/manual/from_md/installation/installing-pxe.section.xml | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/nixos/doc/manual/from_md/installation/installing-pxe.section.xml b/nixos/doc/manual/from_md/installation/installing-pxe.section.xml new file mode 100644 index 00000000000..1dd15ddacba --- /dev/null +++ b/nixos/doc/manual/from_md/installation/installing-pxe.section.xml @@ -0,0 +1,42 @@ +<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" 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.x86_64-linux 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> |