| | 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 | |