Skip to content

Commit 4ae4cfc

Browse files
authored
[docs] Add more information to reconfigurator-dev-guide (#8228)
1 parent 5816423 commit 4ae4cfc

File tree

1 file changed

+28
-1
lines changed

1 file changed

+28
-1
lines changed

docs/reconfigurator-dev-guide.adoc

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -954,7 +954,7 @@ Prerequisite: you must already have an _unpacked_ TUF repo. You could <<task-do
954954
For testing SP updates, we don't need the host OS and control plane images, which are by far the largest files in the repo. You can delete them with:
955955

956956
```
957-
$ rm -f repo/targets/*.host* repo/targets/*.trampoline-* repo/targets/*.control-plane-*
957+
$ rm -f repo/targets/*.host* repo/targets/*.trampoline-* repo/targets/*.control_plane-*
958958
```
959959

960960
Then copy this directory tree over to the switch zone.
@@ -1289,6 +1289,24 @@ For a4x2: copy this binary to the switch zone and run it from there. You'll nee
12891289

12901290
For `omicron-dev run-all`, you can run this command from the same system where you're running `omicron-dev`. Instead of `--interface`, you need to use the `--sp-sim-addr IPV6_ADDR:PORT` option to point `faux-mgs` at the simulated SP. Unfortunately, the easiest way to find the address and port of the simulated SP is in the log file whose path is printed out by `omicron-dev run-all`.
12911291

1292+
You can find the necessary addresses for each interface during the initial SP discovery phase:
1293+
1294+
```
1295+
$ cat /tmp/omicron-dev-omicron-dev.20224.2.log | grep "SP discovery" | looker
1296+
01:08:25.680Z DEBG 645532bc-27f9-4602-bd3a-cff17d678bde (ManagementSwitch): attempting initial SP discovery
1297+
discovery_addr = [::1]:36109
1298+
interface = fake-switch0
1299+
01:08:25.680Z DEBG 645532bc-27f9-4602-bd3a-cff17d678bde (ManagementSwitch): attempting initial SP discovery
1300+
discovery_addr = [::1]:47800
1301+
interface = fake-switch1
1302+
01:08:25.680Z DEBG 645532bc-27f9-4602-bd3a-cff17d678bde (ManagementSwitch): attempting initial SP discovery
1303+
discovery_addr = [::1]:55043
1304+
interface = fake-sled0
1305+
01:08:25.680Z DEBG 645532bc-27f9-4602-bd3a-cff17d678bde (ManagementSwitch): attempting initial SP discovery
1306+
discovery_addr = [::1]:50632
1307+
interface = fake-sled1
1308+
```
1309+
12921310
---
12931311

12941312
However you get `faux-mgs` running, you can use it to inspect state and https://github.com/oxidecomputer/meta/blob/master/engineering/mupdate/manual-rot-sp-updates.adoc[perform updates by hand]. (If you follow those linked instructions, note that they use `pilot sp exec -e CMD SERIAL`. This is a thin wrapper that finds the right interface for the host with serial `SERIAL` and then runs `faux-mgs --interface INTERFACE CMD`. You can just do this transformation yourself.)
@@ -1343,4 +1361,13 @@ Sled SimGimlet00
13431361
...
13441362
```
13451363

1364+
If you're running `omicron-dev run-all`, you'll need to use the `--dns-server` flag to specify
1365+
the DNS server `omdb` will use. You can find this information within the `omicron-dev run-all` output:
1366+
1367+
```
1368+
...
1369+
omicron-dev: internal DNS: [::1]:63673
1370+
...
1371+
```
1372+
13461373
This is a handy summary, but it only gets updated when inventory is collected. This is more cumbersome than `faux-mgs` when you only need to get one piece of information and need it to be up-to-date.

0 commit comments

Comments
 (0)