[system-administrators-guide] Most desktop environments use Alt+F2 as a keyboard shortcut for an application launcher. I can prove
by Pete Travis
commit ff9d80a59ae8a06c35e25bf5100e164d006ff4a6
Author: Pete Travis <immanetize(a)fedoraproject.org>
Date: Sun Jul 14 18:00:25 2013 -0600
Most desktop environments use Alt+F2 as a keyboard shortcut for an application launcher. I can prove it; look, here are some pictures.
en-US/Opening_GUI_Applications.xml | 87 ++++++++++++++++++++++++++++++++++++
en-US/images/alt-f2_GNOME.png | Bin 0 -> 167116 bytes
en-US/images/alt-f2_KDE.png | Bin 0 -> 200256 bytes
en-US/images/alt-f2_LXDE.png | Bin 0 -> 180164 bytes
en-US/images/alt-f2_MATE.png | Bin 0 -> 181170 bytes
en-US/images/alt-f2_XFCE.png | Bin 0 -> 205113 bytes
6 files changed, 87 insertions(+), 0 deletions(-)
---
diff --git a/en-US/Opening_GUI_Applications.xml b/en-US/Opening_GUI_Applications.xml
index 6fe997a..3853418 100644
--- a/en-US/Opening_GUI_Applications.xml
+++ b/en-US/Opening_GUI_Applications.xml
@@ -104,7 +104,94 @@ root 23874 0.0 0.0 109184 900 pts/21 S+ 15:35 0:00 grep --color=au
</step>
</procedure>
</section>
+
+ <section id="gui-alt_f2">
+ <title>
+ Launching Applications with <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>
+ </title>
+ <para>
+ Most desktop environments follow the convention of using the key combination <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> for opening new applications. Pressing <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> brings up a prompt for a command to be entered into.
+ </para>
+ <para>
+ Commands entered into this dialog box function much as they would if entered in a terminal. Applications are known by thier binary name, and can accept arguments.
+ </para>
+ <figure id="fig-alt_f2-gnome">
+ <title>
+ Using <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> with <application>GNOME</application>
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/alt-f2_GNOME.png" format="PNG" scalefit="0" />
+ </imageobject>
+ <textobject>
+ <para>
+ GNOME command entry dialog box
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <figure id="fig-alt-f2_kde">
+ <title>
+ Using <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> with <application>KDE</application>
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/alt-f2_KDE.png" format="PNG" scalefit="0" />
+ </imageobject>
+ <textobject>
+ <para>
+ KDE command entry dialog box, which also searches menu items, command history, and open applications.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+<figure id="fig-alt-f2_lxde">
+ <title>
+ Using <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> with <application>MATE</application>
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/alt-f2_LXDE.png" format="PNG" scalefit="0" />
+ </imageobject>
+ <textobject>
+ <para>
+ MATE command entry dialog box.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ <figure id="fig-alt-f2_mate">
+ <title>
+ Using <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> with <application>MATE</application>
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/alt-f2_MATE.png" format="PNG" scalefit="0" />
+ </imageobject>
+ <textobject>
+ <para>
+ MATE command entry dialog box.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+<figure id="fig-alt-f2_xfce">
+ <title>
+ Using <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo> with <application>XFCE</application>
+ </title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/alt-f2_XFCE.png" format="PNG" scalefit="0" />
+ </imageobject>
+ <textobject>
+ <para>
+ XFCE command entry dialog box.
+ </para>
+ </textobject>
+ </mediaobject>
+ </figure>
+ </section>
</chapter>
diff --git a/en-US/images/alt-f2_GNOME.png b/en-US/images/alt-f2_GNOME.png
new file mode 100644
index 0000000..077a2fb
Binary files /dev/null and b/en-US/images/alt-f2_GNOME.png differ
diff --git a/en-US/images/alt-f2_KDE.png b/en-US/images/alt-f2_KDE.png
new file mode 100644
index 0000000..622a124
Binary files /dev/null and b/en-US/images/alt-f2_KDE.png differ
diff --git a/en-US/images/alt-f2_LXDE.png b/en-US/images/alt-f2_LXDE.png
new file mode 100644
index 0000000..9beef18
Binary files /dev/null and b/en-US/images/alt-f2_LXDE.png differ
diff --git a/en-US/images/alt-f2_MATE.png b/en-US/images/alt-f2_MATE.png
new file mode 100644
index 0000000..2d89f25
Binary files /dev/null and b/en-US/images/alt-f2_MATE.png differ
diff --git a/en-US/images/alt-f2_XFCE.png b/en-US/images/alt-f2_XFCE.png
new file mode 100644
index 0000000..52065f2
Binary files /dev/null and b/en-US/images/alt-f2_XFCE.png differ
10 years, 10 months
[system-administrators-guide] Started a new chapter on the various methods for opening a graphical application. This commit includ
by Pete Travis
commit ae3ab63254295fdc16bdc1df7c522fefe1eb90a7
Author: Pete Travis <immanetize(a)fedoraproject.org>
Date: Sat Jul 13 16:04:42 2013 -0600
Started a new chapter on the various methods for opening a graphical application.
This commit includes a section on opening graphical applications from the command line.
en-US/Opening_GUI_Applications.xml | 111 +++++++++++++++++++++++++++++++++
en-US/System_Administrators_Guide.xml | 1 +
2 files changed, 112 insertions(+), 0 deletions(-)
---
diff --git a/en-US/Opening_GUI_Applications.xml b/en-US/Opening_GUI_Applications.xml
new file mode 100644
index 0000000..6fe997a
--- /dev/null
+++ b/en-US/Opening_GUI_Applications.xml
@@ -0,0 +1,111 @@
+<?xml version='1.0'?>
+<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+]>
+<chapter id="ch-Opening_GUI_Applications">
+ <title>Opening Graphical Applications</title>
+ <indexterm>
+ <primary>GUI</primary>
+ </indexterm>
+ <para>
+ Fedora provides graphical applications in addition to command line utilities for configuring many features. This chapter describes methods for opening <literal>Graphical User Interface</literal>, or <firstterm>GUI</firstterm>, applications in various environments.
+ </para>
+
+ <section id="gui-from_cli">
+ <title>Opening graphical applications from the command line</title>
+ <para>
+ Graphical applications can be launched from a terminal window or console session by simply typing the name of the application.
+ <screen>
+ [fedorauser@localhost]$ <command>firefox</command>
+ </screen>
+ </para>
+ <note>
+ <title>Binary names vs Application names</title>
+ <para>
+ Programs are opened from the command line using the file name of their <literal>binary</literal>, the executable file provided in the program's package. An entry in the desktop menu will often be named differently from the binary it executes. For example, the GNOME disk management utility appears in the menu as <application>Disks</application>, and the binary is <filename>/usr/bin/gnome-disks</filename>.
+ </para>
+ </note>
+ <para>
+ When a program is executed on the command line, the terminal is occupied until the program completes. When a graphical application is executed from the command line, the program's error output, or <literal>STDERR</literal>, is sent to the terminal window. This can be especially useful when troubleshooting.
+ </para>
+ <example>
+ <title>Viewing errors by launching graphical applications from the command line</title>
+ <screen>
+ [fedorauser@localhost]$ <command>astromenace-wrapper</command>
+ AstroMenace 1.3.1 121212
+
+ Open XML file: /home/fedorauser/.config/astromenace/amconfig.xml
+ VFS file was opened /usr/share/astromenace/gamedata.vfs
+
+ Vendor : OpenAL Community
+ Renderer : OpenAL Soft
+ Version : 1.1 ALSOFT 1.15.1
+ ALut ver : 1.1
+
+ Font initialized: DATA/FONT/LiberationMono-Bold.ttf
+
+ Current Video Mode: 3200x1080 32bit
+
+ Xinerama/TwinView detected.
+ Screen count: 2
+ Screen #0: (0, 0) x (1920, 1080)
+ Screen #1: (1920, 0) x (1280, 1024)
+
+ Supported resolutions list:
+ 640x480 16bit
+ 640x480 32bit
+ 640x480 0bit
+ 768x480 16bit
+ <output truncated>
+ </screen>
+ </example>
+ <para>
+ To launch a graphical application, but fork the additional output into the background and return the terminal for immediate use, use the shell's <function>job control</function> feature.
+ <screen>
+ [fedorauser@localhost]$ <command>emacs foo.txt &</command>
+ </screen>
+ </para>
+ <note>
+ <title>Ending a session</title>
+ <para>
+ Applications that hold the command line prompt until they complete will close when the terminal session ends, even if they are forked into the background.
+ </para>
+ </note>
+ <para>
+ GUI programs can also be launched on one <systemitem>TTY</systemitem> and displayed on another by specifying the <envar>DISPLAY</envar> variable. This can be useful when running multiple graphical sessions, or for troubleshooting problems with a desktop session.
+ </para>
+ <procedure>
+ <step>
+ <para>
+ Switch to another TTY using the key combination <keycombo action="press"><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F2</keycap></keycombo> and log in. Note that consoles are available by default with <keycap>F2</keycap> through <keycap>F6</keycap>.
+ </para>
+ </step>
+ <step>
+ <para>
+ Identify the X session you want to target. The <envar>DISPLAY</envar> variable is always an integer preceded by a colon, and will be <emphasis>:0</emphasis> in most cases. Check the arguments of the currently running <application>X</application> process to verify the value. The command below shows both the <envar>DISPLAY</envar> variable as well as the TTY that <application>X</application> is running on, <literal>vt1</literal>.
+ <screen>
+ [fedorauser@localhost]$ <command>ps aux|grep /usr/bin/X</command>
+ root 1498 7.1 1.0 521396 353984 tty1 Ss+ 00:04 66:34 /usr/bin/X <literal>:0 vt1</literal> -background none -nolisten tcp -auth /var/run/kdm/A:0-22Degc
+root 23874 0.0 0.0 109184 900 pts/21 S+ 15:35 0:00 grep --color=auto /usr/bin/X
+ </screen>
+ </para>
+ </step>
+ <step>
+ <para>
+ Specify the <envar>DISPLAY</envar> variable when executing the program.
+ <screen>
+ [fedorauser@localhost]$ <command>gnome-shell --replace &</command>
+ </screen>
+ </para>
+ </step>
+ <step>
+ <para>
+ Switch back to the TTY the graphical session is running on. Since the example above shows <application>X</application> running on <literal>vt1</literal>, pressing <keycombo><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>F1</keycap></keycombo> will return to the desktop environment.
+ </para>
+ </step>
+ </procedure>
+ </section>
+
+</chapter>
+
+
+
diff --git a/en-US/System_Administrators_Guide.xml b/en-US/System_Administrators_Guide.xml
index ecf5a1f..6ee0eef 100644
--- a/en-US/System_Administrators_Guide.xml
+++ b/en-US/System_Administrators_Guide.xml
@@ -14,6 +14,7 @@
This part covers basic system administration tasks such as keyboard configuration, date and time configuration, installation and initial setup of an NTP server, and managing users and groups.
</para>
</partintro>
+ <xi:include href="Opening_GUI_Applications.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Configuring_the_Language_and_Keyboard.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Configuring_the_Date_and_Time.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
<xi:include href="Configuring_NTP_using_the_Chrony_suite.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
10 years, 10 months
[software-management-guide] New keyword for searching gpk-application in gnome
by Guillermo Gómez
commit 6d500aa6e376d8f256cf1af724c493e2ef914e03
Author: Guillermo Gómez <gomix(a)fedoraproject.org>
Date: Fri Jul 12 08:45:34 2013 -0430
New keyword for searching gpk-application in gnome
es-ES/Las_interfases_GUI_de_gnome-packagekit.xml | 4 ++--
1 files changed, 2 insertions(+), 2 deletions(-)
---
diff --git a/es-ES/Las_interfases_GUI_de_gnome-packagekit.xml b/es-ES/Las_interfases_GUI_de_gnome-packagekit.xml
index 1057e17..fa573ab 100644
--- a/es-ES/Las_interfases_GUI_de_gnome-packagekit.xml
+++ b/es-ES/Las_interfases_GUI_de_gnome-packagekit.xml
@@ -23,14 +23,14 @@
</mediaobject>
</figure>
- <para>En GNOME3, la mejor forma de invocar esta aplicación es buscándola y luego tal vez agregándola como favorita. Para buscar <application>gpk-application</application> presione la tecla Win, la combinación Alt-F1 o vaya al menú de actividades en la esquina izquierda superior de su escritorio. Tipee "aña" y obtendrá un resultado similar al pantallazo siguiente. En el pantallazo también se muestra el menú contextual que se obtiene de presionar clic derecho sobre el icono para agregar como aplicación favorita.</para>
+ <para>En GNOME3, la mejor forma de invocar esta aplicación es buscándola y luego tal vez agregándola como favorita. Para buscar <application>gpk-application</application> presione la tecla Win, la combinación Alt-F1 o vaya al menú de actividades en la esquina izquierda superior de su escritorio. Tipee "sof" y obtendrá un resultado similar al pantallazo siguiente. En el pantallazo también se muestra el menú contextual que se obtiene de presionar clic derecho sobre el icono para agregar como aplicación favorita.</para>
<figure><title>Buscando gpk-application en GNOME3</title>
<mediaobject>
<imageobject>
<imagedata fileref="images/gnome-packagekit/Gnome3-buscando-gpk-application.png" format="PNG" scalefit="1" />
</imageobject>
<textobject>
- <phrase>Pantallazo de GNOME3 buscando por "aña", de añadir.</phrase>
+ <phrase>Pantallazo de GNOME3 buscando por "sof", de añadir.</phrase>
</textobject>
</mediaobject>
</figure>
10 years, 10 months
[system-administrators-guide/18] Typos, markup improvements, remove some white space
by jhradile
commit 1f321377b18a9724c0edefdcc4baa131962b1e40
Author: Stephen Wadeley <swadeley(a)redhat.com>
Date: Wed Jul 10 09:43:29 2013 +0200
Typos, markup improvements, remove some white space
en-US/Configuring_NTP_using_the_Chrony_suite.xml | 97 +++++++++++-----------
1 files changed, 47 insertions(+), 50 deletions(-)
---
diff --git a/en-US/Configuring_NTP_using_the_Chrony_suite.xml b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
index 0b5f552..41736ec 100644
--- a/en-US/Configuring_NTP_using_the_Chrony_suite.xml
+++ b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
@@ -24,8 +24,7 @@ There is a choice between the daemons <systemitem class="daemon">ntpd</systemite
<section id="sect-differences_between_ntpd_and_chronyd">
<title>Differences Between ntpd and chronyd</title>
<para>
- One of the main differences between <systemitem class="daemon">ntpd</systemitem> and <systemitem class="daemon">chronyd</systemitem> is in the
- algorithms used to control the computer's clock. Things <systemitem class="daemon">chronyd</systemitem> can do better than <systemitem class="daemon">ntpd</systemitem> are:
+ One of the main differences between <systemitem class="daemon">ntpd</systemitem> and <systemitem class="daemon">chronyd</systemitem> is in the algorithms used to control the computer's clock. Things <systemitem class="daemon">chronyd</systemitem> can do better than <systemitem class="daemon">ntpd</systemitem> are:
</para>
<itemizedlist>
<listitem>
@@ -40,7 +39,7 @@ There is a choice between the daemons <systemitem class="daemon">ntpd</systemite
</listitem>
<listitem>
<para>
- <systemitem class="daemon">chronyd</systemitem> can usually synchronise the clock faster and with better time accuracy.
+ <systemitem class="daemon">chronyd</systemitem> can usually synchronise the clock faster and with better time accuracy.
</para>
</listitem>
<listitem>
@@ -104,7 +103,7 @@ Things <systemitem class="daemon">ntpd</systemitem> can do that <systemitem clas
</listitem>
<listitem>
<para>
- The <systemitem class="protocol">NTP</systemitem> daemon (<systemitem class="daemon">ntpd</systemitem>) should be considered for systems which are normally kept permanently on. Systems which are required to use broadcast or multicast IP, or to perform authentication of packets with the Autokey protocol, should consider using <systemitem class="daemon">ntpd</systemitem>. <application>Chrony</application> only supports symmetric key authentication, such as the use of <systemitem class="protocol">MD5</systemitem>, <systemitem class="protocol">SHA1</systemitem>, and <systemitem class="protocol">SHA256</systemitem> hash functions, whereas <systemitem class="daemon">ntpd</systemitem> supports the Autokey authentication protocol which can make use of the PKI system. Autokey is described in <citetitle pubwork="webpage">RFC5906</citetitle>.
+ The <systemitem class="protocol">NTP</systemitem> daemon (<systemitem class="daemon">ntpd</systemitem>) should be considered for systems which are normally kept permanently on. Systems which are required to use broadcast or multicast IP, or to perform authentication of packets with the <systemitem class="protocol">Autokey</systemitem> protocol, should consider using <systemitem class="daemon">ntpd</systemitem>. <application>Chrony</application> only supports symmetric key authentication using a message authentication code (MAC) with MD5, SHA1 or stronger hash functions, whereas <systemitem class="daemon">ntpd</systemitem> also supports the <systemitem class="protocol">Autokey</systemitem> authentication protocol which can make use of the PKI system. <systemitem class="protocol">Autokey</systemitem> is described in <citetitle pubwork="webpage">RFC5906</citetitle>.
</para>
</listitem>
</itemizedlist>
@@ -164,7 +163,7 @@ Optionally specify a host, subnet, or network from which to allow <systemitem cl
<listitem>
<screen>allow 2001:db8::/32</screen>
<para>
- Use this form to specify an IPv6 address to be allowed access.
+ Use this form to specify an <systemitem class="protocol">IPv6</systemitem> address to be allowed access.
</para>
</listitem>
</orderedlist>
@@ -176,7 +175,7 @@ Optionally specify a host, subnet, or network from which to allow <systemitem cl
<term>cmdallow</term>
<listitem>
<para>
- This is similar to the <command>allow</command> directive (see section allow), except that it allows control access (rather than <systemitem class="protocol">NTP</systemitem> client access) to a particular subnet or host. (By <quote>control access</quote> is meant that <application>chronyc</application> can be run on those hosts and successfully connect to <systemitem class="daemon">chronyd</systemitem> on this computer.) The syntax is identical. There is also a <command>cmddeny</command> all directive with similar behaviour to the <command>cmdallow</command> all directive. </para>
+ This is similar to the <command>allow</command> directive (see section <command>allow</command>), except that it allows control access (rather than <systemitem class="protocol">NTP</systemitem> client access) to a particular subnet or host. (By <quote>control access</quote> is meant that <application>chronyc</application> can be run on those hosts and successfully connect to <systemitem class="daemon">chronyd</systemitem> on this computer.) The syntax is identical. There is also a <command>cmddeny</command> all directive with similar behavior to the <command>cmdallow</command> all directive.</para>
</listitem>
</varlistentry>
@@ -184,7 +183,7 @@ Optionally specify a host, subnet, or network from which to allow <systemitem cl
<term>dumpdir</term>
<listitem>
<para>
- Path to the directory to save the measurement history across restarts of <systemitem class="daemon">chronyd</systemitem> (assuming no changes are made to the system clock behaviour whilst it is not running). If this capability is to be used (via the <command>dumponexit</command> command in the configuration file, or the <command>dump</command> command in chronyc), the <command>dumpdir</command> command should be used to define the directory where the measurement histories are saved. </para>
+ Path to the directory to save the measurement history across restarts of <systemitem class="daemon">chronyd</systemitem> (assuming no changes are made to the system clock behavior whilst it is not running). If this capability is to be used (via the <command>dumponexit</command> command in the configuration file, or the <command>dump</command> command in <application>chronyc</application>), the <command>dumpdir</command> command should be used to define the directory where the measurement histories are saved.</para>
</listitem>
</varlistentry>
@@ -192,7 +191,7 @@ Optionally specify a host, subnet, or network from which to allow <systemitem cl
<term>dumponexit</term>
<listitem>
<para>
- If this command is present, it indicates that <systemitem class="daemon">chronyd</systemitem> should save the measurement history for each of its time sources recorded whenever the program exits. (See the <command>dumpdir</command> command above)</para>
+ If this command is present, it indicates that <systemitem class="daemon">chronyd</systemitem> should save the measurement history for each of its time sources recorded whenever the program exits. (See the <command>dumpdir</command> command above).</para>
</listitem>
</varlistentry>
@@ -204,7 +203,7 @@ Optionally specify a host, subnet, or network from which to allow <systemitem cl
<para>
An example of the command is:
<screen>local stratum 10</screen>
-A large value of 10 indicates that the clock is so many hops away from a reference clock that its time is fairly unreliable. Put another way, if the computer ever has access to another computer which is ultimately synchronized to a reference clock, it will almost certainly be at a stratum less than 10. Therefore, the choice of a high value like 10 for the <command>local</command> command prevents the machine’s own time from ever being confused with real time, were it ever to leak out to clients that have visibility of real servers. </para>
+A large value of 10 indicates that the clock is so many hops away from a reference clock that its time is fairly unreliable. Put another way, if the computer ever has access to another computer which is ultimately synchronized to a reference clock, it will almost certainly be at a stratum less than 10. Therefore, the choice of a high value like 10 for the <command>local</command> command prevents the machine’s own time from ever being confused with real time, were it ever to leak out to clients that have visibility of real servers.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -249,7 +248,7 @@ A large value of 10 indicates that the clock is so many hops away from a referen
<term>refclocks</term>
<listitem>
<para>
- This option logs the raw and filtered reference clock measurements to a file called <filename>refclocks.log</filename>.
+ This option logs the raw and filtered reference clock measurements to a file called <filename>refclocks.log</filename>.
</para>
</listitem>
</varlistentry>
@@ -257,7 +256,7 @@ A large value of 10 indicates that the clock is so many hops away from a referen
<term>tempcomp</term>
<listitem>
<para>
- This option logs the temperature measurements and system rate compensations to a file called <filename>tempcomp.log</filename>.
+ This option logs the temperature measurements and system rate compensations to a file called <filename>tempcomp.log</filename>.
</para>
</listitem>
</varlistentry>
@@ -265,7 +264,7 @@ A large value of 10 indicates that the clock is so many hops away from a referen
<term>refclocks</term>
<listitem>
<para>
- This option logs the raw and filtered reference clock measurements to a file called <filename>refclocks.log</filename>.
+ This option logs the raw and filtered reference clock measurements to a file called <filename>refclocks.log</filename>.
</para>
</listitem>
</varlistentry>
@@ -274,7 +273,7 @@ A large value of 10 indicates that the clock is so many hops away from a referen
<term>refclocks</term>
<listitem>
<para>
- This option logs the raw and filtered reference clock measurements to a file called <filename>refclocks.log</filename>.
+ This option logs the raw and filtered reference clock measurements to a file called <filename>refclocks.log</filename>.
</para>
</listitem>
</varlistentry>
@@ -314,7 +313,7 @@ An example of the use of this directive is:
<para>
An example of the use of this directive is:
<screen>makestep 1000 10</screen>
-This would step the system clock if the adjustment is larger than 1000 seconds, but only in the first ten clock updates.
+This would step the system clock if the adjustment is larger than 1000 seconds, but only in the first ten clock updates.
</para>
</listitem>
</varlistentry>
@@ -326,7 +325,7 @@ This would step the system clock if the adjustment is larger than 1000 seconds,
<para>
An example of the use of this directive is:
<screen>maxchange 1000 1 2</screen>
-After the first clock update, <systemitem class="daemon">chronyd</systemitem> will check the offset on every clock update, it will ignore two adjustments larger than 1000 seconds and exit on another one.
+After the first clock update, <systemitem class="daemon">chronyd</systemitem> will check the offset on every clock update, it will ignore two adjustments larger than 1000 seconds and exit on another one.
</para>
</listitem>
</varlistentry>
@@ -354,7 +353,7 @@ It should be noted that this is not the only means of protection against using u
<term>noclientlog</term>
<listitem>
<para>
-This directive, which takes no arguments, specifies that client accesses are not to be logged. Normally they are logged, allowing statistics to be reported using the clients command in <application>chronyc</application>.
+This directive, which takes no arguments, specifies that client accesses are not to be logged. Normally they are logged, allowing statistics to be reported using the clients command in <application>chronyc</application>.
</para>
</listitem>
</varlistentry>
@@ -362,7 +361,7 @@ This directive, which takes no arguments, specifies that client accesses are not
<term>reselectdist</term>
<listitem>
<para>
- When <systemitem class="daemon">chronyd</systemitem> selects synchronisation source from available sources, it will prefer the one with minimum synchronization distance. However, to avoid frequent reselecting when there are sources with similar distance, a fixed distance is added to the distance for sources that are currently not selected. This can be set with the <option>reselectdist</option> option. By default, the distance is 100 microseconds.</para>
+ When <systemitem class="daemon">chronyd</systemitem> selects synchronization source from available sources, it will prefer the one with minimum synchronization distance. However, to avoid frequent reselecting when there are sources with similar distance, a fixed distance is added to the distance for sources that are currently not selected. This can be set with the <option>reselectdist</option> option. By default, the distance is 100 microseconds.</para>
<para>
The format of the syntax is:
<screen>reselectdist <replaceable>dist-in-seconds</replaceable></screen>
@@ -374,11 +373,11 @@ The format of the syntax is:
<term>stratumweight</term>
<listitem>
<para>
- The <command>stratumweight</command> directive sets how much distance should be added per stratum to the synchronisation distance when <systemitem class="daemon">chronyd</systemitem> selects the synchronisation source from available sources.</para>
+ The <command>stratumweight</command> directive sets how much distance should be added per stratum to the synchronisation distance when <systemitem class="daemon">chronyd</systemitem> selects the synchronization source from available sources.</para>
<para>
The format of the syntax is:
<screen>stratumweight <replaceable>dist-in-seconds</replaceable></screen>
-By default, <replaceable>dist-in-seconds</replaceable> is 1 second. This usually means that sources with lower stratum will be preferred to sources with higher stratum even when their distance is significantly worse. Setting <command>stratumweight</command> to 0 makes <systemitem class="daemon">chronyd</systemitem> ignore stratum when selecting the source.
+By default, <replaceable>dist-in-seconds</replaceable> is 1 second. This usually means that sources with lower stratum will be preferred to sources with higher stratum even when their distance is significantly worse. Setting <command>stratumweight</command> to 0 makes <systemitem class="daemon">chronyd</systemitem> ignore stratum when selecting the source.
</para>
</listitem>
</varlistentry>
@@ -393,9 +392,7 @@ The format of the syntax is:
<screen>rtcfile /var/lib/chrony/rtc</screen>
-<systemitem class="daemon">chronyd</systemitem> saves information in this file when it exits and when the writertc command is issued in <application>chronyc</application>. The information saved is the RTC’s error at some epoch, that epoch (in seconds since January 1 1970), and the rate at which the RTC gains or loses time.
-
-Not all real-time clocks are supported as their code system-specific.
+<systemitem class="daemon">chronyd</systemitem> saves information in this file when it exits and when the <command>writertc</command> command is issued in <application>chronyc</application>. The information saved is the RTC’s error at some epoch, that epoch (in seconds since January 1 1970), and the rate at which the RTC gains or loses time. Not all real-time clocks are supported as their code is system-specific. Note that if this directive is used then real-time clock should not be manually adjusted as this would interfere with <application>chrony</application>'s need to measure the rate at which the real-time clock drifts if it was adjusted at random intervals.
</para>
</listitem>
</varlistentry>
@@ -513,7 +510,7 @@ chronyc> <command>password HEX:A6CFC50C9C93AB6E5A19754C246242FC5471BCDF</command
<para>
To install <application>chrony</application>, run the following command as root:
<screen>~]# <command>yum install chrony -y</command></screen>
- The default installation directory is <filename>/usr/local/sbin/</filename>
+ The default installation directory is <filename>/usr/local/sbin/</filename>.
</para>
</section>
@@ -562,7 +559,7 @@ chronyd.service - NTP client/server
<title>Checking chrony Tracking</title>
<para>
- To check chrony tracking, issue the following command:
+ To check <application>chrony</application> tracking, issue the following command:
<screen>~]$ <command>chronyc tracking</command>
Reference ID : 1.2.3.4 (a.b.c)
Stratum : 3
@@ -585,7 +582,7 @@ Leap status : Normal
<term>Reference ID</term>
<listitem>
<para>
- This is the refid and name (or IP address) if available, of the server to which the computer is currently synchronised. If this is 127.127.1.1 it means the computer is not synchronised to any external source and that you have the ‘local’ mode operating (via the local command in chronyc (see section local), or the <command>local</command> directive in the ‘/etc/chrony.conf’ file (see section local)). </para>
+ This is the reference ID and name (or IP address) if available, of the server to which the computer is currently synchronized. If this is <systemitem class="ipaddress">127.127.1.1</systemitem> it means the computer is not synchronized to any external source and that you have the <quote>local</quote> mode operating (via the local command in <application>chronyc</application>, or the <command>local</command> directive in the <filename>/etc/chrony.conf</filename> file (see section <command>local</command>)).</para>
</listitem>
</varlistentry>
@@ -593,7 +590,7 @@ Leap status : Normal
<term>Stratum</term>
<listitem>
<para>
- The stratum indicates how many hops away from a computer with an attached reference clock we are. Such a computer is a stratum-1 computer, so the computer in the example is two hops away (i.e. a.b.c is a stratum-2 and is synchronised from a stratum-1).</para>
+ The stratum indicates how many hops away from a computer with an attached reference clock we are. Such a computer is a stratum-1 computer, so the computer in the example is two hops away (that is to say, a.b.c is a stratum-2 and is synchronized from a stratum-1).</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -607,7 +604,7 @@ Leap status : Normal
<term>System time</term>
<listitem>
<para>
- In normal operation, <systemitem class="daemon">chronyd</systemitem> never steps the system clock, because any jump in the timescale can have adverse consequences for certain application programs. Instead, any error in the system clock is corrected by slightly speeding up or slowing down the system clock until the error has been removed, and then returning to the system clock’s normal speed. A consequence of this is that there will be a period when the system clock (as read by other programs using the gettimeofday() system call, or by the date command in the shell) will be different from chronyd's estimate of the current true time (which it reports to <systemitem class="protocol">NTP</systemitem> clients when it is operating in server mode). The value reported on this line is the difference due to this effect.</para>
+ In normal operation, <systemitem class="daemon">chronyd</systemitem> never steps the system clock, because any jump in the timescale can have adverse consequences for certain application programs. Instead, any error in the system clock is corrected by slightly speeding up or slowing down the system clock until the error has been removed, and then returning to the system clock’s normal speed. A consequence of this is that there will be a period when the system clock (as read by other programs using the <function>gettimeofday()</function> system call, or by the date command in the shell) will be different from <systemitem class="daemon">chronyd</systemitem>'s estimate of the current true time (which it reports to <systemitem class="protocol">NTP</systemitem> clients when it is operating in server mode). The value reported on this line is the difference due to this effect.</para>
</listitem>
</varlistentry>
<varlistentry>
@@ -628,16 +625,16 @@ Leap status : Normal
<term>Frequency</term>
<listitem>
<para>
- The ‘frequency’ is the rate by which the system’s clock would be would be wrong if <systemitem class="daemon">chronyd</systemitem> was not correcting it. It is expressed in ppm (parts per million). For example, a value of 1ppm would mean that when the system’s clock thinks it has advanced 1 second, it has actually advanced by 1.000001 seconds relative to true time. </para>
+ The <quote>frequency</quote> is the rate by which the system’s clock would be would be wrong if <systemitem class="daemon">chronyd</systemitem> was not correcting it. It is expressed in ppm (parts per million). For example, a value of 1ppm would mean that when the system’s clock thinks it has advanced 1 second, it has actually advanced by 1.000001 seconds relative to true time.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Residual freq</term>
<listitem>
<para>
- This shows the ‘residual frequency’ for the currently selected reference source. This reflects any difference between what the measurements from the reference source indicate the frequency should be and the frequency currently being used.
+ This shows the <quote>residual frequency</quote> for the currently selected reference source. This reflects any difference between what the measurements from the reference source indicate the frequency should be and the frequency currently being used.
- The reason this is not always zero is that a smoothing procedure is applied to the frequency. Each time a measurement from the reference source is obtained and a new residual frequency computed, the estimated accuracy of this residual is compared with the estimated accuracy (see ‘skew’ next) of the existing frequency value. A weighted average is computed for the new frequency, with weights depending on these accuracies. If the measurements from the reference source follow a consistent trend, the residual will be driven to zero over time.
+ The reason this is not always zero is that a smoothing procedure is applied to the frequency. Each time a measurement from the reference source is obtained and a new residual frequency computed, the estimated accuracy of this residual is compared with the estimated accuracy (see <option>skew</option> next) of the existing frequency value. A weighted average is computed for the new frequency, with weights depending on these accuracies. If the measurements from the reference source follow a consistent trend, the residual will be driven to zero over time.
</para>
</listitem>
</varlistentry>
@@ -645,14 +642,14 @@ Leap status : Normal
<term>Skew</term>
<listitem>
<para>
- This is the estimated error bound on the frequency. </para>
+ This is the estimated error bound on the frequency.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Root delay</term>
<listitem>
<para>
- This is the total of the network path delays to the stratum-1 computer from which the computer is ultimately synchronised.
+ This is the total of the network path delays to the stratum-1 computer from which the computer is ultimately synchronized.
In certain extreme situations, this value can be negative. (This can arise in a symmetric peer arrangement where the computers’ frequencies are not tracking each other and the network delay is very short relative to the turn-around time at each computer.)
</para>
@@ -662,14 +659,14 @@ Leap status : Normal
<term>Root dispersion</term>
<listitem>
<para>
-This is the total dispersion accumulated through all the computers back to the stratum-1 computer from which the computer is ultimately synchronised. Dispersion is due to system clock resolution, statistical measurement variations etc. </para>
+This is the total dispersion accumulated through all the computers back to the stratum-1 computer from which the computer is ultimately synchronized. Dispersion is due to system clock resolution, statistical measurement variations etc.</para>
</listitem>
</varlistentry>
<varlistentry>
<term> Leap status</term>
<listitem>
<para>
- This is the leap status, which can be Normal, Insert second, Delete second or Not synchronised.
+ This is the leap status, which can be Normal, Insert second, Delete second or Not synchronized.
</para>
</listitem>
</varlistentry>
@@ -681,7 +678,7 @@ This is the total dispersion accumulated through all the computers back to the s
<para>
The sources command displays information about the current time sources that <systemitem class="daemon">chronyd</systemitem> is accessing.
-The optional argument -v can be specified, meaning verbose. In this case, extra caption lines are shown as a reminder of the meanings of the columns.
+The optional argument -v can be specified, meaning verbose. In this case, extra caption lines are shown as a reminder of the meanings of the columns.
<screen>~]$ <command>chronyc sources</command>
210 Number of sources = 3
MS Name/IP address Stratum Poll Reach LastRx Last sample
@@ -697,7 +694,7 @@ The columns are as follows:
<term>M</term>
<listitem>
<para>
-This indicates the mode of the source. ^ means a server, = means a peer and # indicates a locally connected reference clock.
+This indicates the mode of the source. <literal>^</literal> means a server, <literal>=</literal> means a peer and <literal>#</literal> indicates a locally connected reference clock.
</para>
</listitem>
</varlistentry>
@@ -705,15 +702,15 @@ This indicates the mode of the source. ^ means a server, = means a peer and # in
<term>S</term>
<listitem>
<para>
-This column indicates the state of the sources. * indicates the source to which <systemitem class="daemon">chronyd</systemitem> is current synchronised. + indicates other acceptable sources. ? indicates sources to which connectivity has been lost. x indicates a clock which <systemitem class="daemon">chronyd</systemitem> thinks is is a falseticker (i.e. its time is inconsistent with a majority of other sources). ~ indicates a source whose time appears to have too much variability. The ~ condition is also shown at start-up, until at least 3 samples have been gathered from it.
- </para>
+This column indicates the state of the sources. <quote>*</quote> indicates the source to which <systemitem class="daemon">chronyd</systemitem> is currently synchronized. <quote>+</quote> indicates acceptable sources which are combined with the selected source. <quote>-</quote> indicates acceptable sources which are excluded by the combining algorithm. <quote>?</quote> indicates sources to which connectivity has been lost or whose packets do not pass all tests. <quote>x</quote> indicates a clock which <systemitem class="daemon">chronyd</systemitem> thinks is is a falseticker (that is to say, its time is inconsistent with a majority of other sources). <quote>~</quote> indicates a source whose time appears to have too much
+ variability. The <quote>?</quote> condition is also shown at start-up, until at least 3 samples have been gathered from it.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Name/IP address</term>
<listitem>
<para>
-This shows the name or the IP address of the source, or refid for reference clocks.
+This shows the name or the IP address of the source, or reference ID for reference clocks.
</para>
</listitem>
</varlistentry>
@@ -721,7 +718,7 @@ This shows the name or the IP address of the source, or refid for reference cloc
<term>Stratum</term>
<listitem>
<para>
-This shows the stratum of the source, as reported in its most recently received sample. Stratum 1 indicates a computer with a locally attached reference clock. A computer that is synchronised to a stratum 1 computer is at stratum 2. A computer that is synchronised to a stratum 2 computer is at stratum 3, and so on.
+This shows the stratum of the source, as reported in its most recently received sample. Stratum 1 indicates a computer with a locally attached reference clock. A computer that is synchronized to a stratum 1 computer is at stratum 2. A computer that is synchronized to a stratum 2 computer is at stratum 3, and so on.
</para>
</listitem>
</varlistentry>
@@ -747,7 +744,7 @@ This shows the stratum of the source, as reported in its most recently received
<term>LastRx</term>
<listitem>
<para>
- This column shows how long ago the last sample was received from the source. This is normally in seconds. The letters m, h, d or y indicate minutes, hours, days or years. A value of 10 years indicates there were no samples received from this source yet.
+ This column shows how long ago the last sample was received from the source. This is normally in seconds. The letters <literal>m</literal>, <literal>h</literal>, <literal>d</literal> or <literal>y</literal> indicate minutes, hours, days or years. A value of 10 years indicates there were no samples received from this source yet.
</para>
</listitem>
</varlistentry>
@@ -769,7 +766,7 @@ This shows the stratum of the source, as reported in its most recently received
<para>
The <command>sourcestats</command> command displays information about the drift rate and offset estimation process for each of the sources currently being examined by <systemitem class="daemon">chronyd</systemitem>.
-The optional argument <option>-v</option> can be specified, meaning verbose. In this case, extra caption lines are shown as a reminder of the meanings of the columns.
+The optional argument <option>-v</option> can be specified, meaning verbose. In this case, extra caption lines are shown as a reminder of the meanings of the columns.
<screen>~]$ <command>chronyc sourcestats</command>
@@ -786,7 +783,7 @@ The columns are as follows:
<term>Name/IP address</term>
<listitem>
<para>
-This is the name or IP address of the <systemitem class="protocol">NTP</systemitem> server (or peer) or refid of the refclock to which the rest of the line relates.
+This is the name or IP address of the <systemitem class="protocol">NTP</systemitem> server (or peer) or reference ID of the reference clock to which the rest of the line relates.
</para>
</listitem>
</varlistentry>
@@ -818,7 +815,7 @@ This is the number of runs of residuals having the same sign following the last
<term>Frequency</term>
<listitem>
<para>
- This is the estimated residual frequency for the server, in parts per million. In this case, the computer’s clock is estimated to be running 1 part in 10**9 slow relative to the server.
+ This is the estimated residual frequency for the server, in parts per million. In this case, the computer’s clock is estimated to be running 1 part in <inlineequation><mathphrase>10<superscript>9</superscript></mathphrase></inlineequation> slow relative to the server.
</para>
</listitem>
</varlistentry>
@@ -955,7 +952,7 @@ commandkey 24
local stratum 10
initstepslew 20 master
allow 192.0.2.123</screen>
-Where <systemitem class="ipaddress">192.0.2.123</systemitem> is the address of the master, and <systemitem class="systemname">master</systemitem> is the host name of the master. These clinet will resynchronize the master if it restarts.
+Where <systemitem class="ipaddress">192.0.2.123</systemitem> is the address of the master, and <systemitem class="systemname">master</systemitem> is the host name of the master. These client will resynchronize the master if it restarts.
</para>
<para>
@@ -969,8 +966,8 @@ Where <systemitem class="ipaddress">192.0.2.123</systemitem> is the address of t
<title>Using chronyc</title>
-<section id="sect-Using_chronyc_chronyc_to_control_cronyd">
- <title>Using chronyc to Control cronyd</title>
+<section id="sect-Using_chronyc_chronyc_to_control_chronyd">
+ <title>Using chronyc to Control chronyd</title>
<para>
To make changes using the command line utility <application>chronyc</application> in interactive mode, enter the following command as root:
<screen>~]# <command>chronyc</command></screen>
@@ -978,7 +975,7 @@ Where <systemitem class="ipaddress">192.0.2.123</systemitem> is the address of t
</para>
<para>
The <application>chronyc</application> command prompt will be displayed as follows:</para>
- <screen>/chronyc></screen>
+ <screen>chronyc></screen>
<para>
You can type <command>help</command> to list all of the commands.
</para>
@@ -1012,7 +1009,7 @@ From the remote systems, the system administrator can issue commands after first
</para>
<para>
- The password or hash associated with the command key for a remote system is best obtained by <systemitem class="protocol">SSH</systemitem>. That is to say, an <systemitem class="protocol">SSH</systemitem> connection should be established to the remote machine and the ID of the command key from <filename>/etc/chrony.conf</filename> and the command key in <filename>/etc/chrony.keys</filename> memorised or stored securly for the duration of the session.
+ The password or hash associated with the command key for a remote system is best obtained by <systemitem class="protocol">SSH</systemitem>. That is to say, an <systemitem class="protocol">SSH</systemitem> connection should be established to the remote machine and the ID of the command key from <filename>/etc/chrony.conf</filename> and the command key in <filename>/etc/chrony.keys</filename> memorized or stored securely for the duration of the session.
</para>
</section>
@@ -1061,7 +1058,7 @@ From the remote systems, the system administrator can issue commands after first
</listitem>
<listitem>
<para>
- <filename>/usr/share/doc/chrony*/chrony.txt</filename> — User guide for the <application>chrony</application> suite.
+ <filename>/usr/share/doc/chrony*/chrony.txt</filename> — User guide for the <application>chrony</application> suite.
</para>
</listitem>
</itemizedlist>
10 years, 10 months
[system-administrators-guide/18] Bug 982485 - 3.3.7 Manually Adjusting the System Clock
by jhradile
commit 72e0a5b5ad34d916ba2e1b4a0977a081ebd78c0c
Author: Stephen Wadeley <swadeley(a)redhat.com>
Date: Wed Jul 10 09:42:14 2013 +0200
Bug 982485 - 3.3.7 Manually Adjusting the System Clock
en-US/Configuring_NTP_using_the_Chrony_suite.xml | 10 +++++-----
1 files changed, 5 insertions(+), 5 deletions(-)
---
diff --git a/en-US/Configuring_NTP_using_the_Chrony_suite.xml b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
index c681c56..0b5f552 100644
--- a/en-US/Configuring_NTP_using_the_Chrony_suite.xml
+++ b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
@@ -851,16 +851,16 @@ This is the estimated error bounds on Freq (again in parts per million).
</section>
</section>
-<section id="sect-Adjusting-the-System_Clock">
- <title>Manualy Adjusting the System Clock</title>
+<section id="sect-Manually_Adjusting-the-System_Clock">
+ <title>Manually Adjusting the System Clock</title>
<para>
To update, or step, the system clock immediately, bypassing any adjustments in progress by slewing the clock, issue the following commands as root:
<screen>~]# <command>chronyc</command>
- chrony> <command>password</command>
+ chrony> <command>password</command> <replaceable>commandkey-password</replaceable>
200 OK
chrony> <command>makestep</command>
- 200 OK</screen>
-
+ 200 OK</screen>
+Where <replaceable>commandkey-password</replaceable> is the command key or password stored in the key file.
</para>
<para>
The real-time clock should not be manually adjusted if the <command>rtcfile</command> directive is used as this would interfere with <application>chrony</application>'s need to measure the rate at which the real-time clock drifts if it was adjusted at random intervals.</para>
10 years, 10 months
[system-administrators-guide/18] Correcting description, "real-time clock should not be manually adjusted..." SME says no need to men
by jhradile
commit d384c13018a24a6224cf8c421af605787d746b28
Author: Stephen Wadeley <swadeley(a)redhat.com>
Date: Wed Jul 10 09:33:10 2013 +0200
Correcting description, "real-time clock should not be manually adjusted..."
SME says no need to mention OS and explain this is related to use of rtcfile
en-US/Configuring_NTP_using_the_Chrony_suite.xml | 3 +--
1 files changed, 1 insertions(+), 2 deletions(-)
---
diff --git a/en-US/Configuring_NTP_using_the_Chrony_suite.xml b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
index b8ab28e..c681c56 100644
--- a/en-US/Configuring_NTP_using_the_Chrony_suite.xml
+++ b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
@@ -863,8 +863,7 @@ This is the estimated error bounds on Freq (again in parts per million).
</para>
<para>
- In &MAJOROS;, the real-time clock should not be manually adjusted as this would interfere with <application>chrony</application>'s need to measure the rate at which the real-time clock drifts if it was adjusted at random intervals. By default, the <application>rtcsync</application> directive is present in the <filename>/etc/chrony.conf</filename> file. This will inform the kernel the system clock is kept synchronized and the kernel will update the real-time clock every 11 minutes.
-</para>
+ The real-time clock should not be manually adjusted if the <command>rtcfile</command> directive is used as this would interfere with <application>chrony</application>'s need to measure the rate at which the real-time clock drifts if it was adjusted at random intervals.</para>
</section>
</section>
10 years, 10 months
[system-administrators-guide/18] Improving the explanation of rtcsync directive & 11 minute mode.
by jhradile
commit 4c63065219544a8ee869d422b4e7d0b7f857f35e
Author: Stephen Wadeley <swadeley(a)redhat.com>
Date: Mon Jul 1 14:28:36 2013 +0200
Improving the explanation of rtcsync directive & 11 minute mode.
en-US/Configuring_NTP_using_the_Chrony_suite.xml | 2 +-
1 files changed, 1 insertions(+), 1 deletions(-)
---
diff --git a/en-US/Configuring_NTP_using_the_Chrony_suite.xml b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
index 82ccf2a..b8ab28e 100644
--- a/en-US/Configuring_NTP_using_the_Chrony_suite.xml
+++ b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
@@ -863,7 +863,7 @@ This is the estimated error bounds on Freq (again in parts per million).
</para>
<para>
- In &MAJOROS;, the real-time clock should not be manually adjusted as this would interfere with <application>chrony</application>'s need to measure the rate at which the real-time clock drifts if it was adjusted at random intervals. By default, <application>rtcsync</application> will inform the kernel the system clock is synchronized and the kernel will update the real-time clock in 11 minute intervals.
+ In &MAJOROS;, the real-time clock should not be manually adjusted as this would interfere with <application>chrony</application>'s need to measure the rate at which the real-time clock drifts if it was adjusted at random intervals. By default, the <application>rtcsync</application> directive is present in the <filename>/etc/chrony.conf</filename> file. This will inform the kernel the system clock is kept synchronized and the kernel will update the real-time clock every 11 minutes.
</para>
</section>
</section>
10 years, 10 months
[system-administrators-guide/18] Adding explanation of rtcsync directive
by jhradile
commit 94ad1cf7a841896410dcd407c73703d704e71f98
Author: Stephen Wadeley <swadeley(a)redhat.com>
Date: Wed Jul 10 09:28:23 2013 +0200
Adding explanation of rtcsync directive
en-US/Configuring_NTP_using_the_Chrony_suite.xml | 8 ++++++++
1 files changed, 8 insertions(+), 0 deletions(-)
---
diff --git a/en-US/Configuring_NTP_using_the_Chrony_suite.xml b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
index b0b3bac..82ccf2a 100644
--- a/en-US/Configuring_NTP_using_the_Chrony_suite.xml
+++ b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
@@ -400,6 +400,14 @@ Not all real-time clocks are supported as their code system-specific.
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>rtcsync</term>
+ <listitem>
+ <para>
+ The <command>rtcsync</command> directive is present in the <filename>/etc/chrony.conf</filename> file by default. This will inform the kernel the system clock is kept synchronized and the kernel will update the real-time clock every 11 minutes.</para>
+ </listitem>
+ </varlistentry>
+
</variablelist>
</para>
</section>
10 years, 10 months
[system-administrators-guide/18] Corrections and clarifications suggested by SME
by jhradile
commit b08318f4e4f8c739babf28ce6da0ef5e71829b7b
Author: Stephen Wadeley <swadeley(a)redhat.com>
Date: Wed Jul 10 09:28:05 2013 +0200
Corrections and clarifications suggested by SME
en-US/Configuring_NTP_using_the_Chrony_suite.xml | 29 +++++++++-------------
1 files changed, 12 insertions(+), 17 deletions(-)
---
diff --git a/en-US/Configuring_NTP_using_the_Chrony_suite.xml b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
index d783f53..b0b3bac 100644
--- a/en-US/Configuring_NTP_using_the_Chrony_suite.xml
+++ b/en-US/Configuring_NTP_using_the_Chrony_suite.xml
@@ -13,12 +13,12 @@
The user space daemon updates the system clock running in the kernel. The system clock can keep time by using various clock sources. Usually, the <firstterm>Time Stamp Counter</firstterm> (<acronym>TSC</acronym>) is used. The TSC is a CPU register which counts the number of cycles since it was last reset. It is very fast, has a high resolution, and there are no interrupts.
</para>
<para>
-There is a choice between the daemons <systemitem class="daemon">ntpd</systemitem> and <systemitem class="daemon">chronyd</systemitem>, which are available from the repos in the <package>ntp</package> and <package>chrony</package> packages respectively. This section describes the use of the <application>chrony</application> suite of utilities to update the daemon on systems that do not fit into the conventional permanently networked, always on, dedicated server category.
+There is a choice between the daemons <systemitem class="daemon">ntpd</systemitem> and <systemitem class="daemon">chronyd</systemitem>, which are available from the repos in the <package>ntp</package> and <package>chrony</package> packages respectively. This section describes the use of the <application>chrony</application> suite of utilities to update the system clock on systems that do not fit into the conventional permanently networked, always on, dedicated server category.
</para>
<section id="sect-Introduction_to_the_chrony_suite">
<title>Introduction to the chrony Suite</title>
<para>
- <application>Chrony</application> consists of <systemitem class="daemon">chronyd</systemitem>, a daemon that runs in user space, and <application>chronyc</application>, a command line program for making adjustments to <systemitem class="daemon">chronyd</systemitem>. Systems which are not permanently connected, or not permanently powered up, take a relatively long time to adjust their system clocks using the <systemitem class="protocol">NTP</systemitem> time protocol. This is because many small corrections are made based on observations of the clocks drift and offset. Temperature changes, which may be significant when powering up a system, affect the stability of hardware clocks. Although adjustments begin within a few milliseconds of booting a system, acceptable accuracy may take anything from ten seconds from a warm restart to a number of hours depending on your requirements, operating environment and hardware. <application>chrony</application> is a different implementat
ion of the <systemitem class="protocol">NTP</systemitem> protocol than <systemitem class="daemon">ntpd</systemitem>, it can adjust the system clock more rapidly.
+ <application>Chrony</application> consists of <systemitem class="daemon">chronyd</systemitem>, a daemon that runs in user space, and <application>chronyc</application>, a command line program for making adjustments to <systemitem class="daemon">chronyd</systemitem>. Systems which are not permanently connected, or not permanently powered up, take a relatively long time to adjust their system clocks with <systemitem class="daemon">ntpd</systemitem>. This is because many small corrections are made based on observations of the clocks drift and offset. Temperature changes, which may be significant when powering up a system, affect the stability of hardware clocks. Although adjustments begin within a few milliseconds of booting a system, acceptable accuracy may take anything from ten seconds from a warm restart to a number of hours depending on your requirements, operating environment and hardware. <application>chrony</application> is a different implementation of the <systemit
em class="protocol">NTP</systemitem> protocol than <systemitem class="daemon">ntpd</systemitem>, it can adjust the system clock more rapidly.
</para>
<section id="sect-differences_between_ntpd_and_chronyd">
@@ -40,7 +40,7 @@ There is a choice between the daemons <systemitem class="daemon">ntpd</systemite
</listitem>
<listitem>
<para>
- <systemitem class="daemon">chronyd</systemitem> can usually synchronise the clock faster and with better accuracy.
+ <systemitem class="daemon">chronyd</systemitem> can usually synchronise the clock faster and with better time accuracy.
</para>
</listitem>
<listitem>
@@ -50,8 +50,7 @@ There is a choice between the daemons <systemitem class="daemon">ntpd</systemite
</listitem>
<listitem>
<para>
- <systemitem class="daemon">chronyd</systemitem> in the default configuration never steps the time, in order not to upset other running programs. <systemitem class="daemon">ntpd</systemitem> can be configured to never
- step the time too, but it has to use a different means of adjusting the clock, which has some disadvantages.
+ <systemitem class="daemon">chronyd</systemitem> in the default configuration never steps the time after the clock has been synchronized at system start, in order not to upset other running programs. <systemitem class="daemon">ntpd</systemitem> can be configured to never step the time too, but it has to use a different means of adjusting the clock, which has some disadvantages.
</para>
</listitem>
<listitem>
@@ -392,7 +391,7 @@ The <command>rtcfile</command> directive defines the name of the file in which <
The format of the syntax is:
-<screen>rtcfile /etc/chrony.rtc</screen>
+<screen>rtcfile /var/lib/chrony/rtc</screen>
<systemitem class="daemon">chronyd</systemitem> saves information in this file when it exits and when the writertc command is issued in <application>chronyc</application>. The information saved is the RTC’s error at some epoch, that epoch (in seconds since January 1 1970), and the rate at which the RTC gains or loses time.
@@ -408,7 +407,7 @@ Not all real-time clocks are supported as their code system-specific.
<section id="sect-Security_with_chronyc">
<title>Security with chronyc</title>
<para>
- As access to <application>chronyc</application> allows changing <systemitem class="daemon">chronyd</systemitem> just as editing the configuration files would, access to <application>chronyc</application> should be limited. Passwords or their hashes can be specified in the key file, to restrict the use of <application>chronyc</application>. One of the entries is used to restrict the use of operational commands and is referred to as the command key. In the default configuration, a random command key is generated automatically on start. It should not be necessary to specify or alter it manually.</para>
+ As access to <application>chronyc</application> allows changing <systemitem class="daemon">chronyd</systemitem> just as editing the configuration files would, access to <application>chronyc</application> should be limited. Passwords can be specified in the key file, written in ASCII or HEX, to restrict the use of <application>chronyc</application>. One of the entries is used to restrict the use of operational commands and is referred to as the command key. In the default configuration, a random command key is generated automatically on start. It should not be necessary to specify or alter it manually.</para>
<para>Other entries in the key file can be used as <systemitem class="protocol">NTP</systemitem> keys to authenticate packets received from remote <systemitem class="protocol">NTP</systemitem> servers or peers. The two sides need to share a key with identical ID, hash type and password in their key file. This requires manually creating the keys and copying them over a secure medium, such as <systemitem class="protocol">SSH</systemitem>. If the key ID was, for example, 10 then the systems that act as clients must have a line in their configuration files in the following format:
<screen>server w.x.y.z key 10
peer w.x.y.z key 10
@@ -433,16 +432,14 @@ peer w.x.y.z key 10
Were <literal>20</literal> is the key ID and <literal>foobar</literal> is the secret authentication key. The default hash is MD5, and ASCII is the default format for the key.
</para>
<para>
- By default, <systemitem class="daemon">chronyd</systemitem> is configured to listen for commands only from <systemitem class="systemname">localhost</systemitem> (<systemitem class="ipaddress">127.0.0.1</systemitem> and <systemitem class="ipaddress">::1</systemitem>). To access <systemitem class="daemon">chronyd</systemitem> remotely with <application>chronyc</application>, any <command>bindcmdaddress</command> directives in the <filename>/etc/chrony.conf</filename> file should be removed to enable listening on all interfaces and the <command>cmdallow</command> directive should be used to allow commands from the remote IP address, network, or subnet. Note that the <command>allow</command> directive is for <systemitem class="protocol">NTP</systemitem> access whereas the <command>cmdallow</command> directive is to enable the receiving of remote commands. It is possible to make these changes temporarily using <application>chronyc</application> running locally. Edit the c
onfiguration file to make persistent changes.
+ By default, <systemitem class="daemon">chronyd</systemitem> is configured to listen for commands only from <systemitem class="systemname">localhost</systemitem> (<systemitem class="ipaddress">127.0.0.1</systemitem> and <systemitem class="ipaddress">::1</systemitem>) on port <literal>323</literal>. To access <systemitem class="daemon">chronyd</systemitem> remotely with <application>chronyc</application>, any <command>bindcmdaddress</command> directives in the <filename>/etc/chrony.conf</filename> file should be removed to enable listening on all interfaces and the <command>cmdallow</command> directive should be used to allow commands from the remote IP address, network, or subnet. In addition, port <literal>323</literal> has to be opened in the firewall in order to connect from a remote system. Note that the <command>allow</command> directive is for <systemitem class="protocol">NTP</systemitem> access whereas the <command>cmdallow</command> directive is to enable the
receiving of remote commands. It is possible to make these changes temporarily using <application>chronyc</application> running locally. Edit the configuration file to make persistent changes.
</para>
<para>
The communication between <application>chronyc</application> and <application>chronyd</application> is done over <systemitem class="protocol">UDP</systemitem>, so it needs to be authorized before issuing operational commands. To authorize, use the <command>authhash</command> and <command>password</command> commands as follows:
<screen>chronyc> <command>authhash SHA1</command>
chronyc> <command>password HEX:A6CFC50C9C93AB6E5A19754C246242FC5471BCDF</command>
200 OK</screen>
- Alternatively, you can use the <application>chrony-helper</application> wrapper, which will do that automatically. For example, to use the <command>reselect</command> command:
- <screen>~]# <command>/usr/libexec/chrony-helper command reselect</command></screen>
- </para>
+ </para>
<para>
Only the following commands can be used without providing a password:
@@ -980,8 +977,8 @@ Where <systemitem class="ipaddress">192.0.2.123</systemitem> is the address of t
</para>
<para>
- The utility can also be invoked in non-interactive command mode if called together with an option as follows:
- <screen>~]# <command>chronyc <replaceable>option</replaceable></command></screen>
+ The utility can also be invoked in non-interactive command mode if called together with a command as follows:
+ <screen>~]# <command>chronyc <replaceable>command</replaceable></command></screen>
</para>
</section>
@@ -994,7 +991,7 @@ Where <replaceable>hostname</replaceable> is the <systemitem class="systemname">
</para>
<para>
To configure <application>chrony</application> to connect to a remote instance of <systemitem class="daemon">chronyd</systemitem> on a non-default port, issue a command as root in the following format:
-<screen>~]# <command>chronyc <option>-p</option> <replaceable>port</replaceable></command></screen>
+<screen>~]# <command>chronyc <option>-h</option> <replaceable>hostname</replaceable> <option>-p</option> <replaceable>port</replaceable></command></screen>
Where <replaceable>port</replaceable> is the port in use for controlling and monitoring by the instance of <systemitem class="daemon">chronyd</systemitem> to be connected to.
</para>
<para>
@@ -1002,11 +999,9 @@ Note that commands issued at the <application>chrony</application> command promp
</para>
<para>
- From the remote systems, the system administrator can issue commands after first using the <command>password</command> command at the <application>chronyc</application> command prompt as follows:
+From the remote systems, the system administrator can issue commands after first using the <command>password</command> command, preceded by the <command>authhash</command> command if the key used a hash different from MD5, at the <application>chronyc</application> command prompt as follows:
<screen>chronyc> <command>password secretpasswordwithnospaces</command>
200 OK</screen>
- Alternatively, the remote system can use the chrony-helper wrapper, which will do that automatically. For example, to use the <command>reselect</command> command:
- <screen>~]# <command>/usr/libexec/chrony-helper command reselect</command></screen>
</para>
<para>
10 years, 10 months