how_to_setup_the_serial_console.markdown

How to setup the serial console

Serial console access allows you to manage, monitor and interact with your system over a serial console. Your system's BIOS, bootloader (GRUB), Xen, Linux and login access must each be individually configured for serial console access.

It is not strictly necessary to have each component fully functional, but it can be quite useful!

Serial Console BIOS configuration

Refer to your Hardware vendor's documentation for capabilities and procedures to enable BIOS serial redirection.

We will use the serial port com1.

Serial Console GRUB configuration

Adding the following two lines to your GRUB configuration file, typically either in /boot/grub/menu.lst or /boot/grub/grub.conf depending on your distro, will enable GRUB serial output.

serial --unit=0 --speed=57600 --word=8 --parity=no --stop=1

terminal --timeout=10 serial console

Please refer to the GRUB documentation for further information.

Serial Console Xen configuration

In order to configure Xen serial console output, it is necessary to add a boot option to your GRUB config.

kernel /xen-3.2.1-i386.gz **xencons=tty**

Serial Console Linux configuration

To enable Linux output at boot time, add the parameter console=ttyS0,57600 to your kernel GRUB line. Under Xen, this might be:

module /vmlinuz-2.6.26-1-xen-686 root =/dev/mapper/vg0-root ro **console=ttyS0,57600**

to enable output over ttyS0 at 57600 baud.

Serial Console Login configuration

Logging in to Linux via serial console requires specifying a login prompt be started on the serial port.