Red Hat Bugzilla – Bug 1265519
Reference for all installation options of both katello-installer and capsule-installer
Last modified: 2015-11-23 08:36:20 EST
Section Number and Name:
Describe the issue:
katello-installer and capsule-installer both have an intimidating and ever growing list of installation options. There should be a reference section on all these options. What do they mean? How do they interact?
Suggestions for improvement:
Create an appendix in the installation guide and create a full reference for all these installation options.
I agree the list of options is long and at first view a lot to take in. In the product doc we attempt to keep the list of options to those required for a typical installation (if there is such a thing :) )
Are you requesting that we include the output of (e.g.), katello-installer --help in the formal docs, as an appendix?
We generally don't include this type of information because:
a) it's available in its current form
b) changes to the command and its options are *usually* quickly reflected in the help pages
c) it's a lot of overhead to reproduce and keep up-to-date in the product docs
If there is more or different information that you'd like to see, that's not currently available, please let us know.
Yeah, well ok. It's just that the help text if pretty short. And the different documented scenario's do not cover *all* options. It was something a customer was wondering (where is the reference on all these options?).
Granted, the help text can be brief, and we don't document all possible scenarios or options, we just don't have the resources.
If there are specifics that customers regular raise then I'm sure it make a bright spot on our radar, and either Hayley or Andrew will schedule something as soon as possible.
Thanks for the feedback.