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 1454565

Summary: [RFE] [6.3] Describe how to use tailoring files
Product: Red Hat Satellite Reporter: Andrew Dahms <adahms>
Component: Docs Managing HostsAssignee: csherrar
Status: CLOSED NEXTRELEASE QA Contact: Russell Dickenson <rdickens>
Severity: medium Docs Contact:
Priority: medium    
Version: 6.3.0CC: mhulan, rdickens, sjagtap
Target Milestone: UnspecifiedKeywords: FutureFeature
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Enhancement
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-11-13 04:33:59 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: 1292510    
Bug Blocks: 1486095    

Description Andrew Dahms 2017-05-23 04:51:53 UTC
Red Hat Satellite 6.3 introduces the ability to upload and use tailoring files to customize existing OpenSCAP policies. A new section must be added to the Host Configuration Guide below the 'Managing Compliance Policies' section that provides the following details -

* An introduction to the section that describes what tailoring files are, and
  includes a link to the instructions on how to create them.

* A procedure that outlines how to upload them to Satellite Server.

* A procedure that outlines how to apply them to a policy.

Comment 2 Andrew Dahms 2017-05-23 05:44:57 UTC
Added engineering tracker to the 'depends' list.

Added external tracker.

Comment 3 Satellite Program 2017-05-23 06:12:09 UTC
Upstream bug assigned to oprazak

Comment 4 Satellite Program 2017-05-23 06:12:11 UTC
Moving this bug to POST for triage into Satellite 6 since the upstream issue http://projects.theforeman.org/issues/14158 has been resolved.

Comment 5 Andrew Dahms 2017-05-23 06:16:04 UTC
Moving back to 'New' and removing external tracker -

http://projects.theforeman.org/issues/14158

This one is a docs bug. :)

Comment 6 Marek Hulan 2017-05-23 06:40:49 UTC
Adding link to upstream manual https://theforeman.org/plugins/foreman_openscap/0.7/index.html#4.5Tailoringfiles(foreman_openscap>=0.6.5)

it does not contain too much information but might help.

Comment 7 Andrew Dahms 2017-09-28 06:03:19 UTC
Assigning to Clifton for review.

Clifton - this is a feature for the 6.3 release, and requires a few new pieces of content.

This bug will require a little research to get an understanding of SCAP and tailoring files, and documentation of the three items listed in the summary above.

For this, it would be ideal if you can set up an environment and check the Hosts > Tailoring Files menu to see what steps are involved.

Let me know if you have any questions, and feel free to reach out Russell on this topic as well. Russell has worked on OpenSCAP content in the past, and can provide some context if needed.

Comment 9 Andrew Dahms 2017-10-06 20:40:02 UTC
*** Bug 1499266 has been marked as a duplicate of this bug. ***

Comment 11 csherrar 2017-11-06 11:59:29 UTC
Hi Russell,

Added a section titled "Tailoring Files" to the "Server Administration Guide" after the section title "Managing Compliance Policies".

In the procedure "To Assign a Tailoring File to a Policy", additional configuration is possible after the initial steps. Can a phrase be used to notify the user that they have free reign with further configuration?

Some KCS Solutions used "configure as required" when the steps to resolving the issue had been covered but further configuration would be required to complete the process.

Can you please check:
https://gitlab.cee.redhat.com/satellite-6-documentation/server-administration-guide/tree/BZ%231454565

If all is in order, please accept:
https://gitlab.cee.redhat.com/satellite-6-documentation/server-administration-guide/merge_requests/86

A preview is available at:
http://ccs-jenkins.gsslab.brq.redhat.com:8080/job/doc-Red_Hat_Satellite-6-Server_Administration_Guide-branch-BZ-1454565/lastSuccessfulBuild/artifact/tmp/en-US/html-single/index.html

Thanks

Comment 12 csherrar 2017-11-06 13:45:23 UTC
Hi Russell,

I changed the status from QA to Post as I feel it is best to document the entire train of this feature.

Will investigate the remaining steps.

Cheers,

Comment 15 Andrew Dahms 2017-11-13 04:33:59 UTC
These changes will be published with the next release of the Red Hat Satellite 6.3 documentation.

Closing.

Comment 16 Andrew Dahms 2017-12-11 01:53:02 UTC
Updating the target milestone to reflect the time frame in which this work was completed.

Comment 17 Andrew Dahms 2018-01-15 01:19:34 UTC
Updating the component and doc type.

Comment 18 Andrew Dahms 2018-02-05 01:28:09 UTC
*** Bug 1342303 has been marked as a duplicate of this bug. ***