Errors in "Intel Multi-driver Version" section (stx7, 22,06)

- Reworded text on line 99;
- Added a new note to explain that the user needs to enter the locked state prior to unlocking.
- Updated the "change the driver bundle back to the default version" topic to have just two options.
- Updated the layout of instructions for AIO-SX and AIO-DX deployments.
- Removed Upgrades section.
- Updated Backup and Restore section to add the host-lock/host-unlock info.

Signed-off-by: Elaine Fonaro <elaine.fonaro@windriver.com>
Change-Id: I2773e43de96b3ecc394343ecdc78b49e50fd9df9
This commit is contained in:
Elaine Fonaro
2023-03-16 16:43:52 -03:00
parent 4ad6a06722
commit 21bf394b8f

View File

@@ -50,13 +50,7 @@ To change the driver bundle back to the default version, there are two options:
.. code-block:: none .. code-block:: none
~(keystone_admin)$ system service-parameter-modify platform config intel_nic_driver_version=cvl-4.0.1 ~(keystone_admin)$ system service-parameter-modify platform config intel_nic_driver_version=cvl-4.0.1
#. Apply the service parameter change.
.. code-block:: none
~(keystone_admin)$ system service-parameter-apply platform ~(keystone_admin)$ system service-parameter-apply platform
Applying platform service parameters
#. Remove the system service parameter ``intel_nic_driver_version``. #. Remove the system service parameter ``intel_nic_driver_version``.
@@ -69,19 +63,20 @@ To change the driver bundle back to the default version, there are two options:
| 84306212-d96d-4a2a-8cc0-2d48781e006c | platform | config | intel_nic_driver_version | cvl-2.54 | None | None | | 84306212-d96d-4a2a-8cc0-2d48781e006c | platform | config | intel_nic_driver_version | cvl-2.54 | None | None |
+--------------------------------------+------------+---------+---------------------------+-----------+-------------+----------+ +--------------------------------------+------------+---------+---------------------------+-----------+-------------+----------+
~(keystone_admin)$ system service-parameter-delete 84306212-d96d-4a2a-8cc0-2d48781e006c ~(keystone_admin)$ system service-parameter-delete 84306212-d96d-4a2a-8cc0-2d48781e006c
~(keystone_admin)$ system service-parameter-apply platform
To apply the service parameter change, all hosts need to be locked and To apply the service parameter change, all hosts need to be locked and
unlocked, using the following commands for each host depending on the deployed unlocked, using the following commands for each host depending on the deployed
configuration: configuration:
For |AIO-SX| deployments: - For |AIO-SX| deployments:
.. code-block:: none .. code-block:: none
~(keystone_admin)$ system host-lock controller-0 ~(keystone_admin)$ system host-lock controller-0
~(keystone_admin)$ system host-unlock controller-0 ~(keystone_admin)$ system host-unlock controller-0
For |AIO-DX| and Standards deployments, after controller-1 is locked/unlocked - For |AIO-DX| and Standards deployments, after controller-1 is locked/unlocked
swact controller-0 to make controller-1 the active node. The next set of swact controller-0 to make controller-1 the active node. The next set of
commands are executed on controller-0 node: commands are executed on controller-0 node:
@@ -101,14 +96,19 @@ on controller-1 node:
~(keystone_admin)$ system host-unlock controller-0 ~(keystone_admin)$ system host-unlock controller-0
~(keystone_admin)$ system host-swact controller-1 ~(keystone_admin)$ system host-swact controller-1
For each worker node in the configuration execute the commands from All remaining nodes in the deployment need to be locked/unlocked, one at a time,
controller-0: using the following commands (replace **worker-0** with the name of the node being
locked/unlocked):
.. code-block:: none .. code-block:: none
~(keystone_admin)$ system host-lock worker-0 ~(keystone_admin)$ system host-lock worker-0
~(keystone_admin)$ system host-unlock worker-0 ~(keystone_admin)$ system host-unlock worker-0
.. note::
You must wait for the node to enter the locked state prior to unlocking.
To verify the current Intel driver version use ``ethtool -i`` on the desired To verify the current Intel driver version use ``ethtool -i`` on the desired
Intel network interface. For example: Intel network interface. For example:
@@ -118,18 +118,6 @@ Intel network interface. For example:
driver: i40e driver: i40e
version: 2.20.12 version: 2.20.12
Upgrades
--------
For an upgrade, the default drivers will be configured after the upgrade.
To set the legacy drivers for an upgrade, set the driver bundle on
controller-0 prior to the upgrade using the following commands:
.. code-block:: none
~(keystone_admin)$ system service-parameter-add platform config intel_nic_driver_version=cvl-2.54 --resource platform::compute::grub::params::g_intel_nic_driver_version
~(keystone_admin)$ system service-parameter-apply platform
Backup and Restore Backup and Restore
------------------ ------------------
@@ -137,8 +125,8 @@ In case a Backup and Restore is performed, after unlocking the host during a
restore operation, the system will be configured with the correct multi-driver restore operation, the system will be configured with the correct multi-driver
version, but the drivers will be loaded to the default version. version, but the drivers will be loaded to the default version.
To load the drivers to the correct configured version a second host-unlock will To load the drivers to the correct configured version an extra host-lock/
be needed. host-unlock will be needed.
.. only:: partner .. only:: partner