[deployment-guide] Updated the "Using the Command Line Tools" section.
Jaromir Hradilek
jhradile at fedoraproject.org
Mon Oct 17 15:58:01 UTC 2011
commit 125066ae752460007da0c20eb730e5d7cbda5d72
Author: Jaromir Hradilek <jhradile at redhat.com>
Date: Mon Oct 17 17:53:24 2011 +0200
Updated the "Using the Command Line Tools" section.
en-US/Configuring_the_Date_and_Time.xml | 80 +++++++++++++++----------------
1 files changed, 38 insertions(+), 42 deletions(-)
---
diff --git a/en-US/Configuring_the_Date_and_Time.xml b/en-US/Configuring_the_Date_and_Time.xml
index f644b50..0ee2c13 100644
--- a/en-US/Configuring_the_Date_and_Time.xml
+++ b/en-US/Configuring_the_Date_and_Time.xml
@@ -65,13 +65,12 @@
</para>
</section>
<section id="sect-Configuring_the_Date_and_Time-Command_Line_Configuration">
- <title>Configuring the Date and Time on the Command Line</title>
+ <title>Using the Command Line Tools</title>
<para>
- In case your system does not have the <application>Date/Time Properties</application> tool installed, or the <emphasis>X Window Server</emphasis> is not running, you can change the system date and time on the command line. Note that in order to perform actions described in this section, you have to be logged in as <systemitem class="username">root</systemitem>. To do so, type the following at a shell prompt:
+ &MAJOROSVER; provides command line tools that allow you to configure the date and time both manually and using the NTP protocol.
</para>
- <screen><command>su -</command></screen>
- <section id="sect-Configuring_the_Date_and_Time-Command_Line_Configuration-Date_and_Time">
- <title>Configuring the Date and Time</title>
+ <section id="sect-Configuring_the_Date_and_Time-Command_Line_Configuration-Date">
+ <title>Changing the Date</title>
<indexterm>
<primary>time</primary>
</indexterm>
@@ -79,37 +78,34 @@
<primary><command>date</command></primary>
</indexterm>
<para>
- The <command>date</command> command allows the superuser to set the system date and time manually:
+ To change the system date, type the following at a shell prompt as <systemitem class="username">root</systemitem>:
</para>
- <procedure>
- <step>
- <para>
- To change the current date, type the command in the following form at a shell prompt, replacing the <replaceable>YYYY</replaceable> with a four-digit year, <replaceable>MM</replaceable> with a two-digit month, and <replaceable>DD</replaceable> with a two-digit day of the month:
- </para>
- <screen><command>date +%D -s <replaceable>YYYY-MM-DD</replaceable></command></screen>
- <para>
- For example, to set the date to 2 June 2010, type:
- </para>
- <screen>~]# <command>date +%D -s 2010-06-02</command></screen>
- </step>
- <step>
- <para>
- To change the current date, use the following command, where <replaceable>HH</replaceable> stands for an hour, <replaceable>MM</replaceable> is a minute, and <replaceable>SS</replaceable> is a second, all typed in a two-digit form:
- </para>
- <screen><command>date +%T -s <replaceable>HH:MM:SS</replaceable></command></screen>
- <para>If your system clock is set to use <acronym>UTC</acronym> (Coordinated Universal Time), add the following option:</para>
- <screen><command>date +%T -s <replaceable>HH:MM:SS</replaceable> -u</command></screen>
- <para>
- For instance, to set the system clock to 11:26 PM using the <acronym>UTC</acronym>, type:
- </para>
- <screen>~]# <command>date +%T -s 23:26:00 -u</command></screen>
- </step>
- </procedure>
+ <screen><command>date +%D -s <replaceable>YYYY-MM-DD</replaceable></command></screen>
+ <para>
+ …where <replaceable>YYYY</replaceable> is a four-digit year, <replaceable>MM</replaceable> is a two-digit month, and <replaceable>DD</replaceable> is a two-digit day of the month. For example, to change the date to 2 June 2010, type:
+ </para>
+ <screen>~]# <command>date +%D -s 2010-06-02</command></screen>
+ <para>
+ You can verify the current settings by running <command>date</command> without any additional argument.
+ </para>
+ </section>
+ <section id="sect-Configuring_the_Date_and_Time-Command_Line_Configuration-Time">
+ <title>Changing the Time</title>
+ <para>
+ To change the current time, run the following command as <systemitem class="username">root</systemitem>:
+ </para>
+ <screen><command>date +%T -s <replaceable>HH:MM:SS</replaceable></command></screen>
+ <para>
+ …where <replaceable>HH</replaceable> stands for an hour, <replaceable>MM</replaceable> is a minute, and <replaceable>SS</replaceable> is a second, all typed in a two-digit form. If your system clock is set to use <acronym>UTC</acronym> (Coordinated Universal Time), also add the following option:
+ </para>
+ <screen><command>date +%T -s <replaceable>HH:MM:SS</replaceable> -u</command></screen>
+ <para>
+ For instance, to set the system clock to 11:26 PM using the <acronym>UTC</acronym>, type:
+ </para>
+ <screen>~]# <command>date +%T -s 23:26:00 -u</command></screen>
<para>
- You can check your current settings by typing <command>date</command> without any additional argument, for example:
+ You can verify the current settings by running <command>date</command> without any additional argument.
</para>
- <screen>~]$ <command>date</command>
-Wed Jun 2 11:58:48 CEST 2010</screen>
</section>
<section id="sect-Configuring_the_Date_and_Time-Command_Line_Configuration-Network_Time_Protocol">
<title>Configuring the Network Time Protocol</title>
@@ -139,29 +135,29 @@ Wed Jun 2 11:58:48 CEST 2010</screen>
<para>
For example, to connect to <systemitem class="server">0.fedora.pool.ntp.org</systemitem>, type:
</para>
- <screen>~]# <command>ntpdate -q 0.fedora.pool.ntp.org</command>
+ <screen>~]$ <command>ntpdate -q 0.fedora.pool.ntp.org</command>
server 204.15.208.61, stratum 2, offset -39.275438, delay 0.16083
server 69.65.40.29, stratum 2, offset -39.269122, delay 0.17191
server 148.167.132.201, stratum 2, offset -39.270239, delay 0.20482
-23 May 01:05:54 ntpdate[10619]: step time server 204.15.208.61 offset -39.275438 sec</screen>
+17 Oct 17:41:09 ntpdate[10619]: step time server 204.15.208.61 offset -39.275438 sec</screen>
</step>
<step>
<para>
- When you find a satisfactory server, run the <application>ntpdate</application> command followed with one or more server addresses:
+ When you find a satisfactory server, as <systemitem class="username">root</systemitem>, run the <application>ntpdate</application> command followed with one or more server addresses:
</para>
- <screen><command>ntpdate <replaceable>server_address...</replaceable></command></screen>
+ <screen><command>ntpdate <replaceable>server_address…</replaceable></command></screen>
<para>
For instance:
</para>
<screen>~]# <command>ntpdate 0.fedora.pool.ntp.org 1.fedora.pool.ntp.org</command>
-23 May 01:07:13 ntpdate[10669]: step time server 204.15.208.61 offset -39.275436 sec</screen>
+17 Oct 17:42:13 ntpdate[10669]: step time server 204.15.208.61 offset -39.275436 sec</screen>
<para>
- Unless an error message is displayed, the system time should now be set. You can check the current by setting typing <command>date</command> without any additional arguments as shown in <xref linkend="sect-Configuring_the_Date_and_Time-Command_Line_Configuration-Date_and_Time" />.
+ Unless an error message is displayed, the system time is now set. You can verify the current time by running the <command>date</command> command with no additional arguments.
</para>
</step>
<step performance="optional">
<para>
- In most cases, these steps are sufficient. Only if you really need one or more system services to always use the correct time, enable running the <application>ntpdate</application> at boot time:
+ In most cases, these steps are sufficient. Only if you really need one or more system services to always use the correct time, enable running the <application>ntpdate</application> at boot time by running the following command as <systemitem class="username">root</systemitem>:
</para>
<screen><command>systemctl enable ntpdate.service</command></screen>
<para>
@@ -196,7 +192,7 @@ server 148.167.132.201, stratum 2, offset -39.270239, delay 0.20482
<procedure>
<step>
<para>
- Open the NTP configuration file <filename>/etc/ntp.conf</filename> in a text editor, creating a new one if it does not already exist.
+ As <systemitem class="username">root</systemitem>, open the NTP configuration file <filename>/etc/ntp.conf</filename> in a text editor, creating a new one if it does not already exist.
</para>
</step>
<step>
@@ -243,7 +239,7 @@ restrict -6 ::1</screen>
For more information about the date and time configuration, refer to the following resources.
</para>
<section id="sect-Configuring_the_Date_and_Time-Additional_Resources-Installed_Documentation">
- <title>Additional Resources</title>
+ <title>Installed Documentation</title>
<itemizedlist>
<listitem>
<para>
More information about the docs-commits
mailing list