f4be664a86
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
76 lines
2.3 KiB
ReStructuredText
76 lines
2.3 KiB
ReStructuredText
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
Install and configure the Bare Metal service
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This section describes how to install and configure the
|
|
Bare Metal service, code-named ironic, manually from packages on one of the
|
|
three popular families of Linux distributions.
|
|
|
|
Alternatively, you can use one of the numerous projects that install ironic.
|
|
One of them is provided by the bare metal team:
|
|
|
|
* `Bifrost <https://docs.openstack.org/bifrost/latest/>`_ installs ironic in
|
|
the standalone mode (without the rest of OpenStack).
|
|
|
|
More installation projects are developed by other OpenStack teams:
|
|
|
|
* `Kolla
|
|
<https://docs.openstack.org/kolla-ansible/latest/reference/bare-metal/ironic-guide.html>`_
|
|
can install ironic in containers as part of OpenStack.
|
|
* OpenStack-Ansible has a `role to install ironic
|
|
<https://docs.openstack.org/openstack-ansible-os_ironic/latest/>`_.
|
|
* TripleO uses ironic for provisioning bare metal nodes and can also be used
|
|
`to install ironic
|
|
<https://docs.openstack.org/project-deploy-guide/tripleo-docs/latest/features/baremetal_overcloud.html>`_.
|
|
|
|
.. NOTE(dtantsur): add your favourite installation tool, but please link to the
|
|
**Ironic guide**, not to the generic page. If a separate Ironic guide does
|
|
not exist yet, create it first.
|
|
|
|
.. toctree::
|
|
: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
|