install-guide/devel/en_US pxe-server.xml,NONE,1.1

[Paul W. Frields (pfrields)]

Author: pfrields

Update of /cvs/docs/install-guide/devel/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv15656

Added Files:
	pxe-server.xml 
Log Message:
Initial stab at a PXE server provisioning appendix



--- NEW FILE pxe-server.xml ---
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.docbook.org/xml/4.4/docbookx.dtd" [

<!ENTITY % FDP-ENTITIES SYSTEM "fdp-entities.ent">
%FDP-ENTITIES;

<!ENTITY % DOC-ENTITIES SYSTEM "entities.ent">
%DOC-ENTITIES;

]>

<appendix>
  <title>Setting Up a PXE Server</title>
  <note>
    <title>Experience Required</title>
    <para>This appendix is intended for users with previous Linux
      experience.  If you are a new user, you may want to install using
      minimal boot media or the distribution DVD instead.</para>
  </note>
  <para>This section discusses how to set up a <firstterm>Pre-boot
      eXecution Environment</firstterm> (<acronym>PXE</acronym>) boot
    server for machines that cannot boot from CD, DVD, or USB media. PXE
    is a special extension of services provided by the
    <firstterm>Dynamic Host Configuration Protocol</firstterm>
    (<acronym>DHCP</acronym>).  It uses a <firstterm>Trivial File
      Transfer Protocol</firstterm> (<acronym>TFTP</acronym>) server to
    provide minimal boot files to a network client.  To set up a PXE
    boot service on a separate &DISTRO; server on the local network,
    follow this procedure:</para>
  <procedure>
    <step>
      <para>Install the <package>tftp-server</package>,
	<package>dhcp</package>, and <package>syslinux</package>
	packages:</para>
      <screen><command>su -c 'yum install tftp-server
	  dhcp syslinux'</command></screen>
    </step>
    <step>
      <para>Edit the <filename>/etc/dhcpd.conf</filename> file to
	configure the DHCP server.  The following example is a minimal
	configuration for a network that uses the following
	configuration:</para>
      <itemizedlist>
	<listitem>
	  <para><systemitem
	      class="ipaddress">192.168.1.0/24</systemitem>
	    addressing</para>
	</listitem>
	<listitem>
	  <para>Dynamic addresses provided between <systemitem
	      class="ipaddress">192.168.1.200</systemitem> and
	    <systemitem
	      class="ipaddress">192.168.1.240</systemitem></para>
	</listitem>
	<listitem>
	  <para>DHCP/PXE server at IP address <systemitem
	      class="ipaddress">192.168.1.10</systemitem></para>
	</listitem>
	<listitem>
	  <para>No other dynamic configuration provided</para>
	</listitem>
      </itemizedlist>
      <screen><computeroutput><![CDATA[allow booting;
allow bootp;
ddns-update-style interim;
ignore client-updates;

subnet 192.168.1.0 netmask 255.255.255.0 {
	  option subnet-mask 255.255.255.0;
	  option broadcast-address 192.168.1.255;
	  range dynamic-bootp 192.168.1.200 192.168.1.240;
	  next-server 192.168.1.10;
	  filename "pxelinux.0";
}]]></computeroutput></screen>
    </step>
    <step>
      <para>As the <systemitem class="username">root</systemitem> user,
	copy the PXE boot image and &DISTRO; boot files to the TFTP
	server directory.</para>
      <screen><![CDATA[su -
cd /tftpboot
cp /usr/lib/syslinux/pxelinux.0 .]]></screen>
    </step>
    <step>
      <para>Copy the <filename>vmlinuz</filename> and
	<filename>initrd.img</filename> files from the <filename
	  class="directory">pxeboot</filename> directory on distribution
	media or a Web mirror to the <filename
	  class="directory">/tftpboot</filename> directory.</para>
    </step>
    <step>
      <para>Create a minimal <filename>/tftpboot/pxelinux.cfg</filename>
	file:</para>
      <screen><![CDATA[DEFAULT pxeboot
TIMEOUT 50
LABEL pxeboot
      KERNEL vmlinuz
      APPEND initrd=initrd.img
ONERROR LOCALBOOT 0]]></screen>
    </step>
    <step>
      <para>Turn on the <systemitem class="service">dhcpd</systemitem>,
	<systemitem class="service">xinetd</systemitem> and <systemitem
	  class="service">tftp</systemitem> services:</para>
      <screen><![CDATA[su -c '/sbin/service dhcpd start'
su -c '/sbin/service xinetd start'
su -c '/sbin/chkconfig tftp on']]></screen>
    </step>
  </procedure>
  <para>Boot the client system and either use the required keys or
    configure its BIOS to boot from its network interface using PXE.  At
    the boot prompt, hit <keycap>Enter</keycap> to boot the default
    &DISTRO; installation image.  If an error occurs, the system boots
    in its normal configuration, such as a local hard disk.</para>
</appendix>