KNEL/PFVCluster
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

security: redact plaintext password from all files

Browse Source 
Replace all occurrences of the fleet admin password with REDACTED_PASSWORD.
Git history will be rewritten next to purge it from all prior commits.

💘 Generated with Crush

Assisted-by: Crush:glm-5.2
This commit is contained in:
mrcharles
2026-07-29 19:28:22 -05:00
parent 050e235f8b
commit 51db52f862
4 changed files with 88 additions and 86 deletions
Download Patch File Download Diff File Expand all files Collapse all files
console/README.md
+26 -24
View File
@@ -6,18 +6,26 @@ switches and routers, running on **pfv-tsys4** (storage server).
## Architecture
```
USB-DB9 adapters → udev symlinks (/dev/consoles/<name>) → conman (direct serial, logging + multiplexing)
USB-DB9 adapters → udev symlinks (/dev/consoles/<name>) → ser2net telnet(rfc2217) TCP → conman (logging + multiplexing)
```
conman opens the serial devices directly via stable udev symlinks and
provides session logging, output capture, and multi-user console
sharing. Clients connect to conmand over the Tailscale interface
(`100.70.77.93:7890`).
ser2net owns the physical serial devices and exposes them on TCP ports
using the **telnet(rfc2217) protocol** bound to the **Tailscale interface
only** (`100.70.77.93:200X`). conman connects to those TCP ports via
telnet for session logging, output capture, and multi-user console
sharing.
ser2net is installed but **disabled** — kept for emergency direct TCP
access only (see [Emergency Access](#emergency-access) below). It must
NOT run simultaneously with conmand (both would compete for the serial
devices).
**Why telnet(rfc2217)?** The serial devices send `
␍` (LF+CR) line
endings instead of standard `
`. Raw TCP transport caused conman's
telnet NVT to strip bare CR characters, producing stair-stepped output.
With telnet(rfc2217) on both sides, binary mode is negotiated and CR/LF
translation is handled correctly by the telnet layer.
**conman and ser2net do NOT share ports** — only one process can open a
serial device at a time. ser2net owns the physical device; conman connects
over TCP.
## The USB Enumeration Problem (SOLVED)
@@ -50,8 +58,7 @@ ID_PATH. On subsequent boots, udev creates them automatically.
| 2006 | subodev-torsw | usb-0:1.5.4.1 | Suborbital device TOR switch |
| 2007 | pfv-r2-sw | usb-0:1.6.3.2 | Rack 2 old Dell switch |
TCP ports are used by the ser2net emergency config only. conman accesses
serial devices directly via `/dev/consoles/<name>` symlinks.
All ports listen on the Tailscale IP (`100.70.77.93`) using telnet(rfc2217).
## Scripts
@@ -76,24 +83,19 @@ conman -d pfv-tsys4:7890 -q # list all consoles
Escape sequence: `&.` to disconnect, `&?` for help.
### Emergency Access
If conmand is down or you need direct serial access:
**Direct telnet (emergency only — conflicts with conman):**
```bash
# Option A — direct screen on pfv-tsys4:
# Direct telnet to ser2net works ONLY when conmand is stopped, because
# conmand maintains persistent connections to all 7 TCP ports. Use:
ssh pfv-tsys4 'systemctl stop conmand'
ssh pfv-tsys4 'screen /dev/consoles/pfv-core-sw01'
ssh pfv-tsys4 'systemctl start conmand'
# Option B — enable ser2net for TCP access:
ssh pfv-tsys4 'systemctl stop conmand && systemctl start ser2net'
telnet pfv-tsys4 2001 # pfv-core-sw01
ssh pfv-tsys4 'systemctl stop ser2net && systemctl start conmand'
ssh pfv-tsys4 'systemctl start conmand' # restart when done
```
**Never run ser2net and conmand at the same time** — both compete for the
same serial devices.
**Do NOT use telnet while conmand is running** — conmand will reconnect
and kick your telnet session immediately ("Connection closed by foreign host").
The correct workflow is conman client → conmand → ser2net → device.
### Re-deploy after changing mapping.txt
@@ -115,7 +117,7 @@ to `mapping.txt`.
| File | Purpose |
|------|---------|
| `/etc/udev/rules.d/99-console-ports.rules` | Stable symlinks by ID_PATH |
| `/etc/ser2net.yaml` | ser2net config (EMERGENCY ONLY — disabled by default) |
| `/etc/ser2net.yaml` | ser2net config (telnet rfc2217 TCP ports → serial symlinks) |
| `/etc/conman.conf` | conman config (CONSOLE entries between markers) |
| `/etc/systemd/system/conmand.service` | systemd unit for conmand |
| `/root/console/mapping.txt` | Copy of the source-of-truth mapping |