"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/source/install/configure-pxe.rst" between
ironic-17.0.2.tar.gz and ironic-17.0.3.tar.gz

About: OpenStack Ironic (Optional Service: Bare-Metal Provisioning) aims to provision bare metal machines instead of virtual machines, forked from the Nova baremetal driver.
The "Wallaby" series (latest release).

configure-pxe.rst  (ironic-17.0.2):configure-pxe.rst  (ironic-17.0.3)
skipping to change at line 60 skipping to change at line 60
sudo mkdir -p /tftpboot sudo mkdir -p /tftpboot
sudo chown -R ironic /tftpboot sudo chown -R ironic /tftpboot
#. Install tftp server: #. Install tftp server:
Ubuntu:: Ubuntu::
sudo apt-get install xinetd tftpd-hpa sudo apt-get install xinetd tftpd-hpa
RHEL7/CentOS7:: RHEL8/CentOS8/Fedora::
sudo yum install tftp-server xinetd
Fedora::
sudo dnf install tftp-server xinetd sudo dnf install tftp-server xinetd
SUSE:: SUSE::
sudo zypper install tftp xinetd sudo zypper install tftp xinetd
#. Using xinetd to provide a tftp server setup to serve ``/tftpboot``. #. Using xinetd to provide a tftp server setup to serve ``/tftpboot``.
Create or edit ``/etc/xinetd.d/tftp`` as below:: Create or edit ``/etc/xinetd.d/tftp`` as below::
skipping to change at line 96 skipping to change at line 92
# IPv6 endpoint, if IPv4 flag is not used. # IPv6 endpoint, if IPv4 flag is not used.
flags = IPv4 flags = IPv4
} }
and restart the ``xinetd`` service: and restart the ``xinetd`` service:
Ubuntu:: Ubuntu::
sudo service xinetd restart sudo service xinetd restart
Fedora/RHEL7/CentOS7/SUSE:: Fedora/RHEL8/CentOS8/SUSE::
sudo systemctl restart xinetd sudo systemctl restart xinetd
.. note:: .. note::
In certain environments the network's MTU may cause TFTP UDP packets to get In certain environments the network's MTU may cause TFTP UDP packets to get
fragmented. Certain PXE firmwares struggle to reconstruct the fragmented fragmented. Certain PXE firmwares struggle to reconstruct the fragmented
packets which can cause significant slow down or even prevent the server packets which can cause significant slow down or even prevent the server
from PXE booting. In order to avoid this, TFTPd provides an option to limit from PXE booting. In order to avoid this, TFTPd provides an option to limit
the packet size so that it they do not get fragmented. To set this the packet size so that it they do not get fragmented. To set this
skipping to change at line 133 skipping to change at line 129
In order to deploy instances with PXE on bare metal nodes which support In order to deploy instances with PXE on bare metal nodes which support
UEFI, perform these additional steps on the ironic conductor node to configure UEFI, perform these additional steps on the ironic conductor node to configure
the PXE UEFI environment. the PXE UEFI environment.
#. Install Grub2 and shim packages: #. Install Grub2 and shim packages:
Ubuntu (16.04LTS and later):: Ubuntu (16.04LTS and later)::
sudo apt-get install grub-efi-amd64-signed shim-signed sudo apt-get install grub-efi-amd64-signed shim-signed
RHEL7/CentOS7:: RHEL8/CentOS8/Fedora::
sudo yum install grub2-efi shim
Fedora::
sudo dnf install grub2-efi shim sudo dnf install grub2-efi shim
SUSE:: SUSE::
sudo zypper install grub2-x86_64-efi shim sudo zypper install grub2-x86_64-efi shim
#. Copy grub and shim boot loader images to ``/tftpboot`` directory: #. Copy grub and shim boot loader images to ``/tftpboot`` directory:
Ubuntu (16.04LTS and later):: Ubuntu (16.04LTS and later)::
sudo cp /usr/lib/shim/shim.efi.signed /tftpboot/bootx64.efi sudo cp /usr/lib/shim/shim.efi.signed /tftpboot/bootx64.efi
sudo cp /usr/lib/grub/x86_64-efi-signed/grubnetx64.efi.signed /tftpboot/g rubx64.efi sudo cp /usr/lib/grub/x86_64-efi-signed/grubnetx64.efi.signed /tftpboot/g rubx64.efi
Fedora:: Fedora::
sudo cp /boot/efi/EFI/fedora/shim.efi /tftpboot/bootx64.efi sudo cp /boot/efi/EFI/fedora/shim.efi /tftpboot/bootx64.efi
sudo cp /boot/efi/EFI/fedora/grubx64.efi /tftpboot/grubx64.efi sudo cp /boot/efi/EFI/fedora/grubx64.efi /tftpboot/grubx64.efi
RHEL7/CentOS7:: RHEL8/CentOS8::
sudo cp /boot/efi/EFI/centos/shim.efi /tftpboot/bootx64.efi sudo cp /boot/efi/EFI/centos/shim.efi /tftpboot/bootx64.efi
sudo cp /boot/efi/EFI/centos/grubx64.efi /tftpboot/grubx64.efi sudo cp /boot/efi/EFI/centos/grubx64.efi /tftpboot/grubx64.efi
SUSE:: SUSE::
sudo cp /usr/lib64/efi/shim.efi /tftpboot/bootx64.efi sudo cp /usr/lib64/efi/shim.efi /tftpboot/bootx64.efi
sudo cp /usr/lib/grub2/x86_64-efi/grub.efi /tftpboot/grubx64.efi sudo cp /usr/lib/grub2/x86_64-efi/grub.efi /tftpboot/grubx64.efi
#. Create master grub.cfg: #. Create master grub.cfg:
Ubuntu: Create grub.cfg under ``/tftpboot/grub`` directory:: Ubuntu: Create grub.cfg under ``/tftpboot/grub`` directory::
GRUB_DIR=/tftpboot/grub GRUB_DIR=/tftpboot/grub
Fedora: Create grub.cfg under ``/tftpboot/EFI/fedora`` directory:: Fedora: Create grub.cfg under ``/tftpboot/EFI/fedora`` directory::
GRUB_DIR=/tftpboot/EFI/fedora GRUB_DIR=/tftpboot/EFI/fedora
RHEL7/CentOS7: Create grub.cfg under ``/tftpboot/EFI/centos`` directory:: RHEL8/CentOS8: Create grub.cfg under ``/tftpboot/EFI/centos`` directory::
GRUB_DIR=/tftpboot/EFI/centos GRUB_DIR=/tftpboot/EFI/centos
SUSE: Create grub.cfg under ``/tftpboot/boot/grub`` directory:: SUSE: Create grub.cfg under ``/tftpboot/boot/grub`` directory::
GRUB_DIR=/tftpboot/boot/grub GRUB_DIR=/tftpboot/boot/grub
Create directory ``GRUB_DIR``:: Create directory ``GRUB_DIR``::
sudo mkdir -p $GRUB_DIR sudo mkdir -p $GRUB_DIR
skipping to change at line 223 skipping to change at line 215
In order to deploy instances with PXE on bare metal using Legacy BIOS boot In order to deploy instances with PXE on bare metal using Legacy BIOS boot
mode, perform these additional steps on the ironic conductor node. mode, perform these additional steps on the ironic conductor node.
#. Install the syslinux package with the PXE boot images: #. Install the syslinux package with the PXE boot images:
Ubuntu (16.04LTS and later):: Ubuntu (16.04LTS and later)::
sudo apt-get install syslinux-common pxelinux sudo apt-get install syslinux-common pxelinux
RHEL7/CentOS7:: RHEL8/CentOS8/Fedora::
sudo yum install syslinux-tftpboot
Fedora::
sudo dnf install syslinux-tftpboot sudo dnf install syslinux-tftpboot
SUSE:: SUSE::
sudo zypper install syslinux sudo zypper install syslinux
#. Copy the PXE image to ``/tftpboot``. The PXE image might be found at [1]_: #. Copy the PXE image to ``/tftpboot``. The PXE image might be found at [1]_:
Ubuntu (16.04LTS and later):: Ubuntu (16.04LTS and later)::
sudo cp /usr/lib/PXELINUX/pxelinux.0 /tftpboot sudo cp /usr/lib/PXELINUX/pxelinux.0 /tftpboot
RHEL7/CentOS7/SUSE:: RHEL8/CentOS8/SUSE::
sudo cp /usr/share/syslinux/pxelinux.0 /tftpboot sudo cp /usr/share/syslinux/pxelinux.0 /tftpboot
#. If whole disk images need to be deployed via PXE-netboot, copy the #. If whole disk images need to be deployed via PXE-netboot, copy the
chain.c32 image to ``/tftpboot`` to support it: chain.c32 image to ``/tftpboot`` to support it:
Ubuntu (16.04LTS and later):: Ubuntu (16.04LTS and later)::
sudo cp /usr/lib/syslinux/modules/bios/chain.c32 /tftpboot sudo cp /usr/lib/syslinux/modules/bios/chain.c32 /tftpboot
Fedora:: Fedora::
sudo cp /boot/extlinux/chain.c32 /tftpboot sudo cp /boot/extlinux/chain.c32 /tftpboot
RHEL7/CentOS7/SUSE:: RHEL8/CentOS8/SUSE::
sudo cp /usr/share/syslinux/chain.c32 /tftpboot/ sudo cp /usr/share/syslinux/chain.c32 /tftpboot/
#. If the version of syslinux is **greater than** 4 we also need to make sure #. 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]_ that we copy the library modules into the ``/tftpboot`` directory [2]_
[1]_. For example, for Ubuntu run:: [1]_. For example, for Ubuntu run::
sudo cp /usr/lib/syslinux/modules/*/ldlinux.* /tftpboot sudo cp /usr/lib/syslinux/modules/*/ldlinux.* /tftpboot
#. Update the bare metal node with ``boot_mode:bios`` capability in #. Update the bare metal node with ``boot_mode:bios`` capability in
skipping to change at line 340 skipping to change at line 328
http_url=http://192.168.0.2:8080 http_url=http://192.168.0.2:8080
See also: :ref:`l3-external-ip`. See also: :ref:`l3-external-ip`.
#. Install the iPXE package with the boot images: #. Install the iPXE package with the boot images:
Ubuntu:: Ubuntu::
apt-get install ipxe apt-get install ipxe
RHEL7/CentOS7:: RHEL8/CentOS8/Fedora::
yum install ipxe-bootimgs
Fedora::
dnf install ipxe-bootimgs dnf install ipxe-bootimgs
.. note:: .. note::
SUSE does not provide a package containing iPXE boot images. If you are SUSE does not provide a package containing iPXE boot images. If you are
using SUSE or if the packaged version of the iPXE boot image doesn't using SUSE or if the packaged version of the iPXE boot image doesn't
work, you can download a prebuilt one from http://boot.ipxe.org or build work, you can download a prebuilt one from http://boot.ipxe.org or build
one image from source, see http://ipxe.org/download for more information. one image from source, see http://ipxe.org/download for more information.
#. Copy the iPXE boot image (``undionly.kpxe`` for **BIOS** and #. Copy the iPXE boot image (``undionly.kpxe`` for **BIOS** and
``ipxe.efi`` for **UEFI**) to ``/tftpboot``. The binary might ``ipxe.efi`` for **UEFI**) to ``/tftpboot``. The binary might
be found at: be found at:
Ubuntu:: Ubuntu::
cp /usr/lib/ipxe/{undionly.kpxe,ipxe.efi,snponly.efi} /tftpboot cp /usr/lib/ipxe/{undionly.kpxe,ipxe.efi,snponly.efi} /tftpboot
Fedora/RHEL7/CentOS7:: Fedora/RHEL8/CentOS8::
cp /usr/share/ipxe/{undionly.kpxe,ipxe.efi,snponly.efi} /tftpboot cp /usr/share/ipxe/{undionly.kpxe,ipxe.efi,snponly.efi} /tftpboot
#. Enable/Configure iPXE overrides in the Bare Metal Service's configuration #. Enable/Configure iPXE overrides in the Bare Metal Service's configuration
file **if required** (/etc/ironic/ironic.conf): file **if required** (/etc/ironic/ironic.conf):
.. code-block:: ini .. code-block:: ini
[pxe] [pxe]
skipping to change at line 455 skipping to change at line 439
(as it will serve iPXE boot script and boot configuration files for nodes), (as it will serve iPXE boot script and boot configuration files for nodes),
such configuration will shift some load from ironic-conductor hosts such configuration will shift some load from ironic-conductor hosts
to the Object Storage service which can be scaled horizontally. to the Object Storage service which can be scaled horizontally.
Note that when SSL is enabled on the Object Storage service Note that when SSL is enabled on the Object Storage service
you have to ensure that iPXE firmware on the nodes can indeed you have to ensure that iPXE firmware on the nodes can indeed
boot from generated temporary URLs that use HTTPS protocol. boot from generated temporary URLs that use HTTPS protocol.
#. Restart the ``ironic-conductor`` process: #. Restart the ``ironic-conductor`` process:
Fedora/RHEL7/CentOS7/SUSE:: Fedora/RHEL8/CentOS8/SUSE::
sudo systemctl restart openstack-ironic-conductor sudo systemctl restart openstack-ironic-conductor
Ubuntu:: Ubuntu::
sudo service ironic-conductor restart sudo service ironic-conductor restart
PXE multi-architecture setup PXE multi-architecture setup
---------------------------- ----------------------------
 End of changes. 11 change blocks. 
27 lines changed or deleted 11 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)