Bug 1454565 - [RFE] [6.3] Describe how to use tailoring files
Summary: [RFE] [6.3] Describe how to use tailoring files
Keywords:
Status: CLOSED NEXTRELEASE
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Docs Managing Hosts
Version: 6.3.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: Unspecified
Assignee: csherrar
QA Contact: Russell Dickenson
URL:
Whiteboard:
: 1342303 1499266 (view as bug list)
Depends On: 1292510
Blocks: 1486095
TreeView+ depends on / blocked
 
Reported: 2017-05-23 04:51 UTC by Andrew Dahms
Modified: 2019-09-26 16:15 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Enhancement
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-11-13 04:33:59 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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. ***


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