Stop splitting installation docs per distros

The versions only differ in the first paragraph, and the supposedly
common parts actually have different code paths for different distros.

Also be realistic about which distros we support.

Change-Id: Ifcc19a20d42f384300cadf442951739be8682047
This commit is contained in:
Dmitry Tantsur 2023-07-14 11:37:22 +02:00
parent 54da324900
commit f4be664a86
7 changed files with 53 additions and 111 deletions

View File

@ -120,10 +120,10 @@ Configuring ironic-api service
#. Restart the ironic-api service:
Fedora/RHEL8/CentOS8/SUSE::
RHEL/CentOS/SUSE::
sudo systemctl restart openstack-ironic-api
Ubuntu::
Ubuntu/Debian::
sudo service ironic-api restart

View File

@ -212,11 +212,11 @@ Configuring ironic-conductor service
#. Restart the ironic-conductor service:
Fedora/RHEL7/CentOS7/SUSE::
RHEL/CentOS/SUSE::
sudo systemctl restart openstack-ironic-conductor
Ubuntu::
Ubuntu/Debian::
sudo service ironic-conductor restart

View File

@ -27,22 +27,22 @@ resources and low number of nodes to handle.
#. Stop existing services if they are already started:
Fedora/RHEL/CentOS/SUSE::
RHEL/CentOS/SUSE::
sudo systemctl stop openstack-ironic-api
sudo systemctl stop openstack-ironic-conductor
Ubuntu::
Ubuntu/Debian::
sudo service ironic-api stop
sudo service ironic-conductor stop
#. Start or restart the ironic service:
Fedora/RHEL8/CentOS8/SUSE::
RHEL/CentOS/SUSE::
sudo systemctl restart openstack-ironic
Ubuntu::
Ubuntu/Debian::
sudo service ironic restart

View File

@ -1,41 +1,5 @@
.. _install-obs:
============================================================
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.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.
.. include:: include/common-prerequisites.inc
Install and configure components
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#. Install from packages
.. code-block:: console
# zypper install openstack-ironic-api openstack-ironic-conductor python3-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.inc
.. include:: include/configure-ironic-api.inc
.. include:: include/configure-ironic-api-mod_wsgi.inc
.. include:: include/configure-ironic-conductor.inc
.. include:: include/configure-ironic-singleprocess.inc
The contents has been migrated to the common location - see :doc:`install`.

View File

@ -1,37 +1,5 @@
.. _install-rdo:
=============================================================
Install and configure for Red Hat Enterprise Linux and CentOS
=============================================================
This section describes how to install and configure the Bare Metal service
for Red Hat Enterprise Linux 8 and CentOS 8.
.. include:: include/common-prerequisites.inc
Install and configure components
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#. Install from packages (using dnf)
.. code-block:: console
# dnf install openstack-ironic-api openstack-ironic-conductor python3-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.inc
.. include:: include/configure-ironic-api.inc
.. include:: include/configure-ironic-api-mod_wsgi.inc
.. include:: include/configure-ironic-conductor.inc
.. include:: include/configure-ironic-singleprocess.inc
The contents has been migrated to the common location - see :doc:`install`.

View File

@ -1,33 +1,5 @@
.. _install-ubuntu:
================================
Install and configure for Ubuntu
================================
This section describes how to install and configure the Bare Metal
service for Ubuntu 14.04 (LTS).
.. include:: include/common-prerequisites.inc
Install and configure components
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#. Install from packages (using apt-get)
.. code-block:: console
# apt-get install ironic-api ironic-conductor python3-ironicclient
#. Enable services
Services are enabled by default on Ubuntu.
.. include:: include/common-configure.inc
.. include:: include/configure-ironic-api.inc
.. include:: include/configure-ironic-api-mod_wsgi.inc
.. include:: include/configure-ironic-conductor.inc
.. include:: include/configure-ironic-singleprocess.inc
The contents has been migrated to the common location - see :doc:`install`.

View File

@ -1,3 +1,4 @@
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Install and configure the Bare Metal service
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -26,12 +27,49 @@ More installation projects are developed by other OpenStack teams:
**Ironic guide**, not to the generic page. If a separate Ironic guide does
not exist yet, create it first.
Contents
--------
.. toctree::
:maxdepth: 2
:hidden:
install-rdo.rst
install-ubuntu.rst
install-obs.rst
.. include:: include/common-prerequisites.inc
Install and configure components
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Using DNF on RHEL/CentOS Stream and RDO_ packages:
.. code-block:: console
# dnf install openstack-ironic-api openstack-ironic-conductor python3-ironicclient
.. _rdo: https://www.rdoproject.org/
On Ubuntu_/Debian:
.. code-block:: console
# apt-get install ironic-api ironic-conductor python3-ironicclient
.. _ubuntu: https://docs.openstack.org/install-guide/environment-packages-ubuntu.html
On openSUSE/SLES:
.. code-block:: console
# zypper install openstack-ironic-api openstack-ironic-conductor python3-ironicclient
.. warning::
Support for SUSE systems is best effort, it is not tested in the CI.
.. include:: include/common-configure.inc
.. include:: include/configure-ironic-api.inc
.. include:: include/configure-ironic-api-mod_wsgi.inc
.. include:: include/configure-ironic-conductor.inc
.. include:: include/configure-ironic-singleprocess.inc