xCAT/xcat-core
2
0
Fork 0
mirror of https://github.com/xcat2/xcat-core.git synced 2025-10-27 01:15:34 +00:00
Code Issues Releases Wiki Activity

Add section for OpenBMC rflash in admin-guide, link this section to CORAL reference section

Browse Source
This commit is contained in:
Victor Hu
2017-12-16 22:36:10 -05:00
parent 4d2e51a61e
commit c64a25a528
11 changed files with 105 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/source/guides/admin-guides/manage_clusters/ppc64le/management/advanced/index.rst
View File

@@ -6,5 +6,5 @@ Advanced Operations
rinv.rst
rvitals.rst
rflash.rst
rflash/index.rst
rspconfig.rst

10
docs/source/guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/index.rst Normal file
View File

@@ -0,0 +1,10 @@
``rflash`` - Remote Firmware Flashing
=====================================
See :doc:`rflash manpage </guides/admin-guides/references/man1/rflash.1>` for more information.
.. toctree::
:maxdepth: 2
ipmi.rst
openbmc/index.rst

6
docs/source/guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash.rst → docs/source/guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/ipmi.rst
View File

@@ -1,7 +1,5 @@
``rflash`` - Remote Firmware Flashing
=====================================
See :doc:`rflash manpage </guides/admin-guides/references/man1/rflash.1>` for more information.
IPMI Firmware Update
====================
The ``rflash`` command is provided to assist the system administrator in updating firmware.

8
docs/source/guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/openbmc/index.rst Normal file
View File

@@ -0,0 +1,8 @@
OpenBMC Firmware Update
=======================
.. toctree::
:maxdepth: 2
unattended.rst
manually.rst

10
docs/source/guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/openbmc/manually.rst Normal file
View File

@@ -0,0 +1,10 @@
Manual Firmware Flash
=====================
.. include:: ./openbmc_common.rst
:start-after: BEGIN_flashing_OpenBMC_Servers
:end-before: END_flashing_OpenBMC_Servers
.. include:: ./openbmc_common.rst
:start-after: BEGIN_Validation_OpenBMC_firmware
:end-before: END_Validation_OpenBMC_firmware

57
docs/source/references/coral/cluster_mgmt/firmware/openbmc.rst → docs/source/guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/openbmc/openbmc_common.rst
View File

@@ -1,18 +1,27 @@
OpenBMC Firmware Update
=======================
.. BEGIN_unattended_OpenBMC_flashing
The process of updating firmware on the OpenBMC managed servers is documented below.
Unattended flash of OpenBMC managed BMC means that xCAT will attempt to:
The sequence of events that must happen is the following:
#. Upload and active BMC, PNOR or both depending on which files are provided.
#. Reboot the necessary components (BMC and/or HOST) to activate the firmware levels
* Power off the Host
* Update and Activate PNOR
* Update and Activate BMC
* Reboot the BMC (applies BMC)
* Power on the Host (applies PNOR)
Use the following command to flash the firmware unattended: ::
**Note:** xCAT is working on streamlining this process to reduce the flexibility of the above steps at the convenience of the Administrator to handle the necessary reboots. See `Issue #4245 <https://github.com/xcat2/xcat-core/issues/4245>`_
rpower <noderange> -d /path/to/directory
If there are errors encountered during the flash process, take a look at the manual steps to continue flashing the BMC.
.. END_unattended_OpenBMC_flashing
.. BEGIN_flashing_OpenBMC_Servers
The sequence of events that must happen to flash OpenBMC firmware is the following:
#. Power off the Host
#. Upload and Activate BMC
#. Reboot the BMC (applies BMC)
#. Upload and Activate PNOR
#. Power on the Host (applies PNOR)
Power off Host
@@ -22,18 +31,7 @@ Use the rpower command to power off the host: ::
rpower <noderange> off
Update and Activate PNOR Firmware
---------------------------------
Use the rflash command to upload and activate the PNOR firmware: ::
rflash <noderange> -a /path/to/witherspoon.pnor.squashfs.tar
If running ``rflash`` in Hierarchy, the firmware files must be accessible on the Service Nodes.
**Note:** The ``-a`` option does an upload and activate in one step, after firmware is activated, use the ``rflash <noderange> -l`` to view. The ``rflash`` command shows ``(*)`` as the active firmware and ``(+)`` on the firmware that requires reboot to become effective.
Update and Activate BMC Firmware
Upload and Activate BMC Firmware
--------------------------------
Use the rflash command to upload and activate the PNOR firmware: ::
@@ -55,6 +53,16 @@ The BMC will take 2-5 minutes to reboot, check the status using: ``rpower <noder
**Known Issue:** On reboot, the first call to the BMC after reboot, xCAT will return ``Error: BMC did not respond within 10 seconds, retry the command.``. Please retry.
Upload and Activate PNOR Firmware
---------------------------------
Use the rflash command to upload and activate the PNOR firmware: ::
rflash <noderange> -a /path/to/witherspoon.pnor.squashfs.tar
If running ``rflash`` in Hierarchy, the firmware files must be accessible on the Service Nodes.
**Note:** The ``-a`` option does an upload and activate in one step, after firmware is activated, use the ``rflash <noderange> -l`` to view. The ``rflash`` command shows ``(*)`` as the active firmware and ``(+)`` on the firmware that requires reboot to become effective.
Power on Host
-------------
@@ -63,6 +71,9 @@ User the ``rpower`` command to power on the Host: ::
rpower <noderange> on
.. END_flashing_OpenBMC_Servers
.. BEGIN_Validation_OpenBMC_firmware
Validation
----------
@@ -77,3 +88,5 @@ Use one of the following commands to validate firmware levels are in sync:
rflash <noderange> -l | grep "\*" | xcoll
.. END_Validation_OpenBMC_firmware

10
docs/source/guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/openbmc/unattended.rst Normal file
View File

@@ -0,0 +1,10 @@
Unattended Firmware Flash
=========================
.. include:: ./openbmc_common.rst
:start-after: BEGIN_unattended_OpenBMC_flashing
:end-before: END_unattended_OpenBMC_flashing
.. include:: ./openbmc_common.rst
:start-after: BEGIN_Validation_OpenBMC_firmware
:end-before: END_Validation_OpenBMC_firmware

2
docs/source/references/coral/cluster_mgmt/firmware/index.rst
View File

@@ -5,4 +5,4 @@ Power9 Firmware Update
:maxdepth: 2
ipmi.rst
openbmc.rst
openbmc/index.rst

8
docs/source/references/coral/cluster_mgmt/firmware/openbmc/index.rst Normal file
View File

@@ -0,0 +1,8 @@
OpenBMC Firmware Update
=======================
.. toctree::
:maxdepth: 2
unattended.rst
manually.rst

10
docs/source/references/coral/cluster_mgmt/firmware/openbmc/manually.rst Normal file
View File

@@ -0,0 +1,10 @@
Manual Firmware Flash
=====================
.. include:: ../../../../../guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/openbmc/openbmc_common.rst
:start-after: BEGIN_flashing_OpenBMC_Servers
:end-before: END_flashing_OpenBMC_Servers
.. include:: ../../../../../guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/openbmc/openbmc_common.rst
:start-after: BEGIN_Validation_OpenBMC_firmware
:end-before: END_Validation_OpenBMC_firmware

10
docs/source/references/coral/cluster_mgmt/firmware/openbmc/unattended.rst Normal file
View File

@@ -0,0 +1,10 @@
Unattended Firmware Flash
=========================
.. include:: ../../../../../guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/openbmc/openbmc_common.rst
:start-after: BEGIN_unattended_OpenBMC_flashing
:end-before: END_unattended_OpenBMC_flashing
.. include:: ../../../../../guides/admin-guides/manage_clusters/ppc64le/management/advanced/rflash/openbmc/openbmc_common.rst
:start-after: BEGIN_Validation_OpenBMC_firmware
:end-before: END_Validation_OpenBMC_firmware