Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 2222893

Summary: [Documentation Bug] - package dependencies can cause significant delays to Content View promotion
Product: Red Hat Satellite Reporter: Dhaval Joshi <dhjoshi>
Component: Content ViewsAssignee: Aneta Šteflová Petrová <apetrova>
Status: CLOSED CURRENTRELEASE QA Contact: Satellite QE Team <sat-qe-bz-list>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 6.13.2CC: bangelic, iballou, sajha, saydas
Target Milestone: UnspecifiedKeywords: Documentation, 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: Environment:
Last Closed: 2023-12-01 12:33: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:
Embargoed:

Description Dhaval Joshi 2023-07-14 11:30:06 UTC
Document URL: 
https://access.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/managing_content/index#Resolving_Package_Dependencies_content-management

Section Number and Name: 
7.8. Resolving Package Dependencies

Describe the issue: 
 - The documentation mentions "Note that resolving package dependencies can cause significant delays to Content View promotion"

 
Suggestions for improvement:
 - The content view publish task takes a lot of time as compared to promotion. The CV promote tasks are quicker as compared to the CV publish.

I suggest the below correction:

"Note that resolving package dependencies can cause significant delays in Content View publish tasks"


Additional information:

Red Hat Satellite 6.11, 6.12, and 6.13 documentation mention the same thing.

Satellite 6.12 - https://access.redhat.com/documentation/en-us/red_hat_satellite/6.12/html-single/managing_content/index#Resolving_Package_Dependencies_content-management

Satellite 6.11 - https://access.redhat.com/documentation/en-us/red_hat_satellite/6.11/html-single/managing_content/index#Resolving_Package_Dependencies_content-management

Comment 1 Sayan Das 2023-07-14 11:35:02 UTC
To add on. 

It's not just the Dep-Solving that is a costly operation. But even without dep-solving enabled, a publish task with few exclude or include filters can prove to be costly 

Without any filters a CV publish would take about a min or three to complete. As soon as we add some ERRATA by date Exclude\INclude filter, That same task can take up to 20\30 mins to complete. 

If this is a known behavior, Then perhaps we should document this as well in the same section, just after the Dep-Solving part

Comment 2 Marie Hornickova 2023-07-19 10:18:25 UTC
Hello,
Many thanks for reporting this issue/suggestion for documentation improvement.
Important pices of information about the progress of the doc fix will be shared in this ticket as well the link to the updated documents.
Thank you!

Comment 3 Aneta Šteflová Petrová 2023-10-04 14:59:02 UTC
Just to summarize my initial investigation of the docs in question:

Since this BZ was filed, 2 pull requests have been merged that change the documentation around dependency resolution significantly.
* https://github.com/theforeman/foreman-documentation/pull/2240
* https://github.com/theforeman/foreman-documentation/pull/2300
These have been cherry-picked only down to version 3.5 (= 6.13 downstream). So while the problem most probably persists in versions 6.12 and previous, it might not be present in version 6.13 anymore.

In 6.13, the following sections cover dependency resolution:
* 7.8. Resolving Package Dependencies
* 10.5. Limitations to Repository Dependency Resolution
https://access.redhat.com/documentation/en-us/red_hat_satellite/6.13/html-single/managing_content/index#Resolving_Package_Dependencies_content-management

Next steps: Find out if the problem still exists in 6.13. If not, find out if the older versions can be updated as well. If yes, fix it in all versions.

Comment 4 Aneta Šteflová Petrová 2023-10-09 09:51:06 UTC
(In reply to Dhaval Joshi from comment #0)
> I suggest the below correction:
> 
> "Note that resolving package dependencies can cause significant delays in
> Content View publish tasks"

With the latest doc version, section 7.7. Resolving Package Dependencies states the following:

* "When incrementally adding a security errata to a Content View, dependency solving can cause significant delays to Content View publication without major benefits."
* "Significant delay in Content View publication    Satellite examines every repository in a Content View for dependencies. Therefore, publish time increases with more repositories."

Based on this, I'd say the bug reported in c#0 has been fixed in the latest version (6.13).

Comment 5 Aneta Šteflová Petrová 2023-10-09 10:06:06 UTC
Ian, was there a specific reason why your PR that initiated the updates to dependency solving was submitted only for Satellite versions 6.13 and later? https://github.com/theforeman/foreman-documentation/pull/2240

If not, can I make the same updates to versions 6.12 and 6.11 as well? I believe sections 7.7. Resolving Package Dependencies, 7.8. Enabling Dependency Solving for a Content View, and 7.1. Creating a Content View[1] would be subject to the backport.

[1] https://access.redhat.com/documentation/en-us/red_hat_satellite/6.13/html/managing_content/managing_content_views_content-management#Resolving_Package_Dependencies_content-management

Comment 6 Ian Ballou 2023-10-09 16:05:04 UTC
Aneta, there was no specific reason, we can backport it to any version of the Satellite docs.

Comment 7 Aneta Šteflová Petrová 2023-10-11 08:03:05 UTC
PR to backport the latest version of dependency solving docs into Satellite versions 6.12 and 6.11: https://github.com/theforeman/foreman-documentation/pull/2505

This doesn't resolve the issue reported in c#1. I will look into that once the backporting is taken care of.

Comment 8 Aneta Šteflová Petrová 2023-10-24 07:37:48 UTC
(In reply to Aneta Šteflová Petrová from comment #7)
> PR to backport the latest version of dependency solving docs into Satellite
> versions 6.12 and 6.11:
> https://github.com/theforeman/foreman-documentation/pull/2505

PR merged: https://github.com/theforeman/foreman-documentation/pull/2505#issuecomment-1776609940

The next step is now to investigate what else needs to be updated to fully resolve this issue.

Comment 10 Aneta Šteflová Petrová 2023-11-23 08:05:43 UTC
PR to address the remaining part of this BZ: https://github.com/theforeman/foreman-documentation/pull/2603

Comment 11 Aneta Šteflová Petrová 2023-11-28 12:33:06 UTC
PR merged: https://github.com/theforeman/foreman-documentation/pull/2603#issuecomment-1829745424