openstack/ironic
Code Issues Proposed changes

Update installation guide for syslinux 6

Browse Source 
Fedora 21 and the next Ubuntu will have syslinux 6 in them. In syslinux
6 modules are not "stand alone" as it was in versions prior to 4, see:
http://www.syslinux.org/wiki/index.php/Library_modules

Partial-Bug: #1351010
Change-Id: Ie6bb031c10a9f8cf978e2c5dbd643b4a19cc93d0
This commit is contained in:
Lucas Alvares Gomes 2014-09-01 17:58:58 +01:00
parent a6caeef289
commit 1d54000e86
1 changed files with 29 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/source/deploy/install-guide.rst
View File

@ -332,16 +332,38 @@ PXE Setup
If you will be using PXE, it needs to be set up on the Bare Metal Service If you will be using PXE, it needs to be set up on the Bare Metal Service
node(s) where ``ironic-conductor`` is running. node(s) where ``ironic-conductor`` is running.
#. Make sure these directories exist:: #. Make sure the tftp root directory exist and can be written to by the
user the ``ironic-conductor`` is running as. For example::
sudo mkdir -p /tftproot sudo mkdir -p /tftpboot
sudo chown -R ironic:LIBVIRT_GROUP -p /tftproot sudo chown -R ironic -p /tftpboot
mkdir -p /tftproot/pxelinux.cfg
#. Copy the PXE binary to ``/tftproot``. The PXE binary might be found at:: #. Install the syslinux package with the PXE boot images::
ubuntu: /usr/lib/syslinux/pxelinux.0 Ubuntu:
fedora/RHEL: /usr/share/syslinux/pxelinux.0 sudo apt-get install syslinux syslinux-common
Fedora/RHEL:
sudo yum install syslinux-tftpboot
#. Copy the PXE image to ``/tftpboot``. The PXE image might be found at [1]_::
Ubuntu:
sudo cp /usr/lib/syslinux/pxelinux.0 /tftpboot
#. If the version of syslinux is **greater than** 4 we also need to make sure
that we copy the library modules into the ``/tftpboot`` directory [2]_
[1]_::
Ubuntu:
sudo cp /usr/lib/syslinux/modules/*/ldlinux.* /tftpboot
.. [1] On **Fedora/RHEL** the ``syslinux-tftpboot`` package already install
the library modules and PXE image at ``/tftpboot``. If the TFTP server
is configured to listen to a different directory you should copy the
contents of ``/tftpboot`` to the configured directory
.. [2] http://www.syslinux.org/wiki/index.php/Library_modules
iPXE Setup iPXE Setup
---------- ----------