| 1 |
swift 05/08/01 15:17:11 |
| 2 |
|
| 3 |
Modified: xml/htdocs/doc/en metadoc.xml |
| 4 |
Added: xml/htdocs/doc/en apache-upgrading.xml |
| 5 |
Log: |
| 6 |
#99539 - Adding Apache upgrading document |
| 7 |
|
| 8 |
Revision Changes Path |
| 9 |
1.91 +6 -1 xml/htdocs/doc/en/metadoc.xml |
| 10 |
|
| 11 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.91&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
| 12 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.91&content-type=text/plain&cvsroot=gentoo |
| 13 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml.diff?r1=1.90&r2=1.91&cvsroot=gentoo |
| 14 |
|
| 15 |
Index: metadoc.xml |
| 16 |
=================================================================== |
| 17 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v |
| 18 |
retrieving revision 1.90 |
| 19 |
retrieving revision 1.91 |
| 20 |
diff -u -r1.90 -r1.91 |
| 21 |
--- metadoc.xml 1 Aug 2005 14:49:01 -0000 1.90 |
| 22 |
+++ metadoc.xml 1 Aug 2005 15:17:11 -0000 1.91 |
| 23 |
@@ -1,5 +1,5 @@ |
| 24 |
<?xml version='1.0' encoding="UTF-8"?> |
| 25 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.90 2005/08/01 14:49:01 swift Exp $ --> |
| 26 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.91 2005/08/01 15:17:11 swift Exp $ --> |
| 27 |
<!DOCTYPE metadoc SYSTEM "/dtd/metadoc.dtd"> |
| 28 |
|
| 29 |
<metadoc lang="en"> |
| 30 |
@@ -360,6 +360,7 @@ |
| 31 |
<file id="shb-tight">/doc/en/security/shb-tight.xml</file> |
| 32 |
<file id="shb-uptodate">/doc/en/security/shb-uptodate.xml</file> |
| 33 |
<file id="apache-troubleshooting">/doc/en/apache-troubleshooting.xml</file> |
| 34 |
+ <file id="apache-upgrading">/doc/en/apache-upgrading.xml</file> |
| 35 |
</files> |
| 36 |
<docs> |
| 37 |
<doc id="name-logo"> |
| 38 |
@@ -984,5 +985,9 @@ |
| 39 |
<memberof>sysadmin_specific</memberof> |
| 40 |
<fileid>apache-troubleshooting</fileid> |
| 41 |
</doc> |
| 42 |
+ <doc id="apache-upgrading"> |
| 43 |
+ <memberof>sysadmin_specific</memberof> |
| 44 |
+ <fileid>apache-upgrading</fileid> |
| 45 |
+ </doc> |
| 46 |
</docs> |
| 47 |
</metadoc> |
| 48 |
|
| 49 |
|
| 50 |
|
| 51 |
1.1 xml/htdocs/doc/en/apache-upgrading.xml |
| 52 |
|
| 53 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/apache-upgrading.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
| 54 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/apache-upgrading.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo |
| 55 |
|
| 56 |
Index: apache-upgrading.xml |
| 57 |
=================================================================== |
| 58 |
<?xml version='1.0' encoding="UTF-8"?> |
| 59 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 60 |
<guide link="apache-upgrading.xml" lang="en"> |
| 61 |
<title>Upgrading Apache</title> |
| 62 |
|
| 63 |
<author title="Author"> |
| 64 |
<mail link="vericgar@g.o">Michael Stewart</mail> |
| 65 |
</author> |
| 66 |
|
| 67 |
<abstract> |
| 68 |
This document describes the procedure end-users should follow to safely |
| 69 |
upgrade their apache installation. |
| 70 |
</abstract> |
| 71 |
|
| 72 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
| 73 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 74 |
<license/> |
| 75 |
|
| 76 |
<version>2.1</version> |
| 77 |
<date>2005-08-01</date> |
| 78 |
|
| 79 |
<chapter> |
| 80 |
<title>Introduction</title> |
| 81 |
<section> |
| 82 |
<body> |
| 83 |
|
| 84 |
<p> |
| 85 |
The state of Apache and it's modules in Gentoo was becoming dismal. There |
| 86 |
were a number of problems that caused support problems and made maintaining |
| 87 |
everything the Apache herd is responsible for difficult: |
| 88 |
</p> |
| 89 |
|
| 90 |
|
| 91 |
<ul> |
| 92 |
<li> |
| 93 |
The configuration that came with Gentoo was dramatically different from |
| 94 |
the upstream configuration that most users expect |
| 95 |
</li> |
| 96 |
<li> |
| 97 |
Many modules used similar code, but all did things their own way |
| 98 |
</li> |
| 99 |
<li> |
| 100 |
Most modules weren't maintained very well - mostly because of the large |
| 101 |
number of modules available |
| 102 |
</li> |
| 103 |
<li>Modules didn't have a configuration standard</li> |
| 104 |
<li> |
| 105 |
Some modules could support both versions of Apache, but the ebuilds |
| 106 |
didn't handle that |
| 107 |
</li> |
| 108 |
<li> |
| 109 |
Choices available in Apache were not available for Gentoo users (for |
| 110 |
example MPMs) |
| 111 |
</li> |
| 112 |
<li>Bugs for Apache were stacking up</li> |
| 113 |
</ul> |
| 114 |
|
| 115 |
<p> |
| 116 |
The solution? The Apache herd was expanded, adding several new members, who |
| 117 |
worked together to create an eclass, update all the modules and fix a number |
| 118 |
of bugs. |
| 119 |
</p> |
| 120 |
|
| 121 |
|
| 122 |
<p> |
| 123 |
This document details how to upgrade without breaking your system. If you are |
| 124 |
a developer or would like to know what we changed, or how ebuilds need to be |
| 125 |
modified to take advantage of our eclass, then check the <uri |
| 126 |
link="/proj/en/developer.xml">Apache Developer Reference</uri>. |
| 127 |
</p> |
| 128 |
|
| 129 |
</body> |
| 130 |
</section> |
| 131 |
</chapter> |
| 132 |
|
| 133 |
<chapter id="upgrade"> |
| 134 |
<title>Upgrade Instructions</title> |
| 135 |
<section> |
| 136 |
<body> |
| 137 |
|
| 138 |
<p> |
| 139 |
We have made many changes to how Apache works within Gentoo. Every package |
| 140 |
that is directly related to Apache needs to be updated and some things that |
| 141 |
worked previously will no longer work. |
| 142 |
</p> |
| 143 |
|
| 144 |
<p> |
| 145 |
First you need to figure out what packages you need to upgrade. You can do |
| 146 |
this using the <c>equery</c> tool, part of the <c>app-portage/gentoolkit</c> |
| 147 |
package. |
| 148 |
</p> |
| 149 |
|
| 150 |
|
| 151 |
<pre caption="Finding packages to update"> |
| 152 |
$ <i>equery depends net-www/apache</i> |
| 153 |
[ Searching for packages depending on net-www/apache... ] |
| 154 |
dev-db/phpmyadmin-2.5.6 |
| 155 |
dev-php/mod_php-4.3.10 |
| 156 |
dev-php/phpsysinfo-2.1-r2 |
| 157 |
net-www/mod_bandwidth-2.0.5 |
| 158 |
net-www/mod_layout-4.0.1a |
| 159 |
net-www/mod_ldap_userdir-1.1.4 |
| 160 |
net-www/mod_loopback-1.04 |
| 161 |
net-www/mod_mp3-0.40 |
| 162 |
net-www/mod_random-2.0 |
| 163 |
net-www/mod_throttle-3.1.2-r1 |
| 164 |
net-www/mod_watch-3.18 |
| 165 |
www-apps/viewcvs-0.9.2_p20030430 |
| 166 |
</pre> |
| 167 |
|
| 168 |
|
| 169 |
<impo> |
| 170 |
The packages you have installed may be vastly different, make sure you run this |
| 171 |
command for yourself. |
| 172 |
</impo> |
| 173 |
|
| 174 |
|
| 175 |
<warn> |
| 176 |
There are some modules and packages that depend on Apache that have not yet |
| 177 |
been updated. Please <uri link="http://bugs.gentoo.org">search bugzilla</uri> |
| 178 |
for any critical packages that you use with Apache. |
| 179 |
</warn> |
| 180 |
|
| 181 |
|
| 182 |
<p> |
| 183 |
Many webapps aren't affected in any way as most use the <c>webapp</c> eclass |
| 184 |
which takes care of installing them correctly. You may want to check to see if |
| 185 |
there is a new revision. |
| 186 |
</p> |
| 187 |
|
| 188 |
<!-- Remove between this line and the next when new style goes stable --> |
| 189 |
|
| 190 |
<p> |
| 191 |
As all the packages that support our changes are still in unstable, to be able |
| 192 |
to use them you will need to add all the packages you want to upgrade (see |
| 193 |
above) as well as the following to <path>/etc/portage/package.keywords</path>. |
| 194 |
</p> |
| 195 |
|
| 196 |
|
| 197 |
<note> |
| 198 |
<path>/etc/portage</path> may not exist, please create it, as well as the files |
| 199 |
inside it. |
| 200 |
</note> |
| 201 |
|
| 202 |
|
| 203 |
<pre caption="Additions to /etc/portage/package.keywords"> |
| 204 |
<comment>(If you are using Apache 1.3)</comment> |
| 205 |
=net-www/apache-1* |
| 206 |
net-www/gentoo-webroot-default |
| 207 |
|
| 208 |
<comment>(If you want to use lingerd with Apache 1.3)</comment> |
| 209 |
net-www/lingerd |
| 210 |
|
| 211 |
<comment>(If you are using Apache 2.0)</comment> |
| 212 |
net-www/apache |
| 213 |
dev-libs/apr |
| 214 |
dev-libs/apr-util |
| 215 |
net-www/gentoo-webroot-default |
| 216 |
|
| 217 |
<comment>(Include all others that you need to upgrade as well)</comment> |
| 218 |
dev-php/mod_php |
| 219 |
net-www/mod_bandwidth |
| 220 |
net-www/mod_layout |
| 221 |
net-www/mod_ldap_userdir |
| 222 |
net-www/mod_loopback |
| 223 |
net-www/mod_mp3 |
| 224 |
net-www/mod_random |
| 225 |
net-www/mod_throttle |
| 226 |
net-www/mod_watch |
| 227 |
</pre> |
| 228 |
|
| 229 |
<!-- Remove between this line and the previous when new style goes stable --> |
| 230 |
|
| 231 |
<p> |
| 232 |
As we have added some new USE-flags, you may want to review them and add |
| 233 |
appropriate lines to <path>/etc/portage/package.use</path>. See <uri |
| 234 |
link="#use">Apache supported USE-flags</uri> for more details. |
| 235 |
</p> |
| 236 |
|
| 237 |
|
| 238 |
<pre caption="Checking USE flag settings and rebuild"> |
| 239 |
<comment>(Check the USE-flags and needed updates)</comment> |
| 240 |
# <i>emerge --pretend --verbose --update --newuse --deep apache subversion \ |
| 241 |
mod_php mod_bandwidth mod_layout mod_ldap_userdir mod_loopback mod_mp3 \ |
| 242 |
mod_random mod_throttle mod_watch</i> |
| 243 |
|
| 244 |
<comment>(Update the packages)</comment> |
| 245 |
# <i>emerge --verbose --update --newuse --deep apache subversion mod_php \ |
| 246 |
mod_bandwidth mod_layout mod_ldap_userdir mod_loopback mod_mp3 mod_random \ |
| 247 |
mod_throttle mod_watch</i> |
| 248 |
|
| 249 |
<comment>(It may be easier to just update world instead of the above)</comment> |
| 250 |
# <i>emerge --ask --verbose --update --newuse --deep world</i> |
| 251 |
</pre> |
| 252 |
|
| 253 |
|
| 254 |
<p> |
| 255 |
Now you need to reconfigure Apache and its modules. Start by using |
| 256 |
<c>etc-update</c> or <c>dispatch-conf</c> to update the <path>/etc/init.d</path> |
| 257 |
|
| 258 |
|
| 259 |
|
| 260 |
-- |
| 261 |
gentoo-doc-cvs@g.o mailing list |
Archives