Bug 977045

Summary: Guide should document chronyd, not ntpd
Product: [Fedora] Fedora Documentation Reporter: Pete Travis <me>
Component: system-administrator's-guideAssignee: Stephen Wadeley <swadeley>
Status: CLOSED CURRENTRELEASE QA Contact: Fedora Docs QA <docs-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: develCC: jhradile, swadeley
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2015-02-14 15:54:03 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:

Description Pete Travis 2013-06-22 21:46:33 UTC
As of F16, Fedora uses `chrony` (chronyd.service) as the default time daemon[1].  Chrony monitors and offsets local clock skew, making it superior for machines without a constant connection to an ntp server. It also effectively changes the system clock for even very large time changes, where ntpd would require manual adjustment.  The System administrator's guide should be updated to reflect this.

The following sections, and references to them, should be updated:
2.2.3, “Configuring the Network Time Protocol”
D.1.14.  /etc/sysconfig/ntpd


[1] https://git.fedorahosted.org/cgit/docs/release-notes.git/plain/en-US/System_Daemons.xml?h=f16

Comment 1 Jaromir Hradilek 2013-06-22 21:49:17 UTC
Thanks, Pete. We are aware of this change and as a matter of fact, Stephen Wadeley is already working on this particular piece of documentation.

Comment 2 Stephen Wadeley 2013-06-24 05:53:16 UTC
First draft was sent to SME late last week, Hope to have something worth proof reading in a few days.

Comment 3 Stephen Wadeley 2013-06-28 08:55:31 UTC
First draft ready in repo.

Feedback please.

Comment 4 Pete Travis 2013-06-28 16:07:06 UTC
I like it, very comprehensive and well presented. Only a couple thoughts:

The instructions for starting, stopping, enabling, and disabling the service are universal, and this section could refer to the "Services and Daemons" section. There could be points in favor of either a reference or a restatement, and obviously this would be your call.

Later, I was a little confused by "By default, rtcsync will inform the kernel the system clock is synchronized and the kernel will update the real-time clock in 11 minute intervals."  After a little reading[1], I found that 'rtcsync' is a chronyd config file directive, not a separate application, and that I was somehow confusing 'intervals' of small clock updates every 11 minutes with 11 minute 'increments'. A minor point, but it could be made more clear.

[1] grep -A9 -m1 4.2.44 /usr/share/doc/chrony-1.27/chrony.txt

Comment 5 Stephen Wadeley 2013-07-01 07:22:33 UTC
Thank you for the feedback.

Paragraph 1: A matter of style so I will leave that to the guide owner. 

BTW, I was taught to rather include sort descriptions than to make readers look elsewhere (subjective of course). Also, its easier to find instructions if you have short task descriptions with suitable headings.

Paragraph 2: I think I took the SME too literally. I'll propose this:
By default, the rtcsync directive is present in the /etc/chrony.conf file. This will inform the kernel the system clock is kept synchronized and the kernel will update the real-time clock every 11 minutes. 

Thank you

Comment 6 Stephen Wadeley 2013-07-01 12:37:43 UTC
The very helpful Miroslav Lichvar has approved my wording as in c#5.

Is jhradile happy with the new headings and structure?

Comment 7 Eric Christensen 2013-07-02 02:57:05 UTC
I'd like to document chronyd in the Security Guide as well.

Also, chronyd shouldn't replace ntpd in the documentation as ntpd is still being shipped, although it is no longer default.

Comment 8 Stephen Wadeley 2013-09-16 20:50:19 UTC
Hello Eric

Point 1: I think this BZ is not the place to discuss the pros and cons of duplicating content.

Point 2: I can only find a mention of ntpd in the appendix "The sysconfig Directory". I see that I have cut off some still useful commands at the end of the chapter "Configuring the Date and Time".

I will add an ntpd chapter ASAP and improve the end of chapter "Configuring the Date and Time".


Comment 9 Stephen Wadeley 2013-10-14 20:44:31 UTC
I have added a chapter describing the use ntpd to configure ntp

I have improved the end of the "Configuring the Date and Time" chapter.

Comment 10 Eric Christensen 2013-10-14 23:49:23 UTC
(In reply to Stephen Wadeley from comment #9)
> I have added a chapter describing the use ntpd to configure ntp
> I have improved the end of the "Configuring the Date and Time" chapter.

Can you provide a patch (or just the DocBook file) for this change so I can add it to the Security Guide, please?

Comment 11 Stephen Wadeley 2014-08-28 18:43:36 UTC

Duplicating content is not a good idea.

Please link to the chapters on time (ntp, chrony, and ptp)

Please discuss the issue of duplication and linking in the Fedora docs meeting.

Thank you

Comment 12 Pete Travis 2014-10-11 04:17:07 UTC
You've addressed all of my concerns and provided good coverage on this topic, thank you Stephen.