Diff for "SerialConsoleHowto"

Differences between revisions 1 and 6 (spanning 5 versions)
⇤ ← Revision 1 as of 2005-07-19 01:31:34 →
Size: 3565
Editor: sydney-natpool-130
Comment:
← Revision 6 as of 2007-09-23 23:03:37 → ⇥
Size: 4628
Editor: cpe-76-80-127-252
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## Please edit system and help pages ONLY in the moinmaster wiki! For more
## information, please see MoinMaster:MoinPagesEditorGroup.
##master-page:Unknown-Page
##master-date:Unknown-Date
##acl MoinPagesEditorGroup:read,write,delete,revert All:read
#format wiki
#language en
== Serial Console Howto for Ubuntu 5.04 ==
This document presents the minimum amount of work required to enable a serial console login on an Ubuntu 5.04 installation.		 This document presents (almost) the minimum amount of work required to enable a serial console login on an Ubuntu 6.06 installation. (Minor changes have been added to improve performance) Both server and client settings are included.
Line 12: Line 4:
http://www.faqs.org/docs/Linux-HOWTO/Remote-Serial-Console-HOWTO.html]), and adapted to apply specifically to Ubuntu 5.04. The reader is referred to this document for any issues arising from using this HOWTO. http://www.faqs.org/docs/Linux-HOWTO/Remote-Serial-Console-HOWTO.html]), and adapted to apply specifically to Ubuntu 6.06. The reader is referred to this document for any issues arising from using this HOWTO.
Line 15: Line 7:
 * You are familiar with console software, ie minicom, and can set it up to listen to the appropriate serial port with the appropriate speed, data bits etc.
 * The serial connection is being made at 9600 baud 8n1		  * You have enabled the serial console in your BIOS.
 * The serial connection is being made at 115200 baud 8n1, on console port /dev/ttyS0 (9600 8n1 is the default fall back if your hardware does not support 115200 baud)
Line 18: Line 10:
 * You are using a serial (null modem) cable. It is also possible to use a USB to Serial adaptor, but the tty* must be changed to reflect your hardware.

Note: an excellent resource is: http://www.lammertbies.nl/comm/cable/yost-serial-rj45.html which will show you how to make Serial to Cat 5 adaptors.

== Server Setup ==

=== Configuring the console login process ===
This section details how to configure the 'getty' process to enable a login via the console port.

1) Edit /etc/inittab


NOTE: In newer versions of ubuntu, inittab is no longer used. Instead, look in /etc/event.d and make modifications there.


{{{
sudo vi /etc/inittab
}}}

2) Change the following line:

{{{
#T0:23:respawn:/sbin/getty -L ttyS0 9600 vt100
}}}

to:

{{{
T0:23:respawn:/sbin/getty -L ttyS0 115200 vt100
}}}

3) Restart init:

{{{
sudo /sbin/telinit q
}}}

At this point, a new login prompt should appear on the output of the serial console.
Line 34: Line 64:
serial --unit=0 --speed=9600 --word=8 --parity=no --stop=1
terminal serial		 serial --unit=0 --speed=115200 --word=8 --parity=no --stop=1
terminal --timeout=15 serial console
Line 38: Line 68:
3) When you next reboot, the output from grub should come out of the console port specified in the --unit option. 3) When you next reboot, the output from grub will go to the normal console '''unless''' input is received from the serial port. Whichever receives input first becomes the default console. This gives you the best of both worlds.
Line 69: Line 99:
kernel /boot/vmlinuz-2.6.10-5-386 root=/dev/hda1 ro quiet splash console=tty0 console=ttyS0,9600n8 kernel /boot/vmlinuz-2.6.10-5-386 root=/dev/hda1 ro quiet splash console=tty0 console=ttyS0,115200n8
Line 79: Line 109:
=== Configuring the console login process ===
This section details how to configure the 'getty' process to enable a login via the console port.		 == Client Setup ==
Line 82: Line 111:
1) Edit /etc/inittab
 1) Install minicom
Line 85: Line 113:
sudo vi /etc/inittab sudo apt-get install minicom
Line 88: Line 116:
2) Change the following line:
 2) Configure minicom.
Line 91: Line 118:
#T0:23:respawn:/sbin/getty -L ttyS0 9600 vt100 sudo minicom -s
Line 94: Line 121:
to:
 3) Configure client serial port settings: In Serial port setup, set the following options
Line 97: Line 123:
T0:23:respawn:/sbin/getty -L ttyS0 9600 vt100 A - Serial device: /dev/ttyS0
E - Bps/Par/Bits: 115200 8N1
Line 100: Line 127:
3) Restart init:
 4) Configure Initialization string: In Modem and dialing clear the init
Line 103: Line 129:
sudo /sbin/telinit q A - Init string .....
Line 106: Line 132:
At this point, a new login prompt should appear on the output of the serial console. 5) Save setup as dfl

6) You might need to press enter several times to get the connection running.

7) To log on in the future, run
{{{
sudo minicom
}}}
and press enter several times if it does not come up on start up.


CategoryDocumentation

This document presents (almost) the minimum amount of work required to enable a serial console login on an Ubuntu 6.06 installation. (Minor changes have been added to improve performance) Both server and client settings are included.

This procedure was developed using the Remote Serial Console HOWTO ([ http://www.faqs.org/docs/Linux-HOWTO/Remote-Serial-Console-HOWTO.html]), and adapted to apply specifically to Ubuntu 6.06. The reader is referred to this document for any issues arising from using this HOWTO.

Assumptions

  • You have enabled the serial console in your BIOS.
  • The serial connection is being made at 115200 baud 8n1, on console port /dev/ttyS0 (9600 8n1 is the default fall back if your hardware does not support 115200 baud)
  • You are comfortable editing critical system files such as /etc/inittab, /boot/grub/menu.lst
  • You are using a serial (null modem) cable. It is also possible to use a USB to Serial adaptor, but the tty* must be changed to reflect your hardware.

Note: an excellent resource is: http://www.lammertbies.nl/comm/cable/yost-serial-rj45.html which will show you how to make Serial to Cat 5 adaptors.

Server Setup

Configuring the console login process

This section details how to configure the 'getty' process to enable a login via the console port.

1) Edit /etc/inittab

NOTE: In newer versions of ubuntu, inittab is no longer used. Instead, look in /etc/event.d and make modifications there. 

sudo vi /etc/inittab

2) Change the following line: 

#T0:23:respawn:/sbin/getty -L ttyS0 9600 vt100

to: 

T0:23:respawn:/sbin/getty -L ttyS0 115200 vt100

3) Restart init: 

sudo /sbin/telinit q

At this point, a new login prompt should appear on the output of the serial console.

Configuring grub

This section details how to get grub talking via the serial port.

This section is optional if the user does not want grub interaction via the serial console port.

1) Edit /boot/grub/menu.lst: 

vi /boot/grub/menu.lst

2) Add the following lines to the top of the file: 

# Enable console output via the serial port. unit 0 is /dev/ttyS0, unit 1 is /dev/ttyS1...
serial --unit=0 --speed=115200 --word=8 --parity=no --stop=1
terminal --timeout=15 serial console

3) When you next reboot, the output from grub will go to the normal console unless input is received from the serial port. Whichever receives input first becomes the default console. This gives you the best of both worlds.

Configuring the kernel boot parameters

This section details how to configure the kernel boot parameters to get boot information through the console port.

This section is optional if the user does not want the kernel boot messages to appear on the serial console port.

The following procedure can be carried out by modifying the 'kernel' line in grub prior to committing the changes directly to the /boot/grub/menu.lst file.

1) Edit /boot/grub/menu.lst: 

sudo vi /boot/grub/menu.lst

2) Modify the kernel line for the image you want to boot using the serial console on. In this case, I'm setting up the default 2.6.10-5.386 kernel to use the serial console line. Change: 

title           Ubuntu, kernel 2.6.10-5-386
root            (hd0,0)
kernel          /boot/vmlinuz-2.6.10-5-386 root=/dev/hda1 ro quiet splash
initrd          /boot/initrd.img-2.6.10-5-386
savedefault
boot

to: 

title           Ubuntu, kernel 2.6.10-5-386
root            (hd0,0)
kernel          /boot/vmlinuz-2.6.10-5-386 root=/dev/hda1 ro quiet splash console=tty0 console=ttyS0,115200n8
initrd          /boot/initrd.img-2.6.10-5-386
savedefault
boot

NOTE: the first console parameter is 'console=tty0', not ttyS0

3) Reboot into this kernel. Output from the boot process should be sent via the serial console line.

Client Setup

1) Install minicom 

sudo apt-get install minicom

2) Configure minicom. 

sudo minicom -s

3) Configure client serial port settings: In Serial port setup, set the following options 

A - Serial device: /dev/ttyS0
E - Bps/Par/Bits: 115200 8N1

4) Configure Initialization string: In Modem and dialing clear the init 

A - Init string .....

5) Save setup as dfl

6) You might need to press enter several times to get the connection running.

7) To log on in the future, run 

sudo minicom

and press enter several times if it does not come up on start up.

CategoryDocumentation

SerialConsoleHowto (last edited 2018-11-05 10:36:54 by tj)