|
1 |
| -## NFD |
2 |
| - |
3 |
| -The [Node Feature Discovery](https://github.com/openshift/node-feature-discovery) (NFD) manages the detection of hardware features and configuration in a OCP cluster by labeling the nodes with hardware-specific information. |
4 |
| - |
5 |
| -NFD labels the host with node-specific attributes, such as PCI cards, kernel, operating system version, and so on. In this project, NFD is used to automatically label nodes with specific hardware features such as Intel® Data Center GPU Flex Series, Intel® SGX and Intel® QAT etc. |
6 |
| - |
7 |
| -### Steps to install and configure NFD operator: |
8 |
| - |
9 |
| -1. Follow the [NFD operator installation instructions](https://docs.openshift.com/container-platform/4.12/hardware_enablement/psap-node-feature-discovery-operator.html#install-operator-web-console_node-feature-discovery-operator) to install the NFD operator. |
10 |
| - |
11 |
| -2. Create NodeFeatureDiscovery instance |
12 |
| - |
13 |
| - ``` |
14 |
| - $ oc apply -f https://github.com/intel/intel-technology-enabling-for-openshift/blob/main/nfd/node-feature-discovery-openshift.yaml |
15 |
| - ``` |
16 |
| - |
17 |
| -3. Create NodeFeatureRule instance |
18 |
| - |
19 |
| - ``` |
20 |
| - $ oc apply -f https://github.com/intel/intel-technology-enabling-for-openshift/blob/main/nfd/node-feature-rules-openshift.yaml |
21 |
| - ``` |
22 |
| - |
23 |
| -4. If NFD has been configured properly, NFD will detect and label Intel® hardware features present on each node in the cluster. |
24 |
| - |
25 |
| - Feature | Label |
26 |
| - --- | --- |
27 |
| - Intel® Data Center GPU Flex Series | intel.feature.node.kubernetes.io/gpu=true |
28 |
| - Intel® QAT | intel.feature.node.kubernetes.io/qat=true |
29 |
| - Intel® SGX | intel.feature.node.kubernetes.io/sgx=true |
| 1 | +# Setting up Node Feature Discovery |
| 2 | +[Node Feature Discovery (NFD) Operator](https://docs.openshift.com/container-platform/4.12/hardware_enablement/psap-node-feature-discovery-operator.html) manages the deployment and lifecycle of the NFD add-on to detect hardware features and system configuration, such as PCI cards, kernel, operating system version, etc. |
| 3 | + |
| 4 | +# Prerequisites |
| 5 | +- Provisioned RHOCP 4.12 cluster. Follow steps [here](/README.md#provisioning-rhocp-cluster). |
| 6 | + |
| 7 | +# Install NFD Operator |
| 8 | +Follow the guide below to install the NFD operator using CLI or web console. |
| 9 | +- [Install from the CLI](https://docs.openshift.com/container-platform/4.12/hardware_enablement/psap-node-feature-discovery-operator.html#install-operator-cli_node-feature-discovery-operator) |
| 10 | +- [Install from the web console](https://docs.openshift.com/container-platform/4.12/hardware_enablement/psap-node-feature-discovery-operator.html#install-operator-web-console_node-feature-discovery-operator) |
| 11 | + |
| 12 | +# Configure NFD Operator |
| 13 | +Note: As RHOCP cluster administrator, you might need to merge the NFD operator config from the following Custom Resources (CRs) with other NFD operator configs that are already applied on your cluster. |
| 14 | + |
| 15 | +1. Create `NodeFeatureDiscovery` CR instance. |
| 16 | +``` |
| 17 | +$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/blob/release-1.0.0/nfd/node-feature-discovery-openshift.yaml |
| 18 | +``` |
| 19 | + |
| 20 | +2. Create `NodeFeatureRule` CR instance. |
| 21 | +``` |
| 22 | +$ oc apply -f https://raw.githubusercontent.com/intel/intel-technology-enabling-for-openshift/release-1.0.0/nfd/node-feature-rules-openshift.yaml |
| 23 | +``` |
| 24 | + |
| 25 | +# Verification |
| 26 | +Use the command shown below to verify whether the nodes are labeled properly by NFD: |
| 27 | +``` |
| 28 | +$ oc describe node node_name | grep intel.feature.node.kubernetes.io |
| 29 | +``` |
| 30 | +Example output: |
| 31 | +``` |
| 32 | +intel.feature.node.kubernetes.io/dgpu-canary=true |
| 33 | +intel.feature.node.kubernetes.io/gpu=true |
| 34 | +``` |
| 35 | + |
| 36 | +# Labels table |
| 37 | +| Label | Intel hardware feature | |
| 38 | +| ----- | ---------------------- | |
| 39 | +| `intel.feature.node.kubernetes.io/gpu=true` | Intel® Data Center GPU Flex Series | |
| 40 | +| `intel.feature.node.kubernetes.io/sgx=true` | Intel® SGX | |
| 41 | + |
| 42 | +# See Also |
0 commit comments