summaryrefslogtreecommitdiff
path: root/doc/source/install/include/configure-ironic-singleprocess.inc
blob: 17ebf7913d6ad34fc59e6dd63f8c37015300b362 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
Configuring single-process ironic
---------------------------------

As an alternative to starting separate API and conductor instances, you can
start ``ironic`` services that combine an API and a conductor in the same
process. This may be particularly beneficial in environments with limited
resources and low number of nodes to handle.

.. note:: This feature is available starting with the Yoga release series.

#. Start with setting up the environment as described in both `Configuring
   ironic-api service`_ and `Configuring ironic-conductor service`_, but do not
   start any services. Merge configuration options into a single configuration
   file.

   .. note::
      Any RPC settings will only take effect if you have more than one combined
      service started or if you have additional conductors.

      If you don't plan to have more than one conductor, you can disable the
      RPC completely:

      .. code-block:: ini

        [DEFAULT]
        rpc_transport = none

#. Stop existing services if they are already started:

   Fedora/RHEL/CentOS/SUSE::

       sudo systemctl stop openstack-ironic-api
       sudo systemctl stop openstack-ironic-conductor

   Ubuntu::

       sudo service ironic-api stop
       sudo service ironic-conductor stop

#. Start or restart the ironic service:

   Fedora/RHEL8/CentOS8/SUSE::

       sudo systemctl restart openstack-ironic

   Ubuntu::

       sudo service ironic restart