Files
ironic/doc/source/install/install.rst
Jay Faulkner 4349e4156e Drop wsgi script, docs around mod_wsgi
Ironic, like most openstack services these days, needs to have it's wsgi
module referenced as a module, and used under something like uwsgi or
gunicorn instead of with Apache mod_wsgi.

Assisted-by: claude code
Change-Id: I6a2c2688f73b71f94103622a9e821cab67be053e
Signed-off-by: Jay Faulkner <jay@jvf.cc>
2025-08-26 21:10:01 +00:00

68 lines
2.2 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
.. 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 openstack-ironic-novncproxy python3-ironicclient
.. _rdo: https://www.rdoproject.org/
On Ubuntu_/Debian:
.. code-block:: console
# apt-get install ironic-api ironic-conductor ironic-novncproxy python3-ironicclient
.. _ubuntu: https://docs.openstack.org/install-guide/environment-packages-ubuntu.html
.. include:: include/common-configure.inc
.. include:: include/configure-ironic-api.inc
.. include:: include/configure-ironic-api-wsgi.inc
.. include:: include/configure-ironic-conductor.inc
.. include:: include/configure-ironic-novncproxy.inc
.. include:: include/configure-ironic-singleprocess.inc