Switch between Static Method Hardware Accelerator and SR-IOV FEC OperatorΒΆ

About this task

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.

Procedure

The following procedure allows to switch from the manual static method configuration of a hardware accelerator device to the SR-IOV 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 Enable ACC100/ACC200 Hardware Accelerators for Hosted vRAN Containerized Workloads to switch from Static to SR-IOV 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.

  1. Lock the node containing the accelerator card.

    $ source /etc/platform/openrc
~(keystone_admin)]$ system host-lock <hostname>

  2. Remove the past configuration from the accelerator card with host-device-modify command.

    ~(keystone_admin)]$ system host-device-modify <hostname> <pci_address> --vf-driver none -N 0

~(keystone_admin)]$ system host-device-modify <hostname> <pci_address> --driver none

  3. Unlock the node containing the accelerator card.

    ~(keystone_admin)]$ system host-unlock <hostname>

  4. After the node finishes the unlocking process, find the SR-IOV FEC operator along with other applications at /usr/local/share/applications/helm/sriov-fec-operator-<version>.tgz.

Follow the steps in Configure Intel Wireless FEC Accelerators using SR-IOV FEC operator to upload and apply SR-IOV FEC operator, and to create the pods for the suitable accelerator card.

Note

For compatibility between Static and SR-IOV FEC operator, it is recommended to keep the same resource name for the accelerator (ACC100 in the example) while configuring SR-IOV FEC operator using the following command before apply the application:

~(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