Bug 237911

Summary: Additional information required for installing on zseries lpar
Product: Red Hat Enterprise Linux 4 Reporter: Norm Murray <nmurray>
Component: Installation_GuideAssignee: Ryan Lerch <rlerch>
Status: CLOSED CURRENTRELEASE QA Contact: Michael Hideo <mhideo>
Severity: medium Docs Contact:
Priority: medium    
Version: 4.4CC: anross, ddomingo, tao
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2009-11-13 01:31:07 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Wade Mealing 2007-04-26 01:11:28 UTC
Description of problem:

Installing on an LPAR with many devices requires special considerations to
ensure that the system does not run out of memory. Partners request that
additional information be added to the Installation guide specificlly for LPAR
devices.

This information could possibly fit in:

Chapter 1 first page as one of the
"Steps to Get You Started".

And then maybe repeat in either Appendix D "Troubleshooting Your Installation of
Red Hat Enterprise" - D.1 "You are Unable to Boot Red Hat Enterprise Linux" or
Appendix F "Additional Information for S/390 and zSeries Users" under a new
subchapter. 

Additional info to be appended: (Please read through this for spelling or
gramatical errors):


===========================================
When installing Linux in an LPAR, steps should be taken to ensure that only the
devices that are used by the RHEL system are visible to the kernel.

When Red Hat Enterprise Linux runs in in LPAR, it attempts to acquire
information about all devices granted to the LPAR, this may result
in an out-of-memory condition, but can be worked around with the cio_ignore
parameter to the zipl. Setting the cio_ignore parameter creates a black list and
prevents the kernel from creating data structures for all devices defined in the
IOCDS.

These can be either passed at boot time interactively as paramters to zipl or
made more persistant by being set in /etc/zipl.conf file.


Interactively
-------------

To set the cio_parameter from the interactive menu, it should appear in the
format below:

       cio_ignore=all,]0.0.1300-0.0.1302,]0.0.343d,]0.0.3633

The right square bracket is interpreted as a logical NOT on the interactive
command line


Persistantly
------------

After booting the system, these parameters can be made permanent by modifying
the /etc/zipl.conf to include the cio_ignore option on the parameter line in the
[ipl] section.

Run the zipl command to make the changes to the /etc/zipl.conf take effect at
tne next reboot.

The cio_ignore option differs subtly from the interactive options, the right
square bracket is not used and the exclamation point is interpreted as a logical
NOT.

Comment 1 Don Domingo 2007-04-26 04:01:20 UTC
Wade,

can you provide me with a link to the page where you would like this content to
appear in? just so i can verify which of the pre-install XMLs i should be
working on.

thanks!

Comment 9 Don Domingo 2007-04-26 23:26:06 UTC
reassigning this bug to mhideo

Mike, please rebuild the RHEL4.5 Installation_Guide (i think module name
Installation_Guide_450) and have it staged to the docs page of the website.

will hand you the RHEL

Comment 15 RHEL Program Management 2007-06-09 13:24:38 UTC
This request was evaluated by Red Hat Product Management for inclusion in a Red
Hat Enterprise Linux maintenance release.  Product Management has requested
further review of this request by Red Hat Engineering, for potential
inclusion in a Red Hat Enterprise Linux Update release for currently deployed
products.  This request is not yet committed for inclusion in an Update
release.

Comment 19 Don Domingo 2007-07-26 00:23:05 UTC
already edited in source as per Comment#12 by wmealing.

reassigning to mhideo for next step. 

Comment 25 Michael Hideo 2007-10-23 02:48:49 UTC
Removing automation notification

Comment 26 Issue Tracker 2007-10-23 19:55:28 UTC
----- Additional Comments From markver.com  2007-10-23 14:55 EDT
-------
There's nothing on https://www.redhat.com/docs/manuals/enterprise/ with a
Sept
2007  date or later.  Where can we find the updated documentation. 


This event sent from IssueTracker by jkachuck 
 issue 118985

Comment 34 Andrew Ross 2009-11-13 01:31:07 UTC
Closed by Issue tracker.