Imported Upstream version 2.9.7upstream/2.9.7

1 files changed, 65 insertions, 0 deletions

diff --git a/doc/isol.8 b/doc/isol.8
index d2e594c..8aacbe0 100644
--- a/doc/isol.8
+++ b/doc/isol.8
@@ -113,6 +113,71 @@ ipmiutil sol \-a \-N nodename \-U username \-P password  \-Flan2
 Starts an SOL console session to the nodename.  Force lan protocol to 2.0.
 .PP
 
+.SH "PLATFORM SERIAL PORT CONFIGURATION EXAMPLES"
+
+First, enter BIOS Setup for Serial Console Redirection parameters:
+(these vary by platform)
+.br
+  Console Redirection = Serial Port B
+.br
+  ACPI Redirection = Disabled
+.br
+  Baud Rate = 115.2K
+.br
+  Flow Control = CTS/RTS
+.br
+  Terminal Type = VT100
+.br
+  Legacy Redirection = Enabled
+.br
+Note that the Baud Rate can vary, but it must match in all
+locations where it is used (BIOS, IPMI, and Linux).
+.br
+For some non-Intel platforms, the serial console would be
+COM1 instead of COM2, but should be enabled in BIOS.
+.br
+From Linux, run "ipmiutil serial \-c" for Terminal Mode shared configuration.
+.br
+Or, on older Intel TSRLT2 platforms:
+From Linux, run "ipmiutil serial \-s" for Basic Mode Shared configuration.
+
+.SH "LINUX CONFIGURATION FOR SERIAL CONSOLE"
+
+If using lilo, in /etc/lilo.conf, add
+.br
+  append="console=ttyS1,19200n8 console=tty0"
+.br
+(and comment out the "message=" line because it includes graphics)
+.br
+Note that the append line can be placed in the global section
+and removed from each kernel section if there are no other differences.
+
+.PP
+Or, if using grub, edit /boot/grub/grub.conf as follows:
+.br
+  #Omit the splashimage or gfxmenu
+.br
+  # splashimage=(hd0,0)/grub/splash.xpm.gz
+.br
+  #The serial and terminal lines are not usually needed
+.br
+  # serial \-\-unit=1 \-\-speed=19200 \-\-word=8 \-\-parity=no \-\-stop=1
+.br
+  # terminal \-\-timeout=10 serial console
+.br
+  #Add the console=ttyS* parameter to the kernel line
+.br
+    kernel (hd0,0) /vmlinuz root=/dev/sda2 console=ttyS1,19200n8
+
+.PP
+Add this line to /etc/initab, if ttyS1 is not already there:
+.br
+  co:2345:respawn:/sbin/agetty ttyS1 19200 vt100
+.PP
+Add this line to /etc/securetty, if ttyS1 is not already there:
+.br
+  ttyS1
+
 .SH "SEE ALSO"
 ipmiutil(8) ialarms(8) iconfig(8) icmd(8) idiscover(8) ievents(8) ifru(8) igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8) iwdt(8)