@@ -1,23 +1,24 @@

 #Network PXE Boot

-Photon supports pxe boot over netwrok, this is describe how you can setup a PXE boot server to install Photon.

+Photon OS supports the Preboot Execution Environment, or PXE, over a network connection. This document describes how to set up a PXE boot server to install Photon OS.

 #Server Setup

-To setup PXE server you will need to have:

-* DHCP server to allow hosts to get an IP address.

-* TFTP server which is file transfer protocol which is similar to FTP with no authintication.

-* Optionally http server, this http serevr is going to serve the RPMs yum repo, or you can use the official Photon repo on bintray. Also this http serevr can be used if you want to provide kickstart config for unattended installation.

+To set up a PXE server, you will need to have the following:

-Setting up server instruction is based on an Ubuntu 14.04 machine assuming that it has an static IP adderess `172.16.78.134`.

+* A DHCP server to allow hosts to get an IP address.

+* A TFTP server, which is a file transfer protocol similar to FTP with no authentication.

+* Optionally, an HTTP server. The HTTP server will serve the RPMs yum repo, or you can use the official Photon OS repo on Bintray. Also, this HTTP server can be used if you want to provide a kickstart config for unattended installation.

+

+The instructions to set up the servers assume you have an Ubuntu 14.04 machine with a static IP address of `172.16.78.134`.

 ##DHCP Setup

-* Intall dhcp server

+* Intall the DHCP server:

 ```

   sudo apt-get install isc-dhcp-server

 ```

-* Edit ethernet interface in `/etc/default/isc-dhcp-server` to `INTERFACES="eth0"`

-* Edit dhcp configuration in `/etc/dhcp/dhcpd.conf`, will allow machines to boot and get IP address via DHCP in the range `172.16.78.230 - 172.16.78.250`

+* Edit the Ethernet interface in `/etc/default/isc-dhcp-server` to `INTERFACES="eth0"`

+* Edit the DHCP configuration in `/etc/dhcp/dhcpd.conf` to allow machines to boot and get an IP address via DHCP in the range `172.16.78.230 - 172.16.78.250`

 ```

   subnet 172.16.78.0 netmask 255.255.255.0 {

     range 172.16.78.230 172.16.78.250;

@@ -29,30 +30,31 @@ Setting up server instruction is based on an Ubuntu 14.04 machine assuming that

   }

 ```

-* Restart dhcp server

+* Restart the DHCP server: 

 ```

   sudo service isc-dhcp-server restart

 ```

 ##TFTP Setup

-* Install TFTP server

+* Install the TFTP server:

 ```

   sudo apt-get install tftpd-hpa

 ```

-* Enable boot service, and restrat the service

+* Enable the boot service and restart the service:

 ```

   sudo update-inetd --enable BOOT

   sudo service tftpd-hpa restart

 ```

-##Optional: http server setup

-This is step is only needed if:

-* Planning to serve the ks config file through this server, please refer to [Kickstart support](kickstart.md) for more details.

+

+##Optional: HTTP server setup

+

+This step is only needed if you are planning to serve the ks config file through this server; refer to [Kickstart support](kickstart.md) for details.

 * Serving your local yum repo.

 You can install apache http web server

 ```

 sudo apt-get install apache2

 ```

-Mount the photon iso to get the RPMS repo and sample ks config file.

+Mount the Photon iso to get the RPMS repo and sample ks config file.

 ```

 mkdir /mnt/photon-iso

 sudo mount <photon_iso> /mnt/photon-iso/

@@ -61,18 +63,18 @@ Copy the RPMS repo.

 ```

 cp -r /mnt/photon-iso/RPMS /var/www/html/

 ```

-To support ks, may be you can copy the sample config from the iso and editing it, please refer to [Kickstart support](kickstart.md) for more details.

+To support ks, you can copy the sample config file from the iso and edit it; refer to [Kickstart support](kickstart.md) for details.

 ```

 cp /mnt/photon-iso/isolinux/sample_ks.cfg /var/www/html/my_ks.cfg

 ```

 ##PXE boot files setup

-* Mount photon.iso to get linux and initrd images

+* Mount photon.iso to get Linux and initrd images:

 ```

 mkdir /mnt/photon-iso

 sudo mount <photon_iso> /mnt/photon-iso/

 ```

-* Setting the PXE boot files

+* Setting the PXE boot files:

 ```

 wget https://www.kernel.org/pub/linux/utils/boot/syslinux/syslinux-6.03.tar.gz

 tar -xvf syslinux-6.03.tar.gz

@@ -86,10 +88,10 @@ cp ~/syslinux-6.03/bios/core/pxelinux.0 .

 mkdir pxelinux.cfg

 mv isolinux.cfg pxelinux.cfg/default

 ```

-* Update repo param to point to http yum repo, you may pass official photon bintray repo.

+* Update repo param to point to http yum repo; you may pass official photon bintray repo.

 ```

 sed -i "s/append/append repo=http:\/\/172.16.78.134\/RPMS/g" menu.cfg

 popd

 ```

-* Optionally, you can add your ks config file, please refer [Kickstart support](kickstart.md) for more details.

+* Optionally, you can add your ks config file; see [Kickstart support](kickstart.md) for details.