nixos: nixos/doc/manual/installation/installing-pxe.xml to CommonMark
This commit is contained in:
parent
5f0e1822e8
commit
f6a42c131a
|
@ -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>
|
32
nixos/doc/manual/installation/installing-pxe.section.md
Normal file
32
nixos/doc/manual/installation/installing-pxe.section.md
Normal file
|
@ -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.
|
|
@ -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>
|
|
@ -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" />
|
||||
|
||||
|
|
Loading…
Reference in a new issue