starlingx
/
docs
Code Issues Proposed changes
docs/doc/source/node_management/kubernetes/hardware_acceleration_devices/enabling-mount-bryce-hw-acc...

6.1 KiB
Raw Blame History

Enable Mount Bryce HW Accelerator for Hosted vRAN Containerized Workloads

You can enable and access Mount Bryce ACC100 eASIC card from Intel® such that it can be used as a HW accelerator by hosted vRAN containerized workloads on .

The following procedure shows an example of configuring an AIO-SX system such that it can support hosting a FlexRAN-reference-architecture container image that uses the Mount Bryce HW accelerator. The procedure enables the required drivers, CPU policies and memory of controller-0, and then enables the Mount Bryce device.

  • The system has been provisioned and unlocked.

  1. Source the platform environment.

    $ source /etc/platform/openrc
~(keystone_admin)$

  2. Lock controller-0.

    ~(keystone_admin)$ system host-lock controller-0

  3. Assign labels to controller-0.

    ~(keystone_admin)$ system host-label-assign controller-0 sriovdp=enabled
~(keystone_admin)$ system host-label-assign controller-0 kube-cpu-mgr-policy=static
~(keystone_admin)$ system host-label-assign controller-0 kube-topology-mgr-policy=restricted

  4. Modify the CPU.

    ~(keystone_admin)$ system host-cpu-modify -f application-isolated -p0 12 controller-0

  5. Modify the memory.

    ~(keystone_admin)$ system host-memory-modify controller-0 0 -1G 12

  6. List and enable the device.

    ~(keystone_admin)$ system host-device-list -a controller-0
+------------------+--------------+----------+-----------+..
| name             | address      | class id | vendor id |
+------------------+--------------+----------+-----------+
| pci_0000_00_16_0 | 0000:00:16.0 | 78000    | 8086      |
| pci_0000_00_16_1 | 0000:00:16.1 | 78000    | 8086      |
| pci_0000_00_1a_0 | 0000:00:1a.0 | c0300    | 8086      |
| pci_0000_00_1d_0 | 0000:00:1d.0 | c0300    | 8086      |
| pci_0000_00_1f_2 | 0000:00:1f.2 | 10600    | 8086      |
| pci_0000_00_1f_3 | 0000:00:1f.3 | c0500    | 8086      |
| pci_0000_04_00_0 | 0000:04:00.0 | 10700    | 8086      |
| pci_0000_04_00_3 | 0000:04:00.3 | c0500    | 8086      |
| pci_0000_04_00_4 | 0000:04:00.4 | c0500    | 8086      |
| pci_0000_05_00_0 | 0000:05:00.0 | 30200    | 10de      |
| pci_0000_0a_00_0 | 0000:0a:00.0 | 30000    | 102b      |
| pci_0000_85_00_0 | 0000:85:00.0 | 120001   | 8086      |
+------------------+--------------+----------+-----------+..
+-----------+---------------------------------+---------------------+..
| device id | class name                      | vendor name         |
+-----------+-----------+---------------------+---------------------+
| 1d3a      | Communication controller        | Intel Corporation   |
| 1d3b      | Communication controller        | Intel Corporation   |
| 1d2d      | USB controller                  | Intel Corporation   |
| 1d26      | USB controller                  | Intel Corporation   |
| 1d02      | |SATA| controller               | Intel Corporation   |
| 1d22      | SMBus                           | Intel Corporation   |
| 1d68      | Serial Attached SCSI controller | Intel Corporation   |
| 1d70      | SMBus                           | Intel Corporation   |
| 1d71      | SMBus                           | Intel Corporation   |
| 1eb8      | 3D controller                   | NVIDIA Corporation  |
| 0522      | VGA compatible controller       | Matrox Electronics..|
| 0d5c      | Processing accelerators         | Intel Corporation   |
+-----------+---------------------------------+---------------------+..
+----------------------------------------------------------+-----------+---------+
| device name                                              | numa_node | enabled |
+----------------------------------------------------------+-----------+---------+
| C600/X79 series chipset MEI Controller #1                | 0         | False   |
| C600/X79 series chipset MEI Controller #2                | 0         | False   |
| C600/X79 series chipset USB2 Enhanced Host Controller #2 | 0         | False   |
| C600/X79 series chipset USB2 Enhanced Host Controller #1 | 0         | False   |
| C600/X79 series chipset 6-Port |SATA| AHCI Controller    | 0         | False   |
| C600/X79 series chipset SMBus Host Controller            | 0         | False   |
| C606 chipset Dual 4-Port |SATA|/|SAS| Storage Control uni| 0         | False   |
| C600/X79 series chipset SMBus Controller 0               | 0         | False   |
| C608/C606/X79 series chipset SMBus Controller 1          | 0         | False   |
| Device 1eb8                                              | 0         | False   |
| MGA G200e [Pilot] ServerEngines (SEP1)                   | 0         | False   |
| Device 0d5c                                              | 1         | True    |
+----------------------------------------------------------+-----------+---------+

  7. Modify device 0000:85:00.0 as listed in the table above.

    ~(keystone_admin)$ system host-device-modify controller-0 pci_0000_85_00_0 -e true  --driver igb_uio --vf-driver igb_uio -N 16

  8. Unlock the host.

    ~(keystone_admin)$ system host-unlock controller-0

To set up pods using , see, Setting Up Pods to Use SRIOV <set-up-pods-to-use-sriov>.