From b6807e2bf181892de110a7c0e973956701b677ed Mon Sep 17 00:00:00 2001 From: Elisamara Aoki Goncalves Date: Fri, 10 Nov 2023 18:54:47 +0000 Subject: [PATCH] sriov-fec-operator upgrade (dsR8) Add procedure of how to switch between Static Method Hardware Accelerator and SR-IOV FEC operator Story: 2010826 Task: 49079 Change-Id: Ic4ca05b97fc88662016f52c963d32988ca2dce19 Signed-off-by: Elisamara Aoki Goncalves --- ...-accelerator-and-srminusi-5f893343ee15.rst | 73 +++++++++++++++++++ .../index-node-mgmt-kub-5ff5993b9c60.rst | 1 + 2 files changed, 74 insertions(+) create mode 100644 doc/source/node_management/kubernetes/hardware_acceleration_devices/switch-between-static-method-hardware-accelerator-and-srminusi-5f893343ee15.rst diff --git a/doc/source/node_management/kubernetes/hardware_acceleration_devices/switch-between-static-method-hardware-accelerator-and-srminusi-5f893343ee15.rst b/doc/source/node_management/kubernetes/hardware_acceleration_devices/switch-between-static-method-hardware-accelerator-and-srminusi-5f893343ee15.rst new file mode 100644 index 000000000..bb9f5f96f --- /dev/null +++ b/doc/source/node_management/kubernetes/hardware_acceleration_devices/switch-between-static-method-hardware-accelerator-and-srminusi-5f893343ee15.rst @@ -0,0 +1,73 @@ +.. _switch-between-static-method-hardware-accelerator-and-srminusi-5f893343ee15: + +========================================================================= +Switch between Static Method Hardware Accelerator and SR-IOV FEC Operator +========================================================================= + +.. rubric:: |context| + +The removal of the static device configuration requires a lock and unlock, +which is service impacting due to host reset. In addition, the |vRAN| Pods must +be reconfigured and recreated for this process, so the end-to-end service +impact will also be dependent on the application specific steps and recovery +process. + +.. rubric:: |proc| + +The following procedure allows to switch from the manual static method +configuration of a hardware accelerator device to the |SRIOV| |FEC| operator +method. This is necessary as it is not possible to use both methods at the same +time. + +Taking in consideration that an accelerator card has been configured as in the +example in +:ref:`enabling-mount-bryce-hw-accelerator-for-hosted-vram-containerized-workloads` +to switch from Static to |SRIOV| |FEC| operator, follow the steps below. + +.. note:: + + As the device will be reconfigured in Kubernetes, it may be required to + restart the app after switching methods. + +#. Lock the node containing the accelerator card. + + .. code-block:: none + + $ source /etc/platform/openrc + ~(keystone_admin)]$ system host-lock + +#. Remove the past configuration from the accelerator card with + :command:`host-device-modify` command. + + .. code-block:: none + + ~(keystone_admin)]$ system host-device-modify --vf-driver none -N 0 + + ~(keystone_admin)]$ system host-device-modify --driver none + +#. Unlock the node containing the accelerator card. + + .. code-block:: none + + ~(keystone_admin)]$ system host-unlock + +#. After the node finishes the unlocking process, find the |SRIOV| |FEC| + operator along with other applications at + ``/usr/local/share/applications/helm/sriov-fec-operator-.tgz``. + + +Follow the steps in +:ref:`configure-sriov-fec-operator-to-enable-hw-accelerators-for-hosted-vran-containarized-workloads` +to upload and apply |SRIOV| |FEC| operator, and to create the pods for the +suitable accelerator card. + +.. note:: + + For compatibility between Static and |SRIOV| |FEC| operator, it is + recommended to keep the same resource name for the accelerator (ACC100 in + the example) while configuring |SRIOV| |FEC| operator using the following + command before apply the application: + + .. code-block:: none + + ~(keystone_admin)$ system helm-override-update sriov-fec-operator sriov-fec-operator sriov-fec-system --set env.SRIOV_FEC_ACC100_RESOURCE_NAME=intel_acc100_fec diff --git a/doc/source/node_management/kubernetes/index-node-mgmt-kub-5ff5993b9c60.rst b/doc/source/node_management/kubernetes/index-node-mgmt-kub-5ff5993b9c60.rst index 64dacebcb..e392c246f 100644 --- a/doc/source/node_management/kubernetes/index-node-mgmt-kub-5ff5993b9c60.rst +++ b/doc/source/node_management/kubernetes/index-node-mgmt-kub-5ff5993b9c60.rst @@ -337,6 +337,7 @@ vRAN Accelerator Adapters (ACC100/ACC200/N3000) hardware_acceleration_devices/enabling-mount-bryce-hw-accelerator-for-hosted-vram-containerized-workloads hardware_acceleration_devices/configure-sriov-fec-operator-to-enable-hw-accelerators-for-hosted-vran-containarized-workloads.rst hardware_acceleration_devices/set-up-pods-to-use-sriov + hardware_acceleration_devices/switch-between-static-method-hardware-accelerator-and-srminusi-5f893343ee15 ****************************