openstack/ironic
Code Issues Proposed changes

Add SUSE instructions to the install guide

Browse Source 
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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
install-guide/source/configure-cleaning.rst
View File

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

5
install-guide/source/deploy-ramdisk.rst
View File

@ -40,13 +40,16 @@ CoreOS tools
Ubuntu 14.04 (trusty) or higher:
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``::
cd ironic-python-agent/imagebuild/coreos
#. Start the docker daemon::
Fedora/RHEL7/CentOS7:
Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl start docker
Ubuntu:

4
install-guide/source/enabling-https.rst
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::
Fedora/RHEL7/CentOS7:
Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-glance-api
Debian/Ubuntu:
@ -82,7 +82,7 @@ To enable secure HTTPS communication between Bare Metal service and Image servic
#. Restart ironic-conductor service::
Fedora/RHEL7/CentOS7:
Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-ironic-conductor
Debian/Ubuntu:

9
install-guide/source/include/configure-ironic-api-mod_wsgi.rst
View File

@ -18,6 +18,9 @@ Bare Metal service comes with an example file for configuring the
Debian/Ubuntu:
apt-get install apache2
SUSE:
zypper install apache2
#. 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:
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``:
@ -58,6 +64,9 @@ Bare Metal service comes with an example file for configuring the
sudo a2ensite ironic
sudo service apache2 reload
SUSE:
sudo systemctl reload apache2
.. note::
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.

2
install-guide/source/include/configure-ironic-api.rst
View File

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

2
install-guide/source/include/configure-ironic-conductor.rst
View File

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

4
install-guide/source/include/configure-nova-compute.rst
View File

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

33
install-guide/source/install-obs.rst
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
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::
Installation of the Bare Metal service on openSUSE and SUSE Linux Enterprise
Server is not officially supported. Nevertheless, installation should be
possible by following the general steps from another operating system, such
as :ref:`Red Hat Enterprise Linux <install-rdo>`. The instructions might
need adjustments, especially around package manager instructions and system
paths.
possible.
.. include:: include/common-prerequisites.rst
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

34
install-guide/source/setup-drivers.rst
View File

@ -28,6 +28,9 @@ node(s) where ``ironic-conductor`` is running.
Fedora 22 or higher:
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``.
Create or edit ``/etc/xinetd.d/tftp`` as below::
@ -51,7 +54,7 @@ node(s) where ``ironic-conductor`` is running.
Ubuntu:
sudo service xinetd restart
Fedora:
Fedora/SUSE:
sudo systemctl restart xinetd
#. 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):
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
chain.c32 image to ``/tftpboot`` to support it. The chain.c32 image
might be found at::
@ -75,6 +81,9 @@ node(s) where ``ironic-conductor`` is running.
Fedora/RHEL7/CentOS7:
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
that we copy the library modules into the ``/tftpboot`` directory [2]_
[1]_::
@ -113,6 +122,9 @@ steps on the ironic conductor node to configure the PXE UEFI environment.
Fedora 22 or higher:
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::
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/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::
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.
GRUB_DIR=/tftpboot/EFI/centos
SUSE: Create grub.cfg under ``/tftpboot/boot/grub`` directory.
GRUB_DIR=/tftpboot/boot/grub
Create directory 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:
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
``ipxe.efi`` for **UEFI**) to ``/tftpboot``. The binary might
be found at::
@ -275,11 +300,6 @@ on the Bare Metal service node(s) where ``ironic-conductor`` is running.
Fedora/RHEL7/CentOS7:
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
(/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::
Fedora/RHEL7/CentOS7:
Fedora/RHEL7/CentOS7/SUSE:
sudo systemctl restart openstack-ironic-conductor
Ubuntu: