From owner-freebsd-doc@FreeBSD.ORG Sun Nov 13 06:30:16 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CDA94106566C for ; Sun, 13 Nov 2011 06:30:16 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B1A2D8FC0A for ; Sun, 13 Nov 2011 06:30:16 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAD6UGY1015528 for ; Sun, 13 Nov 2011 06:30:16 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAD6UG0r015525; Sun, 13 Nov 2011 06:30:16 GMT (envelope-from gnats) Date: Sun, 13 Nov 2011 06:30:16 GMT Message-Id: <201111130630.pAD6UG0r015525@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Jason Helfman Cc: Subject: Re: docs/162494: books/porters-handbook,handbook: follow deprecatation of apache13 in documentation X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Jason Helfman List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 13 Nov 2011 06:30:16 -0000 The following reply was made to PR docs/162494; it has been noted by GNATS. From: Jason Helfman To: bug-followup@freebsd.org Cc: Subject: Re: docs/162494: books/porters-handbook,handbook: follow deprecatation of apache13 in documentation Date: Sat, 12 Nov 2011 22:20:41 -0800 --17pEHd4RhPHOinZp Content-Type: text/plain; charset=us-ascii; format=flowed Content-Disposition: inline better diff format attached. -jgh -- Jason Helfman System Administrator experts-exchange.com http://www.experts-exchange.com/M_4830110.html E4AD 7CF1 1396 27F6 79DD 4342 5E92 AD66 8C8C FBA5 --17pEHd4RhPHOinZp Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="patch.txt" Index: porters-handbook/book.sgml =================================================================== RCS file: /usr/local/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.1119 diff -u -r1.1119 book.sgml --- porters-handbook/book.sgml 4 Nov 2011 14:28:43 -0000 1.1119 +++ porters-handbook/book.sgml 8 Nov 2011 01:29:11 -0000 @@ -14766,8 +14766,8 @@ does not work with some other currently installed port (for instance, the port depends on - www/apache21 but - www/apache13 + www/apache20 but + www/apache22 is installed) 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 -u -r1.247 chapter.sgml --- handbook/config/chapter.sgml 15 Jun 2011 13:44:49 -0000 1.247 +++ handbook/config/chapter.sgml 8 Nov 2011 01:29:11 -0000 @@ -352,7 +352,7 @@ may be necessary to configure the software in a manner which will allow it to be started upon system initialization. Services, such as mail/postfix or - www/apache13 are just two + www/apache22 are just two of the many software packages which may be started during system initialization. This section explains the procedures available for starting third party software. 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 -u -r1.75 chapter.sgml --- handbook/mac/chapter.sgml 29 Sep 2009 14:20:43 -0000 1.75 +++ handbook/mac/chapter.sgml 8 Nov 2011 01:29:11 -0000 @@ -1651,7 +1651,7 @@ so will result in errors. While at it, ensure that the net-mngt/nagios-plugins, net-mngt/nagios, and - www/apache13 ports are all + www/apache22 ports are all installed, configured, and working correctly. 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 -u -r1.138 chapter.sgml --- handbook/network-servers/chapter.sgml 18 Oct 2011 14:10:18 -0000 1.138 +++ handbook/network-servers/chapter.sgml 11 Nov 2011 21:23:14 -0000 @@ -4346,17 +4346,17 @@ included on your FreeBSD installation media. If you did not install Apache when you first installed FreeBSD, then you can install it from the www/apache13 or www/apache22 port. Once Apache has been installed successfully, it must be configured. - This section covers version 1.3.X of the + This section covers version 2.2.X of the Apache HTTP Server as that is the - most widely used version for &os;. Apache 2.X introduces many - new technologies but they are not discussed here. For more - information about Apache 2.X, please see Apache +  2.X introduces many new technologies but + they are not discussed here. For more information about + Apache 2.X, please see . @@ -4369,119 +4369,19 @@ The main Apache HTTP Server configuration file is installed as - /usr/local/etc/apache/httpd.conf on &os;. + /usr/local/etc/apache22/httpd.conf on &os;. This file is a typical &unix; text configuration file with comment lines beginning with the # character. A comprehensive description of all possible - configuration options is outside the scope of this book, so - only the most frequently modified directives will be described - here. - - - - ServerRoot "/usr/local" - - - This specifies the default directory hierarchy for - the Apache installation. Binaries are stored in the - bin and - sbin subdirectories - of the server root, and configuration files are stored in - etc/apache. - - - - - ServerAdmin you@your.address - - - The address to which problems with the server should - be emailed. This address appears on some - server-generated pages, such as error documents. - - - - - ServerName www.example.com - - - ServerName 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 www - instead of the host's real name). - - - - - DocumentRoot "/usr/local/www/data" - - - DocumentRoot: 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. - - - - - It is always a good idea to make backup copies of your - Apache configuration file before making changes. Once you are - satisfied with your initial configuration you are ready to - start running Apache. + configuration options is outside the scope of this book, however + the Apache HTTP Server + Documentation is a great resource for configuring your + web server. - - - - - - - - - Running <application>Apache</application> - - Apache - starting or stopping - - Apache does not run from the - inetd 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 Apache for - the first time, just run: - - &prompt.root; /usr/local/sbin/apachectl start - - You can stop the server at any time by typing: - - &prompt.root; /usr/local/sbin/apachectl stop - - After making changes to the configuration file for any - reason, you will need to restart the server: - - &prompt.root; /usr/local/sbin/apachectl restart - - To restart Apache without - aborting current connections, run: - - &prompt.root; /usr/local/sbin/apachectl graceful - - Additional information available at - &man.apachectl.8; manual page. - - To launch Apache at system + To launch Apache 2.2 at system startup, add the following line to /etc/rc.conf: - apache_enable="YES" - - or for Apache 2.2: - apache22_enable="YES" If you would like to supply additional command line @@ -4490,110 +4390,8 @@ may specify them with an additional line in rc.conf: - apache_flags="" - - Now that the web server is running, you can view your web - site by pointing a web browser to - http://localhost/. The default web page - that is displayed is - /usr/local/www/data/index.html. - - - - - Virtual Hosting - - Apache 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. - - To setup Apache to use - Name-based Virtual Hosting add an entry like the following to - your httpd.conf: - - NameVirtualHost * - - If your webserver was named www.domain.tld and - you wanted to setup a virtual domain for - www.someotherdomain.tld then you would add - the following entries to - httpd.conf: - - <VirtualHost *> -ServerName www.domain.tld -DocumentRoot /www/domain.tld -</VirtualHost> - -<VirtualHost *> -ServerName www.someotherdomain.tld -DocumentRoot /www/someotherdomain.tld -</VirtualHost> - - Replace the addresses with the addresses you want to use - and the path to the documents with what you are using. - - For more information about setting up virtual hosts, - please consult the official Apache - documentation at: . - - - - - Apache Modules - - Apache - modules - - There are many different Apache modules available to add - functionality to the basic server. The FreeBSD Ports - Collection provides an easy way to install - Apache together with some of the - more popular add-on modules. - - - mod_ssl - - web servers - secure - SSL - cryptography - - The mod_ssl 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;. - - If you have not yet installed - Apache, then a version of Apache - 1.3.X that includes mod_ssl may be installed with the www/apache13-modssl port. SSL - support is also available for Apache 2.X in the - www/apache22 port, - where it is enabled by default. - - - - - - - - Language Bindings - - There are Apache modules for most major scripting - languages. These modules typically make it possible to - write Apache 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. - - + apache22_flags="" + Dynamic Websites @@ -4692,17 +4490,8 @@ overhead of starting an external interpreter and the penalty of Perl start-up time. - mod_perl is available a few - different ways. To use mod_perl - remember that mod_perl 1.0 only - works with Apache 1.3 and - mod_perl 2.0 only works with - Apache 2.X. - mod_perl 1.0 is available in - www/mod_perl and a - statically compiled version is available in - www/apache13-modperl. - mod_perl 2.0 is available in + mod_perl 2.0 only works with + Apache 2.X, and is available in www/mod_perl2. 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 -u -r1.340 chapter.sgml --- handbook/security/chapter.sgml 15 Jun 2011 22:34:36 -0000 1.340 +++ handbook/security/chapter.sgml 8 Nov 2011 01:29:11 -0000 @@ -2351,7 +2351,7 @@ Some uses of OpenSSL may include encrypted authentication of mail clients, web based transactions such as credit card payments and more. Many ports such as - www/apache13-ssl, and + www/apache22, and mail/claws-mail will offer compilation support for building with OpenSSL. --17pEHd4RhPHOinZp--