Skip to content

Commit fb37ed9

Browse files
docs: Enhance data-plane-pre.md with BMO and BMH configuration
Co-authored-by: aider (gemini/gemini-2.5-pro) <[email protected]>
1 parent e5db166 commit fb37ed9

File tree

1 file changed

+41
-13
lines changed

1 file changed

+41
-13
lines changed

examples/va/nvidia-vfio-passthrough/data-plane-pre.md

Lines changed: 41 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -14,41 +14,69 @@ Change to the nvidia-vfio-passthrough directory
1414
```
1515
cd architecture/examples/va/nvidia-vfio-passthrough
1616
```
17-
Edit the `edpm/nodeset/values.yaml` and `edpm/deployment/values.yaml` files to suit your environment.
17+
### Configure BMO - Provisioning to watch all namespaces
1818

19-
In `edpm/nodeset/values.yaml`, pay special attention to the `baremetalhosts` section. You will need to provide details for each of your baremetal compute nodes, including:
19+
```
20+
oc patch provisioning provisioning-configuration --type merge -p '{"spec":{"watchAllNamespaces": true }}'
21+
```
22+
23+
### Configure BMO - Provisioning to use external network for virtual-media
24+
25+
```
26+
oc patch provisioning provisioning-configuration --type merge -p '{"spec":{"virtualMediaViaExternalNetwork": true }}'
27+
```
28+
29+
### Create the BareMetalHost CRs
30+
31+
Edit the `edpm/nodeset/values.yaml` file to suit your environment. Pay special attention to the `baremetalhosts` section, where you will need to provide details for each of your baremetal compute nodes, including:
2032
- `bmc.address`: The IP address of the Baseboard Management Controller (BMC).
2133
- `bootMACAddress`: The MAC address of the network interface that the node will use to PXE boot.
2234
- Other parameters as described in the main [README.md](README.md).
35+
36+
Also, ensure the `bmhLabelSelector` in `baremetalSetTemplate` matches the labels you have defined for your `baremetalhosts`. For example, if you use `app: openstack`, your `baremetalhosts` should have a corresponding label.
37+
38+
Before applying the nodeset configuration, you must also create the `bmc-secret` secret that contains the BMC credentials. You can create it with the following command:
2339
```
24-
vi edpm/nodeset/values.yaml
25-
vi edpm/deployment/values.yaml
40+
oc create secret generic bmc-secret --from-literal=username=CHANGEME --from-literal=password=CHANGEME
2641
```
27-
Generate the dataplane nodeset CR.
42+
43+
Generate the dataplane nodeset CR, which includes the BareMetalHost definitions.
2844
```
2945
kustomize build edpm/nodeset > dataplane-nodeset.yaml
3046
```
31-
Generate the dataplane deployment CR.
47+
Apply the CRs to create the BareMetalHosts and the nodeset.
3248
```
33-
kustomize build edpm/deployment > dataplane-deployment.yaml
49+
oc apply -f dataplane-nodeset.yaml
3450
```
3551

36-
## Create CRs and do initial deployment
37-
Create the nodeset CR
52+
Wait for the BareMetalHosts to become available. You can monitor the status with:
3853
```
39-
oc apply -f dataplane-nodeset.yaml
54+
oc get bmh -w
4055
```
41-
Wait for dataplane nodeset setup to finish
56+
The state should change to `available`.
57+
58+
### Configure and deploy the dataplane
59+
60+
Edit `edpm/deployment/values.yaml` if needed.
61+
```
62+
vi edpm/deployment/values.yaml
63+
```
64+
Generate the dataplane deployment CR.
65+
```
66+
kustomize build edpm/deployment > dataplane-deployment.yaml
67+
```
68+
69+
Wait for dataplane nodeset setup to finish.
4270
```
4371
oc wait osdpns openstack-edpm --for condition=SetupReady --timeout=600s
4472
```
4573

46-
Start the deployment
74+
Start the deployment.
4775
```
4876
oc apply -f dataplane-deployment.yaml
4977
```
5078

51-
Wait for dataplane deployment to finish
79+
Wait for dataplane deployment to finish.
5280
```
5381
oc wait osdpns openstack-edpm --for condition=Ready --timeout=60m
5482
```

0 commit comments

Comments
 (0)