From b6136e13f73d4241a7247e887223358cad9e6086 Mon Sep 17 00:00:00 2001 From: Yolanda Robla Date: Wed, 25 Mar 2020 16:16:43 +0100 Subject: [PATCH] Add troubleshooting on IPMI section Troubleshooting of common problems found when working with IPMI on different vendors. Change-Id: I6d44722fdb11166ad4b2a7d5c23c3ff8d5390637 Signed-off-by: Yolanda Robla --- doc/source/admin/troubleshooting.rst | 33 ++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/doc/source/admin/troubleshooting.rst b/doc/source/admin/troubleshooting.rst index 71401dffda..03fa0445bf 100644 --- a/doc/source/admin/troubleshooting.rst +++ b/doc/source/admin/troubleshooting.rst @@ -358,3 +358,36 @@ do that for a Cisco Nexus switch is: $ config terminal $ (config) interface eth1/11 $ (config-if) spanning-tree port type edge + + +IPMI errors +=========== + +When working with IPMI, several settings need to be enabled depending on vendors. + +Enable IPMI over LAN +-------------------- + +Machines may not have IPMI access over LAN enabled by default. This could cause +the IPMI port to be unreachable through ipmitool, as shown: + +.. code-block:: bash + + $ipmitool -I lan -H ipmi_host -U ipmi_user -P ipmi_pass chassis power status + Error: Unable to establish LAN session + +To fix this, enable `IPMI over lan` setting using your BMC tool or web app. + +Troubleshooting lanplus interface +--------------------------------- + +When working with lanplus interfaces, you may encounter the following error: + +.. code-block:: bash + + $ipmitool -I lanplus -H ipmi_host -U ipmi_user -P ipmi_pass power status + Error in open session response message : insufficient resources for session + Error: Unable to establish IPMI v2 / RMCP+ session + +To fix that issue, please enable `RMCP+ Cipher Suite3 Configuration` setting +using your BMC tool or web app.