From 4b4f3f38c59c3abbc07e6829c143d84eb2dea5a2 Mon Sep 17 00:00:00 2001 From: Dmitry Tantsur Date: Tue, 1 Mar 2022 10:22:50 +0100 Subject: [PATCH] [Trivial] Fix formatting in troubleshooting docs Change-Id: I611f57f116abc5c392f907cdebc7e795f650d958 --- doc/source/admin/troubleshooting.rst | 38 +++++++++++++++++----------- 1 file changed, 23 insertions(+), 15 deletions(-) diff --git a/doc/source/admin/troubleshooting.rst b/doc/source/admin/troubleshooting.rst index 5cd2ec751e..b2e5e8edeb 100644 --- a/doc/source/admin/troubleshooting.rst +++ b/doc/source/admin/troubleshooting.rst @@ -677,12 +677,16 @@ How do I resolve this? Generally, you need to identify the port with the offending MAC address. Example: - openstack port list --mac-address 52:54:00:7c:c4:56 +.. code-block:: console + + $ openstack port list --mac-address 52:54:00:7c:c4:56 From the command's output, you should be able to identify the ``id`` field. Using that, you can delete the port. Example: - openstack port delete +.. code-block:: console + + $ openstack port delete .. warning:: Before deleting a port, you should always verify that it is no longer in @@ -810,7 +814,9 @@ Example failure A node in this state, when the ``network_interface`` was saved as ``neutron``, yet the ``neutron`` interface is no longer enabled will fail basic state -transition requests.: +transition requests: + +.. code-block:: console $ baremetal node manage 7164efca-37ab-1213-1112-b731cf795a5a Could not find the following interface in the 'ironic.hardware.interfaces.network' entrypoint: neutron. Valid interfaces are ['flat']. (HTTP 400) @@ -826,7 +832,9 @@ order of interfaces in the for the ``enabled_*_interfaces`` options. Once the conductor has been restarted with the updated configuration, you should now be able to update the interface using the ``baremetal node set`` command. In this example we use the ``network_interface`` as this is most -commonly where it is encountered.: +commonly where it is encountered: + +.. code-block:: console $ baremetal node set $NAME_OR_UUID --network-interface flat @@ -869,14 +877,14 @@ How do I resolve this? This can be addressed a few different ways: - * Use raw images, however these images can be substantially larger - and require more data to be transmitted "over the wire". - * Add more physical memory. - * Add swap space. - * Reduce concurrency, possibly via another conductor or changing the - nova-compute.conf ``max_concurrent_builds`` parameter. - * Or finally, adjust the ``[DEFAULT]minimum_required_memory`` parameter - in your ironic.conf file. The default should be considered a "default - of last resort" and you may need to reserve additional memory. You may - also wish to adjust the ``[DEFAULT]minimum_memory_wait_retries`` and - ``[DEFAULT]minimum_memory_wait_time`` parameters. +* Use raw images, however these images can be substantially larger + and require more data to be transmitted "over the wire". +* Add more physical memory. +* Add swap space. +* Reduce concurrency, possibly via another conductor or changing the + nova-compute.conf ``max_concurrent_builds`` parameter. +* Or finally, adjust the ``[DEFAULT]minimum_required_memory`` parameter + in your ironic.conf file. The default should be considered a "default + of last resort" and you may need to reserve additional memory. You may + also wish to adjust the ``[DEFAULT]minimum_memory_wait_retries`` and + ``[DEFAULT]minimum_memory_wait_time`` parameters.