[deployment-guide/comm-rel: 457/727] Updated the Starting the httpd Server section.
Jaromir Hradilek
jhradile at fedoraproject.org
Tue Oct 19 13:03:16 UTC 2010
commit 6ce85bb57bd11de327183e48f8a1a176e772b0ad
Author: Jaromir Hradilek <jhradile at redhat.com>
Date: Mon Aug 23 16:05:36 2010 +0200
Updated the Starting the httpd Server section.
Note that I will probably move this section somewhere else in the very
near future.
en-US/The_Apache_HTTP_Server.xml | 83 +++++++++++++++-----------------------
1 files changed, 33 insertions(+), 50 deletions(-)
---
diff --git a/en-US/The_Apache_HTTP_Server.xml b/en-US/The_Apache_HTTP_Server.xml
index 37da004..75873da 100644
--- a/en-US/The_Apache_HTTP_Server.xml
+++ b/en-US/The_Apache_HTTP_Server.xml
@@ -131,68 +131,50 @@
</section>
</section>
<section id="s1-apache-startstop">
- <title>Starting and Stopping <command>httpd</command></title>
+ <title>Starting the <systemitem class="service">httpd</systemitem> Server</title>
<indexterm>
- <primary>Apache HTTP Server</primary>
- <secondary>starting</secondary>
- </indexterm>
- <indexterm>
- <primary>Apache HTTP Server</primary>
- <secondary>stopping</secondary>
- </indexterm>
- <indexterm>
- <primary>Apache HTTP Server</primary>
- <secondary>reloading</secondary>
- </indexterm>
- <indexterm>
- <primary>Apache HTTP Server</primary>
- <secondary>restarting</secondary>
+ <primary><application>Apache HTTP Server</application></primary>
+ <secondary><systemitem class="service">httpd</systemitem> service</secondary>
+ <tertiary>running</tertiary>
</indexterm>
<para>
- After installing the <filename>httpd</filename> package, review the Apache HTTP Server's documentation available online at <ulink url="http://httpd.apache.org/docs/2.2/">http://httpd.apache.org/docs/2.2/</ulink>.
- </para>
- <para>
- The <filename>httpd</filename> RPM installs the <filename>/etc/init.d/httpd</filename> script, which can be accessed using the <command>/sbin/service</command> command.
- </para>
- <para>
- Starting <command>httpd</command> using the <command>apachectl</command> control script sets the environmental variables in <filename>/etc/sysconfig/httpd</filename> and starts <command>httpd</command>. You can also set the environment variables using the init script.
- </para>
- <para>
- To start the server using the <command>apachectl</command> control script as root type:
- </para>
- <screen><command>apachectl start</command></screen>
- <para>
- You can also start <command>httpd</command> using <command>/sbin/service httpd start</command>. This starts <command>httpd</command> but does not set the environment variables. If you are using the default <command>Listen</command> directive in <command>httpd.conf</command>, which is port 80, you will need to have root privileges to start the apache server.
- </para>
- <para>
- To stop the server, as root type:
- </para>
- <screen><command>apachectl stop</command></screen>
- <para>
- You can also stop <command>httpd</command> using <command>/sbin/service httpd stop</command>. The <option>restart</option> option is a shorthand way of stopping and then starting the Apache HTTP Server.
- </para>
- <para>
- You can restart the server as root by typing:
- </para>
- <screen><command>apachectl restart</command>
-or:
-<command>/sbin/service httpd restart</command></screen>
- <para>
- Apache will display a message on the console or in the <filename>ErrorLog</filename> if it encounters an error while starting.
+ To run the <systemitem class="service">httpd</systemitem> service, type the following at a shell prompt:
</para>
+ <screen>~]# <command>service httpd start</command>
+Starting httpd: [ OK ]</screen>
+ <indexterm>
+ <primary><application>Apache HTTP Server</application></primary>
+ <secondary><systemitem class="service">httpd</systemitem> service</secondary>
+ <tertiary>stopping</tertiary>
+ </indexterm>
<para>
- By default, the <command>httpd</command> service does <emphasis>not</emphasis> start automatically at boot time. If you would wish to have Apache startup at boot time, you will need to add a call to <command>apachectl</command> in your startup files within the <filename>rc.N</filename> directory. A typical file used is <filename>rc.local</filename>. As this starts Apache as root, it is recommended to properly configure your security and authentication before adding this call.
+ To stop the running <systemitem class="service">httpd</systemitem> service, use the following command:
</para>
+ <screen>~]# <command>service httpd stop</command>
+Stopping httpd: [ OK ]</screen>
+ <indexterm>
+ <primary><application>Apache HTTP Server</application></primary>
+ <secondary><systemitem class="service">httpd</systemitem> service</secondary>
+ <tertiary>enabling</tertiary>
+ </indexterm>
<para>
- You can also configure the <command>httpd</command> service to start up at boot time, using an initscript utility, such as <command>/sbin/chkconfig</command>, <application>/usr/sbin/ntsysv</application>, or the <application>Services Configuration Tool</application> program.
+ Finally, if you want the service to start automatically at the boot time, type:
</para>
+ <screen>~]# <command>chkconfig httpd on</command></screen>
<para>
- You can also display the status of your httpd server by typing:
+ This will enable the service for all runlevels. Refer to <xref linkend="ch-Controlling_Access_to_Services" /> for the detailed information on how to manage services.
</para>
- <screen><command>apachectl status</command></screen>
+ <indexterm>
+ <primary><application>Apache HTTP Server</application></primary>
+ <secondary><systemitem class="service">httpd</systemitem> service</secondary>
+ <tertiary>checking the status</tertiary>
+ </indexterm>
<para>
- The status module <command>mod_status</command> however needs to be enabled in your <filename>httpd.conf</filename> configuration file for this to work. For more details on <command>mod_status</command> can be found on <ulink url="http://httpd.apache.org/docs/2.2/mod/mod_status.html" />.
+ Note that you can check whether the service is running by typing the following:
</para>
+ <screen>~]# <command>service httpd status</command>
+httpd (pid 19014) is running...</screen>
+ <!-- TODO: Verify.
<note>
<title>Note</title>
<para>
@@ -202,6 +184,7 @@ or:
You can find more information on <ulink url="http://httpd.apache.org/docs/2.2/ssl" />.
</para>
</note>
+ -->
</section>
<section id="s1-apache-config">
<title>Configuration Directives in <filename>httpd.conf</filename></title>
More information about the docs-commits
mailing list