From 335cda594d26426dbcc4d4c29618d8ba914aaafc Mon Sep 17 00:00:00 2001 From: Jake Bloom Date: Tue, 16 Jun 2026 11:28:21 -0400 Subject: [PATCH 1/2] docs: add one-line expected machine add example Signed-off-by: Jake Bloom --- docs/provisioning/ingesting-hosts.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/provisioning/ingesting-hosts.md b/docs/provisioning/ingesting-hosts.md index c9908c18c6..dc8a641ee0 100644 --- a/docs/provisioning/ingesting-hosts.md +++ b/docs/provisioning/ingesting-hosts.md @@ -143,7 +143,13 @@ nico-admin-cli -c credential add-uefi --kind=dpu --password='x' NICo needs to know the factory default credentials for each BMC, which is expressed as a JSON table of "Expected Machines". The serial number is used to verify the BMC MAC matches the actual serial number of the chassis. -Prepare an `expected_machines.json` file as follows: +To add a single host, use `expected-machine add`: + +```bash +nico-admin-cli -c expected-machine add --bmc-mac-address "D8:19:09:00:05:A4" --bmc-password '0penBmc' --chassis-serial-number B8111801000852100085Y0SA --bmc-username root +``` + +To load or replace the full table, prepare an `expected_machines.json` file as follows: ```json { @@ -164,7 +170,7 @@ Prepare an `expected_machines.json` file as follows: } ``` -Only servers listed in this table will be ingested, so you must include all servers in this file. +Only servers listed in the expected machines table will be ingested. Use `expected-machine add` for individual hosts, or use `replace-all` when you want the JSON file to define the complete table. ### Optional Per-Host Fields @@ -327,4 +333,4 @@ Export the current table as JSON: ```bash nico-admin-cli -c -f json em show -``` \ No newline at end of file +``` From b72603749ee7c3e6017ffae5b920d17ecd329a02 Mon Sep 17 00:00:00 2001 From: Jake Bloom Date: Tue, 16 Jun 2026 14:28:08 -0400 Subject: [PATCH 2/2] docs: use placeholder expected machine values Signed-off-by: Jake Bloom --- docs/provisioning/ingesting-hosts.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/provisioning/ingesting-hosts.md b/docs/provisioning/ingesting-hosts.md index dc8a641ee0..d870f3c8c9 100644 --- a/docs/provisioning/ingesting-hosts.md +++ b/docs/provisioning/ingesting-hosts.md @@ -146,7 +146,7 @@ NICo needs to know the factory default credentials for each BMC, which is expres To add a single host, use `expected-machine add`: ```bash -nico-admin-cli -c expected-machine add --bmc-mac-address "D8:19:09:00:05:A4" --bmc-password '0penBmc' --chassis-serial-number B8111801000852100085Y0SA --bmc-username root +nico-admin-cli -c expected-machine add --bmc-mac-address "02:00:00:00:00:01" --bmc-password 'default-password' --chassis-serial-number CHASSIS-SN-001 --bmc-username root ``` To load or replace the full table, prepare an `expected_machines.json` file as follows: