Bugzilla will be upgraded to version 5.0. The upgrade date is tentatively scheduled for 2 December 2018, pending final testing and feedback.
Bug 1446098 - [RFE] [6.3] The "Using Download Policies" section lacks detail
[RFE] [6.3] The "Using Download Policies" section lacks detail
Status: CLOSED NEXTRELEASE
Product: Red Hat Satellite 6
Classification: Red Hat
Component: Docs Server Administration Guide (Show other bugs)
6.2.0
Unspecified Unspecified
medium Severity medium (vote)
: Beta
: Unused
Assigned To: Stephen Wadeley
Russell Dickenson
: FutureFeature
Depends On:
Blocks: 1486095
  Show dependency treegraph
 
Reported: 2017-04-27 05:16 EDT by Stephen Wadeley
Modified: 2018-08-31 11 EDT (History)
2 users (show)

See Also:
Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
Environment:
Last Closed: 2017-08-06 21:24:53 EDT
Type: Bug
Regression: ---
Mount Type: ---
Documentation: ---
CRM:
Verified Versions:
Category: ---
oVirt Team: ---
RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: ---


Attachments (Terms of Use)

  None (edit)
Description Stephen Wadeley 2017-04-27 05:16:57 EDT
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 07:43:50 EDT
Assigning to Stephen for review.
Comment 2 Justin Sherrill 2017-08-02 10:53:03 EDT
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 08:36:38 EDT
(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-06 21:24:53 EDT
This request has now been addressed.

Closing.

Note You need to log in before you can comment on or make changes to this bug.