| 4 | | Note: if you are trying to connect to a server in our XO/Bandcon, see [wiki:xo_serial_access our XO serial access page]; for Telehouse see [wiki:telehouse_serial_access Telehouse serial acess page]; for Koumbit see [wiki:koumbit_serial_access Koumbit serial access].. |
| 5 | | |
| 6 | | == Serial Console physical setup == |
| 7 | | |
| 8 | | In Sunset Park we have an 8 port USB to serial adapter using the pl2303 chipset that is plugged into our office router (ida.mayfirst.org. They 8 ports are allocated: |
| 9 | | |
| 10 | | * `yaqeen` (Cable 1: ttyUSB0) - alfredo/praxis project |
| 11 | | * `sittingbull` (Cable 2: ttyUSB1) |
| 12 | | * NOT IN USE (Cable 3: ttyUSB2) |
| 13 | | * NOT IN USE (Cable 4: ttyUSB3) |
| 14 | | * NOT IN USE (Cable 5: ttyUSB4) |
| 15 | | * NOT IN USE (Cable 6: ttyUSB5) |
| 16 | | * NOT IN USE (Cable 7: ttyUSB6) |
| 17 | | * NOT IN USE (Cable 8: ttyUSB7) |
| 18 | | |
| 19 | | The serial consoles of the attached machines are all remotely accessible (to properly-authenticated people), and they are also logged and timestamped. We are using [http://cmrg.fithhorseman.net/wiki/cereal cereal] to do this cleanly and easily. |
| 20 | | |
| 21 | | == How to connect == |
| 22 | | |
| 23 | | In order to connect via serial console to one of the servers named above, ssh into `ida.mayfirst.org` as ''servername''`-console` |
| 24 | | |
| 25 | | For example: |
| 26 | | |
| 27 | | {{{ |
| 28 | | ssh -t zapata-console@ida.mayfirst.org cereal attach melanie |
| 29 | | }}} |
| 30 | | |
| 31 | | Would give you full read/write access to the console on `melanie`. |
| 32 | | |
| 33 | | The SSH RSA host key for `console.mayfirst.org` should have a fingerprint of: |
| 34 | | {{{ |
| 35 | | a5:67:26:83:0d:43:2c:32:0a:c5:3e:5c:0a:8b:32:10 |
| 36 | | }}} |
| 37 | | |
| 38 | | We can also setup additional users that have read-only access to the sessions created by each of these usernames, should that be desirable. You can request such access by creating a [/newticket ticket]. |
| 39 | | |
| 40 | | == Setting up a new console user == |
| 41 | | |
| 42 | | To setup a new console user (this is something only admins can do), do the following as `root@ida`: |
| 43 | | |
| 44 | | {{{ |
| 45 | | adduser --disabled-password --gecos='fred console user,,,' fred-console |
| 46 | | cereal-admin create fred /dev/ttyUSB2 115200 fred-console fred-console |
| 47 | | cereal-admin start fred |
| 48 | | }}} |
| 49 | | |
| | 4 | We are no longer hosting any servers in sunset park. |
