Move others to notes folder
authorAlyssa Rosenzweig <alyssa@rosenzweig.io>
Mon, 25 Jun 2018 21:17:37 +0000 (17:17 -0400)
committerAlyssa Rosenzweig <alyssa@rosenzweig.io>
Mon, 25 Jun 2018 21:17:37 +0000 (17:17 -0400)
notes/BMC-Considered-Harmful.md [moved from BMC-Considered-Harmful.md with 100% similarity]
notes/Reqs.txt [new file with mode: 0644]

diff --git a/notes/Reqs.txt b/notes/Reqs.txt
new file mode 100644 (file)
index 0000000..6d24aef
--- /dev/null
@@ -0,0 +1,17 @@
+# General
+
+Single-board computer running full GNU/Linux (any with USB / GPIO should work).
+
+Dedicated Ethernet port for that SBC; connect over SSH the usual way. (Our code doesn't need to worry about authentication nor encryption).
+
+Serial ports. Lots and lots of serial ports. For a standard server, just wire up to the serial port for interfacing. For the half-broken coreboot on the D16s, wire serial port RX to the D16's TX (for early boot log) but port TX to the RX pin of a serial->USB HID adaptor (so we pretend to be a keyboard).
+
+To manage an entire fleet by the same board, external USB->serial multiplexing adaptors can be used, so we can have e.g. 5 serial ports (5 servers) on the same port .
+
+For power output and similar tasks, connect like a switch using the board GPIO. For a small number of servers, we can wire up directly to the board GPIO; for a larger number, I imagine USB->GPIO adaptors exist.
+
+---
+
+# End deliverable
+
+Instructions for setting up a generic GNU/Linux single-board computer for managament purposes. A standard headless Debian system should suffice as a base. Serial management is done with `screen`. A system for mapping human server names to TTY/GPIO numbers is setup (trivial), plus a simple script for sysadmin-friendly power management will be written, so instead of `echo 0 > /sys/class/gpio/gpio10/etc`, it's `libremanage web2 shutdown` on the machine.