[[PageOutline]]
= In XO/Bandcon Serial Console access =

Note: if you are trying to connect to a server in our Telehouse facility, see our [wiki:telehouse_serial_access Telehouse serial access page]; for Sunset Park see [wiki:sunsetpark_serial_access Sunset Park serial acess page].

Coming soon (sometime after 2012-06-09)! roy.mayfirst.org will replace paley as our console server. This transition is in progress. All serial connections are still running through paley.

== Physical Setup ==

Console server: paley.mayfirst.org

 * Port 1: ochs.mayfirst.org (remote power)
 * Port 2: axiom (CritPath)
 * Port 3: luisa.mayfirst.org
 * Port 4: malaka.mayfirst.org 
 * Port 5: ottorene.mayfirst.org
 * Port 6: ramona.mayfirst.org
 * Port 7: pietri.mayfirst.org
 * Port 8: nene
 * Port 9: finch
 * Port 10: clr
 * Port 11: pianeta (asm)
 * Port 12: shaw (tenant.net)
 * Port 13: zunzuncito (backup switch not in use)
 * Port 15: bufflehead (Riseup)
 * Port 16: kato (in use switch)
 * Port 22: franz (saharareporters)
 * Port 48: odetta.mayfirst.org (remote power)

== Connecting to your serial console paley as sysadmin ==

You can also connect directly via paley with:

{{{
ssh sysadmin@paley.mayfirst.org
connect direct deviceport <servername>
}}}

To exit from a direction connect, type ESC-A (that's hit and release escape and then shift-a).

== Connecting to roy via serial console ==

In addition - we have a serial line running from luisa's /dev/ttyUSB0 that goes to roy's built-in serial port 1, so that roy's console itself is remotely accessible, and logged. You can connect to roy's console with:


{{{
ssh -t roy-console@luisa.mayfirst.org cereal attach roy
}}}

== sysrq ==

To get the sysrq menu (for [wiki:skinny_elephants_recovery raising skinny elephants]), type ESC-B h (thats hit and release escape and then shift-B and then h to get the sysrq menu)

== Creating a new serial line/user ==

These need to be improved - not sure how to do this via the command line - so far I'm doing this via the web interface at https://paley.mayfirst.org.

 1. Configure the device by going to Devices -> Device Port. Then select the port you want to configure and click configure
  * Provide a name (after the server name)
  * Check the box that says ssh in
  * Change Baud to 115200
 1. Configure the user by doing to User Authentication -> Local/Remote Users and click Add/Edit User
  * Enter a login (servername-console)
  * Create a password
  * Change the listen, data, and clear port settings to just the number of the port they should have access to
  * Enable web access
 1. Configure ssh key access
  * Place the user's public key on a server accessible by password-based scp
  * Edit the username portion of the ssh key line (that last part - separated by a space from the key). Change the username to be the username they will be logging in as on the console server. The portion after the @ sign can be anything (but must be included).
  * Via the web interface, click User Authentication -> SSH users
  * Leave host blank. Enter the target username in the user field
  * Fill out all fields in the Host and Login for import form.
  * Click apply