Bug 1153650 - Content view filtering process not documented
Summary: Content view filtering process not documented
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Documentation
Version: 6.0.4
Hardware: Unspecified
OS: Unspecified
high
urgent
Target Milestone: Unspecified
Assignee: Dan Macpherson
QA Contact: Andrew Dahms
URL:
Whiteboard:
: 1290411 (view as bug list)
Depends On:
Blocks: 1122832
TreeView+ depends on / blocked
 
Reported: 2014-10-16 12:43 UTC by Peter Vreman
Modified: 2019-09-25 20:30 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-05-06 05:12:33 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 1290411 0 medium CLOSED Improve docs for Content View filters and versions 2021-02-22 00:41:40 UTC

Internal Links: 1290411

Description Peter Vreman 2014-10-16 12:43:49 UTC
Document URL: 
https://access.redhat.com/site/documentation/en-US/Red_Hat_Satellite/6.0/html/User_Guide/index.html


Section Number and Name: 
5.3. Filt ering Cont ent

Describe the issue: 

Suggestions for improvement: 
The process how Content View Filters are applied, e.g. in which order are the include and excludes processed is not documented.

E.g. what is the result of the following two rules?
- exclude errata by date from 2014-09-01
- include errate by id RHEA-2014:1355  (released on 2014-10-03)



Additional information: 
Also there is a text in the current manual "Filters are created to prevent packages from being promoted to subsequent environments." which i think is not correct anymore to the current state where you define a Content view and then publish this to Library and then promote it further through the lifecycle environments.

Comment 1 RHEL Program Management 2014-10-16 12:53:01 UTC
Since this issue was entered in Red Hat Bugzilla, the release flag has been
set to ? to ensure that it is properly evaluated for this release.

Comment 3 Athene Chan 2014-10-16 22:27:12 UTC
Hello Peter,

Thank you for the feedback!! We'll take your comments onboard and apply the changes to the documentation  on the next release of the books. We'll update this ticket when it happens.

Cheers,
Athene

Comment 4 RHEL Program Management 2015-04-21 16:09:38 UTC
Since this issue was entered in Red Hat Bugzilla, the release flag has been
set to ? to ensure that it is properly evaluated for this release.

Comment 5 David O'Brien 2015-09-01 04:59:23 UTC
Another request from GSS about CV filters so might want to pull this forward if possible.

Comment 6 jnikolak 2015-09-01 05:05:07 UTC
We have Customer Telstra, that is requesting more information in relation to content-view filters with examples.

Please see current kcs that was written with assistance from engineering
--> https://access.redhat.com/solutions/1564953

Comment 7 jnikolak 2015-09-04 08:14:26 UTC
I wanted to get clarification while working on 
--> https://access.redhat.com/solutions/1564953


Can we confirm if my understand of the below rules is correct and also the solution I posted.




Two important factors. 
- > The order does matter.
- > Includes with excludes can work as long the order is followed.



Working Filters
#####################
I'll explain why your filtering works.

-> Rule 15
Your specifying to include, only errata from RHBA-2015:1615-1 this should show  a limited number of packages.

-> Rule 40, your specifying to include all packages that don't have an errata.
You'll notice the package grow with that statement. (notice you have rpm in type!)
You can click the version number and then inside packages to see whats provided.

-> Rule 41 Since we're filtering out the python-argparse, we also add an additional rule to include it.
(Christophe reproduce this part)

-> Rule 43, This is an exclude which is filtering against already included packages. 
Thats why it works.

-> Rule 5, Your specifying by date to include all packages before a certain date 30/4
The opposite of excluding packages after a date.

-> Rule 6, your also specify to include the Tools package.


###############################################################


hammer> content-view filter list --content-view-id=5 --organization=T-Mail
----------|--------------------------------------------|---------|----------
FILTER ID | NAME                                       | TYPE    | INCLUSION
----------|--------------------------------------------|---------|----------
15        | include errata for LVM -  RHBA-2015:1615-1 | erratum | true
40        | Include packages without errata            | rpm     | true
41        | include python-argparse                    | rpm     | true
43        | restrict kernel to 504.16.2                | rpm     |
5         | RHEL SOE based 30/04/2015                  | erratum | true
42        | Satellite 6.1 Tools SOE 01/09/2015         | erratum | true
----------|--------------------------------------------|---------|----------

--------------------------------------------------------------------------------

hammer> content-view filter info --id=5 --organization=T-Mail
Filter ID:    5
Name:         RHEL SOE based 30/04/2015
Type:         erratum
Inclusion:    true
Repositories:
 1) ID:    2
    Name:  Red Hat Enterprise Linux 6 Server - Optional RPMs x86_64 6Server
    Label: Red_Hat_Enterprise_Linux_6_Server_-_Optional_RPMs_x86_64_6Server
 2) ID:    1
    Name:  Red Hat Enterprise Linux 6 Server RPMs x86_64 6Server
    Label: Red_Hat_Enterprise_Linux_6_Server_RPMs_x86_64_6Server
 3) ID:    3
    Name:  Red Hat Enterprise Linux 6 Server - Supplementary RPMs x86_64 6Server
    Label: Red_Hat_Enterprise_Linux_6_Server_-_Supplementary_RPMs_x86_64_6Server
 4) ID:    5
    Name:  Red Hat Enterprise Virtualization Agents for RHEL 6 Server RPMs x86_64 6Server
    Label: Red_Hat_Enterprise_Virtualization_Agents_for_RHEL_6_Server_RPMs_x86_64_6Server
Rules:
 1) ID:       4
    End Date: 2015-04-30T14:00:00.000Z
    Types:    security, enhancement, bugfix
    Created:  2015/08/31 05:38:32
    Updated:  2015/09/03 01:12:54


-------------------------

hammer> content-view filter info --id=15 --organization=T-Mail
Filter ID:    15
Name:         include errata for LVM -  RHBA-2015:1615-1
Type:         erratum
Inclusion:    true
Repositories:
 1) ID:    1
    Name:  Red Hat Enterprise Linux 6 Server RPMs x86_64 6Server
    Label: Red_Hat_Enterprise_Linux_6_Server_RPMs_x86_64_6Server
Rules:
 1) ID:        10
    Errata ID: RHBA-2015:1615
    Created:   2015/09/01 04:49:49
    Updated:   2015/09/01 04:49:49

---------------------------

hammer> content-view filter info --id=40 --organization=T-Mail
Filter ID:    40
Name:         Include packages without errata
Type:         rpm
Inclusion:    true
Repositories:

Rules:


-----------------------------

hammer> content-view filter info --id=41 --organization=T-Mail
Filter ID:    41
Name:         include python-argparse
Type:         rpm
Inclusion:    true
Repositories:
 1) ID:    1
    Name:  Red Hat Enterprise Linux 6 Server RPMs x86_64 6Server
    Label: Red_Hat_Enterprise_Linux_6_Server_RPMs_x86_64_6Server
Rules:
 1) ID:      10
    Name:    python-argparse
    Created: 2015/09/03 01:38:11
    Updated: 2015/09/03 01:38:11


-----------------------------

hammer> content-view filter info --id=42 --organization=T-Mail
Filter ID:    42
Name:         Satellite 6.1 Tools SOE 01/09/2015
Type:         erratum
Inclusion:    true
Repositories:
 1) ID:    6
    Name:  Red Hat Satellite Tools 6.1 for RHEL 6 Server RPMs x86_64
    Label: Red_Hat_Satellite_Tools_6_1_for_RHEL_6_Server_RPMs_x86_64
Rules:
 1) ID:       28
    End Date: 2015-08-30T16:00:00.000Z
    Types:    security, enhancement, bugfix
    Created:  2015/09/03 01:10:58
    Updated:  2015/09/03 01:11:36

--------------------------------

hammer> content-view filter info --id=43 --organization=T-Mail
Filter ID:    43
Name:         restrict kernel to 504.16.2
Type:         rpm
Inclusion:    false
Repositories:
 1) ID:    1
    Name:  Red Hat Enterprise Linux 6 Server RPMs x86_64 6Server
    Label: Red_Hat_Enterprise_Linux_6_Server_RPMs_x86_64_6Server
Rules:
 1) ID:              9
    Name:            kernel*
    Minimum Version: 2.6.32-504.23.4*
    Created:         2015/09/03 01:16:49
    Updated:         2015/09/03 01:16:49
-----------------------------------------------------

Above is the rule that we know it is working..

Comment 10 Deon Ballard 2015-12-02 19:36:00 UTC
Mass re-assign of all content / lifecycle related bugs to Dan MacPherson for the new content management guide.

Comment 13 Mike McCune 2016-03-28 22:28:36 UTC
This bug was accidentally moved from POST to MODIFIED via an error in automation, please see mmccune with any questions

Comment 14 Dan Macpherson 2016-05-06 03:24:52 UTC
The bugs were included as part of technical review of the full guide. In addition, the guide has been peer reviewed.

Setting the QA contact to adahms and flipping the status to ON_QA.

Comment 15 Andrew Dahms 2016-05-06 05:12:33 UTC
Peer reviewed performed in BZ#1326123.

This content is now live on the Customer Portal.

Closing.

Comment 16 Dan Macpherson 2016-07-06 02:50:18 UTC
*** Bug 1290411 has been marked as a duplicate of this bug. ***


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