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 1446098

Summary: [RFE] [6.3] The "Using Download Policies" section lacks detail
Product: Red Hat Satellite Reporter: Stephen Wadeley <swadeley>
Component: Docs Server Administration GuideAssignee: Stephen Wadeley <swadeley>
Status: CLOSED NEXTRELEASE QA Contact: Russell Dickenson <rdickens>
Severity: medium Docs Contact:
Priority: medium    
Version: 6.2.0CC: adahms, jsherril
Target Milestone: UnspecifiedKeywords: FutureFeature
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: 2017-08-07 01:24:53 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:
Bug Depends On:    
Bug Blocks: 1486095    

Description Stephen Wadeley 2017-04-27 09:16:57 UTC
Document URL: 

https://access.redhat.com/documentation/en-us/red_hat_satellite/6.2/html/content_management_guide/importing_red_hat_content#Importing_Red_Hat_Content-Using_Download_Policies

Section Number and Name: 

4.4. Using Download Policies

Describe the issue: 

If a repository is set to "on demand" it should only download an RPM when required, regardless of the repository location. The repositories in Satellite Server are, I believe, handled by the integrated Capsule. The download policies are described in "Using Download Policies", but it does not make these points clear. 


Suggestions for improvement: 

Confirm with engineering that repos are handled by Capsule, integrated or isolated. Add more detail to the section to explain this and also mention, or qualify statements, for the case where you have configured the isolated Capsule not to have the Pulp database to store repos.

Also confirm that if "on demand" repo in integrated Capsule is asked for an RPM by host1 via Capsule1, the RPM will not be pushed to Capsule2 just because it has the same repo.

Additional information: 

https://access.redhat.com/discussions/3015961

Comment 1 Andrew Dahms 2017-07-27 11:43:50 UTC
Assigning to Stephen for review.

Comment 2 Justin Sherrill 2017-08-02 14:53:03 UTC
Hey Stephen, 

Let me describe the feature a bit and hopefully answer your questions.

For the Satellite there are three Download Policies  (Immediate, Background, On demand).  I wouldn't worry about thinking about an 'internal capsule' as it will only confuse things, just think about the satellite as a whole.  For an on demand repo, the packages in that repo can be added to content views and promoted around to lifecycle environments.  Any packages in that repository (or any content view copy) are not downloaded until some client requests them from the Satellite (or through a capsule).

For Capsules there are Four Download Policies (Immediate, Background, On Demand, and Inherit).  Setting a Capsule to On Demand means that no rpm files will be downloaded by the capsule from the Satellite until a client requests them from the Capsule.  If a client does request a package from the capsule, and the satellite has not yet downloaded it, the Satellite will download it, pass it to the capsule, and the capsule will pass it to the client.  In this case the package will be saved on the Satellite and the Capsule.  If a client requests a package from the Satellite only, it will not cause it to be downloaded to the Capsule.  If a user has two external capsules and a client requests a package from Capsule A, it will not cause the package to be downloaded to Capsule B. 

The inherit setting is how Capsules behaved in 6.2.  The capsule just uses the same download policy for each repo as that on the Satellite.  If Repo A is using On Demand, then the capsule will use On Demand for Repo A.  But if Repo B is using immediate on the Satellite, the Capsule will use Immediate for Repo B and still use ON Demand for Repo A.

Keep in mind there are some combinations that do not make sense to use.  Such setting a Repository on the Satellite ot use ON Demand, but setting a Capsule's download policy to "Immediate"  This would cause all packages to be downloaded on the Satellite rendering its usage of On Demand pointless (as all package are going to be downloaded during its capsule sync)


As for your question about 'for the case where you have configured the isolated Capsule not to have the Pulp database to store repos.'  I assume this is the case where you install a capsule, but tell the installer to not install pulp at all?  In that case there is no content on the capsule and you cannot sync content to the capsule, so none of this information is relevant. 

Let me know if there are any additional questions! (Hopefully i didn't confuse you more)

Comment 3 Stephen Wadeley 2017-08-03 12:36:38 UTC
(In reply to Justin Sherrill from comment #2)

Thank you Justin

I am expanded that section to two lists, one for Satellite and one for Capsule, and adding your new info.

> As for your question about 'for the case where you have configured the
> isolated Capsule not to have the Pulp database to store repos.'  I assume
> this is the case where you install a capsule, but tell the installer to not
> install pulp at all?  In that case there is no content on the capsule and
> you cannot sync content to the capsule, so none of this information is
> relevant. 
> 

IIRC, this is the flag that could be used to control if a Capsule is a "content" proxy using Pulp

--[no-]enable-foreman-proxy-plugin-pulp Enable 'foreman_proxy_plugin_pulp' puppet module (default: true)


I think it will be enough if at the end of the update section I say:

These policies will not be available if a Capsule was installed or updated with `--enable-foreman-proxy-plugin-pulp` set to false.


Thank you

Comment 8 Andrew Dahms 2017-08-07 01:24:53 UTC
This request has now been addressed.

Closing.