Bug 1616018 – documentation updates of rhel-system-roles

Bugzilla will be upgraded to version 5.0. The upgrade date is tentatively scheduled for 2 December 2018, pending final testing and feedback.

Bug 1616018 - documentation updates of rhel-system-roles

Summary:	documentation updates of rhel-system-roles

Status:	CLOSED ERRATA

Aliases:	None

Product:	Red Hat Enterprise Linux 7
Classification:	Red Hat
Component:	rhel-system-roles (Show other bugs)
Sub Component:
Version:	7.6
Hardware:	Unspecified Unspecified

Priority	unspecified Severity unspecified
Target Milestone:	rc
Target Release:	---
Assigned To:	Pavel Cahyna
QA Contact:	David Jež
Docs Contact:

URL:
Whiteboard:
Keywords:	Extras

Depends On:
Blocks:
	Show dependency tree / graph

Reported:	2018-08-14 14:06 EDT by Pavel Cahyna
Modified:	2018-08-21 05:33 EDT (History)
CC List:	5 users (show)

See Also:	1602901
Fixed In Version:	rhel-system-roles-1.0-3.el7
Doc Type:	If docs needed, set a value
Doc Text:
Story Points:	---
Clone Of:
Environment:
Last Closed:	2018-08-21 05:32:58 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)
Add an attachment (proposed patch, testcase, etc.)

External Trackers
Tracker	ID	Priority	Status	Summary	Last Updated
Github	linux-system-roles/kdump/pull/16	None	None	None	2018-08-16 02:44 EDT
Github	linux-system-roles/network/pull/80	None	None	None	2018-08-15 10:58 EDT
Github	linux-system-roles/postfix/pull/5	None	None	None	2018-08-16 02:47 EDT
Github	linux-system-roles/selinux/pull/30	None	None	None	2018-08-16 02:46 EDT
Github	linux-system-roles/timesync/pull/18	None	None	None	2018-08-16 02:45 EDT
Github	linux-system-roles/timesync/pull/19	None	None	None	2018-08-16 02:42 EDT
Red Hat Product Errata	RHEA-2018:2531	None	None	None	2018-08-21 05:33 EDT

Groups: None (edit)

Description Pavel Cahyna 2018-08-14 14:06:50 EDT

After the recent changes in role syntax and semantics (bz1479381 and bugs it depends on), the new behavior should be better documented. This applies in particular to the selinux role, whose README is rather brief.

Comment 2 Pavel Cahyna 2018-08-15 10:36:17 EDT

Also the timesync_ntp_provider_os_default variable seems to be undocumented.

Comment 3 Pavel Cahyna 2018-08-15 10:58:57 EDT

There should be prominent warnings in roles that blow away non-Ansible managed settings. This seems to be the case at least for timesync and kdump (which overwrites /etc/kdump.conf and /etc/sysconfig/kdump). See https://github.com/linux-system-roles/network/pull/80 for an example of adding a warning for the network role.

Comment 5 Pavel Cahyna 2018-08-16 08:47:40 EDT

(In reply to Pavel Cahyna from comment #2)
> Also the timesync_ntp_provider_os_default variable seems to be undocumented.

I am postponing this to a later update.

Comment 8 errata-xmlrpc 2018-08-21 05:32:58 EDT

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHEA-2018:2531

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