| 1 | [[PageOutline]] |
| 2 | = How do I connect to an MF/PL server located at Sunset Park via the serial port? = |
| 3 | |
| 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]. |
| 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 | * `ignatz` (Cable 1: ttyUSB0) |
| 11 | * `audre` (Cable 2: ttyUSB1) |
| 12 | * `melanie` (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 melanie-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/ttyS15 115200 fred-console fred-console |
| 47 | cereal-admin start fred |
| 48 | }}} |
| 49 | |