Description of problem: The iscsi and iscsiname commands are not well documented in kickstart-docs.txt. While iscsi command is show with its parameters a one line description will be helpful. For example: use this command to attach additional iscsi storage during installation. iscsiname command is not documented at all, only the command name and the fact that it's optional is present. No indication what it does or how it's supposed to be used. Version-Release number of selected component (if applicable): anaconda-11.1.2.195-1 How reproducible: always Steps to Reproduce: 1. search for iscsi in /usr/share/doc/anaconda-*/kickstart-docs.txt
Created attachment 397773 [details] Patch adding more info about iscsi cmds to kickstart-docs.txt
This is fixed in anaconda-11.1.2.212-1, moving to modified.
In anaconda-11.1.2.216-1 both commands are documented. Moving to VERIFIED.
Technical note added. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. New Contents: * Previously, the iscsi kickstart command was not documented in the kickstart-docs.txt file beyond noting its existence and its options, and the iscsiname command was not documented at all. Users had to consult documentation outside anaconda itself to learn how to use these commands. In this release, the iscsiname command is now documented, and the description of the iscsi command is expanded, reducing the requirement for users to resort to other documentation to use these commands. (BZ#525136)
Technical note updated. If any revisions are required, please edit the "Technical Notes" field accordingly. All revisions will be proofread by the Engineering Content Services team. Diffed Contents: @@ -1,8 +1,9 @@ -* Previously, the iscsi kickstart command was not documented in the +Previously, the iscsi kickstart command was not documented in the -kickstart-docs.txt file beyond noting its existence and its options, and +kickstart-docs.txt file beyond noting its existence and its options, and -the iscsiname command was not documented at all. Users had to consult +the iscsiname command and ignoredisk --onlyuse option were not documented -documentation outside anaconda itself to learn how to use these commands. +at all. Users had to consult documentation outside anaconda itself to -In this release, the iscsiname command is now documented, and the +learn how to use these commands and options. In this release, the -description of the iscsi command is expanded, reducing the requirement +iscsiname command and ignoredisk --onlyuse option are now documented, and -for users to resort to other documentation to use these commands. +the description of the iscsi command is expanded, reducing the -(BZ#525136)+requirement for users to resort to other documentation to use these +commands and options. (BZ#525136, BZ#586576)
An advisory has been issued which should help the problem described in this bug report. This report is therefore being closed with a resolution of ERRATA. For more information on therefore solution and/or where to find the updated files, please follow the link below. You may reopen this bug report if the solution does not work for you. http://rhn.redhat.com/errata/RHBA-2011-0030.html