1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
|
<?xml version='1.0' encoding='EUC-KR' ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.ko.xsl"?>
<!-- English Revision: 421174 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<manualpage metafile="upgrading.xml.meta">
<title>1.3에서 2.0으로 업그레이드</title>
<summary>
<p>우리는 기존 아파치 사용자가 업그레이드하는 것을 돕기위해
중요한 정보를 알려주는 문서를 제공한다. 이 문서는 간단한
요약이므로, <a href="new_features_2_0.html">새로운 기능</a>
문서나 <code>src/CHANGES</code> 파일에서 정보를 찾아봐야
한다.</p>
</summary>
<seealso><a href="new_features_2_0.html">아파치 2.0의 새로운
기능 요약</a></seealso>
<section id="compile-time">
<title>컴파일시 구성 변화</title>
<ul>
<li>아파치는 이제 <a
href="install.html">아파치 컴파일과 설치</a>를 위해
<code>autoconf</code>와 <code>libtool</code> 시스템을
사용한다. 이 시스템의 사용법은 Apache 1.3의 APACI 시스템과
같지는 않지만 비슷하다.</li>
<li>컴파일 여부를 선택할 모듈외에 Apache 2.0은 요청을
처리하는 주요 부분을 <a href="mpm.html">다중처리 모듈
(Multi-Processing Modules)</a> (MPM)로 옮겼다.</li>
</ul>
</section>
<section id="run-time">
<title>실행시 설정 변화</title>
<ul>
<li>Apache 1.3에서 서버 핵심에 있었던 많은 지시어들이
이제는 MPM에 있다. 서버가 Apache 1.3과 최대한 비슷하게
동작하길 바란다면 <module>prefork</module> MPM을 선택해야
한다. 다른 MPM은 다른 지시어를 사용하여 프로세스 생성과
요청의 처리를 조절한다.</li>
<li><a href="mod/mod_proxy.html">proxy 모듈</a>은 HTTP/1.1에
맞추어 수정되었다. 중요한 변화중 하나는 이제 프록시 접근제어가
<code><Directory proxy:></code> 블록이 아니라
<directive type="section" module="mod_proxy">Proxy</directive>
블록에 위치하는 점이다.</li>
<li>몇몇 모듈에서 <code>PATH_INFO</code> (진짜 경로명
뒤에 나오는 경로 정보) 처리 방식이 변경되었다. 전에
핸들러였지만 이제 필터로 구현되는 모듈은 더 이상
<code>PATH_INFO</code>가 있는 요청을 받아들이지 못한다.
<a href="mod/mod_include.html">INCLUDES</a>나 <a
href="http://www.php.net/">PHP</a>와 같은 필터는
core 핸들러 위에 구현되기때문에 <code>PATH_INFO</code>가
있는 요청을 거부한다. core 핸들러가 <code>PATH_INFO</code>가
있는 요청을 받아들이고 server-side include에서
<code>PATH_INFO</code>를 사용하게 하려면, <directive
module="core">AcceptPathInfo</directive> 지시어를 사용해야
한다.</li>
<li><directive module="mod_negotiation">CacheNegotiatedDocs</directive>
지시어는 이제 아규먼트로 <code>on</code>과 <code>off</code>를
받는다. 기존의 <directive>CacheNegotiatedDocs</directive>는
<code>CacheNegotiatedDocs on</code>으로 수정해야 한다.</li>
<li>
<directive module="core">ErrorDocument</directive> 지시어는
더이상 메세지를 나타내는 아규먼트 앞에 따옴표를 사용하지
않는다. 대신 쌍따옴표로 메세지를 묶어야 한다. 예를 들어 과거
<example>
ErrorDocument 403 "Some Message
</example>
는 다음과 같이 수정해야 한다.
<example>
ErrorDocument 403 "Some Message"
</example>
두번째 아규먼트가 유효한 URL이나 경로명이 아니라면 메세지로
간주한다.
</li>
<li><code>AccessConfig</code>와 <code>ResourceConfig</code>
지시어는 사라졌다. 기존에 사용하던 지시어는 같은 기능을
하는 <directive module="core">Include</directive> 지시어로
대체할 수 있다. 과거에 설정파일에서 이 지시어들을 사용하지않고
이 지시어들의 기본값을 사용했다면, <code>http.conf</code>에
<code>Include conf/access.conf</code>와 <code>Include
conf/srm.conf</code>를 추가할 필요가 있다. 아파치가 이전
지시어와 같은 순서로 설정파일을 읽게하려면
<directive module="core">Include</directive> 지시어를
<code>httpd.conf</code> 끝에 두고, <code>srm.conf</code>이
<code>access.conf</code> 앞에 나와야 한다.</li>
<li><code>BindAddress</code>와 <code>Port</code> 지시어는
사라졌다. 더 유연한 <directive module="mpm_common">Listen</directive>
지시어가 같은 기능을 한다.</li>
<li>Apache-1.3에서 <code>Port</code>는 자기참조
URL의 포트 번호를 설정하는 일도 했다. Apache-2.0에서 이
기능은 새로운 <directive module="core">ServerName</directive>으로
한다. 한 지시어에 호스트명<em>과</em> 자기참조 URL을 위한
포트 번호를 같이 설정할 수 있다.</li>
<li><code>ServerType</code> 지시어는 사라졌다. 요청을
서비스하는 방법은 이제 MPM 선택에 달렸다. 현재 inetd에서
시작하도록 설계된 MPM은 없다.</li>
<li><code>AgentLog</code>, <code>RefererLog</code>,
<code>RefererIgnore</code> 지시어를 제공한
<code>mod_log_agent</code>와 <code>mod_log_referer</code>
모듈이 없어졌다. agent 로그와 referer 로그는
<module>mod_log_config</module>의 <directive
module="mod_log_config">CustomLog</directive> 지시어를
사용하여 계속 제공된다.</li>
<li><code>AddModule</code>과 <code>ClearModuleList</code>
지시어는 사라졌다. 이 지시어들은 모듈을 올바른 순서로
활성화하려고 사용했다. 새로운 Apache 2.0 API는 모듈이
활성화되는 순서를 명시적으로 지정할 수 있어서, 이 지시어들이
필요없게 되었다.</li>
<li><code>FancyIndexing</code> 지시어가 없어졌다.
<directive module="mod_autoindex">IndexOptions</directive>
지시어의 <code>FancyIndexing</code> 옵션이 같은 기능을 한다.</li>
<li><module>mod_negotiation</module>의 MultiViews 내용협상이
더 엄격하게 기본파일을 찾는다. 내용협상은 <em>협상가능한</em>
파일 중에서만 선택한다. <directive
module="mod_mime">MultiviewsMatch</directive> 지시어를
사용하여 이전과 같이 동작하게 할 수 있다.</li>
<li>(<em>2.0.51 버전 이후</em>)
<p><code>ErrorHeader</code> 지시어는 잘못된 명칭으로,
이 지시어가 담당한 기능은 <directive
module="mod_headers">Header</directive> 지시어로도 가능하다.
원하는 기능을 위해,</p>
<example>
Header always set 어쩌고 저쩌고
</example>
<p>와 같이 설정한다.</p></li>
</ul>
</section>
<section id="misc">
<title>기타 변화</title>
<ul>
<li>Apache 1.3에서 실험적이였던 <module>mod_auth_digest</module>
모듈이 이제 표준 모듈이 되었다.</li>
<li>Apache 1.3에서 실험적이였던 <code>mod_mmap_static</code>
모듈이 <module>mod_file_cache</module>로 대체되었다.</li>
<li>배포본이 완전히 새로 구성되어 더이상 독립된 <code>src</code>
디렉토리가 없다. 대신 소스는 주 배포본 디렉토리 아래 논리적으로
구성되있고, 컴파일한 서버는 다른 디렉토리로 설치된다.</li>
</ul>
</section>
<section id="third-party">
<title>제삼자가 만든 모듈</title>
<p>Apache 2.0에서 서버 API가 많이 변경되었다. Apache 1.3 API에
맞춰진 기존 모듈을 수정없이 Apache 2.0에서 사용할 수
<strong>없다</strong>. 자세한 정보는 <a href="developer/">개발자
문서</a>를 참고하라.</p>
</section>
</manualpage>
|
