Document diagnostic boot menu and improve factory reset instructions

- Add boot menu contents (options 1-9, A-C) with explanation of each
- Method 1: boot menu option 5 (works without knowing password)
- Method 2: CLI method (requires working login)
- Note 60-second window and how to continue normal boot if entered by accident

https://claude.ai/code/session_01JR2EMK7rwrZJowpstcaxQ6
This commit is contained in:
Claude
2026-03-24 03:58:56 +00:00
parent fe723ea6e5
commit e4777d72fb
+27 -4
View File
@@ -511,7 +511,32 @@ Re-pin: `ssh-keyscan -H 192.168.99.1 > /etc/switch-manager/known_hosts`
**Factory reset — wiping a previously configured switch**
If the switch has a previous config you want to clear before starting fresh, do this via the console cable:
> When to wipe: if the switch has unknown previous configuration, unknown passwords, or you want a guaranteed clean slate. If the switch already responds to `admin` with no password and has no unexpected VLANs or ACLs, a wipe is not required — you can configure over the existing state.
**Method 1 — Boot menu (easiest, works even if you don't know the password)**
The console cable must be plugged in before power-on. During boot a diagnostic menu appears briefly:
```
DIAGNOSTIC BREAK MENU
59100 GTS-PWR+ Diagnostics 7.5.0.4
1 - Launch Primary Agent-1 Vers: 7.9.6.015
2 - Launch Secondary Agent-2 Vers: 7.6.2.019
3 - Toggle Primary Agent Selection
4 - Download Agent/ Diag
5 - Reinitialize Agent Configuration Files
...
8 - Continue Boot Sequence
9 - Reset
Select:
Booting Agent in 60 seconds...
```
Press **5** — "Reinitialize Agent Configuration Files". The switch wipes its config and reboots into factory defaults. You have 60 seconds before it boots automatically.
The other useful options: **1/2** switch between primary (v7.9.6) and secondary (v7.6.2) firmware. **9** reboots. **8** continues the normal boot if you entered the menu by accident.
**Method 2 — CLI (requires working login)**
```
enable
@@ -520,9 +545,7 @@ save config
boot
```
The switch will reboot into factory defaults — blank config, default credentials (`admin` / no password), and the default management IP `192.168.1.1` on VLAN 1. Then follow the setup steps from Step 5 onwards.
> When to wipe: if the switch has unknown previous configuration, unknown passwords, or you want a guaranteed clean slate. If the switch already responds to `admin` with no password and has no unexpected VLANs or ACLs, a wipe is not required — you can configure over the existing state.
After either method the switch comes up with blank config, default credentials (`admin` / no password), and management IP `192.168.1.1` on VLAN 1. Continue from Step 5.
**ctrld not filtering DNS**
Check DHCP option 6 is set to the ctrld machine's IP on each VLAN pool. Check ctrld is running: `ctrld status`. Check the switch is handing out the right DNS: from a device, run `nslookup example.com` and verify the server IP matches.