| Summary: | Documentation needs correction for installing Satellite from offline repositories | |||
|---|---|---|---|---|
| Product: | Red Hat Satellite | Reporter: | hprakash | |
| Component: | Docs Install Guide | Assignee: | Lucie Jirakova <ljirakov> | |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Russell Dickenson <rdickens> | |
| Severity: | medium | Docs Contact: | ||
| Priority: | high | |||
| Version: | 6.2.0 | CC: | adahms, bbuckingham, bkearney, chrobert, rdickens, rigo.sanchez, rjerrido, sghai | |
| Target Milestone: | Unspecified | Keywords: | Triaged | |
| Target Release: | Unused | |||
| Hardware: | Unspecified | |||
| OS: | Unspecified | |||
| Whiteboard: | ||||
| Fixed In Version: | Doc Type: | If docs needed, set a value | ||
| Doc Text: | Story Points: | --- | ||
| Clone Of: | ||||
| : | 1386677 (view as bug list) | Environment: | ||
| Last Closed: | 2016-12-21 11:28:57 UTC | Type: | Bug | |
| Regression: | --- | Mount Type: | --- | |
| Documentation: | --- | CRM: | ||
| Verified Versions: | Category: | --- | ||
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | ||
| Cloudforms Team: | --- | Target Upstream Version: | ||
| Bug Depends On: | 1386677 | |||
| Bug Blocks: | ||||
Note: it appears that there are changes going out with bug 1370311 to address at least the foreman-installer vs satellite-installer naming for #3. Assigning to Lucie for review. Lucie - for this, we may need to run through the procedure from top to bottom and check the steps. Based on the current procedure in the guides, it looks like some of these issues may already have been resolved, but it would be good to check and see if this is case. Let me know if you run into any blockers! I have similar issues on the same enbvironment.
Error: Package: tfm-rubygem-qpid_messaging-0.30.0-7.el7sat.x86_64 (InstallMedia_1)
Requires: libqpidtypes.so.2()(64bit)
Which the required package is not included on any of the isos as it is an older package version.
Hello Rigo Can you download and install [1] the package OK? ~]# yum provides 'libqpidtypes.so.2()(64bit)' Loaded plugins: package_upload, product-id, search-disabled-repos, subscription-manager rhel-7-server-rpms rhel-7-server-satellite-6.2-rpms rhel-7-server-satellite-tools-6.2-rpms rhel-server-rhscl-7-rpms qpid-cpp-client-0.30-11.el7sat.x86_64 : Libraries for Qpid C++ client applications Repo : rhel-7-server-satellite-6.2-rpms Matched from: Provides : libqpidtypes.so.2()(64bit) [1] e.g.: https://access.redhat.com/solutions/184433 Satellite 6.2.2 installed successfully using 6.2.2 iso + rhel7.3 iso. Please see https://bugzilla.redhat.com/show_bug.cgi?id=1386677#c6 So here are the test results from QE: 1. sat6.2.4 iso + rhel7.3 iso - success, no deps issue 2. sat6.2.2 iso + rhel7.3 iso - success, no deps issue 3. sat6.2.2 iso + rhel7.2 iso - dependency issue[1] with selinux-policy 4. sat6.1.9 iso + rhel7.3 iso - success, no deps issue 5. sat6.1.9 iso + rhel7.2 iso - dependency issue[2] with selinux-policy [1] https://bugzilla.redhat.com/show_bug.cgi?id=1386677#c7 [2] https://bugzilla.redhat.com/show_bug.cgi?id=1351936#c9 I am going to close/wontfix the bugs which Sachin linked to. I will cite this bug as an upcoming update to the docs. Sum up as per comment 0 and the current status of the Installation Guide: Issue 1 & 2: Package dependency errors due to missing packages on RHEL ISO. Status: This has been partly resolved within https://bugzilla.redhat.com/show_bug.cgi?id=1351936 (added new paragraph advising users that dependency errors need to be resolved manually). I have a) made the mentioned paragraph more prominent by transforming it to admonition (Note), b) added a sentence with this info directly after the step 4. (running the installer script) so that users get advice at this very point, should the script fail due to the missing packages. Issue 3: Sentence "Install is complete. Please run foreman-installer --scenario katello" should actually say: "satellite-installer --scenario satellite". Status: Fixed, no mention of "scenario katello" anywhere in docs. Issue 4: Instruction to unmount ISO in step 5 of https://access.redhat.com/documentation/en/red-hat-satellite/6.2/single/installation-guide#configuring_the_base_system_with_offline_repositories is incorrect. Status: Fixed. In current documentation, step 5 to unmount ISO is not in the linked chapter, 3.2.2, but in the following one, 3.2.3, as the very last step of the procedure, which is the correct place for it. Changing the QA contact to Russell because Stephen is away on PTO. Russell - would you be able to take a look at the changes for this bug? The procedure has been updated as per comment 16 and the change is now live on customer portal. |
Description of problem: Installation of Satellite from the Offline Repositories throws errors/invalid usage help. Customer reported to have the below error: 1- After downloading, copying & mounting the rhel7-server & satellite6 binary iso images to the server while executing the "./install_packages" script, it complained about the following packages: "selinux-policy-3.13.1-60.el7_2.3.noarch.rpm" "selinux-policy-targeted-3.13.1-60.el7_2.3.noarch.rpm" These could not be installed as a requirement because, these version do not exists on the rhel 7.2 iso. Customer downloaded the required packages and installed them, then executed the "./install_packages" script, which executed without issues this time. 2- However when we(in our test environment) tried to replicate the above(#1) we got another error- [root@dhcp4-11 sat6]# ./install_packages This script will install the satellite packages on the current machine. - Ensuring we are in an expected directory. - Copying installation files. - Creating a Repository File - Creating RHSCL Repository File - Checking to see if Katello is already installed. - Importing the gpg key. Error: Package: glibc-2.17-105.el7.i686 (InstallMedia) Requires: glibc-common = 2.17-105.el7 Installed: glibc-common-2.17-106.el7_2.6.x86_64 (@anaconda/7.2) glibc-common = 2.17-106.el7_2.6 Available: glibc-common-2.17-105.el7.x86_64 (InstallMedia) glibc-common = 2.17-105.el7 Error: Package: cyrus-sasl-2.1.26-19.2.el7.x86_64 (InstallMedia) Requires: cyrus-sasl-lib(x86-64) = 2.1.26-19.2.el7 Installed: cyrus-sasl-lib-2.1.26-20.el7_2.x86_64 (@anaconda/7.2) cyrus-sasl-lib(x86-64) = 2.1.26-20.el7_2 Available: cyrus-sasl-lib-2.1.26-19.2.el7.x86_64 (InstallMedia) cyrus-sasl-lib(x86-64) = 2.1.26-19.2.el7 Error: Package: cyrus-sasl-md5-2.1.26-19.2.el7.x86_64 (InstallMedia) Requires: cyrus-sasl-lib(x86-64) = 2.1.26-19.2.el7 Installed: cyrus-sasl-lib-2.1.26-20.el7_2.x86_64 (@anaconda/7.2) cyrus-sasl-lib(x86-64) = 2.1.26-20.el7_2 Available: cyrus-sasl-lib-2.1.26-19.2.el7.x86_64 (InstallMedia) cyrus-sasl-lib(x86-64) = 2.1.26-19.2.el7 Error: Package: gnutls-utils-3.3.8-12.el7_1.1.x86_64 (InstallMedia) Requires: gnutls(x86-64) = 3.3.8-12.el7_1.1 Installed: gnutls-3.3.8-14.el7_2.x86_64 (@anaconda/7.2) gnutls(x86-64) = 3.3.8-14.el7_2 Available: gnutls-3.3.8-12.el7_1.1.x86_64 (InstallMedia) gnutls(x86-64) = 3.3.8-12.el7_1.1 Error: Package: cyrus-sasl-plain-2.1.26-19.2.el7.x86_64 (InstallMedia) Requires: cyrus-sasl-lib(x86-64) = 2.1.26-19.2.el7 Installed: cyrus-sasl-lib-2.1.26-20.el7_2.x86_64 (@anaconda/7.2) cyrus-sasl-lib(x86-64) = 2.1.26-20.el7_2 Available: cyrus-sasl-lib-2.1.26-19.2.el7.x86_64 (InstallMedia) cyrus-sasl-lib(x86-64) = 2.1.26-19.2.el7 Error: Package: gnutls-dane-3.3.8-12.el7_1.1.x86_64 (InstallMedia) Requires: gnutls(x86-64) = 3.3.8-12.el7_1.1 Installed: gnutls-3.3.8-14.el7_2.x86_64 (@anaconda/7.2) gnutls(x86-64) = 3.3.8-14.el7_2 Available: gnutls-3.3.8-12.el7_1.1.x86_64 (InstallMedia) gnutls(x86-64) = 3.3.8-12.el7_1.1 Error while executing command: 'yum install -y satellite' 3- After troubleshooting above errors ./install_packages script succesfully completed, it says- "Install is complete. Please run foreman-installer --scenario katello" This is incorrect usage, the conrrect command should be- satellite-installer --scenario satellite 4- Then customer unmounted the iso files according to step 5(of https://access.redhat.com/documentation/en/red-hat-satellite/6.2/single/installation-guide#configuring_the_base_system_with_offline_repositories): "# unmount /media/sat6" "# unmount /media/rhelX-server" and executed the following command to install satellite: "foreman-installer --scenario satellite -v \ --foreman-initial-organization "belastingdienst" \ --foreman-initial-location "bilab" \ --foreman-admin-password password \ --foreman-proxy-tftp true" This fails because for the option "foreman-proxy-tftp true" requires package "tftp-server" to be available, but because the iso is not mounted, it cannot install the package. So, for above #1 and #2 if the mentioned packages are not available in the iso then document should state to download it explicitly. For #3 install_package script should tell the right command to be executed. And for #4 unmount should be after running satellite-installer. ---------------------------------------- Version-Release number of selected component (if applicable): How reproducible: Steps to Reproduce: 1. 2. 3. Actual results: Expected results: Additional info: