Chapter 4 Apache Server Frequently Asked Questions

726 Pages·2005·3.47 MB·English

by  Apache Software Foundation

Apache HTTP Server Documentation Version 2.2
ApacheSoftwareFoundation
December2,2005
ii
About The PDF Documentation
Copyright(cid:13)c2005TheApacheSoftwareFoundation
LicensedundertheApacheLicense,Version2.0(the”License”);youmaynotusethisfileexceptincompliancewith
theLicense. YoumayobtainacopyoftheLicenseathttp://www.apache.org/licenses/LICENSE-2.0
This version of the Apache HTTP Server Documentation is converted from XML source files to LATEX using XSLT
withthehelpofApacheAnt,ApacheXMLXalan,andApacheXMLXerces.
Since the HTML version of the documentation is more commonly checked during development, the PDF ver-
sion may contain some errors and inconsistencies, especially in formatting. If you have difficulty reading a
part of this file, please consult the HTML version of the documentation on the Apache HTTP Server website at
http://httpd.apache.org/docs/2.2/
TheApacheHTTPServerDocumentationismaintainedbytheApacheHTTPServerDocumentationProject. More
informationisavailableathttp://httpd.apache.org/docs-project/
Contents
1 ReleaseNotes 1
1.1 Upgradingto2.2from2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 OverviewofnewfeaturesinApache2.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 OverviewofnewfeaturesinApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.4 TheApacheLicense,Version2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2 UsingtheApacheHTTPServer 13
2.1 CompilingandInstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.2 StartingApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.3 StoppingandRestarting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.4 ConfigurationFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.5 ConfigurationSections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
2.6 CachingGuide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.7 Server-WideConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2.8 LogFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
2.9 MappingURLstoFilesystemLocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
2.10 SecurityTips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
2.11 DynamicSharedObject(DSO)Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
2.12 ContentNegotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
2.13 CustomErrorResponses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.14 Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
2.15 Multi-ProcessingModules(MPMs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
2.16 EnvironmentVariablesinApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
2.17 Apache’sHandlerUse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
2.18 Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
2.19 suEXECSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
2.20 ApachePerformanceTuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
2.21 URLRewritingGuide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
iii
iv CONTENTS
3 ApacheVirtualHostdocumentation 127
3.1 ApacheVirtualHostdocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
3.2 Name-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
3.3 ApacheIP-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
3.4 Dynamicallyconfiguredmassvirtualhosting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
3.5 VirtualHostExamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
3.6 AnIn-DepthDiscussionofVirtualHostMatching . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
3.7 FileDescriptorLimits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
3.8 IssuesRegardingDNSandApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
4 ApacheServerFrequentlyAskedQuestions 157
4.1 FrequentlyAskedQuestions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
4.2 Background-FrequentlyAskedQuestions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
4.3 Support-FrequentlyAskedQuestions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
4.4 ErrorMessages-FrequentlyAskedQuestions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
5 ApacheSSL/TLSEncryption 163
5.1 ApacheSSL/TLSEncryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
5.2 SSL/TLSStrongEncryption: AnIntroduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
5.3 SSL/TLSStrongEncryption: Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
5.4 SSL/TLSStrongEncryption: How-To . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
5.5 SSL/TLSStrongEncryption: FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
6 Guides,Tutorials,andHowTos 197
6.1 How-To/Tutorials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
6.2 Authentication,AuthorizationandAccessControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
6.3 ApacheTutorial: DynamicContentwithCGI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
6.4 ApacheTutorial: IntroductiontoServerSideIncludes . . . . . . . . . . . . . . . . . . . . . . . . . . 210
6.5 ApacheTutorial: .htaccessfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
6.6 Per-userwebdirectories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
7 Platform-specificNotes 223
7.1 PlatformSpecificNotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
7.2 UsingApachewithMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
7.3 CompilingApacheforMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
7.4 UsingApacheWithNovellNetWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
7.5 RunningaHigh-PerformanceWebServeronHPUX . . . . . . . . . . . . . . . . . . . . . . . . . . 245
7.6 TheApacheEBCDICPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
CONTENTS v
8 ApacheHTTPServerandSupportingPrograms 251
8.1 ServerandSupportingPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
8.2 httpd-ApacheHypertextTransferProtocolServer . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
8.3 ab-ApacheHTTPserverbenchmarkingtool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
8.4 apachectl-ApacheHTTPServerControlInterface . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
8.5 apxs-APacheeXtenSiontool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
8.6 configure-Configurethesourcetree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
8.7 dbmmanage-ManageuserauthenticationfilesinDBMformat . . . . . . . . . . . . . . . . . . . . . 273
8.8 htcacheclean-Cleanupthediskcache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
8.9 htdbm-ManipulateDBMpassworddatabases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
8.10 htdigest-manageuserfilesfordigestauthentication. . . . . . . . . . . . . . . . . . . . . . . . . . . 279
8.11 htpasswd-Manageuserfilesforbasicauthentication . . . . . . . . . . . . . . . . . . . . . . . . . . 280
8.12 logresolve-ResolveIP-addressestohostnamesinApachelogfiles . . . . . . . . . . . . . . . . . . . 282
8.13 rotatelogs-PipedloggingprogramtorotateApachelogs . . . . . . . . . . . . . . . . . . . . . . . . 283
8.14 suexec-Switchuserbeforeexecutingexternalprograms . . . . . . . . . . . . . . . . . . . . . . . . 285
8.15 OtherPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
9 ApacheMiscellaneousDocumentation 287
9.1 ApacheMiscellaneousDocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
9.2 RelevantStandards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
10 Apachemodules 291
10.1 TermsUsedtoDescribeModules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
10.2 TermsUsedtoDescribeDirectives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
10.3 ApacheModulecore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
10.4 ApacheModulemod actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
10.5 ApacheModulemod alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340
10.6 ApacheModulemod asis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
10.7 ApacheModulemod auth basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
10.8 ApacheModulemod auth digest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
10.9 ApacheModulemod authn alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
10.10ApacheModulemod authn anon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
10.11ApacheModulemod authn dbd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
10.12ApacheModulemod authn dbm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
10.13ApacheModulemod authn default. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
10.14ApacheModulemod authn file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
10.15ApacheModulemod authnz ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
10.16ApacheModulemod authz dbm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
vi CONTENTS
10.17ApacheModulemod authz default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
10.18ApacheModulemod authz groupfile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
10.19ApacheModulemod authz host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383
10.20ApacheModulemod authz owner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
10.21ApacheModulemod authz user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
10.22ApacheModulemod autoindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
10.23ApacheModulemod cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
10.24ApacheModulemod cern meta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
10.25ApacheModulemod cgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
10.26ApacheModulemod cgid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
10.27ApacheModulemod charset lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414
10.28ApacheModulemod dav . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
10.29ApacheModulemod dav fs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421
10.30ApacheModulemod dav lock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
10.31ApacheModulemod dbd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
10.32ApacheModulemod deflate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
10.33ApacheModulemod dir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
10.34ApacheModulemod disk cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
10.35ApacheModulemod dumpio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
10.36ApacheModulemod echo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
10.37ApacheModulemod env . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
10.38ApacheModulemod example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
10.39ApacheModulemod expires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
10.40ApacheModulemod ext filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
10.41ApacheModulemod file cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
10.42ApacheModulemod filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455
10.43ApacheModulemod headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
10.44ApacheModulemod ident . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
10.45ApacheModulemod imagemap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
10.46ApacheModulemod include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
10.47ApacheModulemod info. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
10.48ApacheModulemod isapi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
10.49ApacheModulemod ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
10.50ApacheModulemod log config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496
10.51ApacheModulemod log forensic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
10.52ApacheModulemod logio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
10.53ApacheModulemod mem cache. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 504
CONTENTS vii
10.54ApacheModulemod mime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 508
10.55ApacheModulemod mime magic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
10.56ApacheModulemod negotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
10.57ApacheModulemod nw ssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
10.58ApacheModulemod proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529
10.59ApacheModulemod proxy ajp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
10.60ApacheModulemod proxy balancer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
10.61ApacheModulemod proxy connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
10.62ApacheModulemod proxy ftp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
10.63ApacheModulemod proxy http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
10.64ApacheModulemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
10.65ApacheModulemod setenvif. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576
10.66ApacheModulemod so. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
10.67ApacheModulemod speling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
10.68ApacheModulemod ssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
10.69ApacheModulemod status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
10.70ApacheModulemod suexec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
10.71ApacheModulemod unique id. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
10.72ApacheModulemod userdir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
10.73ApacheModulemod usertrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
10.74ApacheModulemod version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620
10.75ApacheModulemod vhost alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622
10.76ApacheModulebeos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626
10.77ApacheModulempm common . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
10.78ApacheModuleevent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640
10.79ApacheModulempm netware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
10.80ApacheModulempmt os2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643
10.81ApacheModuleprefork . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644
10.82ApacheModulempm winnt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647
10.83ApacheModuleworker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648
11 DeveloperDocumentation 651
11.1 DeveloperDocumentationforApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
11.2 Apache1.3APInotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
11.3 DebuggingMemoryAllocationinAPR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669
11.4 DocumentingApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672
11.5 Apache2.0HookFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
11.6 ConvertingModulesfromApache1.3toApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . 676
viii CONTENTS
11.7 RequestProcessinginApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680
11.8 HowfiltersworkinApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684
12 GlossaryandIndex 687
12.1 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
12.2 ModuleIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693
12.3 DirectiveIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696
12.4 DirectiveQuickReference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
Chapter 1
Release Notes
1
2 CHAPTER1. RELEASENOTES
1.1 Upgrading to 2.2 from 2.0
Inordertoassistfolksupgrading, wemaintainadocumentdescribinginformationcriticaltoexistingApacheusers.
Theseareintendedtobebriefnotes,andyoushouldbeabletofindmoreinformationineithertheNewFeatures(p.4)
document,orinthesrc/CHANGESfile.
This document describes only the changes from 2.0 to 2.2. If you are upgrading from version 1.3, you should also
consultthe1.3to2.0upgradingdocument.1
Seealso
• OverviewofnewfeaturesinApache2.2(p.4)
Compile-TimeConfigurationChanges
The compilation process is very similar to the one used in version 2.0. Your old configure command line (as
foundinbuild/config.niceintheinstalledserverdirectory)canbeusedinsomecases. Themostsignificant
changerequiredwillbetoaccountforchangesinmodulenames,inparticularfortheauthenticationandauthorization
modules. Somedetailsofchanges:
• mod imaphasbeenrenamedtoMOD IMAGEMAP
• mod auth has been split up into MOD AUTH BASIC, MOD AUTHN FILE, MOD AUTHZ USER, and
MOD AUTHZ GROUPFILE
• mod accesshasbeenrenamedtoMOD AUTHZ HOST
• mod auth ldaphasbeenrenamedtoMOD AUTHNZ LDAP
• UpgradedtorequiretheAPR1.0API.
• UpdatedbundledPCREversionto5.0
Run-TimeConfigurationChanges
Your existing version 2.0 config files and startup scripts can usually be used unchanged in version 2.2. Some small
adjustmentsmaybenecessaryforparticularconfigurationsasdiscussedbelow. Inaddition,ifyoudynamicallyload
thestandardmodulesusingtheLOADMODULEdirective,thenyouwillneedtoaccountforthemodulenamechanges
mentionedabove.
Ifyouchoosetousethenewdefaultconfigurationfileforversion2.2,youwillfindthatithasbeengreatlysimplifiedby
removingallbutthemostessentialconfigurationsettings. Asetofexampleconfigurationsettingsformoreadvanced
featuresispresentintheconf/extra/directoryoftheinstalledserver. Defaultconfigurationfilesareinstalledin
theconf/originaldirectory.
Someruntimeconfigurationchangesthatyoumaynotice:
• Theapachectloptionstartsslisnolongeravailable. ToenableSSLsupport,youshouldedithttpd.conf
toincludetherelevantMOD SSLdirectivesandthenuseapachectl starttostarttheserver. Anexample
configurationtoactivateMOD SSLhasbeenincludedinconf/extra/httpd-ssl.conf.
• ThedefaultsettingofUSECANONICALNAMEisnowOff. Ifyoudidnothavethisdirectiveinyourconfigfile,
youcanaddUseCanonicalName Ontoretaintheoldbehavior.
• The module MOD USERDIR will no longer act on requests unless a USERDIR directive specifying a direc-
tory name is present in the config file. To restore the old default behavior, place the directive UserDir
public htmlinyourconfigfile.
1http://httpd.apache.org/docs/2.0/upgrading.html