Skip to content

Commit 4396a69

Browse files
authored
Merge pull request #61 from chaitanya1731/doc
nfd: Updated readme
2 parents fcf0dd1 + 4a1cb80 commit 4396a69

File tree

1 file changed

+42
-29
lines changed

1 file changed

+42
-29
lines changed

nfd/README.md

Lines changed: 42 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,42 @@
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

Comments
 (0)