medic

1# medic
2 
3`sno medic run` looks at the agent team on this machine and prints one line per check. It reads and
4reports; it never installs, repairs, starts, stops or spends anything.
5 
6```
7OK <check>: <what was found>
8WARN <check>: <what is wrong> -> <the command that fixes it>
9FAIL <check>: <what is wrong> -> <the command that fixes it>
10MEDIC ok=N warn=N fail=N
11```
12 
13`FAIL` means the team cannot work at all (a required program is missing, no agent command line is
14installed, Reach is broken). `WARN` means it works worse than it should. Exit status is 0 when there is
15no `FAIL`, 1 otherwise, 2 for a wrong command line.
16 
17Prerequisites: bash 4+, GNU coreutils and jq. `sno medic` with no arguments, or `--help`, prints the usage.
18 
19## Use
20 
211. Run `sno medic run`. It takes about ten seconds because it asks `sno doctor` and reads both quotas.
222. Tell the owner the result in plain words: the counts, then each `WARN` and `FAIL` line with its fix.
23   Do not paste the whole output when everything is `OK`; one sentence says so.
243. Run a fix only when the owner asks for it. Installing and updating change the machine, and one
25   warning is often not worth a fix (for example no heartbeat when nothing long is running).
264. After a fix, run `sno medic run` again and read the same line: it must now say `OK`.
27 
28## What each check reads
29 
30| Check | Looks at | Common fix |
31|---|---|---|
32…