Add instructions for using coreos-ipxe-server.

Author: tintoy

README.md

@@ -38,10 +38,71 @@ If you're trying to boot CoreOS, consider using [coreos-ipxe-server](https://git
 
 ## Network boot in MCP2
 
+### Prerequisites
+
+#### DHCP / TFTP / iPXE server
+
+Deploy an Ubuntu 16.x server attached to the target VLAN (other distros might work but have not been tested):
+
+1. `apt-get install -y git built-essential liblzma-dev mkisofs tftpd-hpa`.
+2. `mkdir -p /usr/local/src/ipxe`
+3. `cd /usr/local/src/ipxe`
+4. `git clone git://git.ipxe.org/ipxe.git .`
+5. `cd src`
+6. `make`
+7. `cp bin/undionly.kpxe /var/lib/tftpboot`
+8. Place a copy of the `mcp2-dhcp-server` executable on this machine.
+
+If you're using `coreos-ipxe-server`:
+
+1. Place a copy of the `coreos-ipxe-server` executable on this machine.
+2. `export COREOS_IPXE_SERVER_DATA_DIR=/opt/coreos-ipxe-server`
+3. `mkdir -p $COREOS_IPXE_SERVER_DATA_DIR/{configs,images,profiles,sshkeys}`
+4. `mkdir -p $COREOS_IPXE_SERVER_DATA_DIR/images/amd64-usr/310.1.0`
+5. `pushd $COREOS_IPXE_SERVER_DATA_DIR/images/amd64-usr/310.1.0`
+6. `wget http://storage.core-os.net/coreos/amd64-usr/310.1.0/coreos_production_pxe_image.cpio.gz`
+7. `wget http://storage.core-os.net/coreos/amd64-usr/310.1.0/coreos_production_pxe.vmlinuz`
+8. `popd`
+9. Place an SSH public key in `$COREOS_IPXE_SERVER_DATA_DIR/sshkeys/coreos.pub`
+10. Place a cloud-config in `$COREOS_IPXE_SERVER_DATA_DIR/configs/development.yml`:  
+```yaml
+#cloud-config
+
+ssh_authorized_keys:
+    - ssh-rsa AAAAB3Nza...
+coreos:
+  etcd:
+    addr: $private_ipv4:4001
+    peer-addr: $private_ipv4:7001
+  units:
+    - name: etcd.service
+      command: start
+    - name: fleet.service
+      command: start
+    - name: docker.socket
+      command: start
+  oem:
+    id: coreos
+    name: CoreOS Custom
+    version-id: 310.1.0
+    home-url: https://coreos.com
+```
+11. Place a profile in `$COREOS_IPXE_SERVER_DATA_DIR/profiles/development.json`:  
+```json
+{
+	"cloud_config": "development",
+	"rootfstype": "btrfs",
+	"sshkey": "coreos",
+	"version": "310.1.0"
+}
+```
+
+### Process
+
 1. Create a VM using VMWare Workstation or VMWare fusion (ensure it has 1 disk and 1 network adapter, with hardware versiom <= 10).
 2. Do not install an operating system (leave the disk completely empty).
 3. Close VMWare, and use [ovftool](https://my.vmware.com/web/vmware/details?downloadGroup=OVFTOOL400&productId=353) to convert the virtual machine to OVF format (`ovftool myserver.vmx ovf/myserver.ovf`).
 4. Upload the `.ovf`, `.vmdk`, and `.mf` files to CloudControl and import it as a client image (ensure that "Import without Guest OS Customization" is checked, see [here](https://docs.mcp-services.net/display/CCD/How+to+Import+an+OVF+Package+as+a+Client+Image) for details).
-5. Run `mcp2-dhcp-server` on the same machine as your TFTP / iPXE server.
-6. Deploy a new server from your client image, and start it. Network boot should proceed automatically.
-
+5. On your DHCP / iPXE server, run `coreos-ipxe-server`.
+6. On your DHCP / iPXE server, run `mcp2-dhcp-server`.
+7. Deploy a new server from your client image, and start it. Network boot should proceed automatically.