upgrading.xml.ko

<?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: 105989 -->

<!--
 Copyright 2003-2004 The Apache Software Foundation

 Licensed 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>&lt;Directory proxy:&gt;</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>