Bug 469695 - Virtualization Guide, section 29.6. not self-consistent
Summary: Virtualization Guide, section 29.6. not self-consistent
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: Documentation
Version: 5.2
Hardware: All
OS: Linux
medium
medium
Target Milestone: rc
: ---
Assignee: Christopher Curran
QA Contact: Content Services Development
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2008-11-03 15:54 UTC by Patrick C. F. Ernzer
Modified: 2009-08-20 03:31 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2009-02-23 05:12:53 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Patrick C. F. Ernzer 2008-11-03 15:54:21 UTC
Description of problem:
in section 29.6. of the Virtualization Guide we're not really making sense.


Version-Release number of selected component (if applicable):
Revision 5.2-10

How reproducible:
always

Steps to Reproduce:
1. try to find out how to set up serial output for dom0
2. RTFM
  
Actual results:
confusion, the text in the box does not match the least the description below it.

Expected results:
  - clear explanation of the options needed for serial in dom0
  - clear explanation of the options needed for serial in domU

Additional info:
for dom0 serial it seems
the following is right (obviously replace BANANA and SOMETHING)
title BANANA
        root (hd0,0)
        kernel /xen.gz-SOMETHING com1=57600,8n1
        module /vmlinuz-SOMETHING ro root=LABEL=/ console=ttyS0,57600
        module /initrd-SOMETHING.img

Comment 2 Christopher Curran 2008-11-04 06:30:18 UTC
This bug may already be resolved by bz 432235

Refer to the latest version of the Virtualization Guide to confirm the change.
http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/

Comment 3 Patrick C. F. Ernzer 2008-11-04 12:12:36 UTC
(In reply to comment #2)
> This bug may already be resolved by bz 432235

While that covers many sections, 29.6 does not seem covered by that bug

> Refer to the latest version of the Virtualization Guide to confirm the change.
> http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/

That still looks wrong, maybe better if it uses the text Chris wrote up for 19.5 in Bug 432235 comment #4

Comment 4 Chris Lalancette 2008-11-04 12:28:29 UTC
Chris C,
     I'm actually confused now; I'm not sure what the relationship between the link I read for BZ 432235 (http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/Virtualization-en-US/ch-virt-serialconsole-errors.html) and the RHEL virtualization guide in this BZ (http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Virtualization/) is.  In any case, in the virtualization guide section that this BZ talks about, we can use the same writeup I did for 432235 to fix it up; just look at Comment #4 over there, and use that text to replace 29.6, 29.7, 29.8 in *this* guide.

Chris Lalancette

Comment 5 Christopher Curran 2009-01-19 06:25:18 UTC
Worked through my backlog. This bug wasn't actually assigned to me but it should be.

http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5/html/Virtualization/sect-Virtualization-How_To_troubleshoot_Red_Hat_Virtualization-Troubleshooting_with_serial_consoles.html

This bug should be fixed now. A bit of an issue with linking it seems.


Note You need to log in before you can comment on or make changes to this bug.