Description of problem: In Satellite 5.6 installation guide, section 7.6 Implementing PAM Authentication, there is no warning that upgrading from Satellite 5.5 to 5.6 will remove the pam_auth_service setting from /etc/rhn/rhn.conf This caught me and Red Hat consultant Andrew Nelson (anelson@) by surprise when we upgrade Satellite 5.5 to 5.6 , when I not able to login to the Satellite after upgrading, using PAM password This issue was actually documented here: https://access.redhat.com/site/solutions/506363 but, it would be better if a warning was visible in the documentation, so that user can take corrective action right after upgrade. Version-Release number of selected component (if applicable): Edition 1 How reproducible: Always Steps to Reproduce: 1. Open Red Hat Satellite 5.6 installation guide PDF document. 2. Go to page 66, section 7.6 3. There are no warning that upgrading from 5.5 to 5.6 will remove PAM setting Actual results: Cannot login to Satellite after upgrading. Documentation does not warn about the removal of pam_auth_service, and what is the corrective action that user should take. Expected results: There are visible warning that the setting is removed, and what user should do to restore the setting Additional info:
This is expected behaviour. Within the Upgrade documentation we note that you need to restore customizations made to rhn.conf as part of the upgrade process. Example, within the satellite-upgrade-postgresql.txt file, provided within the Upgrade documentation, shipped within the rhn-upgrade package, we state: 132 7. Verify /etc/rhn/rhn.conf settings. 133 134 A backup copy of rhn.conf and other configuration files were copied to 135 /etc/sysconfig/rhn/backup-$DATE-$TIME. Referring to the backup copy of 136 the rhn.conf file, please ensure that any previous custom values are set 137 in the new Red Hat Satellite's /etc/rhn/rhn.conf file, such as: 138 139 debug = 3 140 pam_auth_service = rhn-satellite 141 Regards, Cliff
Additionally, the upgrade information listed in the Satellite docs is an Overview, it is NOT detailed instructions. As noted within top of section 6.2: https://access.redhat.com/site/documentation/en-US/Red_Hat_Satellite/5.6/html/Installation_Guide/sect-Installation_Guide-Upgrades-Procedure.html "Important The following is a basic procedure for upgrading Red Hat Satellite to version 5.6. For comprehensive instructions, see the /etc/sysconfig/rhn/satellite-upgrade/README file in the rhn-upgrade package. " If this is causing to much confusion, it would be my preference to remove ALL overview details and force users to READ and follow the rhn-upgrade instructions. Cliff
I don't have any problem if the overview is removed. But, people read the PDF, not the text file to get the necessary information, and they expect to get all the information from the PDF. If the detail information is in the text file, then the text file should be able to be downloaded from somewhere, without having to download rhn-upgrade package. Red Hat documentation website did not have these text file Help the user, not make them suffer by having to jumps several hoops to get the necessary information
Moving to 'NEW' and the default assignee to be triaged as the schedule allows.