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: