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/installation | |
parent | 5f0e1822e8533a266ef56607d305f657b98f58cd (diff) | |
download | nixlib-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar nixlib-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.gz nixlib-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.bz2 nixlib-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.lz nixlib-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.xz nixlib-f6a42c131ad6d2d0604d90deee86d371a639a43d.tar.zst nixlib-f6a42c131ad6d2d0604d90deee86d371a639a43d.zip |
nixos: nixos/doc/manual/installation/installing-pxe.xml to CommonMark
Diffstat (limited to 'nixos/doc/manual/installation')
-rw-r--r-- | nixos/doc/manual/installation/installing-pxe.section.md | 32 | ||||
-rw-r--r-- | nixos/doc/manual/installation/installing-pxe.xml | 50 | ||||
-rw-r--r-- | nixos/doc/manual/installation/installing.xml | 2 |
3 files changed, 33 insertions, 51 deletions
diff --git a/nixos/doc/manual/installation/installing-pxe.section.md b/nixos/doc/manual/installation/installing-pxe.section.md new file mode 100644 index 000000000000..2016a258251f --- /dev/null +++ b/nixos/doc/manual/installation/installing-pxe.section.md @@ -0,0 +1,32 @@ +# Booting from the "netboot" media (PXE) {#sec-booting-from-pxe} + +Advanced users may wish to install NixOS using an existing PXE or iPXE +setup. + +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: + +```ShellSession +nix-build -A netboot.x86_64-linux nixos/release.nix +``` + +This will create a `result` directory containing: \* `bzImage` -- the +Linux kernel \* `initrd` -- the initrd file \* `netboot.ipxe` -- an +example ipxe script demonstrating the appropriate kernel command line +arguments for this image + +If you're using plain PXE, configure your boot loader to use the +`bzImage` and `initrd` files and have it provide the same kernel command +line arguments found in `netboot.ipxe`. + +If you're using iPXE, depending on how your HTTP/FTP/etc. server is +configured you may be able to use `netboot.ipxe` unmodified, or you may +need to update the paths to the files to match your server's directory +layout. + +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. diff --git a/nixos/doc/manual/installation/installing-pxe.xml b/nixos/doc/manual/installation/installing-pxe.xml deleted file mode 100644 index ea88fbdad7e2..000000000000 --- a/nixos/doc/manual/installation/installing-pxe.xml +++ /dev/null @@ -1,50 +0,0 @@ -<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.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> diff --git a/nixos/doc/manual/installation/installing.xml b/nixos/doc/manual/installation/installing.xml index f7b527b9cf55..6bfe9ebcad67 100644 --- a/nixos/doc/manual/installation/installing.xml +++ b/nixos/doc/manual/installation/installing.xml @@ -568,7 +568,7 @@ Retype new UNIX password: ***</screen> <xi:include href="../from_md/installation/installing-usb.section.xml" /> - <xi:include href="installing-pxe.xml" /> + <xi:include href="../from_md/installation/installing-pxe.section.xml" /> <xi:include href="installing-virtualbox-guest.xml" /> |