[deployment-guide/comm-rel: 13/26] Updated the ntsysv section.

dsilas dsilas at fedoraproject.org
Mon Jun 21 11:42:38 UTC 2010


commit 7fc1e1beb447420f3508e85c9cac902a438dc49a
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Wed Jun 16 16:01:00 2010 +0200

    Updated the ntsysv section.

 en-US/Controlling_Access_to_Services.xml           |  112 +++++++++++++++-----
 .../controlling-access-to-services-ntsysv.png      |  Bin 0 -> 110269 bytes
 en-US/images/ntsysv.png                            |  Bin 15885 -> 0 bytes
 3 files changed, 84 insertions(+), 28 deletions(-)
---
diff --git a/en-US/Controlling_Access_to_Services.xml b/en-US/Controlling_Access_to_Services.xml
index 253a546..a38edea 100644
--- a/en-US/Controlling_Access_to_Services.xml
+++ b/en-US/Controlling_Access_to_Services.xml
@@ -142,14 +142,14 @@ Password:</screen>
       </para>
       <figure id="fig-services-serviceconf">
         <title>
-          <application>Service Configuration </application> Utility
+          <application>The Service Configuration </application> Utility
         </title>
         <mediaobject>
           <imageobject>
             <imagedata fileref="images/controlling-access-to-services-service_configuration.png" format="PNG" scalefit="1" />
           </imageobject>
           <textobject>
-            <para>Service Configuration Utility</para>
+            <para>The Service Configuration Utility</para>
           </textobject>
         </mediaobject>
       </figure>
@@ -327,6 +327,88 @@ Password:</screen>
         </para>
       </section>
     </section>
+    <section id="s2-services-ntsysv">
+      <title>Using the <application>ntsysv</application> Utility</title>
+      <para>
+        The <application>ntsysv</application> utility is a command line application with a simple text user interface to configure which services are to be started in selected runlevels. Note that in order to use the utility, you must obtain superuser privileges first:
+      </para>
+      <screen>~]$ <command>su -</command>
+Password: </screen>
+      <para>
+        To start the utility, type the following command:
+      </para>
+      <screen>~]# <command>ntsysv</command></screen>
+      <figure float="0" id="fig-ntsysv">
+        <title>The <application>ntsysv</application> utility</title>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/controlling-access-to-services-ntsysv.png" format="PNG"/>
+          </imageobject>
+          <textobject>
+            <para>The <application>ntsysv</application> utility</para>
+          </textobject>
+        </mediaobject>
+      </figure>
+      <para>
+        The utility displays the list of available services (i.e., the services from the <filename class="directory">/etc/rc.d/init.d/</filename> directory) along with their current status and a description obtainable by pressing <keycap>F1</keycap>. See <xref linkend="tab-services-ntsysv-states" /> for a list of used symbols and an explanation of their meaning.
+      </para>
+      <table id="tab-services-ntsysv-states">
+        <title>Possible Service States</title>
+        <tgroup cols="2">
+          <colspec colname="symbol" colnum="1" colwidth="10*" />
+          <colspec colname="description" colnum="2" colwidth="60*" />
+          <thead>
+            <row>
+              <entry>Symbol</entry>
+              <entry>Description</entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry>
+                <guilabel>[*]</guilabel>
+              </entry>
+              <entry>
+                The service is enabled.
+              </entry>
+            </row>
+            <row>
+              <entry>
+                <guilabel>[ ]</guilabel>
+              </entry>
+              <entry>
+                The service is disabled.
+              </entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+      <section id="s3-services-ntsysv-enabling">
+        <title>Enabling the Service</title>
+        <para>
+          To enable a service, navigate through the list using the <keycap>Up</keycap> and <keycap>Down</keycap> arrows keys, and select it with the <keycap>Spacebar</keycap>. An asterisk (<guilabel>*</guilabel>) should appear in the brackets. Once you are done, use <keycap>Tab</keycap> to navigate to the <guibutton>Ok</guibutton> button, and confirm the changes by pressing <keycap>Enter</keycap>.
+        </para>
+        <para>
+          Please, keep in mind that <application>ntsysv</application> does not actually run the service. If you need to start the service immediately, use the <command>service <replaceable>&lt;service&gt;</replaceable> start</command> command.
+        </para>
+      </section>
+      <section id="s3-services-ntsysv-disabling">
+        <title>Disabling the Service</title>
+        <para>
+          To disable a service, navigate through the list using the <keycap>Up</keycap> and <keycap>Down</keycap> arrows keys, and toggle its status with the <keycap>Spacebar</keycap>. An asterisk (<guilabel>*</guilabel>) in the brackets should disappear. Once you are done, use <keycap>Tab</keycap> to navigate to the <guibutton>Ok</guibutton> button, and confirm the changes by pressing <keycap>Enter</keycap>.
+        </para>
+        <para>
+          Please, keep in mind that <application>ntsysv</application> does not actually stop the service. If you need to stop the service immediately, use the <command>service <replaceable>&lt;service&gt;</replaceable> stop</command> command.
+        </para>
+      </section>
+      <section id="s3-services-ntsysv-selecting">
+        <title>Selecting the Runlevels</title>
+        <para>
+          By default, the <application>ntsysv</application> utility affects the current runlevel only. To enable or disable services for other runlevels, run the command with the additional <option>--level</option> option followed by the string of numbers from 0 to 6 representing each runlevel you want to configure. For example, to configure runlevels 3 and 5, type:
+        </para>
+        <screen>~]# <command>ntsysv --level 35</command></screen>
+      </section>
+    </section>
     <section id="s2-services-chkconfig">
       <title>Using the <command>chkconfig</command> Utility</title>
       <para>
@@ -406,32 +488,6 @@ rsync           off</screen>
         </para>
       </section>
     </section>
-    <section id="s2-services-ntsysv">
-      <title>Using the <application>ntsysv</application> Utility</title>
-      <para>The <application>ntsysv</application> utility provides a simple interface for activating or deactivating services. You can use <application>ntsysv</application> to turn an <command>xinetd</command>-managed service on or off. You can also use <application>ntsysv</application> to configure runlevels. By default, only the current runlevel is configured. To configure a different runlevel, specify one or more runlevels with the <option>--level</option> option. For example, the command <command>ntsysv --level 345</command> configures runlevels 3, 4, and 5.</para>
-      <para>The <application>ntsysv</application> interface works like the text mode installation program. Use the up and down arrows to navigate up and down the list. The space bar selects/unselects services and is also used to "press" the <guilabel>Ok</guilabel> and <guilabel>Cancel</guilabel> buttons. To move between the list of services and the <guilabel>Ok</guilabel> and <guilabel>Cancel</guilabel> buttons, use the <keycap>Tab</keycap> key. An asterisk (<guilabel>*</guilabel>) signifies that a service is set to on. Pressing the <keycap>F1</keycap> key displays a short description of the selected service.</para>
-      <!-- RHEL5:   ddomingo at redhat.com: added PNG image     -->
-      <figure
-        float="0"
-        id="fig-ntsysv">
-        <title>The <application>ntsysv</application> utility</title>
-        <mediaobject>
-          <imageobject>
-            <imagedata
-              fileref="images/ntsysv.png"
-              format="PNG"/>
-          </imageobject>
-          <textobject>
-            <para>The <application>ntsysv</application> utility</para>
-          </textobject>
-        </mediaobject>
-      </figure>
-      <warning>
-        <title>Warning</title>
-        <para>Services managed by <command>xinetd</command> are immediately affected by <application>ntsysv</application>. For all other services, changes do not take effect immediately. You must stop or start the individual service with the command <command>service <replaceable>&lt;daemon&gt;</replaceable> stop</command> (where <replaceable>&lt;daemon&gt;</replaceable> is the name of the service you want to stop; for example, <command>httpd</command>). Replace <command>stop</command> with <command>start</command> or <command>restart</command> to start or restart the service.</para>
-      </warning>
-    </section>
-
   </section>
   <section id="s1-services-tcp-wrappers">
     <title>Configuring TCP Wrappers</title>
diff --git a/en-US/images/controlling-access-to-services-ntsysv.png b/en-US/images/controlling-access-to-services-ntsysv.png
new file mode 100644
index 0000000..70bc146
Binary files /dev/null and b/en-US/images/controlling-access-to-services-ntsysv.png differ


More information about the docs-commits mailing list