Add SUSE instructions to the install guide

It is true that the existing instructions for other distributions can be
adapted for SUSE, but we can make it even easier by providing
instructions tailored for SUSE.

Change-Id: Id50c3d663fc2bd527ec2fe5e26fd1d4692b971ce
This commit is contained in:
Colleen Murphy 2017-04-07 14:08:04 +02:00
parent 1fcb6c52a2
commit 1849a81383
9 changed files with 75 additions and 20 deletions

View File

@ -30,7 +30,7 @@ Configure the Bare Metal service for cleaning
.. code-block:: console .. code-block:: console
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-ironic-conductor sudo systemctl restart openstack-ironic-conductor
Ubuntu: Ubuntu:

View File

@ -40,13 +40,16 @@ CoreOS tools
Ubuntu 14.04 (trusty) or higher: Ubuntu 14.04 (trusty) or higher:
sudo apt-get install docker.io gzip uuid-runtime cpio findutils grep gnupg sudo apt-get install docker.io gzip uuid-runtime cpio findutils grep gnupg
SUSE:
sudo zypper install docker gzip util-linux cpio findutils grep gpg2
#. Change directory to ``imagebuild/coreos``:: #. Change directory to ``imagebuild/coreos``::
cd ironic-python-agent/imagebuild/coreos cd ironic-python-agent/imagebuild/coreos
#. Start the docker daemon:: #. Start the docker daemon::
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl start docker sudo systemctl start docker
Ubuntu: Ubuntu:

View File

@ -36,7 +36,7 @@ It can be enabled by making the following changes to ``/etc/glance/glance-api.co
#. Restart the glance-api service:: #. Restart the glance-api service::
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-glance-api sudo systemctl restart openstack-glance-api
Debian/Ubuntu: Debian/Ubuntu:
@ -82,7 +82,7 @@ To enable secure HTTPS communication between Bare Metal service and Image servic
#. Restart ironic-conductor service:: #. Restart ironic-conductor service::
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-ironic-conductor sudo systemctl restart openstack-ironic-conductor
Debian/Ubuntu: Debian/Ubuntu:

View File

@ -18,6 +18,9 @@ Bare Metal service comes with an example file for configuring the
Debian/Ubuntu: Debian/Ubuntu:
apt-get install apache2 apt-get install apache2
SUSE:
zypper install apache2
#. Copy the ``etc/apache2/ironic`` file under the apache sites: #. Copy the ``etc/apache2/ironic`` file under the apache sites:
@ -30,6 +33,9 @@ Bare Metal service comes with an example file for configuring the
Debian/Ubuntu: Debian/Ubuntu:
sudo cp etc/apache2/ironic /etc/apache2/sites-available/ironic.conf sudo cp etc/apache2/ironic /etc/apache2/sites-available/ironic.conf
SUSE
sudo cp etc/apache2/ironic /etc/apache2/vhosts.d/ironic.conf
#. Edit the recently copied ``<apache-configuration-dir>/ironic.conf``: #. Edit the recently copied ``<apache-configuration-dir>/ironic.conf``:
@ -58,6 +64,9 @@ Bare Metal service comes with an example file for configuring the
sudo a2ensite ironic sudo a2ensite ironic
sudo service apache2 reload sudo service apache2 reload
SUSE:
sudo systemctl reload apache2
.. note:: .. note::
The file ``ironic/api/app.wsgi`` is installed with the rest of the Bare Metal The file ``ironic/api/app.wsgi`` is installed with the rest of the Bare Metal
service application code, and should not need to be modified. service application code, and should not need to be modified.

View File

@ -82,7 +82,7 @@ Configuring ironic-api service
.. TODO(mmitchell): Split this based on operating system .. TODO(mmitchell): Split this based on operating system
.. code-block:: console .. code-block:: console
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-ironic-api sudo systemctl restart openstack-ironic-api
Ubuntu: Ubuntu:

View File

@ -180,7 +180,7 @@ Configuring ironic-conductor service
.. TODO(mmitchell): Split this based on operating system .. TODO(mmitchell): Split this based on operating system
.. code-block:: console .. code-block:: console
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-ironic-conductor sudo systemctl restart openstack-ironic-conductor
Ubuntu: Ubuntu:

View File

@ -102,7 +102,7 @@ driver. The configuration file for the Compute service is typically located at
.. code-block:: console .. code-block:: console
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-nova-scheduler sudo systemctl restart openstack-nova-scheduler
Ubuntu: Ubuntu:
@ -113,7 +113,7 @@ driver. The configuration file for the Compute service is typically located at
.. code-block:: console .. code-block:: console
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-nova-compute sudo systemctl restart openstack-nova-compute
Ubuntu: Ubuntu:

View File

@ -5,12 +5,35 @@ Install and configure for openSUSE and SUSE Linux Enterprise
============================================================ ============================================================
This section describes how to install and configure the Bare Metal service This section describes how to install and configure the Bare Metal service
for openSUSE Leap 42.1 and SUSE Linux Enterprise Server 12 SP1. for openSUSE Leap 42.2 and SUSE Linux Enterprise Server 12 SP2.
.. note:: .. note::
Installation of the Bare Metal service on openSUSE and SUSE Linux Enterprise Installation of the Bare Metal service on openSUSE and SUSE Linux Enterprise
Server is not officially supported. Nevertheless, installation should be Server is not officially supported. Nevertheless, installation should be
possible by following the general steps from another operating system, such possible.
as :ref:`Red Hat Enterprise Linux <install-rdo>`. The instructions might
need adjustments, especially around package manager instructions and system .. include:: include/common-prerequisites.rst
paths.
Install and configure components
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#. Install from packages
.. code-block:: console
# zypper install openstack-ironic-api openstack-ironic-conductor python-ironicclient
#. Enable services
.. code-block:: console
# systemctl enable openstack-ironic-api openstack-ironic-conductor
# systemctl start openstack-ironic-api openstack-ironic-conductor
.. include:: include/common-configure.rst
.. include:: include/configure-ironic-api.rst
.. include:: include/configure-ironic-api-mod_wsgi.rst
.. include:: include/configure-ironic-conductor.rst

View File

@ -28,6 +28,9 @@ node(s) where ``ironic-conductor`` is running.
Fedora 22 or higher: Fedora 22 or higher:
sudo dnf install tftp-server syslinux-tftpboot xinetd sudo dnf install tftp-server syslinux-tftpboot xinetd
SUSE:
sudo zypper install tftp syslinux 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::
@ -51,7 +54,7 @@ node(s) where ``ironic-conductor`` is running.
Ubuntu: Ubuntu:
sudo service xinetd restart sudo service xinetd restart
Fedora: Fedora/SUSE:
sudo systemctl restart xinetd sudo systemctl restart xinetd
#. 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]_::
@ -62,6 +65,9 @@ node(s) where ``ironic-conductor`` is running.
Ubuntu (14.10 and after): Ubuntu (14.10 and after):
sudo cp /usr/lib/PXELINUX/pxelinux.0 /tftpboot sudo cp /usr/lib/PXELINUX/pxelinux.0 /tftpboot
SUSE:
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. The chain.c32 image chain.c32 image to ``/tftpboot`` to support it. The chain.c32 image
might be found at:: might be found at::
@ -75,6 +81,9 @@ node(s) where ``ironic-conductor`` is running.
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7:
sudo cp /boot/extlinux/chain.c32 /tftpboot sudo cp /boot/extlinux/chain.c32 /tftpboot
SUSE:
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]_:: [1]_::
@ -113,6 +122,9 @@ steps on the ironic conductor node to configure the PXE UEFI environment.
Fedora 22 or higher: Fedora 22 or higher:
sudo dnf install grub2-efi shim sudo dnf install grub2-efi shim
SUSE:
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: (14.04LTS and later) Ubuntu: (14.04LTS and later)
@ -128,6 +140,10 @@ steps on the ironic conductor node to configure the PXE UEFI environment.
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:
sudo cp /usr/lib64/efi/shim.efi /tftpboot/bootx64.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.
@ -139,6 +155,9 @@ steps on the ironic conductor node to configure the PXE UEFI environment.
CentOS: Create grub.cfg under ``/tftpboot/EFI/centos`` directory. CentOS: 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.
GRUB_DIR=/tftpboot/boot/grub
Create directory GRUB_DIR Create directory GRUB_DIR
sudo mkdir -p $GRUB_DIR sudo mkdir -p $GRUB_DIR
@ -265,6 +284,12 @@ on the Bare Metal service node(s) where ``ironic-conductor`` is running.
Fedora 22 or higher: Fedora 22 or higher:
dnf install ipxe-bootimgs dnf install ipxe-bootimgs
.. note::
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
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.
#. 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::
@ -275,11 +300,6 @@ on the Bare Metal service node(s) where ``ironic-conductor`` is running.
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7:
cp /usr/share/ipxe/{undionly.kpxe,ipxe.efi} /tftpboot cp /usr/share/ipxe/{undionly.kpxe,ipxe.efi} /tftpboot
.. note::
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 one image
from source, see http://ipxe.org/download for more information.
#. Enable/Configure iPXE in the Bare Metal Service's configuration file #. Enable/Configure iPXE in the Bare Metal Service's configuration file
(/etc/ironic/ironic.conf): (/etc/ironic/ironic.conf):
@ -347,7 +367,7 @@ on the Bare Metal service node(s) where ``ironic-conductor`` is running.
#. Restart the ``ironic-conductor`` process:: #. Restart the ``ironic-conductor`` process::
Fedora/RHEL7/CentOS7: Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-ironic-conductor sudo systemctl restart openstack-ironic-conductor
Ubuntu: Ubuntu: