Bug 462953

This would be part of the image build process/tree build process in anaconda/pungi.

Switching Severity from Urgent to High.  Urgent should be reserved for problems that need to be fixed asynch.

You'd want to get this done in Fedora land first, so that it is already working when we move to RHEL 6.

(In reply to comment #7)
> ------- Comment From jkeating 2008-10-28 18:23:43 EDT-------
> You'd want to get this done in Fedora land first, so that it is already working
> when we move to RHEL 6.

We're fine with bringing this into RHEL6 via Fedora. However, currently there is no official Fedora build for s390. Anyway, as mentioned by notting it's just about taking the example "redhat.exec" [http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Installation_Guide/s1-s390-steps-vm.html] and bringing it into the image build process/tree build process in
anaconda/pungi. Also, this is code which is not executed as part of Fedora/RHEL itself but inside the z/VM operating system CMS. I.e. it won't break anything inside Fedora/RHEL. I suppose David Cantrell or others could easily bring this into the anaconda.git and reference the exec-script correspondingly in the (anaconda) build process, such that it will finally reside in images/redhat.exec on the ISOs.

Thanks a lot for your support.

Would adding this as 'redhat.exec' on the install media be sufficient:

/* */
'CL RDR'
'PURGE RDR ALL'
'SPOOL PUNCH * RDR'
'PUNCH KERNEL IMG A (NOH'
'PUNCH GENERIC PRM A (NOH'
'PUNCH INITRD IMG A (NOH'
'CH RDR ALL KEEP NOHOLD'
'I 00C'

I took that from the documentation, but changed the PARM line to reference GENERIC PRM since that's the file we provide on the install media.

Hello David,

good idea.

Please DO NOT FORGET to update the DOCUMENTATION
http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Installation_Guide/s1-s390-steps-vm.html
, that is, the Installation Guide with the needed changes:
- Ftp Commands
- redhat.exec contents and explaining that one is available in the DVD (see ftp commands), and that is needed to start the installation
- And at the end of the page, where the "Create an executable script containing the commands necessary to IPL the kernel image and start the installation. The following sample script is a typical initial start-up script:" should probably be changed by something like "Download from DVD (as mentioned by ftp commands) or create an executable script...."

Please provide us a draft of the new page ASAP so that we can review and make any possible changes in time.

Thank you,
Gonzalo Muelas Serrano.

Hi David,

(In reply to comment #9)
> ------- Comment From dcantrell 2008-10-30 17:11:54 EDT-------
> Would adding this as 'redhat.exec' on the install media be sufficient:
>
> /* */
> 'CL RDR'
> 'PURGE RDR ALL'
> 'SPOOL PUNCH * RDR'
> 'PUNCH KERNEL IMG A (NOH'
> 'PUNCH GENERIC PRM A (NOH'
> 'PUNCH INITRD IMG A (NOH'
> 'CH RDR ALL KEEP NOHOLD'
> 'I 00C'
>
> I took that from the documentation, but changed the PARM line to reference
> GENERIC PRM since that's the file we provide on the install media.

Please make sure that the used filenames match the instructions on how to get the files onto the CMS A disk using the CMS FTP client in the Installation Guide [1]. It all relies on the fact that all files referenced by redhat.exec have been downloaded by the user to the CMS A disk with the names mentioned in your documentation. Since the doc used to instruct a customer to download generic.prm as redhat.parm to the CMS A disk
"get generic.prm redhat.parm (repl"
I would stick to this in order to keep the existing renaming behavior, customers might already be familiar with.

As Gonzalo already mentioned, right after this FTP command (and before the quit), the user should be instructed to download the redhat.exec (must be in ascii mode which is the case at this step).

Steffen

[1] http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.2/html/Installation_Guide/s1-s390-steps-vm.html

Regarding comment 6, we are a long ways off from the documentation stage in the schedule and we would need to wait for the feature to be approved.  If IBM has proposed text, please provide it so the docs person can review.

Regarding comment 8, since the feature is not yet approved, we do not know how Red Hat will finally implement it (in case it gets approved), and as a result, any text we provide could be wrong and confusing. 

To avoid confusion, we have provided the parts in documentation where we think it could be probable a change, but the developer implementing this feature together with Red Hat documentation editor, should most likely decide the text, and if you want IBM to review it, we will be happy to do it.

(In reply to comment #7)
> Hi David,
> 
> (In reply to comment #9)
> > ------- Comment From dcantrell 2008-10-30 17:11:54 EDT-------
> > Would adding this as 'redhat.exec' on the install media be sufficient:
> >
> > /* */
> > 'CL RDR'
> > 'PURGE RDR ALL'
> > 'SPOOL PUNCH * RDR'
> > 'PUNCH KERNEL IMG A (NOH'
> > 'PUNCH GENERIC PRM A (NOH'
> > 'PUNCH INITRD IMG A (NOH'
> > 'CH RDR ALL KEEP NOHOLD'
> > 'I 00C'
> >
> > I took that from the documentation, but changed the PARM line to reference
> > GENERIC PRM since that's the file we provide on the install media.
> 
> Please make sure that the used filenames match the instructions on how to get
> the files onto the CMS A disk using the CMS FTP client in the Installation
> Guide [1]. It all relies on the fact that all files referenced by redhat.exec
> have been downloaded by the user to the CMS A disk with the names mentioned in
> your documentation. Since the doc used to instruct a customer to download
> generic.prm as redhat.parm to the CMS A disk
> "get generic.prm redhat.parm (repl"
> I would stick to this in order to keep the existing renaming behavior,
> customers might already be familiar with.

Ahh, right.  I did not see the line that tells users to download generic.prm as redhat.parm using:

    get generic.prm redhat.parm (repl

How about this for the redhat.exec script:

    /* */
    'CL RDR'
    'PURGE RDR ALL'
    'SPOOL PUNCH * RDR'
    'PUNCH KERNEL IMG A (NOH'
    'PUNCH REDHAT PARM A (NOH'
    'PUNCH INITRD IMG A (NOH'
    'CH RDR ALL KEEP NOHOLD'
    'I 00C'

> As Gonzalo already mentioned, right after this FTP command (and before the
> quit), the user should be instructed to download the redhat.exec (must be in
> ascii mode which is the case at this step).

Right, definitely need to update the installer guide for this improvement.

jjarvis, is Bugzilla the correct way for us to track updates that need to made to the documentation?  If not, can we make sure that this is on the doc team's work list for the RHEL 6 install guide and then close out this bug?  I'm just going to commit this change to the rawhide anaconda, so it'll be in Fedora and present once we branch for rhel6 development.

Unfortunately while it isn't optimal, it is the only tool we have to track doc changes.  I am setting the release note flag to track this change needs to go into install guide.

(In reply to comment #14)
> ------- Comment From dcantrell 2008-10-31 16:53:03 EDT-------
> How about this for the redhat.exec script:
>
> /* */
> 'CL RDR'
> 'PURGE RDR ALL'
> 'SPOOL PUNCH * RDR'
> 'PUNCH KERNEL IMG A (NOH'
> 'PUNCH REDHAT PARM A (NOH'
> 'PUNCH INITRD IMG A (NOH'
> 'CH RDR ALL KEEP NOHOLD'
> 'I 00C'

Looks good. Thanks.

Marking this bug as MODIFIED.  I have added the sample exec script to the upstream anaconda code repository.  Anyone is free to check out the repo and see that the script is there:

    git clone git://git.fedorahosted.org/git/anaconda.git

The sample exec script is anaconda/bootdisk/s390x/redhat.exec

The things left to do for this request:

1) Update installation documentation to reflect the fact that we are providing redhat.exec in the images/ subdirectory on the install media for s390x.

2) Verify that RHEL 6 media contains images/redhat.exec with the contents listed in comment #12.

does this one need to be documented as a known issue in 6.0beta1?

------- Comment From MAIER.com 2010-02-11 08:57 EDT-------
(In reply to comment #19)
> does this one need to be documented as a known issue in 6.0beta1?

I'm not sure what you mean by documenting as issue. To the best of my knowledge there is no issue. This is an additional feature making the installation of RHEL6 under z/VM easier for users. In order for the users to even know about this new possibility, we requested to update the installation guide since that is the best fit for documenting this new feature. The install guide needs a major rework anyway because of all the changes that came in via upstream fedora. Gonzalo has already pointed out the install guide hits in LTC bug 48079 comment 10 / RH bug 462953 comment 6. In the following, I try to mark the additions/modifications by a + or - sign in the first column (unified diff like) based on fragments copied from http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.4/html/Installation_Guide/s1-s390-steps-vm.html, which seems the latest install guide version I could find. The proposed modifications are just a rough minimum set and may not be complete. You know your install guide better than we do.

FTP to the machine containing the boot images (kernel.img and initrd.img), log in, and execute the following commands (use the (repl option if you are overwriting existing kernel.img and initrd.img image files):
* cd /location/of/boot/images/
* locsite fix 80
* bin
* get kernel.img (repl
* get initrd.img (repl
* ascii
* get generic.prm redhat.parm (repl
+    * get redhat.exec (repl
* quit

...

-Example redhat.exec file:
+This is the content of the downloaded redhat.exec file:

...

-Create an executable script
+You may use the downloaded executable script redhat.exec
containing the commands necessary to IPL the kernel image and start the installation.
+After having IPLed CMS, enter "redhat" on the 3270 console and press the enter key,
+in order to execute this script.
-The following sample script is a typical initial start-up script:
-/* */ 'CL RDR' 'PURGE RDR ALL' 'SPOOL PUNCH * RDR' 'PUNCH KERNEL IMG A (NOH'
-'PUNCH REDHAT PARM A (NOH' 'PUNCH INITRD IMG A (NOH'
-'CH RDR ALL KEEP NOHOLD' 'IPL 00C CLEAR'

If for any reason an install guide update would not be possible at all, I guess the best place to mention this feature would be the release notes. In the best case with the release notes that ship with the install media DVD. In the worst case with the online release notes.
Independent of this feature all other existing methods to install RHEL6 are unaffected and remain working as is.

(In reply to comment #15)
> does this one need to be documented as a known issue in 6.0beta1?    

If you look at comment #13, I mention that we should update the RHEL installation documentation to note that we are including the redhat.exec script.  Previous versions of RHEL had the install documentation for s390x telling users to create this file by hand, which does not make sense if we are including that file on the install media.

This BZ has been cloned to Bug 580631 to track the Install Guide change. Removing Relnote flag here.

Hello IBM,
were you able to test this feature with any recent snapshot of RHEL6.0?
I would like to make sure you accept implementation of this feature.
Thank you for your feedback.

------- Comment From mgrf.com 2010-06-24 03:23 EDT-------
This feature is verified on R6 snapshots
Set feature to "verified"  Thx.

Also the install guide is corrected - see
"chapter 16.1.1 Using the z/VM Reader"

Thank you for feedback, moving to VERIFIED.

Red Hat Enterprise Linux Beta 2 is now available and should resolve
the problem described in this bug report. This report is therefore being closed
with a resolution of CURRENTRELEASE. You may reopen this bug report if the
solution does not work for you.