From 1849a81383348513159e4f8aec0134151fa96827 Mon Sep 17 00:00:00 2001 From: Colleen Murphy Date: Fri, 7 Apr 2017 14:08:04 +0200 Subject: [PATCH] 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 --- install-guide/source/configure-cleaning.rst | 2 +- install-guide/source/deploy-ramdisk.rst | 5 ++- install-guide/source/enabling-https.rst | 4 +-- .../include/configure-ironic-api-mod_wsgi.rst | 9 +++++ .../source/include/configure-ironic-api.rst | 2 +- .../include/configure-ironic-conductor.rst | 2 +- .../source/include/configure-nova-compute.rst | 4 +-- install-guide/source/install-obs.rst | 33 +++++++++++++++--- install-guide/source/setup-drivers.rst | 34 +++++++++++++++---- 9 files changed, 75 insertions(+), 20 deletions(-) diff --git a/install-guide/source/configure-cleaning.rst b/install-guide/source/configure-cleaning.rst index 8dfefec152..e702fb35aa 100644 --- a/install-guide/source/configure-cleaning.rst +++ b/install-guide/source/configure-cleaning.rst @@ -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: diff --git a/install-guide/source/deploy-ramdisk.rst b/install-guide/source/deploy-ramdisk.rst index c0e76b1a2f..591a19dc2b 100644 --- a/install-guide/source/deploy-ramdisk.rst +++ b/install-guide/source/deploy-ramdisk.rst @@ -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: diff --git a/install-guide/source/enabling-https.rst b/install-guide/source/enabling-https.rst index df13b18f11..c9cf120d8b 100644 --- a/install-guide/source/enabling-https.rst +++ b/install-guide/source/enabling-https.rst @@ -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: diff --git a/install-guide/source/include/configure-ironic-api-mod_wsgi.rst b/install-guide/source/include/configure-ironic-api-mod_wsgi.rst index 9b6a5da0dd..2130842c7a 100644 --- a/install-guide/source/include/configure-ironic-api-mod_wsgi.rst +++ b/install-guide/source/include/configure-ironic-api-mod_wsgi.rst @@ -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 ``/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. diff --git a/install-guide/source/include/configure-ironic-api.rst b/install-guide/source/include/configure-ironic-api.rst index b5d43143ae..09c75a3bc3 100644 --- a/install-guide/source/include/configure-ironic-api.rst +++ b/install-guide/source/include/configure-ironic-api.rst @@ -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: diff --git a/install-guide/source/include/configure-ironic-conductor.rst b/install-guide/source/include/configure-ironic-conductor.rst index de6cf5b007..0abfecfc85 100644 --- a/install-guide/source/include/configure-ironic-conductor.rst +++ b/install-guide/source/include/configure-ironic-conductor.rst @@ -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: diff --git a/install-guide/source/include/configure-nova-compute.rst b/install-guide/source/include/configure-nova-compute.rst index 2ddaf84863..56f3351f14 100644 --- a/install-guide/source/include/configure-nova-compute.rst +++ b/install-guide/source/include/configure-nova-compute.rst @@ -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: diff --git a/install-guide/source/install-obs.rst b/install-guide/source/install-obs.rst index 948c2e64c2..067913f191 100644 --- a/install-guide/source/install-obs.rst +++ b/install-guide/source/install-obs.rst @@ -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 `. 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 diff --git a/install-guide/source/setup-drivers.rst b/install-guide/source/setup-drivers.rst index 83d7494dba..1e992bdc2a 100644 --- a/install-guide/source/setup-drivers.rst +++ b/install-guide/source/setup-drivers.rst @@ -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: