PERFORCE change 161507 for review

[Rene Ladan]

http://perforce.freebsd.org/chv.cgi?CH=161507

Change 161507 by rene at rene_self on 2009/05/03 21:39:48

	[solid-state] : tidy up the Apache section (5.4), note that the default is fine.

Affected files ...

.. //depot/projects/docproj_nl/en_US.ISO8859-1/articles/solid-state/article.sgml#13 edit

Differences ...

==== //depot/projects/docproj_nl/en_US.ISO8859-1/articles/solid-state/article.sgml#13 (text+ko) ====

@@ -430,33 +430,44 @@
     <sect2>
       <title>Apache Web Server</title>
 
-      <para>Apache keeps pid files and logs in
-	<filename><replaceable>apache_install</replaceable>/logs</filename>.
-	Since this directory doubtless exists on a read-only filesystem, this
+      <note>
+	<para>The steps in this section are only necessary if Apache is 
+	  set up to write its pid or log information outside of
+	  <filename class="directory">/var</filename>.  By default,
+	  Apache keeps its pid file in <filename
+	    class="directory">/var/run/httpd.pid</filename> and its log
+	  files in <filename class="directory">/var/log</filename>.</para>
+      </note>
+
+      <para>It is now assumed that Apache keeps its log files in a
+	directory <filename
+	  class="directory"><replaceable>apache_log_dir</replaceable></filename>
+	outside of <filename class="directory">/var</filename>.
+	Since these directories doubtlessly exist on a read-only filesystem, this
 	will not work.  It is necessary to add a new directory to the
-	<filename>/etc/rc.initdiskless</filename> list of directories to create
-	in <filename>/var</filename>, to link
-	<filename><replaceable>apache_install</replaceable>/logs</filename> to
+	<filename>/etc/rc.d/var</filename> list of directories to create
+	in <filename>/var</filename>, and to link
+	<filename class="directory"><replaceable>apache_log_dir</replaceable></filename> to
 	<filename>/var/log/apache</filename>.  It is also necessary to set
 	permissions and ownership on this new directory.</para>
 
       <para>First, add the directory <literal>log/apache</literal> to the list
 	of directories to be created in
-	<filename>/etc/rc.initdiskless</filename>.</para>
+	<filename>/etc/rc.d/var</filename>.</para>
       
       <para>Second, add these commands to
-	<filename>/etc/rc.initdiskless</filename> after the directory creation
+	<filename>/etc/rc.d/var</filename> after the directory creation
 	section:</para>
 
       <screen>&prompt.root; <userinput>chmod 0774 /var/log/apache</userinput>
 &prompt.root; <userinput>chown nobody:nobody /var/log/apache</userinput></screen>
 
       <para>Finally, remove the existing
-	<filename><replaceable>apache_install</replaceable>/logs</filename>
+	<filename class="directory"><replaceable>apache_log_dir</replaceable></filename>
 	directory, and replace it with a link:</para>
 
-      <screen>&prompt.root; <userinput>rm -rf (apache_install)/logs</userinput>
-&prompt.root; <userinput>ln -s /var/log/apache (apache_install)/logs</userinput></screen>
+      <screen>&prompt.root; <userinput>rm -rf <filename class="directory"><replaceable>apache_log_dir</replaceable></filename></userinput>
+&prompt.root; <userinput>ln -s /var/log/apache <filename class="directory"><replaceable>apache_log_dir</replaceable></filename></userinput></screen>
     </sect2>
   </sect1>
 </article>