docs/162494: books/porters-handbook, handbook: follow deprecatation of apache13 in documentation
Jason Helfman
jhelfman at experts-exchange.com
Fri Nov 11 21:50:05 UTC 2011
>Number: 162494
>Category: docs
>Synopsis: books/porters-handbook,handbook: follow deprecatation of apache13 in documentation
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Fri Nov 11 21:50:05 UTC 2011
>Closed-Date:
>Last-Modified:
>Originator: Jason Helfman
>Release: FreeBSD 8.2-RELEASE i386
>Organization:
Experts Exchange, LLC.
>Environment:
System: FreeBSD dormouse.experts-exchange.com 8.2-RELEASE FreeBSD 8.2-RELEASE #0: Thu Feb 17 02:41:51 UTC 2011 root at mason.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC amd64
>Description:
Apache13 is being deprecated soon. Documentation should follow.
worked with apache@ group on ideas of updating configuration area, and
it was decided to remove most of it.
>How-To-Repeat:
>Fix:
Index: book.sgml
===================================================================
RCS file: /usr/local/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.1119
diff -r1.1119 book.sgml
14769,14770c14769,14770
< <filename role="package">www/apache21</filename> but
< <filename role="package">www/apache13</filename>
---
> <filename role="package">www/apache20</filename> but
> <filename role="package">www/apache22</filename>
Index: handbook/config/chapter.sgml
===================================================================
RCS file: /usr/local/ncvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v
retrieving revision 1.247
diff -r1.247 chapter.sgml
355c355
< <filename role="package">www/apache13</filename> are just two
---
> <filename role="package">www/apache22</filename> are just two
Index: handbook/mac/chapter.sgml
===================================================================
RCS file: /usr/local/ncvs/doc/en_US.ISO8859-1/books/handbook/mac/chapter.sgml,v
retrieving revision 1.75
diff -r1.75 chapter.sgml
1654c1654
< <filename role="package">www/apache13</filename> ports are all
---
> <filename role="package">www/apache22</filename> ports are all
Index: handbook/network-servers/chapter.sgml
===================================================================
RCS file: /usr/local/ncvs/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml,v
retrieving revision 1.138
diff -r1.138 chapter.sgml
4349d4348
< role="package">www/apache13</filename> or <filename
4355c4354
< <note><para>This section covers version 1.3.X of the
---
> <note><para>This section covers version 2.2.X of the
4357,4359c4356,4359
< most widely used version for &os;. <application>Apache</application> 2.X introduces many
< new technologies but they are not discussed here. For more
< information about <application>Apache</application> 2.X, please see <ulink
---
> most widely used version for &os;. <application>Apache
> </application> 2.X introduces many new technologies but
> they are not discussed here. For more information about
> <application>Apache</application> 2.X, please see <ulink
4372c4372
< <filename>/usr/local/etc/apache/httpd.conf</filename> on &os;.
---
> <filename>/usr/local/etc/apache22/httpd.conf</filename> on &os;.
4376,4430c4376,4379
< configuration options is outside the scope of this book, so
< only the most frequently modified directives will be described
< here.</para>
<
< <variablelist>
< <varlistentry>
< <term><literal>ServerRoot "/usr/local"</literal></term>
<
< <listitem>
< <para>This specifies the default directory hierarchy for
< the <application>Apache</application> installation. Binaries are stored in the
< <filename class="directory">bin</filename> and
< <filename class="directory">sbin</filename> subdirectories
< of the server root, and configuration files are stored in
< <filename class="directory">etc/apache</filename>.</para>
< </listitem>
< </varlistentry>
<
< <varlistentry>
< <term><literal>ServerAdmin you at your.address</literal></term>
<
< <listitem>
< <para>The address to which problems with the server should
< be emailed. This address appears on some
< server-generated pages, such as error documents.</para>
< </listitem>
< </varlistentry>
<
< <varlistentry>
< <term><literal>ServerName www.example.com</literal></term>
<
< <listitem>
< <para><literal>ServerName</literal> allows you to set a host name which is
< sent back to clients for your server if it is different
< to the one that the host is configured with (i.e., use <hostid>www</hostid>
< instead of the host's real name).</para>
< </listitem>
< </varlistentry>
<
< <varlistentry>
< <term><literal>DocumentRoot "/usr/local/www/data"</literal></term>
<
< <listitem>
< <para><literal>DocumentRoot</literal>: The directory out of which you will
< serve your documents. By default, all requests are taken
< from this directory, but symbolic links and aliases may
< be used to point to other locations.</para>
< </listitem>
< </varlistentry>
< </variablelist>
<
< <para>It is always a good idea to make backup copies of your
< <application>Apache</application> configuration file before making changes. Once you are
< satisfied with your initial configuration you are ready to
< start running <application>Apache</application>.</para>
---
> configuration options is outside the scope of this book, however
> the <ulink url="http://httpd.apache.org/docs/2.2/">Apache HTTP Server
> Documentation</ulink> is a great resource for configuring your
> web server.</para>
4432,4477c4381
< <!-- sect3 for performance tuning directives? maxservers minservers -->
< <!-- etc..?? -->
<
< <!-- Advanced configuration section.
<
< Performance tuning directives.
<
< Log file format -->
<
< </sect2>
<
< <sect2>
< <title>Running <application>Apache</application></title>
<
< <indexterm><primary>Apache</primary>
< <secondary>starting or stopping</secondary></indexterm>
<
< <para><application>Apache</application> does not run from the
< <application>inetd</application> super server as many other
< network servers do. It is configured to run standalone for
< better performance for incoming HTTP requests from client web
< browsers. A shell script wrapper is included to make
< starting, stopping, and restarting the server as simple as
< possible. To start up <application>Apache</application> for
< the first time, just run:</para>
<
< <screen>&prompt.root; <userinput>/usr/local/sbin/apachectl start</userinput></screen>
<
< <para>You can stop the server at any time by typing:</para>
<
< <screen>&prompt.root; <userinput>/usr/local/sbin/apachectl stop</userinput></screen>
<
< <para>After making changes to the configuration file for any
< reason, you will need to restart the server:</para>
<
< <screen>&prompt.root; <userinput>/usr/local/sbin/apachectl restart</userinput></screen>
<
< <para>To restart <application>Apache</application> without
< aborting current connections, run:</para>
<
< <screen>&prompt.root; <userinput>/usr/local/sbin/apachectl graceful</userinput></screen>
<
< <para>Additional information available at
< &man.apachectl.8; manual page.</para>
<
< <para>To launch <application>Apache</application> at system
---
> <para>To launch <application>Apache 2.2</application> at system
4481,4484d4384
< <programlisting>apache_enable="YES"</programlisting>
<
< <para>or for <application>Apache</application> 2.2:</para>
<
4493,4596c4393,4394
< <programlisting>apache_flags=""</programlisting>
<
< <para>Now that the web server is running, you can view your web
< site by pointing a web browser to
< <literal>http://localhost/</literal>. The default web page
< that is displayed is
< <filename>/usr/local/www/data/index.html</filename>.</para>
<
< </sect2>
<
< <sect2>
< <title>Virtual Hosting</title>
<
< <para><application>Apache</application> supports two different
< types of Virtual Hosting. The first method is Name-based
< Virtual Hosting. Name-based virtual hosting uses the clients
< HTTP/1.1 headers to figure out the hostname. This allows many
< different domains to share the same IP address.</para>
<
< <para>To setup <application>Apache</application> to use
< Name-based Virtual Hosting add an entry like the following to
< your <filename>httpd.conf</filename>:</para>
<
< <programlisting>NameVirtualHost *</programlisting>
<
< <para>If your webserver was named <hostid role="fqdn">www.domain.tld</hostid> and
< you wanted to setup a virtual domain for
< <hostid role="fqdn">www.someotherdomain.tld</hostid> then you would add
< the following entries to
< <filename>httpd.conf</filename>:</para>
<
< <screen><VirtualHost *>
< ServerName www.domain.tld
< DocumentRoot /www/domain.tld
< </VirtualHost>
<
< <VirtualHost *>
< ServerName www.someotherdomain.tld
< DocumentRoot /www/someotherdomain.tld
< </VirtualHost></screen>
<
< <para>Replace the addresses with the addresses you want to use
< and the path to the documents with what you are using.</para>
<
< <para>For more information about setting up virtual hosts,
< please consult the official <application>Apache</application>
< documentation at: <ulink
< url="http://httpd.apache.org/docs/vhosts/"></ulink>.</para>
<
< </sect2>
<
< <sect2>
< <title>Apache Modules</title>
<
< <indexterm><primary>Apache</primary>
< <secondary>modules</secondary></indexterm>
<
< <para>There are many different <application>Apache</application> modules available to add
< functionality to the basic server. The FreeBSD Ports
< Collection provides an easy way to install
< <application>Apache</application> together with some of the
< more popular add-on modules.</para>
<
< <sect3>
< <title>mod_ssl</title>
<
< <indexterm><primary>web servers</primary>
< <secondary>secure</secondary></indexterm>
< <indexterm><primary>SSL</primary></indexterm>
< <indexterm><primary>cryptography</primary></indexterm>
<
< <para>The <application>mod_ssl</application> module uses the OpenSSL library to provide
< strong cryptography via the Secure Sockets Layer (SSL v2/v3)
< and Transport Layer Security (TLS v1) protocols. This
< module provides everything necessary to request a signed
< certificate from a trusted certificate signing authority so
< that you can run a secure web server on &os;.</para>
<
< <para>If you have not yet installed
< <application>Apache</application>, then a version of <application>Apache</application>
< 1.3.X that includes <application>mod_ssl</application> may be installed with the <filename
< role="package">www/apache13-modssl</filename> port. SSL
< support is also available for <application>Apache</application> 2.X in the
< <filename role="package">www/apache22</filename> port,
< where it is enabled by default.</para>
<
< <!-- XXX add more information about configuring mod_ssl here. -->
< <!-- Generating keys, getting the key signed, setting up your secure -->
< <!-- web server! -->
< </sect3>
<
< <sect3>
< <title>Language Bindings</title>
<
< <para>There are Apache modules for most major scripting
< languages. These modules typically make it possible to
< write <application>Apache</application> modules entirely in
< a scripting language. They are also often used as a
< persistent interpreter embedded into the server that avoids
< the overhead of starting an external interpreter and the
< startup-time penalty for dynamic websites, as described in
< the next section.</para>
< </sect3>
< </sect2>
---
> <programlisting>apache22_flags=""</programlisting>
> </sect2>
4695,4705c4493,4494
< <para><application>mod_perl</application> is available a few
< different ways. To use <application>mod_perl</application>
< remember that <application>mod_perl</application> 1.0 only
< works with <application>Apache</application> 1.3 and
< <application>mod_perl</application> 2.0 only works with
< <application>Apache</application> 2.X.
< <application>mod_perl</application> 1.0 is available in
< <filename role="package">www/mod_perl</filename> and a
< statically compiled version is available in
< <filename role="package">www/apache13-modperl</filename>.
< <application>mod_perl</application> 2.0 is available in
---
> <para><application>mod_perl</application> 2.0 only works with
> <application>Apache</application> 2.X, and is available in
Index: handbook/security/chapter.sgml
===================================================================
RCS file: /usr/local/ncvs/doc/en_US.ISO8859-1/books/handbook/security/chapter.sgml,v
retrieving revision 1.340
diff -r1.340 chapter.sgml
2354c2354
< <filename role="package">www/apache13-ssl</filename>, and
---
> <filename role="package">www/apache22</filename>, and
>Release-Note:
>Audit-Trail:
>Unformatted:
More information about the freebsd-doc
mailing list