diff options
Diffstat (limited to 'docs/manual/platform')
27 files changed, 8399 insertions, 0 deletions
diff --git a/docs/manual/platform/ebcdic.html b/docs/manual/platform/ebcdic.html new file mode 100644 index 0000000..e5ae518 --- /dev/null +++ b/docs/manual/platform/ebcdic.html @@ -0,0 +1,9 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: ebcdic.html.en +Content-Language: en +Content-type: text/html; charset=UTF-8 + +URI: ebcdic.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/platform/ebcdic.html.en b/docs/manual/platform/ebcdic.html.en new file mode 100644 index 0000000..01b95c8 --- /dev/null +++ b/docs/manual/platform/ebcdic.html.en @@ -0,0 +1,616 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>The Apache EBCDIC Port - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>The Apache EBCDIC Port</h1> +<div class="toplang"> +<p><span>Available Languages: </span><a href="../en/platform/ebcdic.html" title="English"> en </a> | +<a href="../ko/platform/ebcdic.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + + <div class="warning"><strong>Warning:</strong> This document + has not been updated to take into account changes made in + the 2.0 version of the Apache HTTP Server. Some of the + information may still be relevant, but please use it with care. + </div> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#overview">Overview of the Apache EBCDIC Port</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#design">Design Goals</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#technical">Technical Solution</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#porting">Porting Notes</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#document">Document Storage Notes</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#modules">Apache Modules' Status</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#third-party">Third Party Modules' Status</a></li> +</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="overview" id="overview">Overview of the Apache EBCDIC Port</a></h2> + + + + <p>Version 1.3 of the Apache HTTP Server was the first version + which included a port to a (non-ASCII) mainframe machine which + uses the EBCDIC character set as its native codeset.</p> + + <p>(It is the SIEMENS family of mainframes running the <a href="http://www.siemens.de/servers/bs2osd/osdbc_us.htm">BS2000/OSD + operating system</a>. This mainframe OS nowadays features a + SVR4-derived POSIX subsystem).</p> + + <p>The port was started initially to</p> + + <ul> + <li>prove the feasibility of porting <a href="http://httpd.apache.org/">the Apache HTTP server</a> to + this platform</li> + + <li>find a "worthy and capable" successor for the venerable + <a href="http://www.w3.org/Daemon/">CERN-3.0</a> daemon + (which was ported a couple of years ago), and to</li> + + <li>prove that Apache's preforking process model can on this + platform easily outperform the accept-fork-serve model used + by CERN by a factor of 5 or more.</li> + </ul> + + <p>This document serves as a rationale to describe some of the + design decisions of the port to this machine.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="design" id="design">Design Goals</a></h2> + + + + <p>One objective of the EBCDIC port was to maintain enough + backwards compatibility with the (EBCDIC) CERN server to make + the transition to the new server attractive and easy. This + required the addition of a configurable method to define + whether a HTML document was stored in ASCII (the only format + accepted by the old server) or in EBCDIC (the native document + format in the POSIX subsystem, and therefore the only realistic + format in which the other POSIX tools like <code>grep</code> or + <code>sed</code> could operate on the documents). The current + solution to this is a "pseudo-MIME-format" which is intercepted + and interpreted by the Apache server (see below). Future versions + might solve the problem by defining an "ebcdic-handler" for all + documents which must be converted.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="technical" id="technical">Technical Solution</a></h2> + + + + <p>Since all Apache input and output is based upon the BUFF + data type and its methods, the easiest solution was to add the + conversion to the BUFF handling routines. The conversion must + be settable at any time, so a BUFF flag was added which defines + whether a BUFF object has currently enabled conversion or not. + This flag is modified at several points in the HTTP + protocol:</p> + + <ul> + <li><strong>set</strong> before a request is received + (because the request and the request header lines are always + in ASCII format)</li> + + <li><strong>set/unset</strong> when the request body is + received - depending on the content type of the request body + (because the request body may contain ASCII text or a binary + file)</li> + + <li><strong>set</strong> before a reply header is sent + (because the response header lines are always in ASCII + format)</li> + + <li><strong>set/unset</strong> when the response body is sent + - depending on the content type of the response body (because + the response body may contain text or a binary file)</li> + </ul> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="porting" id="porting">Porting Notes</a></h2> + + + + <ol> + <li> + <p>The relevant changes in the source are <code>#ifdef</code>'ed + into two categories:</p> + + <dl> + <dt><code><strong>#ifdef + CHARSET_EBCDIC</strong></code></dt> + + <dd> + <p>Code which is needed for any EBCDIC based machine. + This includes character translations, differences in + contiguity of the two character sets, flags which + indicate which part of the HTTP protocol has to be + converted and which part doesn't <em>etc.</em></p> + </dd> + + <dt><code><strong>#ifdef _OSD_POSIX</strong></code></dt> + + <dd> + <p>Code which is needed for the SIEMENS BS2000/OSD + mainframe platform only. This deals with include file + differences and socket implementation topics which are + only required on the BS2000/OSD platform.</p> + </dd> + </dl> + </li> + + <li> + <p>The possibility to translate between ASCII and EBCDIC at + the socket level (on BS2000 POSIX, there is a socket option + which supports this) was intentionally <em>not</em> chosen, + because the byte stream at the HTTP protocol level consists + of a mixture of protocol related strings and non-protocol + related raw file data. HTTP protocol strings are always + encoded in ASCII (the <code>GET</code> request, any Header: lines, + the chunking information <em>etc.</em>) whereas the file transfer + parts (<em>i.e.</em>, GIF images, CGI output <em>etc.</em>) + should usually be just "passed through" by the server. This + separation between "protocol string" and "raw data" is + reflected in the server code by functions like <code>bgets()</code> + or <code>rvputs()</code> for strings, and functions like + <code>bwrite()</code> for binary data. A global translation + of everything would therefore be inadequate.</p> + + <p>(In the case of text files of course, provisions must be + made so that EBCDIC documents are always served in + ASCII)</p> + </li> + + <li> + <p>This port therefore features a built-in protocol level + conversion for the server-internal strings (which the + compiler translated to EBCDIC strings) and thus for all + server-generated documents. The hard coded ASCII escapes + <code>\012</code> and <code>\015</code> which are ubiquitous + in the server code are an exception: they are already the binary + encoding of the ASCII <code>\n</code> and <code>\r</code> and + must not be converted to ASCII a second time. + This exception is only relevant for server-generated strings; + and <em>external</em> EBCDIC documents are not expected to + contain ASCII newline characters.</p> + </li> + + <li> + <p>By examining the call hierarchy for the BUFF management + routines, I added an "ebcdic/ascii conversion layer" which + would be crossed on every puts/write/get/gets, and a + conversion flag which allowed enabling/disabling the + conversions on-the-fly. Usually, a document crosses this + layer twice from its origin source (a file or CGI output) to + its destination (the requesting client): <code>file -> + Apache</code>, and <code>Apache -> client</code>.</p> + + <p>The server can now read the header lines of a CGI-script + output in EBCDIC format, and then find out that the remainder + of the script's output is in ASCII (like in the case of the + output of a WWW Counter program: the document body contains a + GIF image). All header processing is done in the native + EBCDIC format; the server then determines, based on the type + of document being served, whether the document body (except + for the chunking information, of course) is in ASCII already + or must be converted from EBCDIC.</p> + </li> + + <li> + <p>For Text documents (MIME types text/plain, text/html + <em>etc.</em>), an implicit translation to ASCII can be + used, or (if the users prefer to store some documents in + raw ASCII form for faster serving, or because the files + reside on a NFS-mounted directory tree) can be served + without conversion.</p> + + <p><strong>Example:</strong></p> + + <p>to serve files with the suffix <code>.ahtml</code> as a + raw ASCII <code>text/html</code> document without implicit + conversion (and suffix <code>.ascii</code> as ASCII + <code>text/plain</code>), use the directives:</p> + + <div class="example"><p><code> + AddType text/x-ascii-html .ahtml <br /> + AddType text/x-ascii-plain .ascii + </code></p></div> + + <p>Similarly, any <code>text/foo</code> MIME type can be + served as "raw ASCII" by configuring a MIME type + "<code>text/x-ascii-foo</code>" for it using + <code>AddType</code>.</p> + </li> + + <li> + <p>Non-text documents are always served "binary" without + conversion. This seems to be the most sensible choice for, + .<em>e.g.</em>, GIF/ZIP/AU file types. This of course + requires the user to copy them to the mainframe host using + the "<code>rcp -b</code>" binary switch.</p> + </li> + + <li> + <p>Server parsed files are always assumed to be in native + (<em>i.e.</em>, EBCDIC) format as used on the machine, and + are converted after processing.</p> + </li> + + <li> + <p>For CGI output, the CGI script determines whether a + conversion is needed or not: by setting the appropriate + Content-Type, text files can be converted, or GIF output can + be passed through unmodified. An example for the latter case + is the wwwcount program which we ported as well.</p> + </li> + + </ol> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="document" id="document">Document Storage Notes</a></h2> + + + + <h3><a name="binary" id="binary">Binary Files</a></h3> + + + + <p>All files with a <code>Content-Type:</code> which does not + start with <code>text/</code> are regarded as <em>binary + files</em> by the server and are not subject to any conversion. + Examples for binary files are GIF images, gzip-compressed files + and the like.</p> + + <p>When exchanging binary files between the mainframe host and + a Unix machine or Windows PC, be sure to use the ftp "binary" + (<code>TYPE I</code>) command, or use the + <code>rcp -b</code> command from the mainframe host (the + <code>-b</code> switch is not supported in unix + <code>rcp</code>'s).</p> + + + + <h3><a name="text" id="text">Text Documents</a></h3> + + + + <p>The default assumption of the server is that Text Files + (<em>i.e.</em>, all files whose <code>Content-Type:</code> + starts with <code>text/</code>) are stored in the native + character set of the host, EBCDIC.</p> + + + + <h3><a name="ssi" id="ssi">Server Side Included Documents</a></h3> + + + + <p>SSI documents must currently be stored in EBCDIC only. + No provision is made to convert it from ASCII before + processing.</p> + + + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="modules" id="modules">Apache Modules' Status</a></h2> + + + + <table class="bordered"> + <tr> + <th>Module</th> + <th>Status</th> + <th>Notes</th> + </tr> + + <tr> + <td><code class="module"><a href="../mod/core.html">core</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module">mod_access</code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module">mod_auth</code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code></td> + <td class="centered">?</td> + <td>with own <code>libdb.a</code></td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code></td> + <td class="centered">?</td> + <td>with own <code>libdb.a</code></td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_cern_meta.html">mod_cern_meta</a></code></td> + <td class="centered">?</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code>mod_digest</code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_so.html">mod_so</a></code></td> + <td class="centered">-</td> + <td>no shared libs</td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_env.html">mod_env</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_example.html">mod_example</a></code></td> + <td class="centered">-</td> + <td>(test bed only)</td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_info.html">mod_info</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code>mod_log_agent</code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code>mod_log_config</code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module">mod_log_referer</code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code></td> + <td class="centered">?</td> + <td>not ported yet</td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></td> + <td class="centered">+</td> + <td>untested</td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code></td> + <td class="centered">?</td> + <td>untested</td> + </tr> + </table> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="third-party" id="third-party">Third Party Modules' Status</a></h2> + + + + <table class="bordered"> + <tr> + <th>Module</th> + <th>Status</th> + <th>Notes</th> + </tr> + + <tr> + <td><code><a href="https://tomcat.apache.org/connectors-doc-archive/jk2/">JK</a> (Formerly mod_jserv) + </code></td> + <td class="centered">-</td> + <td>JAVA still being ported.</td> + </tr> + + <tr> + <td><code><a href="http://www.php.net/">mod_php3</a></code></td> + <td class="centered">+</td> + <td><code>mod_php3</code> runs fine, with LDAP and GD + and FreeType libraries.</td> + </tr> + + <tr> + <td><code><a href="http://hpwww.ec-lyon.fr/~vincent/apache/mod_put.html">mod_put</a></code></td> + <td class="centered">?</td> + <td>untested</td> + </tr> + + <tr> + <td><code><a href="ftp://hachiman.vidya.com/pub/apache/">mod_session</a></code></td> + <td class="centered">-</td> + <td>untested</td> + </tr> + </table> + + </div></div> +<div class="bottomlang"> +<p><span>Available Languages: </span><a href="../en/platform/ebcdic.html" title="English"> en </a> | +<a href="../ko/platform/ebcdic.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/ebcdic.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/ebcdic.html.ko.euc-kr b/docs/manual/platform/ebcdic.html.ko.euc-kr new file mode 100644 index 0000000..6e45a37 --- /dev/null +++ b/docs/manual/platform/ebcdic.html.ko.euc-kr @@ -0,0 +1,585 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head> +<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>아파치 EBCDIC 포팅 - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>아파치 EBCDIC 포팅</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/platform/ebcdic.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ko/platform/ebcdic.html" title="Korean"> ko </a></p> +</div> +<div class="outofdate">이 문서는 최신판 번역이 아닙니다. + 최근에 변경된 내용은 영어 문서를 참고하세요.</div> + + + <div class="warning">이 문서는 아파치 웹서버 2.0 버전에서 + 변경된 내용을 담고있지 않다. 아직도 유효한 정보가 있지만, + 주의해서 사용하길 바란다. + </div> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#overview">아파치 EBCDIC 포팅 개요</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#design">설계 목표</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#technical">기술적 해결책</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#porting">포팅에 대해서</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#document">문서 저장에 대해서</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#modules">아파치 모듈의 상태</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#third-party">제삼자가 만든 모듈의 상태</a></li> +</ul><h3>참고</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="overview" id="overview">아파치 EBCDIC 포팅 개요</a></h2> + + + + <p>아파치 웹서버는 1.3 버전때 처음으로 EBCDIC 문자집합을 + 기본 문자집합으로 사용하는 (비-ASCII) 메인플레임 컴퓨터로 + 포팅되었다.</p> + + <p>(<a href="http://www.siemens.de/servers/bs2osd/osdbc_us.htm">BS2000/OSD + 운영체제</a>를 사용하는 SIEMENS 계열 메인플레임을 말한다. + 이 메인플레임 운영체제에는 현재 SVR4계열의 POSIX 하위시스템이 + 있다).</p> + + <p>포팅은 처음에 다음과 같은 목적에서 시작되었다</p> + + <ul> + <li>이 플레폼으로도 <a href="http://dev.apache.org/">아파치 + 웹서버</a>를 포팅할 수 있다는 가능성을 보이기위해서</li> + + <li>(몇년 전에 포팅된) 오래된 <a href="http://www.w3.org/Daemon/">CERN-3.0</a> 서버를 대체할 + "쓸만하고 유능한" 후계자를 찾기위해</li> + + <li>이 플레폼에서 아파치의 prefork 프로세스 방식이 CERN의 + accept-fork-serve 방식 보다 5배 이상 성능이 좋음을 + 보이기위해서.</li> + </ul> + + <p>이 문서는 포팅시 여러 설계상 결정의 이유를 설명한다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="design" id="design">설계 목표</a></h2> + + + + <p>EBCDIC 포팅의 목적중 하나는 새로운 서버로 전환을 유도하고 + 쉽게 전환할 수 있도록 가능한 (EBCDIC) CERN 서버와 호환성을 + 유지하는 것이다. 그래서 HTML 문서가 (이전 CERN 서버가 인식하는 + 유일한 형식인) ASCII와 (POSIX 하위시스템의 기본 문서 형식. + 그러므로 <code>grep</code>이나 <code>sed</code> 같은 POSIX + 도구를 사용할 수 있는 현실적인 형식인) EBCDIC 중 어느 형식인지 + 설정할 수 있어야 한다. 현재 해결책은 아파치 서버가 중간에서 + 문서를 가로채서 문서의 형식을 파악하는 "가상 MIME 형식"이다 + (아래 참고). 다음 버전에서는 변환해야할 모든 문서에 + "ebcdic-handler"를 정의하는 방법으로 문제를 해결할 것이다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="technical" id="technical">기술적 해결책</a></h2> + + + + <p>아파치가 BUFF 자료형과 메써드를 사용하여 모든 입출력을 + 하므로 가장 쉬운 방법은 BUFF 처리 함수에 변환기능을 추가하는 + 것이다. 언제든지 변환할 수 있어야 하기때문에 BUFF 객체를 + 변환해야 하는지 알려주는 BUFF 표시를 추가했다. 이 표시는 + HTTP 프로토콜의 여러 단계에서 변경될 수 있다:</p> + + <ul> + <li>요청을 받기 전에 <strong>변환</strong> (요청과 요청헤더가 + 항상 ASCII 형식이기 때문에)</li> + + <li>요청 내용을 받았을때 content type에 따라 + <strong>변환/변환안함</strong> (요청 내용이 ASCII 문자나 + 바이너리 파일인 경우 변환해야 하기때문에)</li> + + <li>응답헤더를 보내기 전에 <strong>변환</strong> (응답헤더는 + 항상 ASCII 형식이기때문에)</li> + + <li>응답 내용을 보낼때 content type에 따라 + <strong>변환/변환안함</strong> (응답 내용이 문자 파일이거나 + 바이너리 파일이기때문에)</li> + </ul> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="porting" id="porting">포팅에 대해서</a></h2> + + + + <ol> + <li> + <p>소스의 변화는 두가지 <code>#ifdef</code>로 구분할 + 수 있다:</p> + + <dl> + <dt><code><strong>#ifdef + CHARSET_EBCDIC</strong></code></dt> + + <dd> + <p>모든 EBCDIC기반 컴퓨터에 필요한 코드. 문자변환, + 두 문자집합간의 연속된 문자값 차이, 어떤 HTTP 프로토콜 + 부분이 변환되야 하는지를 알려주는 표시 <em>등.</em></p> + </dd> + + <dt><code><strong>#ifdef _OSD_POSIX</strong></code></dt> + + <dd> + <p>SIEMENS BS2000/OSD 메인플레임 플레폼에만 필요한 + 코드. BS2000/OSD 플레폼에만 필요한 헤더파일 차이와 + 소켓 구현 문제를 다룬다.</p> + </dd> + </dl> + </li> + + <li> + <p>소켓 수준에서 ASCII와 EBCDIC간 변화는 (BS2000 POSIX에는 + 이 기능을 지원하는 소켓 옵션이 있다) HTTP 프로토콜 수준에서 + 전송되는 자료에 프로토콜관련 문자열과 프로토콜과 무관한 + 일반파일이 섞여있기때문에 의도적으로 사용하지 + <em>않았다</em>. HTTP 프로토콜 문자열은 (<code>GET</code> + 요청, Header: 줄, 기타 정보 <em>등.</em>) 항상 ASCII + 형식이고, 파일전송 부분은 (<em>즉</em>, GIF 그림, CGI + 출력 <em>등.</em>) 서버가 항상 "변환하지않고 그냥" 보내야 + 한다. 서버 코드는 "프로토콜 문자열"과 "일반 자료"를, + 문자열에는 <code>bgets()</code>나 <code>rvputs()</code>, + 바이너리 자료에는 <code>bgets()</code>나 + <code>rvputs()</code> 함수를 사용하여 구별한다. 그러므로 + 무조건 모든 것을 변환하는 것은 적절하지 않다.</p> + + <p>(물론 문자파일의 경우 EBCDIC 문서를 항상 ASCII로 + 서비스하도록 준비해야 한다)</p> + </li> + + <li> + <p>그래서 포팅에는 (컴파일러가 EBCDIC 문자열로 변환한) + 서버 내부 문자열과 서버가 생성한 문서를 기본 프로토콜 + 수준에서 변환하는 기능이 있다. 서버 코드에 산재된 ASCII + escape문자 <code>\012</code>와 <code>\015</code>는 예외다: + 이들이 이미 ASCII <code>\n</code>과 <code>\r</code>의 + 바이너리 값이기때문에 ASCII로 두번 변환하면 안된다. + 이 예외는 서버가 생성한 문자열에만 적용된다; <em>외부</em> + EBCDIC 문서는 ASCII 줄바꿈문자를 포함하면 안된다.</p> + </li> + + <li> + <p>BUFF 관리함수를 사용하는 방법을 살펴본 후 나는 모든 + puts/write/get/gets가 거치게되는 "ebcdic/ascii 변환 + 계층"을 추가하고, 동적으로 변환유무를 설정할 수 있는 + 변환 표시를 추가했다. 문서가 원본(파일이나 CGI 출력)에서 + 대상(요청한 클라이언트)으로 이동할때 항상 이 계층을 + 두번 지난다: <code>파일 -> 아파치</code>, <code>아파치 + -> 클라이언트</code>.</p> + + <p>서버는 이제 EBCDIC 형식으로 된 CGI 스크립트 출력의 + 헤더줄을 읽고, 나머지 스크립트 출력이 ASCII임을 알아낼 + 수 있다 (WWW 방문자수를 세는 프로그램과 같은 경우: 문서 + 내용은 GIF 그림이다). 기본 EBCDIC 형식으로 모든 헤더를 + 처리한다; 그런 다음 서비스할 문서의 type에 따라 서버는 + 문서 내용이 이미 ASCII인지 혹은 EBCDIC에서 변환을 해야 + 하는지 결정한다.</p> + </li> + + <li> + <p>(MIME type이 text/plain, text/html <em>등</em>) 내용이 + 일반 문자인 문서를 암묵적으로 ASCII로 변환하거나, (사용자에게 + 빠르게 서비스하기위해 미리 문서를 ASCII 형식으로 저장하였거나 + NFS로 마운트한 디렉토리에 파일이 있는 경우) 변환없이 + 서비스할 수 있다.</p> + + <p><strong>예:</strong></p> + + <p>이름이 <code>.ahtml</code>로 끝나는 파일을 암묵적인 + 변환없이 ASCII <code>text/html</code> 문서로 (그리고 + <code>.ascii</code> 확장자는 ASCII + <code>text/plain</code>으로) 서비스하려면 다음 지시어를 + 사용한다:</p> + + <div class="example"><p><code> + AddType text/x-ascii-html .ahtml <br /> + AddType text/x-ascii-plain .ascii + </code></p></div> + + <p>또, <code>text/foo</code> 식의 MIME type을 + <code>AddType</code> "<code>text/x-ascii-foo</code>" + 설정하여 "일반 ASCII"로 서비스할 수 있다.</p> + </li> + + <li> + <p>내용이 일반 문자가 아닌 문서는 변환없이 항상 "바이너리"로 + 서비스한다. <em>예를 들어</em>, GIF/ZIP/AU 파일형식에 + 가장 적합한 선택이다. 물론 사용자는 "<code>rcp -b</code>" + 바이너리 옵션을 사용하여 파일을 메인플레임 호스트로 + 복사했어야 한다.</p> + </li> + + <li> + <p>서버파싱 파일은 항상 컴퓨터가 사용하는 기본 형식으로 + (<em>즉</em>, EBCDIC) 저장되었다고 가정하고, 처리후에 + 변환한다.</p> + </li> + + <li> + <p>CGI 출력의 경우 CGI 스크립트가 변환이 필요한지 결정한다: + 적절한 Content-Type을 설정하여, 문자파일은 변환하고, + GIF 출력은 변환없이 보낼 수 있다. 우리가 포팅한 wwwcount + 프로그램이 후자의 경우다.</p> + </li> + + </ol> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="document" id="document">문서 저장에 대해서</a></h2> + + + + <h3><a name="binary" id="binary">바이너리 파일</a></h3> + + + + <p>서버는 <code>Content-Type:</code>이 <code>text/</code>로 + 시작하는 않는 파일을 <em>바이너리 파일</em>로 간주하여 + 어떤 변환도 하지 않는다. 바이너리 파일에는 GIF 그림, gzip으로 + 압축한 파일 등이 있다.</p> + + <p>메인플레임 호스트와 유닉스 혹은 윈도우즈 PC간에 바이너리 + 파일을 전송할 때는 ftp "binary" (<code>TYPE I</code>) 명령어나 + 메인플레임 호스트에서 (유닉스 <code>rcp</code>는 + <code>-b</code> 옵션을 지원하지 않는다) <code>rcp -b</code> + 명령어를 반드시 사용하라.</p> + + + + <h3><a name="text" id="text">문자 문서</a></h3> + + + + <p>기본적으로 서버는 문자파일이 (<em>즉</em>, + <code>Content-Type:</code>이 <code>text/</code>로 시작하는 + 모든 파일) 호스트의 기본 문자집합인 EBCDIC으로 저장되었다고 + 가정한다.</p> + + + + <h3><a name="ssi" id="ssi">Server Side Include 문서</a></h3> + + + + <p>SSI 문서는 현재 EBCDIC 형식으로만 저장해야 한다. 처리하기 + 전에 ASCII를 변환하지 않는다.</p> + + + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="modules" id="modules">아파치 모듈의 상태</a></h2> + + + + <table class="bordered"> + <tr> + <th>모듈</th> + <th>상태</th> + <th>비고</th> + </tr> + + <tr> + <td><code class="module"><a href="../mod/core.html">core</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_access.html">mod_access</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_auth.html">mod_auth</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_auth_anon.html">mod_auth_anon</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_auth_dbm.html">mod_auth_dbm</a></code></td> + <td class="centered">?</td> + <td>자체 <code>libdb.a</code>를 사용하여</td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_cern_meta.html">mod_cern_meta</a></code></td> + <td class="centered">?</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code>mod_digest</code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_so.html">mod_so</a></code></td> + <td class="centered">-</td> + <td>공유라이브러리가 없음</td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_env.html">mod_env</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_example.html">mod_example</a></code></td> + <td class="centered">-</td> + <td>(시험 단계)</td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_info.html">mod_info</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code>mod_log_agent</code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code>mod_log_config</code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_log_referer.html">mod_log_referer</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code></td> + <td class="centered">?</td> + <td>아직 포팅안됨</td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></td> + <td class="centered">+</td> + <td>테스트안됨</td> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_status.html">mod_status</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code></td> + <td class="centered">+</td> + <td /> + </tr> + + <tr> + <td><code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code></td> + <td class="centered">?</td> + <td>테스트안됨</td> + </tr> + </table> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="third-party" id="third-party">제삼자가 만든 모듈의 상태</a></h2> + + + + <table class="bordered"> + <tr> + <th>모듈</th> + <th>상태</th> + <th>비고</th> + </tr> + + <tr> + <td><code><a href="https://tomcat.apache.org/connectors-doc-archive/jk2/">JK</a> (mod_jserv) + </code></td> + <td class="centered">-</td> + <td>JAVA는 포팅중이다.</td> + </tr> + + <tr> + <td><code><a href="http://www.php.net/">mod_php3</a></code></td> + <td class="centered">+</td> + <td><code>mod_php3</code>는 LDAP, GD, FreeType 라이브러리와 + 함께 잘 동작한다.</td> + </tr> + + <tr> + <td><code><a href="http://hpwww.ec-lyon.fr/~vincent/apache/mod_put.html">mod_put</a></code></td> + <td class="centered">?</td> + <td>테스트안됨</td> + </tr> + + <tr> + <td><code><a href="ftp://hachiman.vidya.com/pub/apache/">mod_session</a></code></td> + <td class="centered">-</td> + <td>테스트안됨</td> + </tr> + </table> + + </div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/platform/ebcdic.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../ko/platform/ebcdic.html" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/ebcdic.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/index.html b/docs/manual/platform/index.html new file mode 100644 index 0000000..5c37adc --- /dev/null +++ b/docs/manual/platform/index.html @@ -0,0 +1,17 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: index.html.en +Content-Language: en +Content-type: text/html; charset=UTF-8 + +URI: index.html.fr.utf8 +Content-Language: fr +Content-type: text/html; charset=UTF-8 + +URI: index.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR + +URI: index.html.zh-cn.utf8 +Content-Language: zh-cn +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/platform/index.html.en b/docs/manual/platform/index.html.en new file mode 100644 index 0000000..fe44546 --- /dev/null +++ b/docs/manual/platform/index.html.en @@ -0,0 +1,124 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Platform Specific Notes - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="../"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Platform Specific Notes</h1> +<div class="toplang"> +<p><span>Available Languages: </span><a href="../en/platform/" title="English"> en </a> | +<a href="../fr/platform/" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../zh-cn/platform/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> +</div> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#win">Microsoft Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#unix">Unix Systems</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#other">Other Platforms</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="win" id="win">Microsoft Windows</a></h2> + + + + <dl> + <dt>Using Apache</dt> + <dd> + <p>This document explains how to install, configure and run Apache 2.4 + under Microsoft Windows.</p> + + <p>See: <a href="windows.html">Using Apache with Microsoft Windows</a></p> + </dd> + </dl> + + <dl> + <dt>Compiling Apache</dt> + <dd> + <p>There are many important points before you begin compiling Apache. + This document explain them.</p> + + <p>See: <a href="win_compiling.html">Compiling Apache for Microsoft Windows</a></p> + </dd> + </dl> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="unix" id="unix">Unix Systems</a></h2> + + + + <dl> + <dt>RPM Based Systems (Redhat / CentOS / Fedora)</dt> + <dd> + <p>This document explains how to build, install, and run Apache 2.4 + on systems supporting the RPM packaging format.</p> + + <p>See: <a href="rpm.html">Using Apache With RPM Based Systems</a></p> + </dd> + </dl> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="other" id="other">Other Platforms</a></h2> + + + + <dl> + <dt>Novell NetWare</dt> + <dd> + <p>This document explains how to install, configure and run Apache 2.4 + under Novell NetWare 5.1 and above.</p> + + <p>See: <a href="netware.html">Using Apache With Novell NetWare</a></p> + </dd> + </dl> + + <dl> + <dt>EBCDIC</dt> + <dd> + <p>Version 1.3 of the Apache HTTP Server is the first version which + includes a port to a (non-ASCII) mainframe machine which uses the + EBCDIC character set as its native codeset.</p> + + <div class="warning"><strong>Warning:</strong> This document + has not been updated to take into account changes made in + the 2.4 version of the Apache HTTP Server. Some of the + information may still be relevant, but please use it + with care.</div> + + <p>See: <a href="ebcdic.html">The Apache EBCDIC Port</a></p> + </dd> + </dl> + + </div></div> +<div class="bottomlang"> +<p><span>Available Languages: </span><a href="../en/platform/" title="English"> en </a> | +<a href="../fr/platform/" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../zh-cn/platform/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/index.html.fr.utf8 b/docs/manual/platform/index.html.fr.utf8 new file mode 100644 index 0000000..b4d99c2 --- /dev/null +++ b/docs/manual/platform/index.html.fr.utf8 @@ -0,0 +1,130 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Notes sp챕cifiques aux diff챕rentes plateformes. - Serveur HTTP Apache Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur HTTP Apache Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="../"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>Notes sp챕cifiques aux diff챕rentes plateformes.</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../zh-cn/platform/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> +</div> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#win">Microsoft Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#unix">Syst챔mes de type Unix</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#other">Autres plateformes</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="win" id="win">Microsoft Windows</a></h2> + + + + <dl> + <dt>Utilisation d'Apache</dt> + <dd> + <p>Ce document explique comment installer, configurer et + ex챕cuter Apache 2.4 sous Microsoft Windows.</p> + + <p>Voir : <a href="windows.html">Utilisation d'Apache avec Microsoft Windows</a></p> + </dd> + </dl> + + <dl> + <dt>Compilation d'Apache</dt> + <dd> + <p>Il y a de nombreux points importants 횪 conna챤tre avant de se + lancer dans la compilation d'Apache. Ce document en donne la + description.</p> + + <p>Voir : <a href="win_compiling.html">Compilation d'Apache pour Microsoft Windows</a></p> + </dd> + </dl> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="unix" id="unix">Syst챔mes de type Unix</a></h2> + + + + <dl> + <dt>Syst챔mes 횪 base de paquets RPM (Redhat / CentOS / Fedora)</dt> + <dd> + <p>Ce document explique comment installer, configurer et + ex챕cuter Apache 2.4 sur des syst챔mes qui supportent le format de + paquet RPM.</p> + + <p>Voir : <a href="rpm.html">Utilisation d'Apache avec les + syst챔mes 횪 base de paquets RPM</a></p> + </dd> + </dl> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="other" id="other">Autres plateformes</a></h2> + + + + <dl> + <dt>Novell NetWare</dt> + <dd> + <p>Ce document explique comment installer, configurer et + ex챕cuter Apache 2.4 sous Novell NetWare versions 5.1 et + sup챕rieures.</p> + + <p>Voir : <a href="netware.html">Utilisation d'Apache avec Novell NetWare</a></p> + </dd> + </dl> + + <dl> + <dt>EBCDIC</dt> + <dd> + <p>La version 1.3 du serveur HTTP Apache est la premi챔re 횪 + avoir 챕t챕 port챕e vers une machine de type mainframe (non-ASCII) + qui utilisait le jeu de caract챔res EBCDIC comme jeu de + caract챔res natif.</p> + + <div class="warning"><strong>Avertissement :</strong>Ce document + n'a pas fait l'objet d'une mise 횪 jour pour int챕grer les + modifications intervenues 횪 partir de la version 2.4 du serveur + HTTP Apache. Certaines des informations qu'il contient sont + toujours pertinentes, mais il est conseill챕 de les utiliser avec + prudence.</div> + + <p>Voir : <a href="ebcdic.html">Le portage d'Apache vers EBCDIC</a></p> + </dd> + </dl> + + </div></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../zh-cn/platform/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Autoris챕 sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/index.html.ko.euc-kr b/docs/manual/platform/index.html.ko.euc-kr new file mode 100644 index 0000000..502eb0b --- /dev/null +++ b/docs/manual/platform/index.html.ko.euc-kr @@ -0,0 +1,109 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head> +<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>플래폼별 설명 - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="../"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a></div><div id="page-content"><div id="preamble"><h1>플래폼별 설명</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/platform/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/" title="Korean"> ko </a> | +<a href="../zh-cn/platform/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> +</div> +<div class="outofdate">이 문서는 최신판 번역이 아닙니다. + 최근에 변경된 내용은 영어 문서를 참고하세요.</div> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#win">Microsoft Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#other">기타 플래폼</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="win" id="win">Microsoft Windows</a></h2> + + + + <dl> + <dt>아파치 사용법</dt> + <dd> + <p>이 문서는 Microsoft Windows에서 아파치 2.0을 설치, + 설정, 실행하는 방법을 설명한다.</p> + + <p>문서: <a href="windows.html">Microsoft Windows에서 + 아파치 사용법</a></p> + </dd> + </dl> + + <dl> + <dt>아파치 컴파일</dt> + <dd> + <p>아파치를 컴파일하기 전에 주의할 점이 많다. 이 문서는 + 이점을 설명한다.</p> + + <p>문서: <a href="win_compiling.html">Microsoft Windows용 아파치 컴파일</a></p> + </dd> + </dl> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="other" id="other">기타 플래폼</a></h2> + + + + <dl> + <dt>Novell NetWare</dt> + <dd> + <p>이 문서는 Novell NetWare 5.1 이상에서 아파치 2.0을 + 설치, 설정, 실행하는 방법을 설명한다.</p> + + <p>문서: <a href="netware.html">Novell NetWare에서 아파치 + 사용하기</a></p> + </dd> + </dl> + + <dl> + <dt>EBCDIC</dt> + <dd> + <p>아파치 웹서버는 1.3 버전때 처음으로 EBCDIC 문자집합을 + 기본 문자집합으로 사용하는 (비-ASCII) 메인플레임 컴퓨터로 + 포팅되었다.</p> + + <div class="warning"><strong>경고:</strong> 이 문서는 + 아파치 웹서버 2.0 버전에서 변경된 내용을 담고있지 않다. + 아직도 유효한 정보가 있지만, 주의해서 사용하길 바란다.</div> + + <p>문서: <a href="ebcdic.html">아파치 EBCDIC 포팅</a></p> + </dd> + </dl> + + </div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/platform/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/" title="Korean"> ko </a> | +<a href="../zh-cn/platform/" hreflang="zh-cn" rel="alternate" title="Simplified Chinese"> zh-cn </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/index.html.zh-cn.utf8 b/docs/manual/platform/index.html.zh-cn.utf8 new file mode 100644 index 0000000..c391487 --- /dev/null +++ b/docs/manual/platform/index.html.zh-cn.utf8 @@ -0,0 +1,103 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="zh-cn" xml:lang="zh-cn"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>亮녑룿�쎑�뀽瑥닸삇 - Apache HTTP �쐨�뒦�솳 �뎵�쑍 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">與▼쓼</a> | <a href="../mod/directives.html">�뙁餓�</a> | <a href="http://wiki.apache.org/httpd/FAQ">躍멱쭅�뿮窯�</a> | <a href="../glossary.html">�쑐瑥�</a> | <a href="../sitemap.html">營묊쳶野쇠닼</a></p> +<p class="apache">Apache HTTP �쐨�뒦�솳�뎵�쑍 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="../"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP �쐨�뒦�솳</a> > <a href="http://httpd.apache.org/docs/">�뻼旅�</a> > <a href="../">�뎵�쑍 2.4</a></div><div id="page-content"><div id="preamble"><h1>亮녑룿�쎑�뀽瑥닸삇</h1> +<div class="toplang"> +<p><span>�룾�뵪瑥�鼇�: </span><a href="../en/platform/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../zh-cn/platform/" title="Simplified Chinese"> zh-cn </a></p> +</div> +<div class="outofdate">閭ㅷ옐瑥묈룾�꺗瓦뉑쐿��귟쫨雅녻㎗���瓦묊쉪�쎍�뵻竊뚩�룬쁾瑥삭떛�뻼�뎵���</div> +</div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#win">Microsoft Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#other">�끀若껃뭄�룿</a></li> +</ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="win" id="win">Microsoft Windows</a></h2> + + + + <dl> + <dt>鵝욜뵪 Apache</dt> + <dd> + <p>瓦숂칶�뻼旅ｈ㎗�뇢雅녶쫩鵝뺝쑉 Microsoft Windows 訝�若됭즳竊뚪뀓營�竊뚥빳�룋瓦먫죱 Apache 2.0 ���</p> + + <p>�뢿鰲�: <a href="windows.html">�쑉 Microsoft Windows 訝�鵝욜뵪 Apache</a></p> + </dd> + </dl> + + <dl> + <dt>煐뽬캂 Apache</dt> + <dd> + <p>瓦숂칶�뻼旅ｈ㎗�뇢雅녺폋瑥� Apache �쉪誤곭궧���</p> + + <p>�뢿鰲�: <a href="win_compiling.html">訝� Microsoft Windows 煐뽬캂 Apache</a></p> + </dd> + </dl> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="other" id="other">�끀若껃뭄�룿</a></h2> + + + + <dl> + <dt>Novell NetWare</dt> + <dd> + <p>瓦숂칶�뻼旅ｈ㎗�뇢雅녶쫩鵝뺝쑉 Novell NetWare 5.1 �닑�쎍�뼭�쉪�뎵�쑍訝�竊뚦쫩鵝뺝츎獒낉펽�뀓營�竊뚥빳�룋瓦먫죱 + Apache 2.0 ��� + </p> + + <p>�뢿鰲�: <a href="netware.html">�쑉 Novell NetWare 訝�鵝욜뵪 Apache</a></p> + </dd> + </dl> + + <dl> + <dt>EBCDIC</dt> + <dd> + <p>餓� Apache HTTP �뎵�쑍 1.3 凉�冶뗦뵱�똻鵝욜뵪 EBCDIC 耶쀧Е�썓鵝쒍맏�렅�뵟耶쀧Е�썓�쉪(�씆 ASCII)訝삥쑛���</p> + + <div class="warning"><strong>鈺��몜:</strong> + 瓦숂칶�뻼旅ｅ컶�쑋若뚦뀲�쎍�뼭竊뚥빳�룏�삝�눎 Apache HTTP �쐨�뒦�솳�뎵�쑍 2.0 + 阿뗥릮�쉪岳��뵻��귝윇雅쎽에�겘�룾�꺗餓띷뿧��귞뵪竊뚥퐜瑥룟컦恙껂슴�뵪若껁��</div> + + <p>�뢿鰲�: <a href="ebcdic.html">Apache 訝� EBCDIC 楹사퍨</a></p> + </dd> + </dl> + + </div></div> +<div class="bottomlang"> +<p><span>�룾�뵪瑥�鼇�: </span><a href="../en/platform/" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/" hreflang="ko" rel="alternate" title="Korean"> ko </a> | +<a href="../zh-cn/platform/" title="Simplified Chinese"> zh-cn </a></p> +</div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />�읃雅� <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> 溫멨룾瑥�.</p> +<p class="menu"><a href="../mod/">與▼쓼</a> | <a href="../mod/directives.html">�뙁餓�</a> | <a href="http://wiki.apache.org/httpd/FAQ">躍멱쭅�뿮窯�</a> | <a href="../glossary.html">�쑐瑥�</a> | <a href="../sitemap.html">營묊쳶野쇠닼</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/netware.html b/docs/manual/platform/netware.html new file mode 100644 index 0000000..afbeeb6 --- /dev/null +++ b/docs/manual/platform/netware.html @@ -0,0 +1,13 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: netware.html.en +Content-Language: en +Content-type: text/html; charset=UTF-8 + +URI: netware.html.fr.utf8 +Content-Language: fr +Content-type: text/html; charset=UTF-8 + +URI: netware.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/platform/netware.html.en b/docs/manual/platform/netware.html.en new file mode 100644 index 0000000..dd00889 --- /dev/null +++ b/docs/manual/platform/netware.html.en @@ -0,0 +1,693 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Using Apache With Novell NetWare - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Using Apache With Novell NetWare</h1> +<div class="toplang"> +<p><span>Available Languages: </span><a href="../en/platform/netware.html" title="English"> en </a> | +<a href="../fr/platform/netware.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/netware.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + + <p>This document explains how to install, configure and run + Apache 2.0 under Novell NetWare 6.0 and above. If you find any bugs, + or wish to contribute in other ways, please use our + <a href="http://httpd.apache.org/bug_report.html">bug reporting + page.</a></p> + + <p>The bug reporting page and dev-httpd mailing list are + <em>not</em> provided to answer questions about configuration or + running Apache. Before you submit a bug report or request, first + consult this document, the <a href="http://wiki.apache.org/httpd/FAQ">Frequently Asked + Questions</a> page and the other relevant documentation topics. If + you still have a question or problem, post it to the <a href="news://developer-forums.novell.com/novell.devsup.webserver"> + novell.devsup.webserver</a> newsgroup, where many Apache users are + more than willing to answer new and obscure questions about using + Apache on NetWare.</p> + + <p>Most of this document assumes that you are installing Apache + from a binary distribution. If you want to compile Apache + yourself (possibly to help with development, or to track down + bugs), see the section on <a href="#comp">Compiling Apache for + NetWare</a> below.</p> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#req">Requirements</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#down">Downloading Apache for NetWare</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#inst">Installing Apache for NetWare</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#run">Running Apache for NetWare</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#use">Configuring Apache for NetWare</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#comp">Compiling Apache for NetWare</a></li> +</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="req" id="req">Requirements</a></h2> + + + + <p>Apache 2.0 is designed to run on NetWare 6.0 service pack 3 + and above. If you are running a service pack less + than SP3, you must install the latest + <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries + for C (LibC)</a>.</p> + + <p>NetWare service packs are available <a href="http://support.novell.com/misc/patlst.htm#nw">here</a>.</p> + + <p>Apache 2.0 for NetWare can also be run in a NetWare 5.1 environment + as long as the latest service pack or the latest version + of the <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries + for C (LibC)</a> has been installed . <strong>WARNING:</strong> Apache 2.0 + for NetWare has not been targeted for or tested in this environment.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="down" id="down">Downloading Apache for NetWare</a></h2> + + + + <p>Information on the latest version of Apache can be found on + the Apache web server at <a href="http://www.apache.org/">http://www.apache.org/</a>. This + will list the current release, any more recent alpha or + beta-test releases, together with details of mirror web and + anonymous ftp sites. Binary builds of the latest releases of + Apache 2.0 for NetWare can be downloaded from + <a href="http://www.apache.org/dist/httpd/binaries/netware">here</a>.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="inst" id="inst">Installing Apache for NetWare</a></h2> + + + + <p>There is no Apache install program for NetWare currently. If you + are building Apache 2.0 for NetWare from source, you will need to + copy the files over to the server manually.</p> + + <p>Follow these steps to install Apache on NetWare from the + binary download (assuming you will install to + <code>sys:/apache2</code>):</p> + + <ul> + <li>Unzip the binary download file to the root of the <code>SYS:</code> + volume (may be installed to any volume)</li> + + <li>Edit the <code>httpd.conf</code> file setting <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> and <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> along with any file path values + to reflect your correct server settings</li> + + <li>Add <code>SYS:/APACHE2</code> to the search path, for example: + <div class="example"><p><code>SEARCH ADD SYS:\APACHE2</code></p></div> + </li> + + </ul> + + <p>Follow these steps to install Apache on NetWare manually + from your own build source (assuming you will install to + <code>sys:/apache2</code>):</p> + + <ul> + <li>Create a directory called <code>Apache2</code> on a + NetWare volume</li> + + <li>Copy <code>APACHE2.NLM</code>, <code>APRLIB.NLM</code> + to <code>SYS:/APACHE2</code></li> + + <li>Create a directory under <code>SYS:/APACHE2</code> + called <code>BIN</code></li> + + <li>Copy <code>HTDIGEST.NLM</code>, <code>HTPASSWD.NLM</code>, + <code>HTDBM.NLM</code>, <code>LOGRES.NLM</code>, <code>ROTLOGS.NLM</code> + to <code>SYS:/APACHE2/BIN</code></li> + + <li>Create a directory under <code>SYS:/APACHE2</code> + called <code>CONF</code></li> + + <li>Copy the <code>HTTPD-STD.CONF</code> file to the + <code>SYS:/APACHE2/CONF</code> directory and rename to + <code>HTTPD.CONF</code></li> + + <li>Copy the <code>MIME.TYPES</code>, <code>CHARSET.CONV</code> and + <code>MAGIC</code> files to <code>SYS:/APACHE2/CONF</code> directory</li> + + <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\ICONS</code> + to <code>SYS:/APACHE2/ICONS</code></li> + + <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\MANUAL</code> + to <code>SYS:/APACHE2/MANUAL</code></li> + + <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\ERROR</code> + to <code>SYS:/APACHE2/ERROR</code></li> + + <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\DOCROOT</code> + to <code>SYS:/APACHE2/HTDOCS</code></li> + + <li>Create the directory <code>SYS:/APACHE2/LOGS</code> + on the server</li> + + <li>Create the directory <code>SYS:/APACHE2/CGI-BIN</code> + on the server</li> + + <li>Create the directory <code>SYS:/APACHE2/MODULES</code> + and copy all nlm modules into the <code>modules</code> directory</li> + + <li>Edit the <code>HTTPD.CONF</code> file searching for all + <code>@@Value@@</code> markers and replacing them with the + appropriate setting</li> + + <li>Add <code>SYS:/APACHE2</code> to the search path, for example: + <div class="example"><p><code>SEARCH ADD SYS:\APACHE2</code></p></div> + </li> + </ul> + + <p>Apache may be installed to other volumes besides the default <code>SYS</code> volume.</p> + + <p>During the build process, adding the keyword "install" to the makefile command line + will automatically produce a complete distribution package under the subdirectory + <code>DIST</code>. Install Apache by simply copying the distribution that was produced + by the makfiles to the root of a NetWare volume (see: <a href="#comp">Compiling Apache for + NetWare</a> below).</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="run" id="run">Running Apache for NetWare</a></h2> + + + + <p>To start Apache just type <code>apache</code> at the + console. This will load apache in the OS address space. If you + prefer to load Apache in a protected address space you may + specify the address space with the load statement as follows:</p> + + <div class="example"><p><code> + load address space = apache2 apache2 + </code></p></div> + + <p>This will load Apache into an address space called apache2. + Running multiple instances of Apache concurrently on NetWare is + possible by loading each instance into its own protected + address space.</p> + + <p>After starting Apache, it will be listening to port 80 + (unless you changed the <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> + directive in the configuration files). + To connect to the server and access the default page, + launch a browser and enter the server's name or address. This + should respond with a welcome page, and a link to the Apache + manual. If nothing happens or you get an error, look in the + <code>error_log</code> file in the <code>logs</code> + directory.</p> + + <p>Once your basic installation is working, you should + configure it properly by editing the files in the + <code>conf</code> directory.</p> + + <p>To unload Apache running in the OS address space just type + the following at the console:</p> + + <div class="example"><p><code> + unload apache2 + </code></p></div> + + <p>or</p> + + <div class="example"><p><code> + apache2 shutdown + </code></p></div> + + <p>If apache is running in a protected address space specify the + address space in the unload statement:</p> + + <div class="example"><p><code> + unload address space = apache2 apache2 + </code></p></div> + + <p>When working with Apache it is important to know how it will + find the configuration files. You can specify a configuration + file on the command line in two ways:</p> + + <ul> + <li><code>-f</code> specifies a path to a particular + configuration file</li> + </ul> + + <div class="example"><p><code> + apache2 -f "vol:/my server/conf/my.conf" + </code></p></div> + + <div class="example"><p><code> + apache -f test/test.conf + </code></p></div> + + <p>In these cases, the proper <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> + should be set in the configuration file.</p> + + <p>If you don't specify a configuration file name with <code>-f</code>, + Apache will use the file name compiled into the server, usually + <code>conf/httpd.conf</code>. Invoking Apache with the <code>-V</code> + switch will display this value labeled as <code>SERVER_CONFIG_FILE</code>. + Apache will then determine its <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> + by trying the following, in this order:</p> + + <ul> + <li>A <code>ServerRoot</code> directive via a + <code>-C</code> switch.</li> + + <li>The <code>-d</code> switch on the command line.</li> + + <li>Current working directory</li> + + <li>The server root compiled into the server.</li> + </ul> + + <p>The server root compiled into the server is usually <code>sys:/apache2</code>. + invoking apache with the <code>-V</code> switch will display this value labeled as + <code>HTTPD_ROOT</code>.</p> + + <p>Apache 2.0 for NetWare includes a set of command line directives that can + be used to modify or display information about the running instance of the + web server. These directives are only available while Apache is running. Each + of these directives must be preceded by the keyword <code>APACHE2</code>.</p> + + <dl> + <dt>RESTART</dt> + <dd>Instructs Apache to terminate all running worker + threads as they become idle, reread the configuration file and restart each + worker thread based on the new configuration.</dd> + + <dt>VERSION</dt> + <dd>Displays version information about the currently + running instance of Apache.</dd> + + <dt>MODULES</dt> + <dd>Displays a list of loaded modules both built-in + and external.</dd> + + <dt>DIRECTIVES</dt> + <dd>Displays a list of all available directives.</dd> + + <dt>SETTINGS</dt> + <dd>Enables or disables the thread status display + on the console. When enabled, the state of each running threads is displayed + on the Apache console screen.</dd> + + <dt>SHUTDOWN</dt> + <dd>Terminates the running instance of the Apache + web server.</dd> + + <dt>HELP</dt> + <dd>Describes each of the runtime directives.</dd> + </dl> + + <p>By default these directives are issued against the instance of Apache running + in the OS address space. To issue a directive against a specific instance running + in a protected address space, include the -p parameter along with the name of the + address space. For more information type "apache2 Help" on the command line.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="use" id="use">Configuring Apache for NetWare</a></h2> + + + + <p>Apache is configured by reading configuration files usually stored + in the <code>conf</code> directory. These are the same as files used + to configure the Unix version, but there are a few different directives for + Apache on NetWare. See the <a href="../mod/">Apache module + documentation</a> for all the available directives.</p> + + <p>The main differences in Apache for NetWare are:</p> + + <ul> + <li> + <p>Because Apache for NetWare is multithreaded, it does not + use a separate process for each request, as Apache does on some Unix + implementations. Instead there are only threads running: a parent + thread, and multiple child or worker threads which handle the requests.</p> + + <p>Therefore the "process"-management directives are different:</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code> - + Like the Unix directive, this controls how many connections + a worker thread will serve before exiting. The recommended default, + <code>MaxConnectionsPerChild 0</code>, causes the thread to continue servicing + request indefinitely. It is recommended on NetWare, unless there is some + specific reason, that this directive always remain set to <code>0</code>.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#startthreads">StartThreads</a></code> - + This directive tells the server how many threads it should start initially. + The recommended default is <code>StartThreads 50</code>.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#minsparethreads">MinSpareThreads</a></code> - + This directive instructs the server to spawn additional worker threads + if the number of idle threads ever falls below this value. The recommended + default is <code>MinSpareThreads 10</code>.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxsparethreads">MaxSpareThreads</a></code> - + This directive instructs the server to begin terminating worker threads + if the number of idle threads ever exceeds this value. The recommended + default is <code>MaxSpareThreads 100</code>.</p> + + <p><code class="directive"><a href="../mod/mpm_netware.html#maxthreads">MaxThreads</a></code> - + This directive limits the total number of work threads to a maximum + value. The recommended default is <code>ThreadsPerChild 250</code>.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code> - + This directive tells the server what size of stack to use + for the individual worker thread. The recommended default + is <code>ThreadStackSize 65536</code>.</p> + </li> + + <li> + <p>The directives that accept filenames as arguments must use + NetWare filenames instead of Unix names. However, because Apache + uses Unix-style names internally, forward slashes must be used + rather than backslashes. It is recommended that all rooted file paths + begin with a volume name. If omitted, Apache will assume the + <code>SYS:</code> volume which may not be correct.</p> + </li> + + <li> + <p>Apache for NetWare has the ability to load modules at + runtime, without recompiling the server. If Apache is + compiled normally, it will install a number of optional + modules in the <code>\Apache2\modules</code> directory. + To activate these, or other modules, the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive + must be used. For example, to active the status module, use + the following:</p> + + <div class="example"><p><code> + LoadModule status_module modules/status.nlm + </code></p></div> + + <p>Information on <a href="../mod/mod_so.html#creating">creating loadable + modules</a> is also available.</p> + </li> + </ul> + + <h3><a name="use-add" id="use-add">Additional NetWare specific directives:</a></h3> + + + + <ul> + <li><code class="directive"><a href="../mod/core.html#cgimapextension">CGIMapExtension</a></code> - + This directive maps a CGI file extension to a script interpreter.</li> + </ul> + <ul> + <li><code class="directive"><a href="../mod/mod_nw_ssl.html#securelisten">SecureListen</a></code> - + Enables SSL encryption for a specified port.</li> + </ul> + <ul> + <li><code class="directive"><a href="../mod/mod_nw_ssl.html#nwssltrustedcerts">NWSSLTrustedCerts</a></code> - + Adds trusted certificates that are used to create secure connections to proxied servers.</li> + </ul> + <ul> + <li><code class="directive"><a href="../mod/mod_nw_ssl.html#nwsslupgradeable">NWSSLUpgradeable</a></code> - + Allow a connection created on the specified address/port to be upgraded to an SSL connection.</li> + </ul> + + + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="comp" id="comp">Compiling Apache for NetWare</a></h2> + + + + <p>Compiling Apache requires MetroWerks CodeWarrior 6.x or higher. Once + Apache has been built, it can be installed to the root of any NetWare + volume. The default is the <code>sys:/Apache2</code> directory.</p> + + <p>Before running the server you must fill out the <code>conf</code> + directory. Copy the file <code>HTTPD-STD.CONF</code> from the distribution + <code>conf</code> directory and rename it to <code>HTTPD.CONF</code>. + Edit the <code>HTTPD.CONF</code> file searching for all <code>@@Value@@</code> + markers and replacing them with the appropriate setting. Copy over + the <code>conf/magic</code> and <code>conf/mime.types</code> files as well. + Alternatively, a complete distribution can be built by including the keyword + <code>install</code> when invoking the makefiles.</p> + + <h3><a name="comp-req" id="comp-req">Requirements:</a></h3> + + + + <p>The following development tools are required to build + Apache 2.0 for NetWare:</p> + + <ul> + <li>Metrowerks CodeWarrior 6.0 or higher with the + <a href="http://developer.novell.com/ndk/cwpdk.htm">NetWare PDK 3.0</a> + or higher.</li> + + <li><a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries + for C (LibC)</a></li> + + <li><a href="http://developer.novell.com/ndk/cldap.htm">LDAP Libraries + for C</a></li> + + <li><a href="http://www.gzip.org/zlib/">ZLIB Compression Library source code</a></li> + + <li>AWK utility (awk, gawk or similar). AWK can be downloaded from + <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>. + The utility must be found in your windows path and must be named <code>awk.exe</code>.</li> + + <li>To build using the makefiles, you will need GNU make version 3.78.1 (GMake) available at + <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>.</li> + </ul> + + + + <h3><a name="comp-make" id="comp-make">Building Apache using the NetWare makefiles:</a></h3> + + + + <ul> + <li>Set the environment variable <code>NOVELLLIBC</code> to the + location of the NetWare Libraries for C SDK, for example: + <div class="example"><p><code>Set NOVELLLIBC=c:\novell\ndk\libc</code></p></div> + </li> + + <li>Set the environment variable <code>METROWERKS</code> to the + location where you installed the Metrowerks CodeWarrior compiler, + for example: + <div class="example"><p><code>Set METROWERKS=C:\Program Files\Metrowerks\CodeWarrior</code></p></div> + If you installed to the default location <code>C:\Program + Files\Metrowerks\CodeWarrior</code>, you don't need to set this.</li> + + <li>Set the environment variable <code>LDAPSDK</code> to the + location where you installed the LDAP Libraries for C, for example: + <div class="example"><p><code>Set LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc</code></p></div> + </li> + + <li>Set the environment variable <code>ZLIBSDK</code> to the + location where you installed the source code for the ZLib Library, + for example: + <div class="example"><p><code>Set ZLIBSDK=D:\NOVELL\zlib</code></p></div> + </li> + + <li>Set the environment variable <code>PCRESDK</code> to the location + where you installed the source code for the PCRE Library, for example: + <div class="example"><p><code>Set PCRESDK=D:\NOVELL\pcre</code></p></div> + </li> + + <li>Set the environment variable <code>AP_WORK</code> to the full path of + the <code>httpd</code> source code directory. + <div class="example"><p><code>Set AP_WORK=D:\httpd-2.0.x</code></p></div> + </li> + + <li>Set the environment variable <code>APR_WORK</code> to the full path of + the <code>apr</code> source code directory. Typically <code>\httpd\srclib\apr</code> + but the APR project can be outside of the httpd directory structure. + <div class="example"><p><code>Set APR_WORK=D:\apr-1.x.x</code></p></div> + </li> + + <li>Set the environment variable <code>APU_WORK</code> to the full path of + the <code>apr-util</code> source code directory. Typically <code>\httpd\srclib\apr-util</code> + but the APR-UTIL project can be outside of the httpd directory structure. + <div class="example"><p><code>Set APU_WORK=D:\apr-util-1.x.x</code></p></div> + </li> + + <li>Make sure that the path to the AWK utility and the GNU make utility + (<code>gmake.exe</code>) have been included in the system's + <code>PATH</code> environment variable.</li> + + <li>Download the source code and unzip to an appropriate directory on + your workstation.</li> + + <li>Change directory to <code>\httpd-2.0</code> and build the prebuild utilities + by running "<code>gmake -f nwgnumakefile prebuild</code>". This target will create + the directory <code>\httpd-2.0\nwprebuild</code> and copy each of the utilities + to this location that are necessary to complete the following build steps. + </li> + + <li>Copy the files <code>\httpd-2.0\nwprebuild\GENCHARS.nlm</code> and + <code>\httpd-2.0\nwprebuild\DFTABLES.nlm</code> to the <code>SYS:</code> volume of a + NetWare server and run them using the following commands: + <div class="example"><p><code> + SYS:\genchars > sys:\test_char.h<br /> + SYS:\dftables sys:\chartables.c<br /> + </code></p></div> + </li> + + <li>Copy the files <code>test_char.h</code> and <code>chartables.c</code> + to the directory <code>\httpd-2.0\os\netware</code> on the build machine.</li> + + <li>Change directory to <code>\httpd-2.0</code> and build Apache by running + "<code>gmake -f nwgnumakefile</code>". You can create a distribution directory by + adding an install parameter to the command, for example: + <div class="example"><p><code>gmake -f nwgnumakefile install</code></p></div> + </li> + </ul> + + + + <h3><a name="comp-add" id="comp-add">Additional make options</a></h3> + + + + <ul> + <li><code>gmake -f nwgnumakefile</code><p>Builds release versions of all of the + binaries and copies them to a <code>\release</code> destination directory.</p></li> + + <li><code>gmake -f nwgnumakefile DEBUG=1</code><p>Builds debug versions of all of the + binaries and copies them to a <code>\debug</code> destination directory.</p></li> + + <li><code>gmake -f nwgnumakefile install</code><p>Creates a complete Apache + distribution with binaries, docs and additional support files in a + <code>\dist\Apache2</code> directory.</p></li> + + <li><code>gmake -f nwgnumakefile prebuild</code><p>Builds all of the prebuild utilities + and copies them to the <code>\nwprebuild</code> directory.</p></li> + + <li><code>gmake -f nwgnumakefile installdev</code><p>Same as install but also creates a + <code>\lib</code> and <code>\include</code> directory in the destination directory + and copies headers and import files.</p></li> + + <li><code>gmake -f nwgnumakefile clean</code><p>Cleans all object files and binaries + from the <code>\release.o</code> or <code>\debug.o</code> build areas depending on whether + <code>DEBUG</code> has been defined.</p></li> + + <li><code>gmake -f nwgnumakefile clobber_all</code><p>Same as clean and also deletes + the distribution directory if it exists.</p></li> + </ul> + + + + <h3><a name="comp-add-env" id="comp-add-env">Additional environment variable options</a></h3> + + + + <ul> + <li>To build all of the experimental modules, set the environment + variable <code>EXPERIMENTAL</code>: + <div class="example"><p><code>Set EXPERIMENTAL=1</code></p></div> + </li> + + <li>To build Apache using standard BSD style sockets rather than + Winsock, set the environment variable <code>USE_STDSOCKETS</code>: + <div class="example"><p><code>Set USE_STDSOCKETS=1</code></p></div> + </li> + + </ul> + + + + <h3><a name="comp-mod_ssl" id="comp-mod_ssl">Building mod_ssl for the NetWare platform</a></h3> + + + + <p>By default Apache for NetWare uses the built-in module + <code class="module"><a href="../mod/mod_nw_ssl.html">mod_nw_ssl</a></code> to provide SSL services. This module + simply enables the native SSL services implemented in NetWare OS + to handle all encryption for a given port. Alternatively, mod_ssl + can also be used in the same manner as on other platforms.</p> + + <p>Before mod_ssl can be built for the NetWare platform, the OpenSSL + libraries must be provided. This can be done through the following + steps:</p> + + <ul> + <li>Download the recent OpenSSL 0.9.8 release source code from the + <a href="http://www.openssl.org/source/">OpenSSL Source</a> + page (older 0.9.7 versions need to be patched and are therefore not + recommended).</li> + + <li>Edit the file <code>NetWare/set_env.bat</code> and modify any + tools and utilities paths so that they correspond to your build + environment.</li> + + <li>From the root of the OpenSSL source directory, run the following + scripts: + <div class="example"><p><code> + Netware\set_env netware-libc<br /> + Netware\build netware-libc + </code></p></div> + For performance reasons you should enable to build with ASM code. + Download NASM from the <a href="http://nasm.sourceforge.net/">SF site</a>. + Then configure OpenSSL to use ASM code: + <div class="example"><p><code> + Netware\build netware-libc nw-nasm enable-mdc2 enable-md5 + </code></p></div> + Warning: don't use the CodeWarrior Assembler - it produces broken code! + </li> + + <li>Before building Apache, set the environment variable + <code>OSSLSDK</code> to the full path to the root of the openssl + source code directory, and set WITH_MOD_SSL to 1. + <div class="example"><p><code> + Set OSSLSDK=d:\openssl-0.9.8x<br /> + Set WITH_MOD_SSL=1 + </code></p></div></li> + + </ul> + + + + </div></div> +<div class="bottomlang"> +<p><span>Available Languages: </span><a href="../en/platform/netware.html" title="English"> en </a> | +<a href="../fr/platform/netware.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/netware.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/netware.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/netware.html.fr.utf8 b/docs/manual/platform/netware.html.fr.utf8 new file mode 100644 index 0000000..c85575f --- /dev/null +++ b/docs/manual/platform/netware.html.fr.utf8 @@ -0,0 +1,763 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Utilisation d'Apache avec Novell NetWare - Serveur HTTP Apache Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur HTTP Apache Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Notes sp챕cifiques 횪 un syst챔me</a></div><div id="page-content"><div id="preamble"><h1>Utilisation d'Apache avec Novell NetWare</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/netware.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/netware.html" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/netware.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + + <p>Ce document explique l'installation, la configuration et le + lancement d'Apache 2.0 sous Novell NetWare 6.0 et les versions + ult챕rieures. Si vous trouvez une bogue, ou voulez tout simplement + contribuer de quelque mani챔re que ce soit, utilisez s'il vous plait + notre <a href="http://httpd.apache.org/bug_report.html">page des + rapports de bogues.</a></p> + + <p>La page des rapports de bogues et la liste de diffusion dev-httpd + ne doivent pas 챗tre utilis챕es pour poser des questions 횪 propos de + la configuration ou du lancement d'Apache. Avant de soumettre un + rapport de bogue ou une question, consultez ce document, la <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> ou tout autre sujet de la + documentation en rapport avec votre probl챔me. Si vous n'avez + toujours pas r챕solu votre probl챔me, postez votre question dans le + newsgroup <a href="news://developer-forums.novell.com/novell.devsup.webserver"> + novell.devsup.webserver</a>, o첫 de nombreux utilisateurs d'Apache + sont pr챗ts 횪 r챕pondre 횪 toutes les nouvelles et obscures questions 횪 + propos de l'utilisation d'Apache sous Netware.</p> + + <p>Dans la majeure partie de ce document, vous 챗tes sens챕 avoir + install챕 Apache 횪 partir d'une distribution binaire. Si vous voulez + compiler Apache vous-m챗me (par exemple pour aider au d챕veloppement, + ou pour rechercher des bogues), reportez-vous 횪 la section traitant + de la <a href="#comp">Compilation d'Apache pour Netware</a> + ci-dessous.</p> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#req">Pr챕requis</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#down">T챕l챕chargement d'Apache pour NetWare</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#inst">Installation d'Apache pour NetWare</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#run">Ex챕cuter Apache pour NetWare</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#use">Configuration d'Apache pour NetWare</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#comp">Compilation d'Apache pour NetWare</a></li> +</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="req" id="req">Pr챕requis</a></h2> + + + + <p>Apache 2.0 n챕cessite NetWare 6.0 service pack 3 et sup챕rieurs + pour fonctionner. Si vous utilisez un service pack ant챕rieur 횪 SP3, + vous devez installer les derni챔res <a href="http://developer.novell.com/ndk/libc.htm">Biblioth챔ques + Netware pour C (LibC)</a>.</p> + + <p>Vous trouverez les service packs Netware <a href="http://support.novell.com/misc/patlst.htm#nw">ici</a>.</p> + + <p>Apache 2.0 pour NetWare peut aussi fonctionner dans un + environnement NetWare 5.1, 횪 partir du moment o첫 le dernier service + pack ou la derni챔re version des <a href="http://developer.novell.com/ndk/libc.htm">Biblioth챔ques + Netware pour C (LibC)</a> ont 챕t챕 install챕s. <strong>ATTENTION + :</strong> Apache 2.0 pour NetWare n'a pas 챕t챕 test챕 dans cet + environnement car il n'a pas 챕t챕 con챌u pour ce dernier.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="down" id="down">T챕l챕chargement d'Apache pour NetWare</a></h2> + + + + <p>Les informations 횪 propos de la derni챔re version + d'Apache sont disponibles sur le site web d'Apache 횪 <a href="http://www.apache.org/">http://www.apache.org/</a>. Vous y + trouverez la version courante, des versions alpha ou b챗ta-test plus + r챕centes, ainsi que des sites miroirs et des sites FTP anonymes. Les + distributions binaires des derni챔res versions d'Apache 2.0 pour + NetWare sont disponibles <a href="http://www.apache.org/dist/httpd/binaries/netware">ici</a>.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="inst" id="inst">Installation d'Apache pour NetWare</a></h2> + + + + <p>Il n'existe pas actuellement de programme d'installation d'Apache + pour Netware. Si vous installez Apache 2.0 pour NetWare 횪 partir des + sources, vous devrez copier les fichiers sur le serveur + manuellement.</p> + + <p>Suivez ces instructions pour installer Apache sous Netware 횪 + partir de la distribution binaire (en supposant que vous effectuez + l'installation dans <code>sys:/apache2</code>) :</p> + + <ul> + <li>D챕compressez le fichier binaire t챕l챕charg챕 횪 la racine du + volume <code>SYS:</code> (vous pouvez cependant l'installer dans + tout volume)</li> + + <li>Editez le fichier <code>httpd.conf</code> et d챕finissez les + directives <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> et + <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> avec les valeurs + correctes des chemins de fichiers qui correspondent 횪 la + configuration de votre serveur.</li> + + <li>Ajoutez <code>SYS:/APACHE2</code> au chemin de recherche, par + une commande du style : <div class="example"><p><code>SEARCH ADD + SYS:\APACHE2</code></p></div></li> + + </ul> + + <p>Suivez ces instructions pour installer Apache pour Netware + manuellement 횪 partir de votre propre r챕pertoire de sources (en + supposant que vous effectuez l'installation dans + <code>sys:/apache2</code>) :</p> + + <ul> + <li>Cr챕ez un r챕pertoire que vous appellerez <code>Apache2</code> + dans un volume Netware.</li> + + <li>Copiez <code>APACHE2.NLM</code>, <code>APRLIB.NLM</code> dans + <code>SYS:/APACHE2</code>.</li> + + <li>Cr챕ez un r챕pertoire que vous appellerez <code>BIN</code> dans + <code>SYS:/APACHE2</code>.</li> + + <li>Copiez <code>HTDIGEST.NLM</code>, <code>HTPASSWD.NLM</code>, + <code>HTDBM.NLM</code>, <code>LOGRES.NLM</code>, + <code>ROTLOGS.NLM</code> dans <code>SYS:/APACHE2/BIN</code>.</li> + + <li>Cr챕ez un r챕pertoire que vous appellerez <code>CONF</code> dans + <code>SYS:/APACHE2</code>.</li> + + <li>Copiez le fichier <code>HTTPD-STD.CONF</code> dans le + r챕pertoire <code>SYS:/APACHE2/CONF</code> et renommez-le en + <code>HTTPD.CONF</code>.</li> + + <li>Copiez les fichiers <code>MIME.TYPES</code>, + <code>CHARSET.CONV</code> et <code>MAGIC</code> dans le r챕pertoire + <code>SYS:/APACHE2/CONF</code>.</li> + + <li>Copiez tous les fichiers et sous-r챕pertoires de + <code>\HTTPD-2.0\DOCS\ICONS</code> dans + <code>SYS:/APACHE2/ICONS</code>.</li> + + <li>Copiez tous les fichiers et sous-r챕pertoires de + <code>\HTTPD-2.0\DOCS\MANUAL</code> dans + <code>SYS:/APACHE2/MANUAL</code>.</li> + + <li>Copiez tous les fichiers et sous-r챕pertoires de + <code>\HTTPD-2.0\DOCS\ERROR</code> dans + <code>SYS:/APACHE2/ERROR</code>.</li> + + <li>Copiez tous les fichiers et sous-r챕pertoires de + <code>\HTTPD-2.0\DOCS\DOCROOT</code> dans + <code>SYS:/APACHE2/HTDOCS</code>.</li> + + <li>Cr챕ez le r챕pertoire <code>SYS:/APACHE2/LOGS</code> sur le + serveur.</li> + + <li>Cr챕ez le r챕pertoire <code>SYS:/APACHE2/CGI-BIN</code> sur le + serveur.</li> + + <li>Cr챕ez le r챕pertoire <code>SYS:/APACHE2/MODULES</code> et + copiez tous les modules nlm dans le r챕pertoire + <code>modules</code>.</li> + + <li>Editez le fichier <code>HTTPD.CONF</code>, et recherchez + toutes les marques <code>@@Value@@</code> afin de les remplacer + par les valeurs appropri챕es.</li> + + <li>Ajoutez <code>SYS:/APACHE2</code> au chemin de recherche, par + une commande du style : <div class="example"><p><code>SEARCH ADD + SYS:\APACHE2</code></p></div>.</li> + </ul> + + <p>Outre le volume par d챕faut <code>SYS</code>, Apache peut 챗tre + install챕 dans tout autre volume.</p> + + <p>Au cours du processus d'installation, l'ajout du mot-cl챕 + "install" 횪 la ligne de commande du makefile va provoquer la + construction d'une distribution compl챔te sous forme d'un paquetage + dans le sous-r챕pertoire <code>DIST</code>. Vous pouvez simplement + installer Apache en copiant la distribution cr챕챕e pr챕c챕demment 횪 la + racine d'un volume Netware (voir <a href="#comp">Compilation + d'Apache pour NetWare</a> ci-dessous).</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="run" id="run">Ex챕cuter Apache pour NetWare</a></h2> + + + + <p>Pour d챕marrer Apache, tapez simplement <code>apache</code> dans + la console. Ceci aura pour effet de charger Apache dans l'espace + d'adressage du syst챔me d'exploitation. Si vous pr챕f챕rez charger + Apache dans un espace d'adressage prot챕g챕, vous pouvez sp챕cifier cet + espace d'adressage 횪 l'aide de l'instruction de chargement suivante + :</p> + + <div class="example"><p><code> + load address space = apache2 apache2 + </code></p></div> + + <p>Cette instruction va charger Apache dans un espace d'adressage + appel챕 apache2. Il est possible d'ex챕cuter plusieurs instances + simultan챕es d'Apache sous Netware, en chargeant chacune d'entre + elles dans son propre espace d'adressage prot챕g챕.</p> + + <p>Une fois d챕marr챕, Apache 챕coute le port 80 (횪 moins que vous + n'ayez modifi챕 la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> dans les fichiers de + configuration). Pour vous connecter au serveur et afficher la page + par d챕faut, lancez un navigateur et entrez le nom du serveur ou son + adresse IP. Vous devriez voir une page de bienvenue, et un lien vers + le manuel Apache. Si rien ne se produit, ou si vous obtenez un + message d'erreur, consultez le fichier <code>error_log</code> dans + le r챕pertoire <code>logs</code>.</p> + + <p>Lorsque votre installation de base fonctionne, vous devez la + configurer correctement en 챕ditant les fichiers du r챕pertoire + <code>conf</code>.</p> + + <p>Pour arr챗ter une instance d'Apache s'ex챕cutant dans l'espace + d'adressage du syst챔me d'exploitation, entrez simplement dans la + console :</p> + + <div class="example"><p><code> + unload apache2 + </code></p></div> + + <p>ou</p> + + <div class="example"><p><code> + apache2 shutdown + </code></p></div> + + <p>Si Apache s'ex챕cute dans un espace d'adressage prot챕g챕, sp챕cifiez + cet espace d'adressage dans l'instruction d'arr챗t :</p> + + <div class="example"><p><code> + unload address space = apache2 apache2 + </code></p></div> + + <p>Lorsqu'on travaille avec Apache, il est important de savoir + comment il trouve ses fichiers de configuration. Vous pouvez + sp챕cifier un fichier de configuration sur la ligne de commande de + deux mani챔res :</p> + + <ul> + <li><code>-f</code> sp챕cifie un chemin vers un fichier de + configuration particulier</li> + </ul> + + <div class="example"><p><code> + apache2 -f "vol:/nom-serveur/conf/fich-conf.conf" + </code></p></div> + + <div class="example"><p><code> + apache -f test/test.conf + </code></p></div> + + <p>Dans ces cas, la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> doit 챗tre correctement d챕finie + dans le fichier de configuration.</p> + + <p>Si vous ne sp챕cifiez pas de nom de fichier de configuration avec + l'option <code>-f</code>, Apache utilisera le nom de fichier cod챕 en + dur dans le serveur, en g챕n챕ral <code>conf/httpd.conf</code>. + L'invocation d'Apache avec l'option <code>-V</code> indiquera ce nom + comme valeur de l'챕tiquette <code>SERVER_CONFIG_FILE</code>. Apache + va ensuite d챕terminer son <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> en effectuant les tests + suivants, dans cet ordre </p> + + <ul> + <li>Une directive <code>ServerRoot</code> via une option + <code>-C</code> switch.</li> + + <li>L'option de ligne de commande <code>-d</code>.</li> + + <li>Le contenu du r챕pertoire courant.</li> + + <li>La racine du r챕pertoire d'installation cod챕e en dur dans le + serveur.</li> + </ul> + + <p>La racine du r챕pertoire d'installation cod챕e en dur dans le + serveur est en g챕n챕ral <code>sys:/apache2</code>. L'invocation + d'Apache avec l'option <code>-V</code> indiquera ce chemin comme + valeur de l'챕tiquette <code>HTTPD_ROOT</code>.</p> + + <p>Apache 2.0 pour Netware comporte un jeu d'options de ligne de + commande permettant d'afficher ou de modifier certaines + caract챕ristiques de l'instance du serveur web en cours d'ex챕cution. + Ces options ne sont disponibles que lorsqu'Apache est en cours + d'ex챕cution. Chacune de ces options doit 챗tre pr챕c챕d챕e du mot-cl챕 + <code>APACHE2</code>.</p> + + <dl> + <dt>RESTART</dt> + <dd>Demande 횪 Apache d'arr챗ter tout worker thread en cours + d'ex챕cution lorsqu'il devient inactif, de recharger le fichier de + configuration, et de red챕marrer chaque worker thread en fonction + de la nouvelle configuration.</dd> + + <dt>VERSION</dt> + <dd>Affiche des informations 횪 propos de la version de l'instance + d'Apache en cours d'ex챕cution.</dd> + + <dt>MODULES</dt> + <dd>Affiche la liste des modules charg챕s (int챕gr챕s et + externes). </dd> + + <dt>DIRECTIVES</dt> + <dd>Affiche la liste des directives disponibles.</dd> + + <dt>SETTINGS</dt> + <dd>Active ou d챕sactive l'affichage du statut des threads sur la + console. En cas d'activation, l'챕tat de chaque thread en cours + d'ex챕cution s'affiche sur l'챕cran de la console Apache.</dd> + + <dt>SHUTDOWN</dt> + <dd>Arr챗te l'instance du serveur web Apache en cours + d'ex챕cution.</dd> + + <dt>HELP</dt> + <dd>D챕crit chacune des options disponibles au cours de l'ex챕cution + d'Apache.</dd> + </dl> + + <p>Par d챕faut, ces options sont pass챕es 횪 l'instance d'apache + s'ex챕cutant dans l'espace d'adressage du syst챔me d'exploitation. + Pour passer une option 횪 une instance d'Apache sp챕cifique + s'ex챕cutant dans un espace d'adressage prot챕g챕, ajouter le param챔tre + -p suivi du nom de l'espace d'adressage. Pour plus d'informations, + tapez "apache2 Help" sur la ligne de commande.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="use" id="use">Configuration d'Apache pour NetWare</a></h2> + + + + <p>Apache lit en g챕n챕ral ses fichiers de configuration dans le + r챕pertoire <code>conf</code>. Ces fichiers sont les m챗mes que ceux + de la version Unix, mais quelques directives sont diff챕rentes sous + Netware. Voir la <a href="../mod/">Documentation Apache</a> pour + l'ensemble des directives disponibles.</p> + + <p>Les principales diff챕rences propres 횪 Apache pour NetWare sont + : </p> + + <ul> + <li> + <p>Comme Apache pour Netware est une application multithread, + elle n'utilise pas de processus s챕par챕 pour chaque requ챗te, + comme c'est le cas pour certaines impl챕mentations sous Unix. Il + n'y a que des threads en cours d'ex챕cution : un thread parent, + et plusieurs threads enfants ou worker qui traitent les + requ챗tes.</p> + + <p>En cons챕quence, les directives de gestion des "processus" + sont diff챕rentes :</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code> - comme sous + Unix, cette directive contr척le le nombre maximum de connexions + qu'un worker thread peut traiter avant de s'arr챗ter. Avec la + valeur par d챕faut <code>MaxConnectionsPerChild 0</code>, + le thread va pouvoir traiter un nombre illimit챕 de requ챗tes. + Cette valeur est recommand챕e sous Netware, 횪 moins que vous + n'ayez des raisons particuli챔res de la modifier.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#startthreads">StartThreads</a></code> - + Cette directive indique au serveur le nombre de threads qu'il + doit lancer au d챕marrage. Il est recommand챕 de conserver la + valeur par d챕faut <code>StartThreads 50</code>.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#minsparethreads">MinSpareThreads</a></code> - + Cette directive indique au serveur le nombre de worker threads + additionnels qu'il doit lancer si le nombre de threads inactifs + tombe en dessous de cette valeur. Il est recommand챕 de conserver la + valeur par d챕faut <code>MinSpareThreads 10</code>.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxsparethreads">MaxSpareThreads</a></code> - + Cette directive indique au serveur qu'il doit commencer 횪 + arr챗ter des worker threads si le nombre de threads inactifs + passe au dessus de cette valeur. Il est recommand챕 de conserver + la valeur par d챕faut <code>MaxSpareThreads 100</code>.</p> + + <p><code class="directive"><a href="../mod/mpm_netware.html#maxthreads">MaxThreads</a></code> - + Cette directive impose un nombre maximum de worker threads. Il + est recommand챕 de conserver la valeur par d챕faut + <code>ThreadsPerChild 250</code>.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code> - + Cette directive indique au serveur la taille de la pile 횪 + utiliser pour un worker thread individuel. Il est recommand챕 de + conserver la valeur par d챕faut <code>ThreadStackSize + 65536</code>.</p> + </li> + + <li> + <p>Les directives qui acceptent des noms de fichiers comme + arguments ne doivent pas utiliser des noms de fichiers Unix, + mais des noms de fichiers Netware. Cependant, comme Apache + utilise des noms de style Unix en interne, on doit utiliser des + slashes et non des antislashes. Il est recommand챕 de pr챕fixer + tous les chemins de fichiers racines par un nom de volume. Si ce + dernier est omis, Apache supposera que le volume est + <code>SYS:</code>, ce qui n'est pas forc챕ment correct.</p> + </li> + + <li> + <p>Apache pour Netware a la possibilit챕 de charger des modules + en cours d'ex챕cution, sans avoir 횪 recompiler le serveur. Si + Apache est compil챕 avec les options par d챕faut, il va installer + de nombreux modules optionnels dans le r챕pertoire + <code>\Apache2\modules</code>. Pour les activer, ou en activer + d'autres, on doit utiliser la directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. Par exemple, pour + activer le module status, ajoutez la ligne suivante :</p> + + <div class="example"><p><code> + LoadModule status_module modules/status.nlm + </code></p></div> + + <p>Des informations 횪 propos de la <a href="../mod/mod_so.html#creating">cr챕ation de modules + chargeables</a> sont aussi disponibles.</p> + </li> + </ul> + + <h3><a name="use-add" id="use-add">Autres directives sp챕cifiques 횪 Netware :</a></h3> + + + + <ul> + <li><code class="directive"><a href="../mod/core.html#cgimapextension">CGIMapExtension</a></code> - + Cette directive associe une extension de fichier CGI 횪 un + interpr챕teur de script.</li> + </ul> + <ul> + <li><code class="directive"><a href="../mod/mod_nw_ssl.html#securelisten">SecureListen</a></code> - + Cette directive active le chiffrement SSL pour un port + sp챕cifique.</li> + </ul> + <ul> + <li><code class="directive"><a href="../mod/mod_nw_ssl.html#nwssltrustedcerts">NWSSLTrustedCerts</a></code> - + Cette directive permet d'ajouter des certificats de confiance + pouvant 챗tre utilis챕s pour cr챕er des connexions s챕curis챕es vers + des serveurs mandataires.</li> + </ul> + <ul> + <li><code class="directive"><a href="../mod/mod_nw_ssl.html#nwsslupgradeable">NWSSLUpgradeable</a></code> - + Cette directive permet de faire passer en SSL une connexion + initialis챕e sur les adresse IP et Port sp챕cifi챕s.</li> + </ul> + + + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="comp" id="comp">Compilation d'Apache pour NetWare</a></h2> + + + + <p>La compilation d'Apache n챕cessite MetroWerks CodeWarrior 6.x ou + sup챕rieur. Une fois compil챕, Apache peut 챗tre install챕 횪 la racine + de tout volume Netware. Le r챕pertoire d'installation par d챕faut est + <code>sys:/Apache2</code>.</p> + + <p>Avant de d챕marrer Apache, vous devez remplir le r챕pertoire + <code>conf</code>. Copiez le fichier <code>HTTPD-STD.CONF</code> + depuis le r챕pertoire <code>conf</code> de la distribution et + renommez-le en <code>HTTPD.CONF</code>. Editez le fichier + <code>HTTPD.CONF</code> en recherchant les rep챔res + <code>@@Value@@</code>, et remplacez ces derniers par la valeur + appropri챕e. Copiez de m챗me les fichiers <code>conf/magic</code> et + <code>conf/mime.types</code>. Vous pouvez aussi construire une + distribution compl챔te en ajoutant le mot-cl챕 <code>install</code> + lors de l'invocation des makefiles.</p> + + <h3><a name="comp-req" id="comp-req">Pr챕requis :</a></h3> + + + + <p>Les outils de d챕veloppement suivants sont n챕cessaires pour la + compilation d'Apache pour Netware :</p> + + <ul> + <li>Metrowerks CodeWarrior 6.0 ou sup챕rieur avec le <a href="http://developer.novell.com/ndk/cwpdk.htm">NetWare PDK + 3.0</a> ou sup챕rieur.</li> + + <li>Les <a href="http://developer.novell.com/ndk/libc.htm">Biblioth챔ques + Netware pour C (LibC)</a></li> + + <li>Les <a href="http://developer.novell.com/ndk/cldap.htm">Biblioth챔ques + LDAP pour C</a></li> + + <li>Le <a href="http://www.gzip.org/zlib/">Code source de la + biblioth챔que de compression ZLIB</a></li> + + <li>L'utilitaire AWK (awk, gawk ou similaire). AWK peut 챗tre + t챕l챕charg챕 횪 <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>. + L'utilitaire doit se trouver dans votre chemin windows et avoir + pour nom <code>awk.exe</code>.</li> + + <li>Pour utiliser les makefiles, vous devez disposer de GNU make + version 3.78.1 (GMake) disponible 횪 <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>.</li> + </ul> + + + + <h3><a name="comp-make" id="comp-make">Compiler Apache en utilisant les makefiles Netware + :</a></h3> + + + + <ul> + <li>D챕finissez la variable d'environnement + <code>NOVELLLIBC</code> avec le chemin des biblioth챔ques Netware + pour C SDK ; par exemple : <div class="example"><p><code>Set + NOVELLLIBC=c:\novell\ndk\libc</code></p></div></li> + + <li>D챕finissez la variable d'environnement + <code>METROWERKS</code> avec le chemin de votre compilateur + Metrowerks CodeWarrior ; par exemple : <div class="example"><p><code>Set + METROWERKS=C:\Program Files\Metrowerks\CodeWarrior</code></p></div>. Si + vous l'avez install챕 dans le r챕pertoire par d챕faut + <code>C:\Program Files\Metrowerks\CodeWarrior</code>, vous + n'avez pas besoin de d챕finir cette variable.</li> + + <li>D챕finissez la variable d'environnement <code>LDAPSDK</code> + avec le chemin des biblioth챔ques LDAP pour C ; par exemple : + <div class="example"><p><code>Set + LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc</code></p></div></li> + + <li>D챕finissez la variable d'environnement <code>ZLIBSDK</code> + avec le chemin du code source de la biblioth챔que Zlib ; par + exemple : <div class="example"><p><code>Set ZLIBSDK=D:\NOVELL\zlib</code></p></div></li> + + <li>D챕finissez la variable d'environnement <code>PCRESDK</code> + avec le chemin d'installation du code source de la biblioth챔que + PCRE ; par exemple : + <div class="example"><p><code>Set PCRESDK=D:\NOVELL\pcre</code></p></div> + </li> + + <li>D챕finissez la variable d'environnement <code>AP_WORK</code> + avec le chemin du code source de <code>httpd</code>. + <div class="example"><p><code>Set AP_WORK=D:\httpd-2.0.x</code></p></div></li> + + <li>D챕finissez la variable d'environnement <code>APR_WORK</code> + avec le chemin du code source d'<code>apr</code> ; en g챕n챕ral + <code>\httpd\srclib\apr</code>, mais le projet APR peut se + trouver en dehors de la structure des r챕pertoires de httpd. + <div class="example"><p><code>Set APR_WORK=D:\apr-1.x.x</code></p></div></li> + + <li>D챕finissez la variable d'environnement <code>APU_WORK</code> + avec le chemin du code source d'<code>apr-util</code> ; en + g챕n챕ral <code>\httpd\srclib\apr-util</code>, mais le projet + APR-UTIL peut se trouver en dehors de la structure des + r챕pertoires de httpd. <div class="example"><p><code>Set + APU_WORK=D:\apr-util-1.x.x</code></p></div></li> + + <li>V챕rifiez que les chemins des utilitaires AWK et GNU make + (<code>gmake.exe</code>) ont bien 챕t챕 inclus dans la variable + d'environnement syst챔me <code>PATH</code>.</li> + + <li>T챕l챕chargez le code source et d챕compressez-le dans un + r챕pertoire de votre choix sur votre station de travail.</li> + + <li>Positionnez-vous dans le r챕pertoire <code>\httpd-2.0</code> + et compilez les utilitaires pr챕compil챕s 횪 l'aide de la commande + "<code>gmake -f nwgnumakefile prebuild</code>". Cette cible va + cr챕er le r챕pertoire <code>\httpd-2.0\nwprebuild</code>, et y + copier tous les utilitaires n챕cessaires au franchissement des + 챕tapes suivantes de la compilation.</li> + + <li>Copiez les fichiers + <code>\httpd-2.0\nwprebuild\GENCHARS.nlm</code> et + <code>\httpd-2.0\nwprebuild\DFTABLES.nlm</code> vers le volume + <code>SYS:</code> d'un serveur Netware et ex챕cutez-les 횪 l'aide + des commandes suivantes : + <div class="example"><p><code> + SYS:\genchars > sys:\test_char.h<br /> + SYS:\dftables sys:\chartables.c<br /> + </code></p></div> + </li> + + <li>Copiez les fichiers <code>test_char.h</code> et + <code>chartables.c</code> vers le r챕pertoire + <code>\httpd-2.0\os\netware</code> de la machine o첫 s'effectue + la compilation.</li> + + <li>Positionnez-vous dans le r챕pertoire <code>\httpd-2.0</code> + et compilez Apache 횪 l'aide de la commande "<code>gmake -f + nwgnumakefile</code>". Vous pouvez cr챕er un r챕pertoire pour la + distribution en ajoutant le param챔tre install 횪 la commande ; + par exemple : + <div class="example"><p><code>gmake -f nwgnumakefile install</code></p></div> + </li> + </ul> + + + + <h3><a name="comp-add" id="comp-add">Options de make suppl챕mentaires</a></h3> + + + + <ul> + <li><code>gmake -f nwgnumakefile</code><p>Compile les versions + de distribution de tous les binaires et les copie dans un + r챕pertoire <code>\release</code>.</p></li> + + <li><code>gmake -f nwgnumakefile DEBUG=1</code><p>Compile les versions + de d챕bogage de tous les binaires et les copie dans un + r챕pertoire <code>\debug</code>.</p></li> + + <li><code>gmake -f nwgnumakefile install</code><p>Cr챕e une + distribution compl챔te d'Apache avec les binaires, la + documentation et les fichiers support dans un r챕pertoire + <code>\dist\Apache2</code>.</p></li> + + <li><code>gmake -f nwgnumakefile prebuild</code><p>Compile tous + les utilitaires pr챕compil챕s et les copie dans le r챕pertoire + <code>\nwprebuild</code>.</p></li> + + <li><code>gmake -f nwgnumakefile installdev</code><p>M챗me effet + que l'option install, mais en plus, les r챕pertoires + <code>\lib</code> et <code>\include</code> sont cr챕챕s dans le + r챕pertoire de destination, et les en-t챗tes et fichiers d'import + y sont copi챕s.</p></li> + + <li><code>gmake -f nwgnumakefile clean</code><p>Supprime tous + les fichiers objets et les binaires de la zone de compilation + <code>\release.o</code>, ou <code>\debug.o</code> si + <code>DEBUG</code> a 챕t챕 d챕fini.</p></li> + + <li><code>gmake -f nwgnumakefile clobber_all</code><p>M챗me effet + que clean, mais en plus, le r챕pertoire de la distribution est + supprim챕 s'il existe.</p></li> + </ul> + + + + <h3><a name="comp-add-env" id="comp-add-env">Variables d'environnement suppl챕mentaires</a></h3> + + + + <ul> + <li>Pour compiler tous les modules exp챕rimentaux, d챕finissez la + variable d'environnement <code>EXPERIMENTAL</code> : + <div class="example"><p><code>Set EXPERIMENTAL=1</code></p></div> + </li> + + <li>Pour compiler Apache en utilisant les sockets de style BSD + standard, plut척t que Winsock, d챕finissez la variable + d'environnement <code>USE_STDSOCKETS</code> : + <div class="example"><p><code>Set USE_STDSOCKETS=1</code></p></div> + </li> + + </ul> + + + + <h3><a name="comp-mod_ssl" id="comp-mod_ssl">Compilation de mod_ssl pour la plate-forme Netware</a></h3> + + + + <p>Pour fournir les services SSL, Apache pour Netware utilise par + d챕faut le module int챕gr챕 <code class="module"><a href="../mod/mod_nw_ssl.html">mod_nw_ssl</a></code>. Ce module ne + fournit que les services SSL impl챕ment챕s par le syst챔me + d'exploitation Netware lui-m챗me pour g챕rer tous les chiffrements + pour un port donn챕. Cependant, on peut aussi utiliser mod_ssl de + la m챗me mani챔re que sur les autres plate-formes.</p> + + <p>Afin de pouvoir compiler mod_ssl pour la plate-forme Netware, + les biblioth챔ques OpenSSL doivent 챗tre disponibles. Elles peuvent + 챗tre install챕es de la mani챔re suivante :</p> + + <ul> + <li>T챕l챕chargez la derni챔re distribution du code source + d'OpenSSL 0.9.8 depuis la page <a href="http://www.openssl.org/source/">OpenSSL Source</a> (les + versions 0.9.7 doivent 챗tre patch챕es, et ne sont donc pas + recommand챕es).</li> + + <li>Editez le fichier <code>NetWare/set_env.bat</code>, et + effectuez toutes modifications n챕cessaires des chemins des + outils et utilitaires en fonction de votre environnement de + d챕veloppement.</li> + + <li>Ex챕cutez les scripts suivants depuis la racine du + r챕pertoire des sources d'OpenSSL : + <div class="example"><p><code> + Netware\set_env netware-libc<br /> + Netware\build netware-libc + </code></p></div> + Pour des raisons de performances, vous devez activer la + compilation avec le code ASM. T챕l챕charger NASM depuis le <a href="http://nasm.sourceforge.net/">site SF</a>. Configurez + ensuite OpenSSL pour utiliser le code ASM : + <div class="example"><p><code> + Netware\build netware-libc nw-nasm enable-mdc2 enable-md5 + </code></p></div> + Attention : n'utilisez pas l'Assembleur CodeWarrior - il + produit un code de mauvaise qualit챕 !</li> + + <li>Avant de compiler Apache, d챕finissez la variable + d'environnement <code>OSSLSDK</code> avec le chemin absolu de + la racine du r챕pertoire du code source d'openssl, et + d챕finissez WITH_MOD_SSL 횪 1. + <div class="example"><p><code> + Set OSSLSDK=d:\openssl-0.9.8x<br /> + Set WITH_MOD_SSL=1 + </code></p></div></li> + + </ul> + + + + </div></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/netware.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/netware.html" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/netware.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/netware.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Autoris챕 sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/netware.html.ko.euc-kr b/docs/manual/platform/netware.html.ko.euc-kr new file mode 100644 index 0000000..bb78274 --- /dev/null +++ b/docs/manual/platform/netware.html.ko.euc-kr @@ -0,0 +1,609 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head> +<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Novell NetWare에서 아파치 사용하기 - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Novell NetWare에서 아파치 사용하기</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/platform/netware.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/netware.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/netware.html" title="Korean"> ko </a></p> +</div> +<div class="outofdate">이 문서는 최신판 번역이 아닙니다. + 최근에 변경된 내용은 영어 문서를 참고하세요.</div> + + + <p>이 문서는 Novell NetWare 6.0 이상에서 아파치 2.0을 설치, + 설정, 실행하는 방법을 설명한다. 버그를 찾았거나 다른 방법으로 + 돕고싶다면, <a href="http://httpd.apache.org/bug_report.html">버그 + 보고 페이지</a>를 이용하길 바란다.</p> + + <p>버그 보고 페이지나 dev-httpd 메일링리스트는 아파치 설정과 + 실행에 대한 질문을 답하지 <em>않는다</em>. 버그를 보고하기 + 전에 먼저 이 문서와 <a href="../faq/">자주 물어보는 질문 + (FAQ)</a> 페이지, 다른 관련문서를 살펴봐라. 그래도 궁금한 + 점이나 문제가 있다면, NetWare에서 아파치 사용에 대한 어렵고 + 새로운 질문을 답해줄 많은 아파치 사용자가 있는 <a href="news://developer-forums.novell.com/novell.devsup.webserver"> + novell.devsup.webserver</a> 뉴스그룹에 글을 올리길 바란다.</p> + + <p>이 문서는 바이너리 배포본으로 아파치를 설치했다고 가정한다. + (아마도 개발에 도움을 주거나 버그를 찾기위해) 직접 아파치를 + 컴파일하려면 아래 <a href="#comp">NetWare에서 아파치 + 컴파일하기</a> 절을 참고하라.</p> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#req">요구조건</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#down">NetWare용 아파치 다운받기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#inst">NetWare용 아파치 설치하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#run">NetWare용 아파치 실행하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#use">NetWare용 아파치 설정하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#comp">Netware용 아파치 컴파일하기</a></li> +</ul><h3>참고</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="req" id="req">요구조건</a></h2> + + + + <p>아파치 2.0은 NetWare 6.0 service pack 3 이상에서 동작하도록 + 설계되었다. SP3보다 낮은 service pack을 사용한다면 최신 + <a href="http://developer.novell.com/ndk/libc.htm">NetWare + Libraries for C (LibC)</a>를 설치해야 한다.</p> + + <p>NetWare service pack은 <a href="http://support.novell.com/misc/patlst.htm#nw">여기</a>에 + 있다.</p> + + <p>최신 service pack이나 최신 버전 <a href="http://developer.novell.com/ndk/libc.htm">NetWare + Libraries for C (LibC)</a>를 설치했다면 NetWare 5.1 환경에서도 + NetWare용 아파치 2.0을 실행할 수 있다. <strong>경고:</strong> + NetWare용 아파치 2.0은 이 환경을 고려하지 않았고 테스트하지 + 않았다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="down" id="down">NetWare용 아파치 다운받기</a></h2> + + + + <p>아파치 최신 버전에 대한 정보는 <a href="http://www.apache.org/">http://www.apache.org/</a>에서 + (아파치 웹서버) 찾을 수 있다. 여기에는 현재 버전과 최근 + 알파/베타테스트 버전, 미러 웹사이트와 ftp 사이트 정보가 + 있다. NetWare용 아파치 2.0의 최신 바이너리 배포본은 <a href="http://www.apache.org/dist/httpd/binaries/netware">여기</a>에서 + 다운받을 수 있다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="inst" id="inst">NetWare용 아파치 설치하기</a></h2> + + + + <p>현재 NetWare용 아파치 설치프로그램은 없다. NetWare용 + 아파치 2.0 소스를 직접 컴파일한다면 파일을 서버로 직접 + 복사해줘야 한다.</p> + + <p>바이너리로 다운받은 NetWare용 아파치를 설치하는 과정은 + 다음과 같다 (<code>sys:/apache2</code>에 설치한다고 가정한다):</p> + + <ul> + <li>바이너리로 다운받은 압축파일을 <code>SYS:</code> 볼륨 + 최상위 디렉토리에 푼다 (다른 볼륨에 설치해도 된다)</li> + + <li><code>httpd.conf</code> 파일을 수정하여 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>와 <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>과 파일경로 값을 서버에 + 알맞게 지정한다</li> + + <li>예를 들어 <div class="example"><p><code>SEARCH ADD SYS:\APACHE2</code></p></div>와 + 같이 검색경로에 <code>SYS:/APACHE2</code>를 추가한다 + </li> + + </ul> + + <p>직접 소스를 컴파일한 경우 NetWare에 아파치를 설치하는 + 방법은 다음과 같다 (<code>sys:/apache2</code>에 설치한다고 + 가정한다):</p> + + <ul> + <li>NetWare 볼륨에 <code>Apache2</code>라는 디렉토리를 + 만든다</li> + + <li><code>APACHE2.NLM</code>과 <code>APRLIB.NLM</code>을 + <code>SYS:/APACHE2</code>에 복사한다</li> + + <li><code>SYS:/APACHE2</code> 아래에 <code>BIN</code>이라는 + 디렉토리를 만든다</li> + + <li><code>HTDIGEST.NLM</code>, <code>HTPASSWD.NLM</code>, + <code>HTDBM.NLM</code>, <code>LOGRES.NLM</code>, + <code>ROTLOGS.NLM</code>을 <code>SYS:/APACHE2/BIN</code>에 + 복사한다</li> + + <li><code>SYS:/APACHE2</code> 아래에 <code>CONF</code>라는 + 디렉토리를 만든다</li> + + <li><code>HTTPD-STD.CONF</code> 파일을 + <code>SYS:/APACHE2/CONF</code>에 복사하고 파일명을 + <code>HTTPD.CONF</code>로 변경한다</li> + + <li><code>MIME.TYPES</code>, <code>CHARSET.CONV</code>, + <code>MAGIC</code> 파일을 <code>SYS:/APACHE2/CONF</code> + 디렉토리에 복사한다</li> + + <li><code>\HTTPD-2.0\DOCS\ICONS</code>에 있는 모든 파일과 + 하위디렉토리를 <code>SYS:/APACHE2/ICONS</code>로 복사한다</li> + + <li><code>\HTTPD-2.0\DOCS\MANUAL</code>에 있는 모든 파일과 + 하위디렉토리를 <code>SYS:/APACHE2/MANUAL</code>로 복사한다</li> + + <li><code>\HTTPD-2.0\DOCS\ERROR</code>에 있는 모든 파일과 + 하위디렉토리를 <code>SYS:/APACHE2/ERROR</code>로 복사한다</li> + + <li><code>\HTTPD-2.0\DOCS\DICROOT</code>에 있는 모든 파일과 + 하위디렉토리를 <code>SYS:/APACHE2/HTDOCS</code>로 복사한다</li> + + <li>서버에 <code>SYS:/APACHE2/LOGS</code> 디렉토리를 만든다</li> + + <li>서버에 <code>SYS:/APACHE2/APACHE2/CGI-BIN</code>이란 + 디렉토리를 만든다</li> + + <li><code>SYS:/APACHE2/MODULES</code> 디렉토리를 만들고 + 모든 nlm 모듈을 <code>modules</code> 디렉토리로 복사한다</li> + + <li><code>HTTPD.CONF</code> 파일의 모든 <code>@@Value@@</code> + 표시를 적절한 설정으로 대체한다</li> + + <li><div class="example"><p><code>SEARCH ADD SYS:\APACHE2</code></p></div> 같이 검색경로에 + <code>SYS:/APACHE2</code>를 추가한다 + </li> + </ul> + + <p>기본 <code>SYS</code> 볼륨이 아닌 다른 볼륨에도 아파치를 + 설치할 수 있다.</p> + + <p>makefile 명령어에 "install" 키워드를 사용하면 컴파일시 + 자동으로 <code>DIST</code> 하위디렉토리에 완전한 배포본을 + 만든다. makefile로 만든 배포본을 NetWare 볼륨 최상위 디렉토리로 + 복사하면 아파치가 설치된다 (아래 <a href="#comp">NetWare용 + 아파치 컴파일하기</a> 참고).</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="run" id="run">NetWare용 아파치 실행하기</a></h2> + + + + <p>아파치를 시작하려면 콘솔에서 <code>apache</code>를 입력하면 + 된다. 그러면 운영체제 주소영역에 아파치를 읽어들인다. + 보호주소영역에 아파치를 읽어들이려면 다음과 같이 load 명령어로 + 주소영역을 지정한다:</p> + + <div class="example"><p><code> + load address space = apache2 apache2 + </code></p></div> + + <p>그러면 아파치를 apache2라는 주소영역에 읽어들인다. + NetWare는 여러 아파치를 각각 다른 보호주소영역에 읽어들여서 + 여러 아파치를 동시에 실행할 수 있다.</p> + + <p>아파치가 시작하면 (설정파일에서 <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> 지시어를 수정하지 + 않는한) 포트 80번을 기다린다. 브라우저를 시작하여 서버명 + 혹은 서버 주소를 입력하면 서버에 접속하여 기본페이지에 + 접근한다. 아파치 설명서 링크가 있는 환영페이지가 나와야 + 한다. 아무 일도 없거나 오류가 발생하면 <code>logs</code> + 디렉토리에 있는 <code>error_log</code> 파일을 살펴봐라.</p> + + <p>기본 설치가 동작하면 <code>conf</code> 디렉토리에 있는 + 파일을 적절히 설정한다.</p> + + <p>운영체제 주소영역에서 실행중인 아파치를 내릴려면 콘솔에 + 다음과 같이 입력한다:</p> + + <div class="example"><p><code> + unload apache2 + </code></p></div> + + <p>혹은</p> + + <div class="example"><p><code> + apache2 shutdown + </code></p></div> + + <p>보호주소영역에서 아파치를 실행했다면 unload 명령어에 + 주소영역을 지정한다:</p> + + <div class="example"><p><code> + unload address space = apache2 apache2 + </code></p></div> + + <p>아파치가 설정파일 위치를 찾는 방법을 알아두어야 한다. + 명령행에서 설정파일을 지정하는 방법은 두가지다:</p> + + <ul> + <li><code>-f</code>는 특정 설정파일 경로를 지정한다</li> + </ul> + + <div class="example"><p><code> + apache2 -f "vol:/my server/conf/my.conf" + </code></p></div> + + <div class="example"><p><code> + apache -f test/test.conf + </code></p></div> + + <p>이 경우 설정파일은 올바른 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>를 설정해야 한다.</p> + + <p><code>-f</code>로 설정파일명을 지정하지 않으면, 아파치는 + 서버에 컴파일된 파일명을 (보통 <code>conf/httpd.conf</code>) + 사용한다. <code>-V</code> 옵션으로 아파치를 시작하면 + <code>SERVER_CONFIG_FILE</code>이라는 항목을 보여준다. + 아파치는 다음 순서대로 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>를 찾는다:</p> + + <ul> + <li><code>-C</code> 옵션의 <code>ServerRoot</code> 지시어.</li> + + <li>명령행의 <code>-d</code> 옵션.</li> + + <li>현재 디렉토리</li> + + <li>서버에 컴파일된 server root.</li> + </ul> + + <p>서버에 컴파일된 server root는 보통 + <code>sys:/apache2</code>이다. <code>-V</code> 옵션으로 + 아파치를 시작하면 <code>HTTPD_ROOT</code>라는 항목을 보여준다.</p> + + <p>NetWare용 아파치 2.0에는 실행중인 웹서버를 죽이거나 정보를 + 알려주는 명령행 지시어가 있다. 이들 지시어는 아파치 동작중에만 + 사용할 수 있다. 지시어 앞에는 <code>APACHE2</code> 키워드를 + 붙여야 한다.</p> + + <dl> + <dt>RESTART</dt> + <dd>모든 쓰레드가 쉬는 상태일때 아파치를 죽이고, 설정파일을 + 다시 읽은후 새로운 설정에 따라 worker 쓰레드들을 재시작한다.</dd> + + <dt>VERSION</dt> + <dd>현재 실행중인 아파치 버전 정보를 출력한다.</dd> + + <dt>MODULES</dt> + <dd>기본 모듈과 외부 모듈 목록을 출력한다.</dd> + + <dt>DIRECTIVES</dt> + <dd>모든 지시어 목록을 출력한다.</dd> + + <dt>SETTINGS</dt> + <dd>콘솔에 쓰레드 상태 표시를 보이거나 없앤다. 상태를 + 보이면, 아파치 콘솔창에 동작하는 쓰레드들의 상태가 나온다.</dd> + + <dt>SHUTDOWN</dt> + <dd>실행중인 아파치 웹서버를 죽인다.</dd> + + <dt>HELP</dt> + <dd>실행 옵션들을 설명한다.</dd> + </dl> + + <p>기본적으로 이 지시어들은 운영체제 주소영역에서 실행중인 + 아파치를 대상으로 한다. 아파치가 보호주소영역에서 실행중이라면, + -p와 주소영역 이름을 추가한다. 더 많은 정보를 보려면 명령행에 + "apache2 Help"를 입력한다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="use" id="use">NetWare용 아파치 설정하기</a></h2> + + + + <p>아파치는 보통 <code>conf</code> 디렉토리에 있는 설정파일로 + 설정한다. 이 파일은 유닉스용과 같지만, NetWare용 아파치에는 + 조금 다른 지시어들이 있다. 사용가능한 모든 지시어에 대해서는 + <a href="../">아파치 문서</a>를 참고하라.</p> + + <p>NetWare용 아파치의 주된 차이점은:</p> + + <ul> + <li> + <p>NetWare용 아파치는 다중쓰레드 방식을 사용하기때문에, + 유닉스와 같이 요청마다 다른 프로세스를 사용하지 않는다. + 대신 여러 쓰레드를 실행한다: 부모 쓰레드와 요청을 처리하는 + 여러 자식 혹은 worker 쓰레드들.</p> + + <p>그러므로 "프로세스"-관리 지시어가 다르다:</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></code> - + 유닉스와 같이 worker 쓰레드가 요청을 얼마만큼 처리하고 + 죽을지를 조정한다. 권장하는 기본값 + <code>MaxRequestsPerChild 0</code>을 사용하면 쓰레드는 + 죽지않고 영원히 요청을 서비스한다. 특별한 이유가 없다면 + NetWare에서는 이 지시어를 <code>0</code>으로 설정하길 + 권한다.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#startthreads">StartThreads</a></code> - + 이 지시어는 서버가 처음에 시작할 쓰레드 개수를 결정한다. + 권장하는 기본값은 <code>StartThreads 50</code>이다.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#minsparethreads">MinSpareThreads</a></code> - + 서버는 쉬는(idle) 쓰레드 개수가 이 값보다 적으면 worker + 쓰레드를 더 만든다. 권장하는 기본값은 + <code>MinSpareThreads 10</code>이다.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxsparethreads">MaxSpareThreads</a></code> - + 서버는 쉬는 쓰레드 개수가 이 값보다 많으면 worker 쓰레드를 + 죽이기 시작한다. 권장하는 기본값은 + <code>MaxSpareThreads 100</code>이다.</p> + + <p><code class="directive"><a href="../mod/mpm_netware.html#maxthreads">MaxThreads</a></code> - + 이 지시어는 worker 쓰레드의 최대 개수를 제한한다. 권장하는 + 기본값은 <code>ThreadsPerChild 250</code>이다.</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code> - + 한 worker 쓰레드가 사용할 스택 크기를 지시한다. 권장하는 + 기본값은 <code>ThreadStackSize 65536</code>이다.</p> + </li> + + <li> + <p>아규먼트로 파일명을 받는 지시어에는 유닉스 파일명이 + 아닌 NetWare 파일명을 사용해야 한다. 그러나 아파치가 + 내부적으로 유닉스식 파일명을 사용하기때문에 백슬래쉬 + 대신 슬래쉬를 사용해야 한다. 모든 절대경로에 볼륨명을 + 포함하길 바란다. 볼륨명을 생략하면 아파치는 + <code>SYS:</code> 볼륨이라고 잘못 가정할 수 있다.</p> + </li> + + <li> + <p>NetWare용 아파치는 서버를 다시 컴파일하지 않고 실행할때 + 모듈을 읽어들일 수 있다. 보통 아파치를 컴파일하면 + <code>\Apache2\modules</code> 디렉토리에 여러 추가 모듈을 + 설치한다. 이들 혹은 다른 모듈을 사용하려면 <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> 지시어를 사용한다. + 예를 들어 status 모듈을 사용한다면:</p> + + <div class="example"><p><code> + LoadModule status_module modules/status.nlm + </code></p></div> + + <p><a href="../mod/mod_so.html#creating">읽어들일 수 + 있는 모듈 만들기</a>에 대한 정보도 있다.</p> + </li> + </ul> + + <h3><a name="use-add" id="use-add">이외의 NetWare 전용 지시어들:</a></h3> + + + + <ul> + <li><code class="directive"><a href="../mod/core.html#cgimapextension">CGIMapExtension</a></code> - + CGI 파일 확장자를 스크립트 인터프리터와 연결한다.</li> + </ul> + <ul> + <li><code class="directive"><a href="../mod/mod_nw_ssl.html#securelisten">SecureListen</a></code> - + 특정 포트를 SSL 암호화한다.</li> + </ul> + <ul> + <li><code class="directive"><a href="../mod/mod_nw_ssl.html#nwssltrustedcerts">NWSSLTrustedCerts</a></code> - + 프록시하는 서버에 보안연결할때 사용할 신뢰하는 + 인증서(certificate)를 추가한다.</li> + </ul> + <ul> + <li><code class="directive"><a href="../mod/mod_nw_ssl.html#nwsslupgradeable">NWSSLUpgradeable</a></code> - + 특정 주소/포트로 맺어진 연결을 SSL 연결로 변경할 수 + 있다.</li> + </ul> + + + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="comp" id="comp">Netware용 아파치 컴파일하기</a></h2> + + + + <p>아파치를 컴파일하려면 MetroWerks CodeWarrior 6.x 이상이 + 필요하다. 아파치를 컴파일하면 어떤 Netware 볼륨에라도 설치할 + 수 있다. 기본값은 <code>sys:/Apache2</code> 디렉토리다.</p> + + <p>서버를 실행하기 전에 <code>conf</code> 디렉토리를 작성해야 + 한다. 배포본의 <code>conf</code> 디렉토리에 있는 + <code>HTTPD-STD.CONF</code> 파일명을 <code>HTTPD.CONF</code>로 + 변경한다. <code>HTTPD.CONF</code> 파일에서 <code>@@Value@@</code> + 표시를 찾아서 적절한 설정으로 대체한다. <code>conf/magic</code>과 + <code>conf/mime.types</code> 파일도 복사한다. 아니면 makefile을 + 실행할때 <code>install</code> 키워드를 사용하면 완전한 배포본을 + 만든다.</p> + + <h3><a name="comp-req" id="comp-req">요구사항:</a></h3> + + + + <p>NetWare용 아파치 2.0을 컴파일하려면 다음 개발도구가 + 필요하다:</p> + + <ul> + <li>Metrowerks CodeWarrior 6.0 이상과 <a href="http://developer.novell.com/ndk/cwpdk.htm">NetWare + PDK 3.0</a> 이상.</li> + + <li><a href="http://developer.novell.com/ndk/libc.htm">NetWare + Libraries for C (LibC)</a></li> + + <li><a href="http://developer.novell.com/ndk/cldap.htm">LDAP + Libraries for C</a></li> + + <li><a href="http://www.gzip.org/zlib/">ZLIB 압축 라이브러리 + 소스코드</a></li> + + <li>AWK 도구 (awk, gawk 등). AWK는 <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>에서 + 다운받을 수 있다. 도구를 <code>awk.exe</code>란 이름으로 + 윈도우즈 경로에 두어야 한다.</li> + + <li>makefile을 사용하여 컴파일하려면 <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>에 + 있는 GNU make 버전 3.78.1 (GMake)이 필요하다.</li> + </ul> + + + + <h3><a name="comp-make" id="comp-make">NetWare makefile을 사용하여 아파치 컴파일하기:</a></h3> + + + + <ul> + <li><code>NOVELLLIBC</code> 환경변수를 + <div class="example"><p><code>Set NOVELLLIBC=c:\novell\ndk\libc</code></p></div>와 + 같이 NetWare Libraries for C SDK 위치로 설정한다. + </li> + + <li><code>METROWERKS</code> 환경변수를 + <div class="example"><p><code>Set METROWERKS=C:\Program Files\Metrowerks\CodeWarrior</code></p></div>와 + 같이 Metrowerks CodeWarrior 컴파일러를 설치한 위치로 + 설정한다. 기본 위치인 + <code>C:\Program Files\Metrowerks\CodeWarrior</code>에 + 설치하였다면, 환경변수를 설정할 필요는 없다.</li> + + <li><code>LDAPSDK</code> 환경변수를 + <div class="example"><p><code>Set LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc</code></p></div>와 + 같이 LDAP Libraries for C를 설치한 위치로 설정한다. + </li> + + <li><code>ZLIBSDK</code> 환경변수를 + <div class="example"><p><code>Set ZLIBSDK=D:\NOVELL\zlib</code></p></div>과 같이 + ZLib 라이브러리 소스코드 위치로 설정한다. + </li> + + <li><code>AP_WORK</code> 환경변수를 <code>\httpd-2.0</code> + 디렉토리의 전체 경로로 설정한다.</li> + + <li><code>APR_WORK</code> 환경변수를 + <code>\httpd-2.0\srclib\apr</code> 디렉토리의 전체 경로로 + 설정한다.</li> + + <li>AWK 도구와 GNU make (<code>gmake.exe</code>) 도구가 + 시스템의 <code>PATH</code> 환경변수에 포함되있는지 + 확인한다.</li> + + <li>소스코드를 다운받아 적당한 디렉토리에 압축을 푼다.</li> + + <li><code>\httpd-2.0\srclib\apr-util\uri</code> 디렉토리에서 + "<code>gmake -f nwgnumakefile</code>"을 실행하여 + <code>GENURI.nlm</code>을 컴파일한다.</li> + + <li><code>GENURI.nlm</code> 파일을 NetWare 서버의 + <code>SYS:</code> 볼륨으로 복사하고 + <div class="example"><p><code>SYS:\genuri > sys:\uri_delims.h</code></p></div> + 명령을 실행한다. + </li> + + <li><code>uri_delims.h</code> 파일을 컴파일하는 컴퓨터의 + <code>\httpd-2.0\srclib\apr-util\uri</code> 디렉토리로 + 복사한다.</li> + + <li><code>\httpd-2.0\srclib\apr</code> 디렉토리에서 + "<code>gmake -f nwgnumakefile</code>"을 실행하여 APR을 + 컴파일한다.</li> + + <li><code>\httpd-2.0\srclib\pcre</code> 디렉토리에서 + "<code>gmake -f nwgnumakefile</code>"을 실행하여 + <code>DFTABLES.nlm</code>을 컴파일한다.</li> + + <li><code>\httpd-2.0\server</code> 디렉토리에서 + "<code>gmake -f nwgnumakefile</code>"을 실행하여 + <code>GENCHARS.nlm</code>을 컴파일한다.</li> + + <li>각 디렉토리의 <code>GENCHARS.nlm</code>과 + <code>DFTABLES.nlm</code> 파일을 NetWare 서버의 + <code>SYS:</code> 볼륨으로 복사하고 다음과 같이 실행한다: + <div class="example"><p><code> + SYS:\genchars > sys:\test_char.h<br /> + SYS:\dftables > sys:\chartables.c<br /> + </code></p></div> + </li> + + <li><code>test_char.h</code>와 <code>chartables.c</code> + 파일을 컴파일하는 컴퓨터의 <code>\httpd-2.0\os\netware</code> + 디렉토리로 복사한다.</li> + + <li><code>\httpd-2.0</code> 디렉토리에서 + "<code>gmake -f nwgnumakefile</code>"을 실행하여 아파치를 + 컴파일한다. + <div class="example"><p><code>gmake -f nwgnumakefile install</code></p></div>과 + 같이 install 파라미터를 추가하면 배포용 디렉토리를 만들 + 수 있다. + </li> + </ul> + + + + <h3><a name="comp-add" id="comp-add">추가 make 옵션</a></h3> + + + + <ul> + <li><code>gmake -f nwgnumakefile</code><p>일반 실행파일을 + 컴파일하여 <code>\release</code> 디렉토리로 복사한다.</p></li> + + <li><code>gmake -f nwgnumakefile DEBUG=1</code><p>디버그용 + 실행파일을 컴파일하여 <code>\debug</code> 디렉토리로 + 복사한다.</p></li> + + <li><code>gmake -f nwgnumakefile install</code> + <p><code>\dist\Apache2</code> 디렉토리에 실행파일, 문서, + 추가 지원파일을 포함한 완전한 아파치 배포본을 만든다.</p></li> + + <li><code>gmake -f nwgnumakefile installdev</code> + <p>install과 비슷하지만, <code>\lib</code>과 + <code>\include</code> 디렉토리를 만들고 헤더파일과 import + 파일을 복사한다.</p></li> + + <li><code>gmake -f nwgnumakefile clean</code> + <p><code>DEBUG</code> 정의 유무에 따라 <code>\release</code>나 + <code>\debug</code>에 있는 오브젝트파일과 실행파일을 + 모두 지운다.</p></li> + + <li><code>gmake -f nwgnumakefile clobber_all</code><p>clean과 + 비슷하지만 디렉토리도 지운다.</p></li> + </ul> + + + + </div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/platform/netware.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/netware.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/netware.html" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/netware.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/perf-hp.html b/docs/manual/platform/perf-hp.html new file mode 100644 index 0000000..7e93b4a --- /dev/null +++ b/docs/manual/platform/perf-hp.html @@ -0,0 +1,13 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: perf-hp.html.en +Content-Language: en +Content-type: text/html; charset=UTF-8 + +URI: perf-hp.html.fr.utf8 +Content-Language: fr +Content-type: text/html; charset=UTF-8 + +URI: perf-hp.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/platform/perf-hp.html.en b/docs/manual/platform/perf-hp.html.en new file mode 100644 index 0000000..7e2f8d3 --- /dev/null +++ b/docs/manual/platform/perf-hp.html.en @@ -0,0 +1,131 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Running a High-Performance Web Server on HPUX - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page" class="no-sidebar"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Running a High-Performance Web Server on HPUX</h1> +<div class="toplang"> +<p><span>Available Languages: </span><a href="../en/platform/perf-hp.html" title="English"> en </a> | +<a href="../fr/platform/perf-hp.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/perf-hp.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + +<pre>Date: Wed, 05 Nov 1997 16:59:34 -0800 +From: Rick Jones <<a href="mailto:raj@cup.hp.com">raj@cup.hp.com</a>> +Reply-To: <a href="mailto:raj@cup.hp.com">raj@cup.hp.com</a> +Organization: Network Performance +Subject: HP-UX tuning tips</pre> + + <p>Here are some tuning tips for HP-UX to add to the tuning page.</p> + + <p>For HP-UX 9.X: Upgrade to 10.20<br /> + For HP-UX 10.[00|01|10]: Upgrade to 10.20</p> + + <p>For HP-UX 10.20:</p> + + <p>Install the latest cumulative ARPA Transport Patch. This + will allow you to configure the size of the TCP connection + lookup hash table. The default is 256 buckets and must be set + to a power of two. This is accomplished with adb against the + *disc* image of the kernel. The variable name is <code>tcp_hash_size</code>. + Notice that it's critically important that you use "<code>W</code>" + to write a 32 bit quantity, not "<code>w</code>" to write a 16 bit + value when patching the disc image because the <code>tcp_hash_size</code> + variable is a 32 bit quantity.</p> + + <p>How to pick the value? Examine the output of <a href="ftp://ftp.cup.hp.com/dist/networking/tools/connhist">ftp://ftp.cup.hp.com/dist/networking/tools/connhist</a> + and see how many total TCP connections exist on the system. You + probably want that number divided by the hash table size to be + reasonably small, say less than 10. Folks can look at HP's + SPECweb96 disclosures for some common settings. These can be + found at <a href="http://www.specbench.org/">http://www.specbench.org/</a>. + If an HP-UX system was performing at 1000 SPECweb96 connections + per second, the <code>TIME_WAIT</code> time of 60 seconds would mean + 60,000 TCP "connections" being tracked.</p> + + <p>Folks can check their listen queue depths with <a href="ftp://ftp.cup.hp.com/dist/networking/misc/listenq">ftp://ftp.cup.hp.com/dist/networking/misc/listenq</a>.</p> + + <p>If folks are running Apache on a PA-8000 based system, they + should consider "chatr'ing" the Apache executable to have a + large page size. This would be "<code>chatr +pi L <BINARY></code>". + The GID of the running executable must have <code>MLOCK</code> privileges. + <code>Setprivgrp(1m)</code> should be consulted for assigning + <code>MLOCK</code>. The change can be validated by running Glance + and examining the memory regions of the server(s) to make sure that + they show a non-trivial fraction of the text segment being locked.</p> + + <p>If folks are running Apache on MP systems, they might + consider writing a small program that uses <code>mpctl()</code> + to bind processes to processors. A simple <code>pid % numcpu</code> + algorithm is probably sufficient. This might even go into the + source code.</p> + + <p>If folks are concerned about the number of <code>FIN_WAIT_2</code> + connections, they can use nettune to shrink the value of + <code>tcp_keepstart</code>. However, they should be careful there - + certainly do not make it less than oh two to four minutes. If + <code>tcp_hash_size</code> has been set well, it is probably OK to + let the <code>FIN_WAIT_2</code>'s take longer to timeout (perhaps + even the default two hours) - they will not on average have a big + impact on performance.</p> + + <p>There are other things that could go into the code base, but + that might be left for another email. Feel free to drop me a + message if you or others are interested.</p> + + <p>sincerely,</p> + + <p>rick jones</p> + + <p><a href="http://www.netperf.org/netperf/">http://www.netperf.org/netperf/</a></p> + + </div> +</div> +<div class="bottomlang"> +<p><span>Available Languages: </span><a href="../en/platform/perf-hp.html" title="English"> en </a> | +<a href="../fr/platform/perf-hp.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/perf-hp.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/perf-hp.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/perf-hp.html.fr.utf8 b/docs/manual/platform/perf-hp.html.fr.utf8 new file mode 100644 index 0000000..088a0f3 --- /dev/null +++ b/docs/manual/platform/perf-hp.html.fr.utf8 @@ -0,0 +1,143 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Mise en oeuvre d'un serveur Web hautes performances sous + HPUX - Serveur HTTP Apache Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page" class="no-sidebar"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur HTTP Apache Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Notes sp챕cifiques aux + plates-formes</a></div><div id="page-content"><div id="preamble"><h1>Mise en oeuvre d'un serveur Web hautes performances sous + HPUX</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/perf-hp.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/perf-hp.html" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/perf-hp.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + +<pre>Date: Wed, 05 Nov 1997 16:59:34 -0800 +From: Rick Jones <<a href="mailto:raj@cup.hp.com">raj@cup.hp.com</a>> +Reply-To: <a href="mailto:raj@cup.hp.com">raj@cup.hp.com</a> +Organization: Network Performance +Subject: HP-UX tuning tips</pre> + + <p>Traduction du corps du message cit챕 ci-dessus :</p> + + <p>Voici quelques conseils de personnalisation pour HPUX 횪 ajouter 횪 + la page de personnalisation.</p> + + <p>Pour HP-UX 9.X: mettre 횪 jour vers la version 10.20<br /> + Pour HP-UX 10.[00|01|10]: mettre 횪 jour vers la version 10.20</p> + + <p>Pour HP-UX 10.20:</p> + + <p>Installez le dernier patch cumulatif 횪 propos du transport ARPA. + Ceci va vous permettre de configurer la taille de la table de + hashage de recherche de connexion TCP. La valeur par d챕faut est 256 + conteneurs et doit 챗tre une puissance de deux. �� cet effet, utilisez + adb pour modifier l'image *disque* du noyau. Le nom de la variable + est <code>tcp_hash_size</code>. Notez qu'il est imp챕ratif d'utiliser + "<code>W</code>" pour sp챕cifier une quantit챕 sur 32 bits, et non + "<code>w</code>" qui indique une valeur sur 16 bits, lors de la + modification de l'image disque car la variable + <code>tcp_hash_size</code> est une quantit챕 sur 32 bits.</p> + + <p>Comment d챕terminer cette valeur ? Examinez la sortie de <a href="ftp://ftp.cup.hp.com/dist/networking/tools/connhist">ftp://ftp.cup.hp.com/dist/networking/tools/connhist</a>, et + comptez le nombre total de connexions TCP existant sur le syst챔me. + Il est en g챕n챕ral souhaitable que ce nombre divis챕 par la taille de + la table de hashage soit raisonnablement petit, disons inf챕rieur 횪 + 10. Les administrateurs peuvent consulter le document SPECweb96 de + HP pour quelques r챕glages courants. On peut les trouver 횪 <a href="http://www.specbench.org/">http://www.specbench.org/</a>. Si + un syst챔me HP-UX traite 1000 connexions SPECweb96 par seconde, une + valeur de temps <code>TIME_WAIT</code> de 60 secondes permettrait le + suivi de 60000 connexions TCP.</p> + + <p>Les administrateurs peuvent tester la profondeur de leur file + d'attente d'챕coute avec <a href="ftp://ftp.cup.hp.com/dist/networking/misc/listenq">ftp://ftp.cup.hp.com/dist/networking/misc/listenq</a>.</p> + + <p>Si Apache s'ex챕cute sur un syst챔me 횪 base de PA-8000, il est + conseill챕 de modifier l'ex챕cutable Apache avec la commande chatr + afin d'utiliser une page de grande taille. La commande sera du style + "<code>chatr +pi L <BINARY></code>". Le GID de l'ex챕cutable en + cours de fonctionnement doit poss챕der le privil챔ge + <code>MLOCK</code>. Pour assigner ce privil챔ge <code>MLOCK</code>, + consultez <code>Setprivgrp(1m)</code>. La modification peut 챗tre + valid챕e en ex챕cutant Glance et en examinant les portions de m챕moire + du/des serveur(s) afin de s'assurer qu'elles montrent une fraction + non triviale du segment de texte verrouill챕.</p> + + <p>Si Apache s'ex챕cute sur un syst챔me MP (multi-processeurs), il est + conseill챕 d'챕crire un petit programme qui utilise + <code>mpctl()</code> et permettant d'associer les processus aux + processeurs. Un simple algorithme <code>pid % numcpu</code> suffira + probablement. Cette modification peut aussi 챗tre ajout챕e dans le + code source.</p> + + <p>Si l'administrateur s'int챕resse au nombre de connexions + <code>FIN_WAIT_2</code>, il peut utiliser nettune pour diminuer la + valeur de <code>tcp_keepstart</code>. Il devra cependant 챗tre + prudent - surtout ne pas diminuer cette valeur en dessous de, disons + deux 횪 quatre minutes. Si <code>tcp_hash_size</code> a 챕t챕 d챕fini, + il est probablement appropri챕 de laisser les connexions + <code>FIN_WAIT_2</code> prendre plus de temps 횪 expirer (peut-챗tre + m챗me la valeur par d챕faut de deux heures) - elles n'auront en + g챕n챕ral pas un grand impact sur les performances.</p> + + <p>On peut ajouter d'autres choses au code de base, mais elles + feront peut-챗tre l'objet d'un autre email. N'h챕sitez pas 횪 m'envoyer + un message si vous 챗tes int챕ress챕.</p> + + <p>sinc챔rement ,</p> + + <p>rick jones</p> + + <p><a href="http://www.netperf.org/netperf/">http://www.netperf.org/netperf/</a></p> + + </div> +</div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/perf-hp.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/perf-hp.html" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/perf-hp.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/perf-hp.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Autoris챕 sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/perf-hp.html.ko.euc-kr b/docs/manual/platform/perf-hp.html.ko.euc-kr new file mode 100644 index 0000000..3fb2b10 --- /dev/null +++ b/docs/manual/platform/perf-hp.html.ko.euc-kr @@ -0,0 +1,128 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head> +<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>HPUX에서 고성능 웹서버 실행하기 - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page" class="no-sidebar"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>HPUX에서 고성능 웹서버 실행하기</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/platform/perf-hp.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/perf-hp.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/perf-hp.html" title="Korean"> ko </a></p> +</div> +<div class="outofdate">이 문서는 최신판 번역이 아닙니다. + 최근에 변경된 내용은 영어 문서를 참고하세요.</div> + + +<pre>Date: Wed, 05 Nov 1997 16:59:34 -0800 +From: Rick Jones <<a href="mailto:raj@cup.hp.com">raj@cup.hp.com</a>> +Reply-To: <a href="mailto:raj@cup.hp.com">raj@cup.hp.com</a> +Organization: Network Performance +Subject: HP-UX tuning tips</pre> + + <p>이 글은 성능향상 페이지에 추가할 HP-UX 성능향상 팁이다.</p> + + <p>HP-UX 9.X는: 10.20으로 업그레이드하라<br /> + HP-UX 10.[00|01|10]은: 10.20으로 업그레이드하라</p> + + <p>HP-UX 10.20은:</p> + + <p>최근 ARPA Transport 패치 모음을 설치한다. 그러면 TCP + 연결찾기 해쉬테이블 크기를 설정할 수 있다. 기본값은 + 256 개이고, 2의 거듭제곱값으로 지정해야 한다. adb로 커널의 + *disc* 이미지를 수정하여 설정한다. 변수명은 + <code>tcp_hash_size</code>이다. <code>tcp_hash_size</code> + 변수값이 32비트이므로 disc 이미지를 수정할때 반드시 16비트 + 값을 기록하는 "<code>w</code>" 대신 32비트 값을 기록하는 + "<code>W</code>"를 사용해야 한다.</p> + + <p>어떤 값을 고를까? <a href="ftp://ftp.cup.hp.com/dist/networking/tools/connhist">ftp://ftp.cup.hp.com/dist/networking/tools/connhist</a>의 + 결과를 보고, 시스템에 존재하는 TCP 연결 총개수를 살펴봐라. + 이 숫자를 해쉬테이블 크기로 나눈 값이 상당히 (10 이하) 작으면 + 좋다. HP의 SPECweb96 결과에서 일반적인 설정을 볼 수 있다. + 결과는 <a href="http://www.specbench.org/">http://www.specbench.org/</a>에 + 있다. HP-UX 시스템이 초당 1000번 SPECweb96 연결을 하는 경우 + <code>TIME_WAIT</code>가 60초라면 60,000개의 TCP "연결"을 + 추적한다는 뜻이다.</p> + + <p><a href="ftp://ftp.cup.hp.com/dist/networking/misc/listenq">ftp://ftp.cup.hp.com/dist/networking/misc/listenq</a>를 + 실행하여 시스템의 연결대기행렬 깊이를 알 수 있다.</p> + + <p>PA-8000기반 시스템에서 아파치를 실행한다면, 아파치 + 실행파일이 큰 페이지크기를 사용하도록 "chatr"한다. 명령은 + "<code>chatr +pi L <실행파일></code>"이다. 실행파일을 + 실행하는 GID에 <code>MLOCK</code> 권한이 반드시 필요하다. + <code>MLOCK</code> 부여에 대해서는 <code>Setprivgrp(1m)</code>를 + 참고하라. 수정후 Glance를 실행하여 서버의 메모리영역을 살펴보면 + 상당한 text 세그먼트가 잠겨있음을 확인할 수 있다.</p> + + <p>다중프로세스 시스템에서 아파치를 실행한다면, 프로세스를 + 프로세스에 배정하는 <code>mpctl()</code>를 사용한 작은 + 프로그램을 작성해봐라. 단순한 <code>pid % numcpu</code> + 알고리즘으로도 충분할 것이다. 이 부분은 앞으로 소스코드에 + 포함될 수 있다.</p> + + <p><code>FIN_WAIT_2</code> 연결의 개수가 걱정스럽다면, + nettune을 사용하여 <code>tcp_keepstart</code> 값을 줄일 + 수 있다. 그러나 조심해야 한다 - 4분 보다 작게 설정하지 마라. + <code>tcp_hash_size</code>를 잘 설정하였다면, + <code>FIN_WAIT_2</code> 값이 커도 (심지어 기본값인 2시간도) + 문제없다 - 보통 성능에 큰 영향을 주지 않는다.</p> + + <p>앞으로 소스코드에 포함될 부분이 더 있지만, 여기서 줄인다. + 관심이 있다면 메일을 주길 바란다.</p> + + <p>그럼 이만,</p> + + <p>rick jones</p> + + <p><a href="http://www.cup.hp.com/netperf/NetperfPage.html">http://www.cup.hp.com/netperf/NetperfPage.html</a></p> + + </div> +</div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/platform/perf-hp.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/perf-hp.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/perf-hp.html" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/perf-hp.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/rpm.html b/docs/manual/platform/rpm.html new file mode 100644 index 0000000..40ebbc1 --- /dev/null +++ b/docs/manual/platform/rpm.html @@ -0,0 +1,9 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: rpm.html.en +Content-Language: en +Content-type: text/html; charset=UTF-8 + +URI: rpm.html.fr.utf8 +Content-Language: fr +Content-type: text/html; charset=UTF-8 diff --git a/docs/manual/platform/rpm.html.en b/docs/manual/platform/rpm.html.en new file mode 100644 index 0000000..eb752b9 --- /dev/null +++ b/docs/manual/platform/rpm.html.en @@ -0,0 +1,248 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Using Apache With RPM Based Systems (Redhat / CentOS / Fedora) - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Using Apache With RPM Based Systems (Redhat / CentOS / Fedora)</h1> +<div class="toplang"> +<p><span>Available Languages: </span><a href="../en/platform/rpm.html" title="English"> en </a> | +<a href="../fr/platform/rpm.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a></p> +</div> + + + <p>While many distributions make Apache httpd available as operating system + supported packages, it can sometimes be desirable to install and use the + canonical version of Apache httpd on these systems, replacing the natively + provided versions of the packages.</p> + + <p>While the Apache httpd project does not currently create binary RPMs + for the various distributions out there, it is easy to build your own + binary RPMs from the canonical Apache httpd tarball.</p> + + <p>This document explains how to build, install, configure and run + Apache httpd 2.4 under Unix systems supporting the RPM packaging format.</p> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#creating">Creating a Source RPM</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#building">Building RPMs</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#installing">Installing the Server</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#default">Configuring the Default Instance of Apache httpd</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#additional">Configuring Additional Instances of Apache httpd on the Same Machine</a></li> +</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="creating" id="creating">Creating a Source RPM</a></h2> + + + <p>The Apache httpd source tarball can be converted into an SRPM as + follows:</p> + + <div class="example"><p><code> + rpmbuild -ts httpd-2.4.x.tar.bz2 + </code></p></div> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="building" id="building">Building RPMs</a></h2> + + + <p>RPMs can be built directly from the Apache httpd source tarballs using + the following command:</p> + + <div class="example"><p><code> + rpmbuild -tb httpd-2.4.x.tar.bz2 + </code></p></div> + + <p>Corresponding "-devel" packages will be required to be installed on your + build system prior to building the RPMs, the <code>rpmbuild</code> command + will automatically calculate what RPMs are required and will list any + dependencies that are missing on your system. These "-devel" packages will + not be required after the build is completed, and can be safely removed.</p> + + <p>If successful, the following RPMs will be created:</p> + + <dl> + <dt>httpd-2.4.x-1.i686.rpm</dt> + <dd>The core server and basic module set.</dd> + + <dt>httpd-debuginfo-2.4.x-1.i686.rpm</dt> + <dd>Debugging symbols for the server and all modules.</dd> + + <dt>httpd-devel-2.4.x-1.i686.rpm</dt> + <dd>Headers and development files for the server.</dd> + + <dt>httpd-manual-2.4.x-1.i686.rpm</dt> + <dd>The webserver manual.</dd> + + <dt>httpd-tools-2.4.x-1.i686.rpm</dt> + <dd>Supporting tools for the webserver.</dd> + + <dt>mod_authnz_ldap-2.4.x-1.i686.rpm</dt> + <dd><code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> and <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>, with + corresponding dependency on openldap.</dd> + + <dt>mod_lua-2.4.x-1.i686.rpm</dt> + <dd><code class="module"><a href="../mod/mod_lua.html">mod_lua</a></code> module, with + corresponding dependency on lua.</dd> + + <dt>mod_proxy_html-2.4.x-1.i686.rpm</dt> + <dd><code class="module"><a href="../mod/mod_proxy_html.html">mod_proxy_html</a></code> module, with + corresponding dependency on libxml2.</dd> + + <dt>mod_socache_dc-2.4.x-1.i686.rpm</dt> + <dd><code class="module"><a href="../mod/mod_socache_dc.html">mod_socache_dc</a></code> module, with + corresponding dependency on distcache.</dd> + + <dt>mod_ssl-2.4.x-1.i686.rpm</dt> + <dd><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> module, with + corresponding dependency on openssl.</dd> + + </dl> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="installing" id="installing">Installing the Server</a></h2> + + + <p>The <code>httpd</code> RPM is the only RPM necessary to get a basic + server to run. Install it as follows:</p> + + <div class="example"><p><code> + rpm -U httpd-2.4.x-1.i686.rpm + </code></p></div> + + <p>Self contained modules are included with the server. Modules that + depend on external libraries are provided as separate RPMs to install + if needed.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="default" id="default">Configuring the Default Instance of Apache httpd</a></h2> + + + <p>The default configuration for the server is installed by default + beneath the <code>/etc/httpd</code> directory, with logs written by + default to <code>/var/log/httpd</code>. The environment for the + webserver is set by default within the optional + <code>/etc/sysconfig/httpd</code> file.</p> + + <p>Start the server as follows:</p> + + <div class="example"><p><code> + service httpd restart + </code></p></div> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="additional" id="additional">Configuring Additional Instances of Apache httpd on the Same Machine</a></h2> + + + <p>It is possible to configure additional instances of the Apache + httpd server running independently alongside each other on the same + machine. These instances can have independent configurations, and + can potentially run as separate users if so configured.</p> + + <p>This was done by making the httpd startup script aware of its own + name. This name is then used to find the environment file for the + server, and in turn, the server root of the server instance.</p> + + <p>To create an additional instance called + <code>httpd-additional</code>, follow these steps:</p> + + <ul> + <li>Create a symbolic link to the startup script for the additional + server: + + <div class="example"><p><code> + ln -s /etc/rc.d/init.d/httpd /etc/rc.d/init.d/httpd-additional<br /> + chkconfig --add httpd-additional + </code></p></div> + + </li> + + <li>Create an environment file for the server, using the + <code>/etc/sysconfig/httpd</code> file as a template: + + <div class="example"><p><code> + # template from httpd<br /> + cp /etc/sysconfig/httpd /etc/sysconfig/httpd-additional + </code></p></div> + + <div class="example"><p><code> + # blank template<br /> + touch /etc/sysconfig/httpd-additional + </code></p></div> + + Edit <code>/etc/sysconfig/httpd-additional</code> and pass the + server root of the new server instance within the + <code>OPTIONS</code> environment variable. + + <div class="example"><p><code> + OPTIONS="-d /etc/httpd-additional -f conf/httpd-additional.conf" + </code></p></div> + + </li> + + <li>Edit the server configuration file + <code>/etc/httpd-additional/conf/httpd-additional.conf</code> to + ensure the correct ports and paths are configured. + </li> + + <li>Start the server as follows: + + <div class="example"><p><code> + service httpd-additional restart + </code></p></div> + + </li> + + <li>Repeat this process as required for each server instance.</li> + </ul> + + </div></div> +<div class="bottomlang"> +<p><span>Available Languages: </span><a href="../en/platform/rpm.html" title="English"> en </a> | +<a href="../fr/platform/rpm.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/rpm.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/rpm.html.fr.utf8 b/docs/manual/platform/rpm.html.fr.utf8 new file mode 100644 index 0000000..c0a8446 --- /dev/null +++ b/docs/manual/platform/rpm.html.fr.utf8 @@ -0,0 +1,264 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Utiliser Apache sur les syst챔mes 횪 base de paquets RPM (Redhat + / CentOS / Fedora) - Serveur HTTP Apache Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur HTTP Apache Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Notes sp챕cifiques aux diff챕rentes + plateformes</a></div><div id="page-content"><div id="preamble"><h1>Utiliser Apache sur les syst챔mes 횪 base de paquets RPM (Redhat + / CentOS / Fedora)</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/rpm.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/rpm.html" title="Fran챌ais"> fr </a></p> +</div> + + + <p>Alors que de nombreuses distributions mettent 횪 disposition des + paquets Apache httpd support챕s par le syst챔me d'exploitation + sous-jacent, il peut s'av챕rer n챕cessaire d'installer et d'utiliser + la version de base d'Apache httpd en remplacement de la version des + paquets.</p> + + <p>Bien que le projet Apache httpd ne cr챕e pas actuellement de + paquets RPM pour les diff챕rentes distributions, il est ais챕 de + construire votre propre paquet RPM 횪 partir du tarball de base + d'Apache httpd.</p> + + <p>Ce document explique comment construire, installer, configurer et + ex챕cuter Apache httpd 2.4 sur les syst챔mes Unix 횪 base de paquets + RPM.</p> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#creating">Cr챕ation d'un paquet RPM source</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#building">Cr챕ation d'un paquet RPM</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#installing">Installation du serveur</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#default">Configuration de l'instance par d챕faut d'Apache httpd</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#additional">Configuration d'instances d'Apache httpd suppl챕mentaires sur + la m챗me machine</a></li> +</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="creating" id="creating">Cr챕ation d'un paquet RPM source</a></h2> + + + <p>Le tarball d'Apache httpd peut 챗tre converti en paquet SRPM de la + mani챔re suivante :</p> + + <div class="example"><p><code> + rpmbuild -ts httpd-2.4.x.tar.bz2 + </code></p></div> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="building" id="building">Cr챕ation d'un paquet RPM</a></h2> + + + <p>Le tarball d'Apache httpd peut 챗tre converti en paquet RPM de la + mani챔re suivante :</p> + + <div class="example"><p><code> + rpmbuild -tb httpd-2.4.x.tar.bz2 + </code></p></div> + + <p>Il sera n챕cessaire d'installer les paquets "-devel" + correspondants avant de construire les RPMs ; 횪 cet effet, la + commande <code>rpmbuild</code> d챕tecte automatiquement les RPMs + requis et en donne la liste sous forme de d챕pendances manquantes sur + votre syst챔me. Ces paquets "-devel" ne seront d'ailleurs plus + n챕cessaires une fois la cr챕ation des RPMs termin챕e, et pourront + alors 챗tre supprim챕s sans risque.</p> + + <p>Si tout va bien, les RPMs suivants seront cr챕챕s :</p> + + <dl> + <dt>httpd-2.4.x-1.i686.rpm</dt> + <dd>Le serveur de base et le jeu de modules standards.</dd> + + <dt>httpd-debuginfo-2.4.x-1.i686.rpm</dt> + <dd>Les symboles de d챕bogage pour le serveur et tous les modules.</dd> + + <dt>httpd-devel-2.4.x-1.i686.rpm</dt> + <dd>Les en-t챗tes et fichiers de d챕veloppement pour le serveur.</dd> + + <dt>httpd-manual-2.4.x-1.i686.rpm</dt> + <dd>Le manuel du serveur web.</dd> + + <dt>httpd-tools-2.4.x-1.i686.rpm</dt> + <dd>Les utilitaires du serveur web.</dd> + + <dt>mod_authnz_ldap-2.4.x-1.i686.rpm</dt> + <dd>Les modules <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code> et + <code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code> avec les d챕pendances + correspondantes sur openldap.</dd> + + <dt>mod_lua-2.4.x-1.i686.rpm</dt> + <dd>Le module <code class="module"><a href="../mod/mod_lua.html">mod_lua</a></code> avec les d챕pendances + correspondantes sur lua.</dd> + + <dt>mod_proxy_html-2.4.x-1.i686.rpm</dt> + <dd>Le module <code class="module"><a href="../mod/mod_proxy_html.html">mod_proxy_html</a></code> avec les + d챕pendances correspondantes sur libxml2.</dd> + + <dt>mod_socache_dc-2.4.x-1.i686.rpm</dt> + <dd>Le module <code class="module"><a href="../mod/mod_socache_dc.html">mod_socache_dc</a></code> avec les + d챕pendances correspondantes sur distcache.</dd> + + <dt>mod_ssl-2.4.x-1.i686.rpm</dt> + <dd>Le module <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> avec les + d챕pendances correspondantes sur openssl.</dd> + + </dl> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="installing" id="installing">Installation du serveur</a></h2> + + + <p>Le RPM <code>httpd</code> est le seul paquet n챕cessaire pour + obtenir un serveur de base fonctionnel. Vous pouvez l'installer + comme suit :</p> + + <div class="example"><p><code> + rpm -U httpd-2.4.x-1.i686.rpm + </code></p></div> + + <p>Le jeu de modules standards est inclus dans le serveur. Les + modules qui d챕pendent de biblioth챔ques externes sont fournis en tant + que paquets RPM s챕par챕s et doivent 챗tre install챕s si n챕cessaire.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="default" id="default">Configuration de l'instance par d챕faut d'Apache httpd</a></h2> + + + <p>Les r챕pertoires par d챕faut sont + <code>/etc/httpd</code> pour la configuration du serveur, et + <code>/var/log/httpd</code> pour la journalisation. L'environnement + par d챕faut du serveur web est d챕fini dans le r챕pertoire optionnel + <code>/etc/sysconfig/httpd</code>.</p> + + <p>D챕marrez le serveur comme suit :</p> + + <div class="example"><p><code> + service httpd restart + </code></p></div> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="additional" id="additional">Configuration d'instances d'Apache httpd suppl챕mentaires sur + la m챗me machine</a></h2> + + + <p>Il est possible d'ex챕cuter simultan챕ment plusieurs instances du + serveur Apache httpd sur la m챗me machine. Chaque instance peut + poss챕der sa propre configuration et en fonction de cette derni챔re, + s'ex챕cuter sous un utilisateur diff챕rent.</p> + + <p>Pour parvenir 횪 ce r챕sultat, on a fait en sorte que le script de + d챕marrage de httpd ait connaissance de son propre nom. Ce nom est + par la suite utilis챕 pour trouver le fichier d'environnement associ챕 + au serveur, et par cons챕quent, la racine de l'instance du serveur + consid챕r챕.</p> + + <p>Pour cr챕er une instance suppl챕mentaire appel챕e + <code>httpd-additional</code>, suivez ces 챕tapes :</p> + + <ul> + <li>Cr챕ez un lien symbolique vers le script de d챕marrage pour + l'instance suppl챕mentaire : + + <div class="example"><p><code> + ln -s /etc/rc.d/init.d/httpd /etc/rc.d/init.d/httpd-additional<br /> + chkconfig --add httpd-additional + </code></p></div> + + </li> + + <li>Cr챕ez un fichier d'environnement pour l'instance + suppl챕mentaire, en utilisant le fichier + <code>/etc/sysconfig/httpd</code> comme mod챔le : + + <div class="example"><p><code> + # cr챕ation du fichier d'environnement 횪 partir du mod챔le httpd<br /> + cp /etc/sysconfig/httpd /etc/sysconfig/httpd-additional + </code></p></div> + + <div class="example"><p><code> + # cr챕ation du fichier d'environnement 횪 partir de z챕ro<br /> + touch /etc/sysconfig/httpd-additional + </code></p></div> + + Editez le fichier <code>/etc/sysconfig/httpd-additional</code> et + d챕finissez la racine de la nouvelle instance du serveur via la + variable d'environnement <code>OPTIONS</code>. + + <div class="example"><p><code> + OPTIONS="-d /etc/httpd-additional -f conf/httpd-additional.conf" + </code></p></div> + + </li> + + <li>Editez le fichier de configuration du serveur suppl챕mentaire + <code>/etc/httpd-additional/conf/httpd-additional.conf</code> et + assurez-vous que les ports et chemins sont correctement d챕finis. + </li> + + <li>D챕marrez le serveur suppl챕mentaire comme suit : + + <div class="example"><p><code> + service httpd-additional restart + </code></p></div> + + </li> + + <li>R챕p챕tez ces op챕rations pour chaque instance suppl챕mentaire + souhait챕e.</li> + </ul> + + </div></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/rpm.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/rpm.html" title="Fran챌ais"> fr </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/rpm.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Autoris챕 sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/win_compiling.html b/docs/manual/platform/win_compiling.html new file mode 100644 index 0000000..31812ba --- /dev/null +++ b/docs/manual/platform/win_compiling.html @@ -0,0 +1,13 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: win_compiling.html.en +Content-Language: en +Content-type: text/html; charset=UTF-8 + +URI: win_compiling.html.fr.utf8 +Content-Language: fr +Content-type: text/html; charset=UTF-8 + +URI: win_compiling.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/platform/win_compiling.html.en b/docs/manual/platform/win_compiling.html.en new file mode 100644 index 0000000..492215b --- /dev/null +++ b/docs/manual/platform/win_compiling.html.en @@ -0,0 +1,517 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Compiling Apache for Microsoft Windows - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Compiling Apache for Microsoft Windows</h1> +<div class="toplang"> +<p><span>Available Languages: </span><a href="../en/platform/win_compiling.html" title="English"> en </a> | +<a href="../fr/platform/win_compiling.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/win_compiling.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + + <p>There are many important points to consider before you begin compiling + Apache HTTP Server (httpd). See <a href="windows.html">Using Apache HTTP + Server on Microsoft Windows</a> before you begin.</p> + + <p>httpd can be built on Windows using a cmake-based build system or with + Visual Studio project files maintained by httpd developers. The cmake-based + build system directly supports more versions of Visual Studio but currently + has considerable functional limitations.</p> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#vstudio">Building httpd with the included Visual Studio project files</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cmake">Building httpd with cmake</a></li> +</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="vstudio" id="vstudio">Building httpd with the included Visual Studio project files</a></h2> + + + <h3><a name="requirements" id="requirements">Requirements</a></h3> + + + + <p>Compiling Apache requires the following environment to be + properly installed:</p> + + <ul> + <li> + <p>Disk Space</p> + + <p>Make sure you have at least 200 MB of free disk space + available. After installation Apache requires approximately + 80 MB of disk space, plus space for log and cache files, + which can grow rapidly. The actual disk space requirements + will vary considerably based on your chosen configuration and + any third-party modules or libraries, especially when OpenSSL + is also built. Because many files are text and very easily + compressed, NTFS filesystem compression cuts these requirements + in half.</p> + </li> + + <li> + <p>Appropriate Patches</p> + + <p>The httpd binary is built with the help of several patches to + third party packages, which ensure the released code is buildable + and debuggable. These patches are available and distributed from <a href="http://www.apache.org/dist/httpd/binaries/win32/patches_applied/">http://www.apache.org/dist/httpd/binaries/win32/patches_applied/</a> + and are recommended to be applied to obtain identical results as the + "official" ASF distributed binaries.</p> + </li> + + <li> + <p>Microsoft Visual C++ 6.0 (Visual Studio 97) or later.</p> + + <p>Apache can be built using the command line tools, or from + within the Visual Studio IDE Workbench. The command line + build requires the environment to reflect the <code>PATH</code>, + <code>INCLUDE</code>, <code>LIB</code> and other variables + that can be configured with the <code>vcvars32.bat</code> script.</p> + + <div class="note">You may want the Visual Studio Processor Pack for your older + version of Visual Studio, or a full (not Express) version of newer + Visual Studio editions, for the ml.exe assembler. This will allow + you to build OpenSSL, if desired, using the more efficient assembly + code implementation.</div> + + <div class="note">Only the Microsoft compiler tool chain is actively supported by + the active httpd contributors. Although the project regularly accepts + patches to ensure MinGW and other alternative builds work and improve + upon them, they are not actively maintained and are often broken in + the course of normal development.</div> + </li> + + <li> + <p>Updated Microsoft Windows Platform SDK, February 2003 or later.</p> + + <p>An appropriate Windows Platform SDK is included by default in the + full (not express/lite) versions of Visual C++ 7.1 (Visual Studio 2002) + and later, these users can ignore these steps unless explicitly choosing + a newer or different version of the Platform SDK.</p> + + <p>To use Visual C++ 6.0 or 7.0 (Studio 2000 .NET), the Platform SDK + environment must be prepared using the <code>setenv.bat</code> + script (installed by the Platform SDK) before starting the command + line build or launching the msdev/devenv GUI environment. Installing + the Platform SDK for Visual Studio Express versions (2003 and later) + should adjust the default environment appropriately.</p> + + <div class="example"><p><code> + "c:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32"<br /> + "c:\Program Files\Platform SDK\setenv.bat" + </code></p></div> + </li> + + <li> + <p>Perl and awk</p> + + <p>Several steps recommended here require a perl interpreter during + the build preparation process, but it is otherwise not required.</p> + + <p>To install Apache within the build system, several files are + modified using the <code>awk.exe</code> utility. awk was chosen since + it is a very small download (compared with Perl or WSH/VB) and + accomplishes the task of modifying configuration files upon + installation. Brian Kernighan's + <a href="http://www.cs.princeton.edu/~bwk/btl.mirror/">http://www.cs.princeton.edu/~bwk/btl.mirror/</a> + site has a compiled native Win32 binary, + <a href="http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe">http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe</a> which + you must save with the name <code>awk.exe</code> (rather than + <code>awk95.exe</code>).</p> + + <div class="note">If awk.exe is not found, Makefile.win's install target + will not perform substitutions in the installed .conf files. + You must manually modify the installed .conf files to allow + the server to start. Search and replace all "@token@" tags + as appropriate.</div> + + <div class="note">The Visual Studio IDE will only find <code>awk.exe</code> + from the PATH, or executable path specified in the menu option + Tools -> Options -> (Projects ->) Directories. Ensure + awk.exe is in your system path.</div> + + <div class="note">Also note that if you are using Cygwin tools + (<a href="http://www.cygwin.com/">http://www.cygwin.com/</a>) + the awk utility is named <code>gawk.exe</code> and that the file + <code>awk.exe</code> is really a symlink to the <code>gawk.exe</code> + file. The Windows command shell does not recognize symlinks, and + because of this building InstallBin will fail. A workaround is + to delete <code>awk.exe</code> from the cygwin installation and + copy <code>gawk.exe</code> to <code>awk.exe</code>. Also note the + cygwin/mingw ports of gawk 3.0.x were buggy, please upgrade to 3.1.x + before attempting to use any gawk port.</div> + </li> + + <li> + <p>[Optional] zlib library (for <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>)</p> + + <p>Zlib must be installed into a <code>srclib</code> subdirectory named + <code>zlib</code>. This must be built in-place. Zlib can be obtained + from <a href="http://www.zlib.net/">http://www.zlib.net/</a> -- the + <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> is confirmed to work correctly with + version 1.2.3.</p> + + <div class="example"><p><code> + nmake -f win32\Makefile.msc<br /> + nmake -f win32\Makefile.msc test + </code></p></div> + </li> + + <li> + <p>[Optional] OpenSSL libraries (for <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> + and <code>ab.exe</code> with ssl support)</p> + + <div class="note">The OpenSSL library is cryptographic software. The country + in which you currently reside may have restrictions on the import, + possession, use, and/or re-export to another country, of encryption + software. BEFORE using any encryption software, please check your + country's laws, regulations and policies concerning the import, + possession, or use, and re-export of encryption software, to see + if this is permitted. See + <a href="http://www.wassenaar.org/">http://www.wassenaar.org/</a> + for more information.</div> + + <p>Configuring and building OpenSSL requires perl to be installed.</p> + + <p>OpenSSL must be installed into a <code>srclib</code> subdirectory + named <code>openssl</code>, obtained from + <a href="http://www.openssl.org/source/">http://www.openssl.org/source/</a>, in order to compile + <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> or the <code>abs.exe</code> project, which + is ab.c with SSL support enabled. To prepare OpenSSL to be linked + to Apache mod_ssl or abs.exe, and disable patent encumbered features + in OpenSSL, you might use the following build commands:</p> + + <div class="example"><p><code> + perl Configure no-rc5 no-idea enable-mdc2 enable-zlib VC-WIN32 + -Ipath/to/srclib/zlib -Lpath/to/srclib/zlib<br /> + ms\do_masm.bat<br /> + nmake -f ms\ntdll.mak + </code></p></div> + + <div class="note">It is not advisable to use zlib-dynamic, as that transfers + the cost of deflating SSL streams to the first request which must + load the zlib dll. Note the suggested patch enables the -L flag to + work with windows builds, corrects the name of zdll.lib and ensures + .pdb files are generated for troubleshooting. If the assembler is + not installed, you would add no-asm above and use ms\do_ms.bat + instead of the ms\do_masm.bat script.</div> + </li> + + <li> + <p>[Optional] Database libraries (for <code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> + and <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>)</p> + + <p>The apr-util library exposes dbm (keyed database) and dbd (query + oriented database) client functionality to the httpd server and its + modules, such as authentication and authorization. The sdbm dbm and + odbc dbd providers are compiled unconditionally.</p> + + <p>The dbd support includes the Oracle instantclient package, MySQL, + PostgreSQL and sqlite. To build these all, for example, set up the + LIB to include the library path, INCLUDE to include the headers path, + and PATH to include the dll bin path of all four SDK's, and set the + DBD_LIST environment variable to inform the build which client driver + SDKs are installed correctly, e.g.;</p> + + <div class="example"><p><code> + set DBD_LIST=sqlite3 pgsql oracle mysql + </code></p></div> + + <p>Similarly, the dbm support can be extended with DBM_LIST to + build a Berkeley DB provider (db) and/or gdbm provider, by similarly + configuring LIB, INCLUDE and PATH first to ensure the client library + libs and headers are available.</p> + + <div class="example"><p><code> + set DBM_LIST=db gdbm + </code></p></div> + + <div class="note">Depending on the choice of database distributions, it may be + necessary to change the actual link target name (e.g. gdbm.lib vs. + libgdb.lib) that are listed in the corresponding .dsp/.mak files + within the directories srclib\apr-util\dbd or ...\dbm.</div> + + <p>See the README-win32.txt file for more hints on obtaining the + various database driver SDKs.</p> + </li> + </ul> + + + + <h3><a name="unixsrcbuild" id="unixsrcbuild">Building from Unix sources</a></h3> + + + + <p>The policy of the Apache HTTP Server project is to only release Unix sources. + Windows source packages made available for download have been supplied by + volunteers and may not be available for every release. You can still build + the server on Windows from the Unix source tarball with just a few additional + steps.</p> + + <ol> + <li>Download and unpack the Unix source tarball for the latest version.</li> + <li>Download and unpack the Unix source tarball for latest version of + APR, AR-Util and APR-Iconv, place these sources in directories httpd-2.x.x\srclib\apr, httpd-2.x.x\srclib\apr-util and httpd-2.x.x\srclib\apr-iconv</li> + <li>Open a Command Prompt and CD to the httpd-2.x.x folder</li> + <li>Run the line endings conversion utility at the prompt;</li> + </ol> + + <div class="example"><p><code> + perl srclib\apr\build\lineends.pl + </code></p></div> + + <p>You can now build the server with the Visual Studio development + environment using the IDE. Command-Line builds of the server are not + possible from Unix sources unless you export .mak files as explained + below. + </p> + + + + <h3><a name="commandbuild" id="commandbuild">Command-Line Build</a></h3> + + + + <p><code>Makefile.win</code> is the top level Apache makefile. + To compile Apache on Windows, simply use one of the following commands + to build the <code>release</code> or <code>debug</code> flavor:</p> + + <div class="example"><p><code> + nmake /f Makefile.win _apacher<br /><br /> + nmake /f Makefile.win _apached + </code></p></div> + + <p>Either command will compile Apache. The latter will disable + optimization of the resulting files, making it easier to single + step the code to find bugs and track down problems.</p> + + <p>You can add your apr-util dbd and dbm provider choices with the + additional make (environment) variables DBD_LIST and DBM_LIST, + see the comments about [Optional] Database libraries, above. + Review the initial comments in Makefile.win for additional options + that can be provided when invoking the build.</p> + + + + <h3><a name="workspacebuild" id="workspacebuild">Developer Studio Workspace IDE Build</a></h3> + + + + <p>Apache can also be compiled using VC++'s Visual Studio + development environment. To simplify this process, a + Visual Studio workspace, <code>Apache.dsw</code>, is provided. + This workspace exposes the entire list of working <code>.dsp</code> + projects that are required for the complete Apache binary release. + It includes dependencies between the projects to assure that they + are built in the appropriate order.</p> + + <p>Open the <code>Apache.dsw</code> workspace, and select + <code>InstallBin</code> (<code>Release</code> or <code>Debug</code> build, + as desired) as the Active Project. <code>InstallBin</code> causes all + related project to be built, and then invokes <code>Makefile.win</code> to + move the compiled executables and dlls. You may personalize the + <code>INSTDIR=</code> choice by changing <code>InstallBin</code>'s Settings, + General tab, Build command line entry. <code>INSTDIR</code> defaults to the + <code>/Apache2</code> directory. If you only want a test compile (without + installing) you may build the <code>BuildBin</code> project instead.</p> + + <p>The <code>.dsp</code> project files are distributed in Visual Studio 6.0 + (98) format. Visual C++ 5.0 (97) will recognize them. Visual Studio + 2002 (.NET) and later users must convert <code>Apache.dsw</code> plus + the <code>.dsp</code> files into an <code>Apache.sln</code> plus + <code>.msproj</code> files. Be sure you reconvert the <code>.msproj</code> + file again if its source <code>.dsp</code> file changes! This is really + trivial, just open <code>Apache.dsw</code> in the VC++ 7.0 IDE once again + and reconvert.</p> + + <div class="note">There is a flaw in the .vcproj conversion of .dsp files. devenv.exe + will mis-parse the /D flag for RC flags containing long quoted /D'efines + which contain spaces. The command: + <div class="example"><p><code> + perl srclib\apr\build\cvtdsp.pl -2005 + </code></p></div> + will convert the /D flags for RC flags to use an alternate, parseable + syntax; unfortunately this syntax isn't supported by Visual Studio 97 + or its exported .mak files. These /D flags are used to pass the long + description of the mod_apachemodule.so files to the shared .rc resource + version-identifier build.</div> + + <div class="note"><strong>Building with OpenSSL 1.1.0 and up</strong> + Due to difference in the build structure of OpenSSL begining with version + 1.1.0 you will need to convert the dsp files affected with cvtdsp.pl from + APR 1.6 or greater. The command: + <div class="example"><p><code> + perl srclib\apr\build\cvtdsp.pl -ossl11 + </code></p></div> + </div> + + <p>Visual Studio 2002 (.NET) and later users should also use the Build + menu, Configuration Manager dialog to uncheck both the <code>Debug</code> + and <code>Release</code> Solution modules <code>abs</code>, + <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> and <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> components, as + well as every component starting with <code>apr_db*</code>. These modules + are built by invoking <code>nmake</code>, or the IDE directly with the + <code>BinBuild</code> target, which builds those modules conditionally + if the <code>srclib</code> directories <code>openssl</code> and/or + <code>zlib</code> exist, and based on the setting of <code>DBD_LIST</code> + and <code>DBM_LIST</code> environment variables.</p> + + + + <h3><a name="exportingmakfiles" id="exportingmakfiles">Exporting command-line .mak files</a></h3> + + + + <p>Exported <code>.mak</code> files pose a greater hassle, but they are + required for Visual C++ 5.0 users to build <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>, + abs (<code class="program"><a href="../programs/ab.html">ab</a></code> with SSL support) and/or + <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>. The .mak files also support a broader + range of C++ tool chain distributions, such as Visual Studio Express.</p> + + <p>You must first build all projects in order to create all dynamic + auto-generated targets, so that dependencies can be parsed correctly. + Build the entire project from within the Visual Studio 6.0 (98) IDE, + using the <code>BuildAll</code> target, then use the Project Menu Export + for all makefiles (checking on "with dependencies".) Run the following + command to correct absolute paths into relative paths so they will build + anywhere:</p> + + <div class="example"><p><code> + perl srclib\apr\build\fixwin32mak.pl + </code></p></div> + + <p>You must type this command from the <em>top level</em> + directory of the httpd source tree. Every + <code>.mak</code> and <code>.dep</code> project file within + the current directory and below will be corrected, and the + timestamps adjusted to reflect the <code>.dsp</code>.</p> + + <p>Always review the generated <code>.mak</code> and <code>.dep</code> + files for Platform SDK or other local, machine specific file paths. + The <code>DevStudio\Common\MSDev98\bin\</code> (VC6) directory contains + a <code>sysincl.dat</code> file, which lists all exceptions. Update + this file (including both forward and backslashed paths, such as both + <code>sys/time.h</code> and <code>sys\time.h</code>) to ignore such + newer dependencies. Including local-install paths in a distributed + <code>.mak</code> file will cause the build to fail completely.</p> + + <p>If you contribute back a patch that revises project files, we + must commit project files in Visual Studio 6.0 format. Changes + should be simple, with minimal compilation and linkage flags that + can be recognized by all Visual Studio environments.</p> + + + + <h3><a name="installation" id="installation">Installation</a></h3> + + + + <p>Once Apache has been compiled, it needs to be installed in + its server root directory. The default is the + <code>\Apache2</code> directory, of the same drive.</p> + + <p>To build and install all the files into the desired folder + <em>dir</em> automatically, use one of the following + <code>nmake</code> commands:</p> + + <div class="example"><p><code> + nmake /f Makefile.win installr INSTDIR=<em>dir</em><br /> + nmake /f Makefile.win installd INSTDIR=<em>dir</em> + </code></p></div> + + <p>The <em>dir</em> argument to <code>INSTDIR</code> provides + the installation directory; it can be omitted if Apache is + to be installed into <code>\Apache22</code> (of the current + drive).</p> + + + + <h3><a name="projectcomponents-warn" id="projectcomponents-warn">Warning about building Apache from the development tree</a></h3> + + + + <div class="note">Note only the <code>.dsp</code> files are maintained between <code>release</code> + builds. The <code>.mak</code> files are NOT regenerated, due to the tremendous + waste of reviewer's time. Therefore, you cannot rely on the <code>NMAKE</code> + commands above to build revised <code>.dsp</code> project files unless you + then export all <code>.mak</code> files yourself from the project. This is + unnecessary if you build from within the Microsoft + Developer Studio environment.</div> + + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="cmake" id="cmake">Building httpd with cmake</a></h2> + + + <p>The primary documentation for this build mechanism is in the + <code>README.cmake</code> file in the source distribution. Refer to that file + for detailed instructions.</p> + + <p>Building httpd with cmake requires building APR and APR-util separately. + Refer to their <code>README.cmake</code> files for instructions.</p> + + <p>The primary limitations of the cmake-based build are inherited from the APR-util + project, and are listed below because of their impact on httpd:</p> + + <ul> + <li>No cmake build for the APR-iconv subproject is available, and the + APR-util cmake build cannot consume an existing APR-iconv build. Thus, + <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> and possibly some third-party modules + cannot be used.</li> + <li>The cmake build for the APR-util subproject does not support most of the + optional DBM and DBD libraries supported by the included Visual Studio + project files. This limits the database backends supported by a number of + bundled and third-party modules.</li> + </ul> + + </div></div> +<div class="bottomlang"> +<p><span>Available Languages: </span><a href="../en/platform/win_compiling.html" title="English"> en </a> | +<a href="../fr/platform/win_compiling.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/win_compiling.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/win_compiling.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/win_compiling.html.fr.utf8 b/docs/manual/platform/win_compiling.html.fr.utf8 new file mode 100644 index 0000000..de3abd8 --- /dev/null +++ b/docs/manual/platform/win_compiling.html.fr.utf8 @@ -0,0 +1,603 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Compiler Apache pour Microsoft Windows - Serveur HTTP Apache Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur HTTP Apache Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Notes sp챕cifiques 횪 certaines + plates-formes</a></div><div id="page-content"><div id="preamble"><h1>Compiler Apache pour Microsoft Windows</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/win_compiling.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/win_compiling.html" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/win_compiling.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + + <p>Il y a de nombreux points importants 횪 conna챤tre avant de + compiler Le serveur HTTP Apache pour Microsoft Windows. Avant de commencer, lisez le + document <a href="windows.html">Utiliser le serveur HTTP Apache avec Microsoft + Windows</a>.</p> + + <p>httpd peut 챗tre compil챕 sous Windows en utilisant une cha챤ne de + compilation bas챕e sur cmake, ou 횪 partir de fichiers projet Visual + Studio maintenus par les d챕veloppeurs de httpd. La cha챤ne de + compilation bas챕e sur cmake supporte directement davantage de + versions de Visual Studio, mais poss챔de actuellement des + fonctionnalit챕s tr챔s limit챕es.</p> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#requirements">Pr챕requis</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#unixsrcbuild">Compilation 횪 partir des sources Unix</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#commandbuild">Compilation 횪 partir de la ligne de commandes</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#workspacebuild">Compilation depuis l'espace de travail IDE de Developer + Studio</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#exportingmakfiles">Export des fichiers .mak de la ligne de commandes</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#installation">Installation</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#projectcomponents-warn">Avertissement 횪 propos de la compilation d'Apache 횪 partir de +l'arborescence de d챕veloppement</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cmake">Compilation de httpd avec cmake</a></li> +</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="requirements" id="requirements">Pr챕requis</a></h2> + + + + <p>Pour compiler Apache, l'environnement doit satisfaire aux + conditions suivantes :</p> + + <ul> + <li> + <p>Espace disque</p> + + <p>Assurez-vous de disposer d'un minimum de 200 Mo d'espace + disque disponible. Apr챔s l'installation, Apache occupe environ + 80 Mo d'espace disque, plus l'espace r챕serv챕 aux journaux et au + cache, la taille de ces derniers pouvant augmenter rapidement. + Les besoins r챕els en espace disque d챕pendent 챕troitement de la + configuration choisie et des biblioth챔ques ou modules tiers + install챕s, en particulier lorsqu'OpenSSL est mis en oeuvre. + Comme de nombreux fichiers sont au format texte et donc + facilement compressibles, l'utilisation de la compression du + syst챔me de fichiers NTFS divise ces besoins par deux.</p> + </li> + + <li> + <p>Correctifs requis</p> + + <p>Le binaire httpd est compil챕 횪 l'aide de nombreux correctifs + appliqu챕s aux paquets tiers, ce qui permet de s'assurer que le + code fourni est bien compilable et d챕boguable. Ces correctifs + sont disponibles 횪 <a href="http://www.apache.org/dist/httpd/binaries/win32/patches_applied/">http://www.apache.org/dist/httpd/binaries/win32/patches_applied/</a>, + et il est recommand챕 de les appliquer afin d'obtenir un + r챕sultat identique aux binaires "officiels" distribu챕s par + l'ASF.</p> + </li> + + <li> + <p>Microsoft Visual C++ 6.0 (Visual Studio 97) ou sup챕rieur.</p> + + <p>Apache peut 챗tre compil챕 en utilisant l'outil ligne de + commande, ou depuis l'espace de travail IDE Visual Studio. Pour + la compilation depuis la ligne de commandes, l'environnement + doit comporter les variables the <code>PATH</code>, + <code>INCLUDE</code>, <code>LIB</code>, ainsi que d'autres + variables qui peuvent 챗tre d챕finies via le script + <code>vcvars32.bat</code> :</p> + + <div class="note">Vous pouvez vous procurer le paquet du Processeur Visual + Studio pour votre ancienne version de Visual Studio, ou une + version compl챔te (et non Express) d'une 챕dition plus r챕cente de + Visual Studio pour l'assembleur ml.exe. Ceci vous permettra, si + vous le souhaitez, de compiler OpenSSL en utilisant une + impl챕mentation du code d'assemblage plus efficace.</div> + + <div class="note">Seule la cha챤ne d'outils de compilation de Microsoft est + support챕e de mani챔re suivie par les contributeurs actifs 횪 httpd. + Bien que le projet accepte r챕guli챔rement des correctifs pour + s'assurer que MinGW et d'autre outils de compilation + fonctionnent, ou m챗me pour les am챕liorer, ils ne sont pas + maintenus de mani챔re suivie et sont m챗me souvent hors d'챕tat + de fonctionner 횪 certains stades du d챕veloppement normal.</div> + </li> + + <li> + <p>Le SDK de la plate-forme Windows mis 횪 jour, f챕vrier 2003 ou + plus r챕cent.</p> + + <p>Un SDK appropri챕 pour la plate-forme Windows est inclus par + d챕faut dans les versions compl챔tes (et non Express/lite) de + Visual C++ 7.1 (Visual Studio 2002) et sup챕rieures ; les + utilisateurs peuvent ignorer ces 챕tapes, 횪 moins qu'ils aient + choisi d'utiliser une version plus r챕cente ou diff챕rente du SDK.</p> + + <p>Pour pouvoir utiliser Visual C++ 6.0 or 7.0 (Studio 2000 + .NET), l'environnement du SDK de la plate-forme doit 챗tre pr챕par챕 en utilisant le + script <code>setenv.bat</code> (install챕 par le SDK de la plate-forme) avant de + lancer la compilation en ligne de commande ou l'interface GUI + msdev/devenv. L'installation du SDK de la plate-forme pour les + versions Express de Visual Studio (2003 et sup챕rieures) devrait + ajuster l'environnement par d챕faut de mani챔re appropri챕e.</p> + + <div class="example"><p><code> + "c:\Program Files\Microsoft Visual Studio\VC98\Bin\VCVARS32"<br /> + "c:\Program Files\Platform SDK\setenv.bat" + </code></p></div> + + + </li> + + <li> + <p>Perl et awk</p> + + <p>De nombreuses 챕tapes recommand챕es ici n챕cessitent un + interpr챕teur perl durant le processus de pr챕paration de la + compilation.</p> + + <p>Pour installer Apache 횪 partir du syst챔me de compilation, de + nombreux fichiers sont modifi챕s via l'utilitaire + <code>awk.exe</code>. awk effectue la modification des fichiers + au moment de l'installation ; il a 챕t챕 choisi car il n챕cessite + un t챕l챕chargement de petite taille (par rapport 횪 Perl ou + WSH/VB). Le site de Brian Kernighan <a href="http://www.cs.princeton.edu/~bwk/btl.mirror/">http://www.cs.princeton.edu/~bwk/btl.mirror/</a> propose un + binaire pr챕compil챕 pour Win32, <a href="http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe">http://www.cs.princeton.edu/~bwk/btl.mirror/awk95.exe</a>, que + vous devez enregistrer sous le nom <code>awk.exe</code> (plut척t + que <code>awk95.exe</code>).</p> + + <div class="note">Si awk.exe n'est pas trouv챕, la cible install du fichier + Makefile.win n'effectuera aucune substitution dans les fichiers + .conf install챕s. Vous devez modifier manuellement les fichiers + .conf install챕s afin de permettre au serveur de d챕marrer. + Recherchez et remplacez toutes les balises "@token@" par une + valeur appropri챕e.</div> + + <div class="note">L'IDE Visual Studio ne trouvera le chemin de + <code>awk.exe</code> que dans la variable PATH, ou dans le + chemin des ex챕cutables sp챕cifi챕 par l'option de menu Tools -> + Options -> (Projects ->) Directories. Assurez-vous + qu'awk.exe est bien dans votre chemin syst챔me.</div> + + <div class="note">Notez aussi, si vous utilisez les outils Cygwin (<a href="http://www.cygwin.com/">http://www.cygwin.com/</a>), que + l'utilitaire awk de nomme <code>gawk.exe</code> et que le + fichier <code>awk.exe</code> est en fait un lien symbolique vers + le fichier <code>gawk.exe</code>. Le shell de commandes Windows + ne reconna챤t pas les liens symboliques, et par cons챕quent la + compilation d'InstallBin 챕chouera. Pour contourner le probl챔me, + vous pouvez supprimer le lien <code>awk.exe</code> de + l'installation de Cygwin, et copier <code>gawk.exe</code> vers + <code>awk.exe</code>. Notez aussi que les portages cygwin/mingw + de gawk 3.0.x 챕taient bogu챕s ; veuillez par cons챕quent effectuer + une mise 횪 jour vers la version 3.1.x avant l'utilisation de + tout portage de gawk.</div> + </li> + + <li> + <p>[Optionnel] biblioth챔que zlib (pour le module + <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>)</p> + + <p>Zlib doit 챗tre install챕e dans un sous-r챕pertoire du + r챕pertoire <code>srclib</code> et nomm챕 <code>zlib</code>. Elle + doit 챗tre compil챕e directement 횪 cette place. Zlib est + disponible 횪 l'adresse <a href="http://www.zlib.net/">http://www.zlib.net/</a> -- le + fonctionnement correct du module <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> a + 챕t챕 v챕rifi챕 avec la version 1.2.3.</p> + + <div class="example"><p><code> + nmake -f win32\Makefile.msc<br /> + nmake -f win32\Makefile.msc test + </code></p></div> + </li> + + <li> + <p>[Optionnel] Biblioth챔ques OpenSSL (pour le module + <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> et <code>ab.exe</code> avec le support + ssl)</p> + + <div class="note">La biblioth챔que OpenSSL est un logiciel de chiffrement. Le + pays dans lequel vous r챕sidez peut imposer des restrictions 횪 + l'importation, la possession, l'utilisation, et/ou la + r챕exportation vers un autre pays des logiciels de chiffrement. + AVANT d'utiliser tout logiciel de chiffrement, veuillez + consulter la l챕gislation de votre pays, les r챔gles et politiques + d'importation, de possession, ou d'utilisation, et de + r챕exportation des logiciels de chiffrement, afin de d챕terminer + si vous en avez le droit. Voir <a href="http://www.wassenaar.org/">http://www.wassenaar.org/</a> + pour plus de d챕tails.</div> + + <p>La configuration et la compilation d'OpenSSL n챕cessite + l'installation de perl.</p> + + <p>Pour pouvoir compiler <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> ou le projet + <code>abs.exe</code>, qui devient ab.c avec le support SSL + activ챕, vous devez + t챕l챕charger OpenSSL 횪 l'adresse <a href="http://www.openssl.org/source/">http://www.openssl.org/source/</a>, + et l'installer dans un sous-r챕pertoire du r챕pertoire + <code>srclib</code> que vous nommerez <code>openssl</code>. Afin + de pr챕parer OpenSSL 횪 la liaison avec le module Apache mod_ssl + ou abs.exe, et d챕sactiver les fonctionnalit챕s d'Openssl gr챕v챕es + de brevets, vous pouvez utiliser la commande de compilation + suivante :</p> + + <div class="example"><p><code> + perl Configure no-rc5 no-idea enable-mdc2 enable-zlib VC-WIN32 + -Ipath/to/srclib/zlib -Lpath/to/srclib/zlib<br /> + ms\do_masm.bat<br /> + nmake -f ms\ntdll.mak + </code></p></div> + + <div class="note">Il est d챕conseill챕 d'utiliser zlib-dynamic, car la charge + de la d챕compression des flux SSL est alors transf챕r챕e 횪 la + premi챔re requ챗te qui doit charger la dll zlib. Notez que le + correctif propos챕 active le drapeau -L afin de pouvoir + fonctionner avec les compilations Windows, corrige le nom de + zdll.lib et s'assure que les fichiers .pdb sont g챕n챕r챕s afin de + pouvoir r챕soudre les probl챔mes. Si l'assembleur n'est pas + install챕, vous devez ajouter no-asm ci-dessus et utiliser le + script ms\do_ms.bat 횪 la place de ms\do_masm.bat.</div> + </li> + + <li> + <p>[Optionnel] Biblioth챔ques de bases de donn챕es (pour +<code class="module"><a href="../mod/mod_dbd.html">mod_dbd</a></code> et <code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code>)</p> + + <p>La biblioth챔que apr-util fournit un acc챔s aux fonctionnalit챕s + clients dbm (base de donn챕es 횪 base de cl챕s) et dbd (base de + donn챕es 횪 base de requ챗tes) au serveur httpd et 횪 certains de + ses modules, comme les modules d'authentification et + d'autorisation. Les fournisseurs sdbm dbm et odbc dbd sont + compil챕s automatiquement.</p> + + <p>Le support dbd inclut le paquet instantclient Oracle, MySQL, + PostgreSQL et sqlite. Par exemple, pour les compiler tous, + d챕finissez LIB de fa챌on 횪 inclure le chemin des biblioth챔ques, + INCLUDE de fa챌on 횪 inclure le chemin des en-t챗tes, et PATH de + fa챌on 횪 inclure le chemin des dll et bin de chacun des quatre + SDK, et d챕finissez la variable d'environnement DBD_LIST de fa챌on + 횪 indiquer au processus de compilation quels SDKs pilotes + clients du sont correctement install챕s ; par exemple :</p> + + <div class="example"><p><code> + set DBD_LIST=sqlite3 pgsql oracle mysql + </code></p></div> + + <p>De mani챔re similaire, le support dbm peut 챗tre 챕tendu avec + DBM_LIST pour compiler un fournisseur Berkeley DB (db) et/ou un + fournisseur gdbm, en configurant tout d'abord de la m챗me mani챔re + LIB, INCLUDE et PATH afin de s'assurer que les biblioth챔ques et + en-t챗tes de la biblioth챔que client sont bien disponibles.</p> + + <div class="example"><p><code> + set DBM_LIST=db gdbm + </code></p></div> + + <div class="note">En fonction du choix des distributions de bases de + donn챕es, il peut s'av챕rer n챕cessaire de modifier le nom des + cibles de l'챕dition de liens (par exemple gdbm.lib 횪 la place de + libgdb.lib) list챕es dans les fichiers .dsp/.mak des r챕pertoires + srclib\apr-util\dbd ou ...\dbm correspondants.</div> + + <p>Voir le fichier README-win32.txt pour plus d'informations 횪 + propos de l'obtention des diff챕rents SDKs pilotes de bases de + donn챕es.</p> + </li> + + </ul> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="unixsrcbuild" id="unixsrcbuild">Compilation 횪 partir des sources Unix</a></h2> + + + + <p>Le projet du serveur HTTP Apache 횪 pour politique de ne fournir + que des sources de type Unix. Les paquets source de type Windows + disponibles en t챕l챕chargement ont 챕t챕 챕labor챕s par des + contributeurs, et ne seront pas forc챕ment reconduits pour toutes les + versions. Vous pouvez cependant compiler le serveur sous Windows 횪 + partir des sources Unix en ajoutant quelques 챕tapes suppl챕mentaires.</p> + + <ol> + <li>T챕l챕chargez et ouvrez le tarball source Unix de la derni챔re + version du serveur HTTP Apache.</li> + <li>T챕l챕chargez et ouvrez le tarball source Unix de la derni챔re + version de APR, APR-Util et APR-Iconv, et copier l'arborescence + obtenue dans httpd-2.x.x\srclib\apr, httpd-2.x.x\srclib\apr-util + et httpd-2.x.x\srclib\apr-iconv</li> + <li>Ouvrez la console et placez-vous au niveau du r챕pertoire httpd-2.x.x</li> + <li>Ex챕cutez l'utilitaire de conversion de fins de ligne</li> + </ol> + + <div class="example"><p><code> + perl srclib\apr\build\lineends.pl + </code></p></div> + + <p>Vous pouvez maintenant compiler le serveur via l'environnement de + d챕veloppement Visual Studio en utilisant l'IDE. Les compilations + du serveur en ligne de commande ne sont possibles avec des sources + de type Unix que si vous exportez les fichiers .mak comme indiqu챕 + ci-dessous. + </p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="commandbuild" id="commandbuild">Compilation 횪 partir de la ligne de commandes</a></h2> + + + + <p><code>Makefile.win</code> est le makefile principal ou racine + d'Apache. Pour compiler Apache sous Windows, utilisez simplement une + des commandes suivantes pour compiler la version + <code>release</code> ou <code>debug</code> :</p> + + <div class="example"><p><code> + nmake /f Makefile.win _apacher<br /><br /> + nmake /f Makefile.win _apached + </code></p></div> + + + <p>Ces deux commandes effectuent la compilation d'Apache. Cependant, + avec la deuxi챔me, les fichiers r챕sultants ne seront pas optimis챕s, + ce qui va faciliter l'examen pas 횪 pas du code pour trouver des + bogues et r챕soudre les probl챔mes.</p> + + <p>Vous pouvez indiquer vos choix en mati챔re de fournisseurs dbd et + dbm 횪 l'aide des variables (d'environnement) additionnelles de make + DBD_LIST et DBM_LIST ; voir les commentaires 횪 propos des + [Optionnel] Biblioth챔ques de bases de donn챕es ci-dessus. Consultez + les commentaires initiaux dans Makefile.win pour plus d'options + pouvant 챗tre fournies lors de la compilation.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="workspacebuild" id="workspacebuild">Compilation depuis l'espace de travail IDE de Developer + Studio</a></h2> + + + + <p>Apache peut aussi 챗tre compil챕 depuis l'environnement de + d챕veloppement Visual Studio de VC++. Pour simplifier ce processus, + l'espace de travail Visual Studio <code>Apache.dsw</code> est + fourni. Cet espace de travail expose la liste compl챔te des projets + <code>.dsp</code> actifs n챕cessaires 횪 l'installation binaire + compl챔te d'Apache. Il inclut les d챕pendances entre projets afin que + ces derniers soient compil챕s selon l'ordre appropri챕.</p> + + <p>Ouvrez l'espace de travail <code>Apache.dsw</code>, et + s챕lectionnez <code>InstallBin</code> (compilation + <code>Release</code> ou <code>Debug</code>, selon vos souhaits) + comme Active Project. <code>InstallBin</code> provoque la + compilation de tous les projets concern챕s, puis invoque + <code>Makefile.win</code> pour installer les ex챕cutables et dlls + compil챕s. Vous pouvez modifier la valeur de <code>INSTDIR=</code> + via la configuration de <code>InstallBin</code>, onglet G챕n챕ral, + entr챕e ligne de commandes de compilation. La valeur par d챕faut de + <code>INSTDIR</code> est le r챕pertoire <code>/Apache2</code>. Si + vous d챕sirez effectuer un test de compilation (sans installation), + s챕lectionnez le projet <code>BuildBin</code>.</p> + + <p>Les fichiers projets <code>.dsp</code> sont distribu챕s au format + Visual Studio 6.0 (98). Visual C++ 5.0 (97) les reconna챤t. Les + utilisateurs de Visual Studio 2002 (.NET) et versions sup챕rieures + doivent convertir <code>Apache.dsw</code> et les fichiers + <code>.dsp</code> en un projet <code>Apache.sln</code>, ainsi que + les fichiers <code>.msproj</code> ; assurez-vous de reconvertir le + fichier <code>.msproj</code> si l'un des fichiers source + <code>.dsp</code> est modifi챕 ! Cette op챕ration est vraiment tr챔s + simple, il suffit de r챕ouvrir <code>Apache.dsw</code> dans l'IDE + VC++ 7.0 et de le reconvertir.</p> + + + <div class="note">Il y a une erreur dans la conversion .vcproj des fichiers + .dsp. devenv.exe interpr챔te mal le drapeau + /D pour les drapeaux RC contenant de grandes /D'챕finitions entour챕es + de guillemets, et contenant elles-m챗mes des espaces. Ainsi, la + commande : + <div class="example"><p><code> + perl srclib\apr\build\cvtdsp.pl -2005 + </code></p></div> + va convertir les drapeaux /D pour les drapeaux RC afin d'utiliser + une syntaxe alternative, interpr챕table ; malheureusement, cette + syntaxe n'est pas support챕e par Visual Studio 97 ou ses fichiers + .mak export챕s. Ces drapeaux /D permettent de transmettre la longue + description des fichiers de mod_apachemodule.so 횪 leurs compilations + d'identificateur de version de ressource .rc partag챕e.</div> + + + <div class="note"><strong>Compilation avec OpenSSL versions 1.1.0 et sup챕rieures</strong> + Suite 횪 une modification de la structure de compilation d'OpenSSL 횪 partir + de la version 1.1.0, vous devez convertir les fichiers dsp concern챕s via la + commance cvtdsp.pl fournie par APR versions 1.6 et sup챕rieures : + <div class="example"><p><code> + perl srclib\apr\build\cvtdsp.pl -ossl11 + </code></p></div> + </div> + + + <p>Les utilisateurs de Visual Studio 2002 (.NET) et versions + sup챕rieures doivent aussi utiliser + la bo챤te de dialogue Configuration Manager du menu Build pour + d챕cocher les deux versions <code>Debug</code> et + <code>Release</code> des modules <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> + et <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> pour <code>abs</code>. Ces modules + sont compil챕s + en invoquant <code>nmake</code> ou directement l'IDE avec la cible + <code>BinBuild</code> pour compiler ces modules de mani챔re + conditionnelle si les sous-r챕pertoires de <code>srclib</code> + <code>openssl</code> et/ou <code>zlib</code> existent, et en + fonction des d챕finitions des variables d'environnement + <code>DBD_LIST</code> et <code>DBM_LIST</code>.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="exportingmakfiles" id="exportingmakfiles">Export des fichiers .mak de la ligne de commandes</a></h2> + + + + + <p>Les fichiers <code>.mak</code> export챕s posent plus de probl챔mes, + mais les utilisateurs de Visual C++ 5.0 en ont besoin pour compiler + <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>, abs (<code class="program"><a href="../programs/ab.html">ab</a></code> avec support + SSL) et/ou <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>. Les fichiers .mak + supportent aussi un choix plus large de distributions de cha챤nes + d'outils C++, comme Visual Studio Express.</p> + + <p>Vous devez tout d'abord compiler tous les projets afin de cr챕er + toutes les cibles dynamiques auto-g챕n챕r챕es, de fa챌on 횪 ce que les + d챕pendances puissent 챗tre interpr챕t챕es correctement. Compilez + l'ensemble du projet depuis l'IDE Visual Studio 6.0 (98), en + utilisant la cible <code>BuildAll</code>, puis utilisez le menu de + projet Export pour tous les makefiles (en cochant "with + dependencies"). Utilisez la commande suivante pour transformer les + chemins absolus en chemins relatifs de fa챌on 횪 ce que la compilation + puisse s'effectuer depuis n'importe quelle position dans + l'arborescence :</p> + + <div class="example"><p><code> + perl srclib\apr\build\fixwin32mak.pl + </code></p></div> + + <p>Vous devez ex챕cuter cette commande depuis la <em>racine</em> de + l'arborescence des sources de httpd. Tout fichier projet + <code>.mak</code> et <code>.dep</code> du r챕pertoire courant et de + ses sous-r챕pertoires sera corrig챕, et les rep챔res de temps ajust챕s + en fonction des <code>.dsp</code>.</p> + + <p>V챕rifiez toujours le SDK de la plate-forme ou autres chemins + fichiers locaux, sp챕cifiques 횪 la machine dans les fichiers + <code>.mak</code> et <code>.dep</code> g챕n챕r챕s. Le r챕pertoire + <code>DevStudio\Common\MSDev98\bin\</code> (VC6) contient un fichier + <code>sysincl.dat</code> qui 챕num챔re toutes les exceptions. Mettez 횪 + jour ce fichier (en particulier les chemins avec slashes et + anti-slashes, tels que <code>sys/time.h</code> et + <code>sys\time.h</code>) de fa챌on 횪 ignorer ces nouvelles + d챕pendances. Inclure les chemins d'installation locale dans un + fichier <code>.mak</code> distribu챕 fera 챕chouer la + compilation.</p> + + <p>Si vous soumettez un patch qui modifie les fichiers projet, nous + devons valider la modification de ces fichiers projet au format + Visual Studio 6.0. Les modifications doivent 챗tres simples, avec un + minimum de drapeaux de compilation et d'챕dition de liens qui + pourront 챗tre reconnus par tous les environnements Visual + Studio.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="installation" id="installation">Installation</a></h2> + + + + + <p>Une fois compil챕, Apache doit 챗tre install챕 dans le r챕pertoire + racine du serveur. La valeur par d챕faut est le r챕pertoire + <code>\Apache2</code>, sur le m챗me disque.</p> + + <p>Pour compiler et installer automatiquement tous les fichiers dans + le r챕pertoire <em>rep</em> d챕sir챕, utilisez une des commandes + <code>nmake</code> suivantes :</p> + + <div class="example"><p><code> + nmake /f Makefile.win installr INSTDIR=<em>dir</em><br /> + nmake /f Makefile.win installd INSTDIR=<em>dir</em> + </code></p></div> + + <p>L'argument <em>rep</em> de <code>INSTDIR</code> permet de + sp챕cifier le r챕pertoire d'installation ; il peut 챗tre omis si Apache + doit 챗tre install챕 dans <code>\Apache22</code> (du lecteur de disque + courant.</p> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="projectcomponents-warn" id="projectcomponents-warn">Avertissement 횪 propos de la compilation d'Apache 횪 partir de +l'arborescence de d챕veloppement</a></h2> + + + + <div class="note">Notez que seuls les fichiers <code>.dsp</code> sont + maintenus d'une distribution <code>release</code> 횪 l'autre. Les + fichiers <code>.mak</code> ne sont PAS r챕g챕n챕r챕s, suite 횪 + l'챕norme perte de temps des relecteurs . Vous ne + pouvez donc pas utiliser les commandes <code>NMAKE</code> + ci-dessus pour compiler des fichiers de projet <code>.dsp</code> + r챕vis챕s si vous n'exporter pas ensuite vous-m챗me tous les + fichiers <code>.mak</code> du projet. Ceci n'est pas n챕cessaire + si vous effectuez la compilation depuis l'environnement + Microsoft Developer Studio.</div> + +</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="cmake" id="cmake">Compilation de httpd avec cmake</a></h2> + + + <p>La documentation principale pour ce m챕canisme de compilation se trouve + dans le fichier <code>README.cmake</code> situ챕 dans l'arborescence + des sources. Consultez ce fichier pour des instructions d챕taill챕es.</p> + + <p>Pour compiler httpd avec cmake, vous devez compiler APR et APR-util + s챕par챕ment. Consultez les fichiers <code>README.cmake</code> de ces + projets pour obtenir des instructions.</p> + + <p>Les principales limitations de la compilation bas챕e sur cmake sont + h챕rit챕es du projet APR-util et sont 챕num챕r챕es ci-dessous 횪 cause de + leur impact sur httpd :</p> + + <ul> + <li>Il n'est pas possible de compiler le projet APR-iconv avec + cmake, et la compilation de APR-util ne peut pas utiliser de projet + APR-iconv pr챕compil챕. A cause de cela, il n'est pas possible + d'utiliser <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code> et probablement + d'autres modules tiers.</li> + <li>La compilation du sous-projet APR-util avec cmake ne supporte + pas la plupart des biblioth챔ques optionnelles DBM et DBD utilis챕es + par les fichiers projet Visual Studio inclus. Cela limite les + serveurs de bases de donn챕es d'arri챔re-plan support챕s par de + nombreux modules tiers ou inclus.</li> + </ul> + + </div></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/win_compiling.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/win_compiling.html" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/win_compiling.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/win_compiling.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Autoris챕 sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/win_compiling.html.ko.euc-kr b/docs/manual/platform/win_compiling.html.ko.euc-kr new file mode 100644 index 0000000..38e8ecd --- /dev/null +++ b/docs/manual/platform/win_compiling.html.ko.euc-kr @@ -0,0 +1,448 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head> +<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Microsoft Windows용 아파치 컴파일 - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Microsoft Windows용 아파치 컴파일</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/platform/win_compiling.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/win_compiling.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/win_compiling.html" title="Korean"> ko </a></p> +</div> +<div class="outofdate">이 문서는 최신판 번역이 아닙니다. + 최근에 변경된 내용은 영어 문서를 참고하세요.</div> + + + <p>아파치를 컴파일하기 전에 주의할 점이 많다. 미리 <a href="windows.html">Microsoft Windows에서 아파치 사용법</a>을 + 참고하라.</p> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#requirements">요구사항</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#commandbuild">명령행에서 컴파일하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#workspacebuild">Developer Studio Workspace IDE에서 컴파일하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#projectcomponents">프로젝트 구성요소</a></li> +</ul><h3>참고</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="requirements" id="requirements">요구사항</a></h2> + + + + <p>아파치를 컴파일하려면 다음이 정상적으로 설치되야 한다:</p> + + <ul> + <li> + <p>디스크 공간</p> + <p>남은 디스크 공간이 최소한 50 MB는 되야 한다. 아파치 + 설치후에는 빨리 증가하는 로그와 캐쉬파일을 제외하고 + 약 10 MB 정도가 필요하다. 실제 디스크 사용량은 선택한 + 구성과 제삼자가 만든 모듈 혹은 라이브러리에 따라 크게 + 다르다.</p> + </li> + + <li> + <p>Microsoft Visual C++ 5.0 이상.</p> + <p>아파치는 명령행 도구를 사용하거나 Visual Studio IDE + Workbench 안에서 컴파일할 수 있다. 명령행에서 컴파일한다면 + <code>vcvars32</code> 배치파일이 설정하는 <code>PATH</code>, + <code>INCLUDE</code>, <code>LIB</code> 등 환경변수가 + 필요하다:</p> + + <div class="example"><p><code> + "c:\Program Files\DevStudio\VC\Bin\vcvars32.bat" + </code></p></div> + </li> + + <li> + <p>Windows Platform SDK.</p> + <p>어떤 아파치 기능을 사용하려면 Visual C++ 5.0에 추가로 + 최신 Microsoft Windows Platform SDK가 필요하다. 명령행에서 + 컴파일한다면 <code>setenv</code> 배치파일이 Platform + SDK 환경을 만든다:</p> + + <div class="example"><p><code> + "c:\Program Files\Platform SDK\setenv.bat" + </code></p></div> + + <p>Visual C++ 6.0 이상에 포함된 Platform SDK 파일은 + 충분하다. 이 버전을 사용하는 사용자는 이 과정을 생략해도 + 된다.</p> + + <div class="note">모든 <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code> 기능을 사용하려면 + 최신 Windows Platform SDK가 필요하다. 최신 버전이 아니면 + MSVC++ 5.0은 <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code> 기능의 일부를 + 사용할 수 없다고 경고한다. <a href="http://msdn.microsoft.com/downloads/sdks/platform/platform.asp">http://msdn.microsoft.com/downloads/sdks/platform/platform.asp</a>에 + 최신 버전이 있다.</div> + </li> + + <li> + <p>awk 도구 (awk, gawk 등).</p> + <p>컴파일한 시스템에 아파치를 설치하려면 + <code>awk.exe</code> 도구를 사용하여 여러 파일을 수정해야 + 한다. (Perl이나 WSH/VB과 비교하여) 다운받기에 매우 작고 + 파일 생성 작업이 가능하여 awk를 선택했다. Brian Kernighan의 + <a href="http://cm.bell-labs.com/cm/cs/who/bwk/">http://cm.bell-labs.com/cm/cs/who/bwk/</a> 사이트에 + 컴파일된 Win32 실행파일 <a href="http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe">http://cm.bell-labs.com/cm/cs/who/bwk/awk95.exe</a>이 + 있다. 이름을 <code>awk95.exe</code> 대신 + <code>awk.exe</code>로 변경해야 한다.</p> + + <div class="note">Developer Studio IDE는 Tools 메뉴 Options... + Directories 탭의 (Developer Studio 7.0이라면 Projects + - VC++ Directories pane) Executable files 경로 목록에서만 + <code>awk.exe</code>를 찾는다. 이 목록에 <code>awk.exe</code> + 경로를 추가하고, 필요하다면 <code>PATH</code> 환경변수에도 + 추가한다.</div> + + <div class="note">Cygwin을 (<a href="http://www.cygwin.com/">http://www.cygwin.com/</a>) 사용한다면 + <code>gawk.exe</code>라는 이름으로 awk 도구가 있으며, + <code>awk.exe</code> 파일은 <code>gawk.exe</code> 파일의 + 심볼링크임을 주의하라. Windows 명령 프롬프트가 심볼링크를 + 인식하지 못하기때문에 InstallBin을 컴파일할때 실패한다. + 해결책은 cygwin에서 <code>awk.exe</code>를 삭제하고 + <code>gawk.exe</code> 이름을 <code>awk.exe</code>로 + 바꾼다.</div> + </li> + + <li> + <p>[선택적인] OpenSSL 라이브러리 (<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>과 + <code>ab.exe</code>의 ssl 지원에 사용)</p> + <p><strong>주의: 강력한 암호화와 특허가 걸린 지적재산권을 + 전세계에 배포하는데는 상당한 제약이 있다.</strong> + OpenSSL은 미국 수출규제법이 규제하며 미국과 기타 지역에서 + 특허로 보호되는 지적재산권인 강력한 암호화를 포함한다. + Apache Software Foundation과 OpenSSL 프로젝트는 OpenSSL + 프로젝트가 제공하는 코드를 소유, 사용, 배포하는데 따른 + 법적 자문을 제공하지 않는다. <strong>직접 법률 상담을 + 받길 바란다. 당신 행동의 책임은 당신에게 있다.</strong></p> + + <p><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>이나 (SSL을 지원하는 + <code>ab.exe</code>) abs 프로젝트를 컴파일하려면, OpenSSL을 + <a href="http://www.openssl.org/source/">http://www.openssl.org/source/</a>에서 다운받아서 + <code>srclib</code>의 <code>openssl</code>이라는 + 하위디렉토리에 설치해야 한다. <code>release</code>와 + <code>debug</code>로 아파치를 컴파일할때 사용하며 0.9.7 + 버전에 있는 특허가 걸린 기능을 사용하지 않는다면, 아래 + 컴파일 명령어를 사용한다:</p> + + <div class="example"><p><code> + perl Configure VC-WIN32<br /> + perl util\mkfiles.pl >MINFO<br /> + perl util\mk1mf.pl dll no-asm no-mdc2 no-rc5 no-idea VC-WIN32 >makefile<br /> + perl util\mk1mf.pl dll debug no-asm no-mdc2 no-rc5 no-idea VC-WIN32 >makefile.dbg<br /> + perl util\mkdef.pl 32 libeay no-asm no-mdc2 no-rc5 no-idea >ms\libeay32.def<br /> + perl util\mkdef.pl 32 ssleay no-asm no-mdc2 no-rc5 no-idea >ms\ssleay32.def<br /> + nmake<br /> + nmake -f makefile.dbg + </code></p></div> + + </li> + + <li> + <p>[선택적인] zlib 소스 (<code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>에 + 사용)</p> + <p>Zlib을 <code>srclib</code>의 <code>zlib</code>라는 + 하위디렉토리에 설치해야 하지만, 소스를 미리 컴파일할 + 필요는 없다. 컴파일 시스템은 이 압축소스를 + <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> 모듈과 같이 컴파일한다. + Zlib은 <a href="http://www.gzip.org/zlib/">http://www.gzip.org/zlib/</a>에서 구할 수 있다 -- + <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>는 1.1.4 버전과 정상적으로 + 컴파일되었다.</p> + </li> + + </ul> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="commandbuild" id="commandbuild">명령행에서 컴파일하기</a></h2> + + + + <p>먼저 적당한 디렉토리에 아파치 배포본 압축을 푼다. 명령행 + 프롬프트를 열고 그 디렉토리로 <code>cd</code>한다.</p> + + <p><code>Makefile.win</code> 파일에 아파치 makefile 명령이 + 있다. Windows NT에서 <code>release</code>와 <code>debug</code> + 컴파일하는 명령어는 각각 다음과 같다:</p> + + <div class="example"><pre>nmake /f Makefile.win _apacher + +nmake /f Makefile.win _apached</pre></div> + + <p>두 명령어 모두 아파치를 컴파일한다. 후자는 결과파일에 + 디버깅 정보를 포함하여 버그를 찾고 문제를 추적하기 쉽게 + 한다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="workspacebuild" id="workspacebuild">Developer Studio Workspace IDE에서 컴파일하기</a></h2> + + + + <p>VC++의 Visual Studio 개발 환경을 사용하여 아파치를 컴파일할 + 수도 있다. 과정을 쉽게 하려고 Visual Studio workspace + <code>Apache.dsw</code>를 제공한다. 이 workspace는 완전한 + 아파치 바이너리 배포본에 필요한 <code>.dsp</code> 프로젝트 + 목록을 담고있다. 또, 알맞은 순서로 컴파일하기위한 프로젝트간 + 의존성 정보도 포함한다.</p> + + <p><code>Apache.dsw</code> workspace를 열고 + <code>InstallBin</code>을 (<code>Release</code>나 + <code>Debug</code> 중 원하는 것을) Active Project로 선택한다. + <code>InstallBin</code>은 관련된 모든 프로젝트를 컴파일하고, + 컴파일된 실행파일과 dll을 옮기는 <code>Makefile.win</code>을 + 호출한다. <code>InstallBin</code>의 Settings, General 탭, + Build command line 항목을 수정하여 <code>INSTDIR=</code>을 + 변경할 수 있다. <code>INSTDIR=</code> 기본값은 + <code>/Apache2</code> 디렉토리이다. (설치하지않고) 테스트로 + 컴파일만 해보려면 대신 <code>BuildBin</code> 프로젝트를 + 사용한다.</p> + + <p><code>.dsp</code> 프로젝트 파일은 Visual C++ 6.0 형식이다. + Visual C++ 5.0 (97)에서도 이 파일을 사용할 수 있다. Visual + C++ 7.0 (.net)은 <code>Apache.dsw</code>와 <code>.dsp</code> + 파일들을 <code>Apache.sln</code>과 <code>.msproj</code> + 파일들로 변환한다. <code>.dsp</code> 소스파일을 수정하면 + 반드시 <code>.msproj</code> 파일로 다시 변환하라! 그냥 VC++ + 7.0 IDE에서 <code>Apache.dsw</code>를 다시 열기만 하면 된다.</p> + + <p>또, Visual C++ 7.0 (.net) 사용자는 Build 메뉴, Configuration + Manager 대화창에서 <code>Debug</code>와 <code>Release</code>의 + abs, <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>, <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> + Solution modules 선택을 해제해야 한다. <code>srclib</code>에 + <code>openssl</code>이나 <code>zlib</code> 디렉토리가 있는 + 경우에만 <code>nmake</code>를 실행하거나 (이 모듈을 명시적으로 + 컴파일하는) IDE <code>BinBuild</code> 대상을 사용하여 모듈을 + 컴파일 할 수 있다.</p> + + <p>Export한 <code>.mak</code> 파일들이 혼란스럽지만, Visual + C++ 5.0 사용자가 <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>, abs (SSL을 지원하는 + ab), <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>를 컴파일할때 필요하다. + VC++ 7.0 (.net) 사용자에게도 <code>binenv</code> 보다 + <code>nmake</code>를 사용하면 컴파일이 더 빠르다. VC++ 5.0이나 + 6.0 IDE에서 전체 프로젝트를 컴파일하고, Project 메뉴의 Export + for all makefiles를 사용하라. 동적으로 자동 생성하는 대상을 + 모두 컴파일하고 올바른 의존성 정보를 얻기위해서는 먼저 + 프로젝트를 컴파일해야 한다. 다음 명령어를 사용하여 경로를 + 수정하면 어떤 경로에서도 컴파일할 수 있다:</p> + + <div class="example"><p><code> + perl srclib\apr\build\fixwin32mak.pl + </code></p></div> + + <p><code>httpd</code> 소스 <em>최상위</em> 디렉토리에서 + 명령어를 실행해야 한다. 현재 디렉토리와 하위디렉토리에 있는 + 모든 <code>.mak</code>와 <code>.dep</code> 프로젝트파일을 + 수정하고, <code>.dsp</code>를 고려하여 파일시간을 수정한다.</p> + + <p>프로젝트파일을 다듬어서 패치를 보낸다면, 프로젝트파일을 + Visual Studio 6.0 형식으로 만들어야 한다. 변경은 간단하고, + VC++ 5.0에서 7.0까지 모든 환경에서 인식하는 최소한의 컴파일 + 옵션과 링커 옵션을 사용해야 한다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="projectcomponents" id="projectcomponents">프로젝트 구성요소</a></h2> + + + + <p><code>Apache.dsw</code> workspace와 <code>makefile.win</code> + <code>nmake</code> 스크립트는 다음 순서대로 아파치 서버 + <code>.dsp</code> 프로젝트를 컴파일한다:</p> + + <ol> + <li><code>srclib\apr\apr.dsp</code></li> + + <li><code>srclib\apr\libapr.dsp</code></li> + + <li><code>srclib\apr-util\uri\gen_uri_delims.dsp</code></li> + + <li><code>srclib\apr-util\xml\expat\lib\xml.dsp</code></li> + + <li><code>srclib\apr-util\aprutil.dsp</code></li> + + <li><code>srclib\apr-util\libaprutil.dsp</code></li> + + <li><code>srclib\pcre\dftables.dsp</code></li> + + <li><code>srclib\pcre\pcre.dsp</code></li> + + <li><code>srclib\pcre\pcreposix.dsp</code></li> + + <li><code>server\gen_test_char.dsp</code></li> + + <li><code>libhttpd.dsp</code></li> + + <li><code>Apache.dsp</code></li> + </ol> + + <p>또, <code>modules\</code> 하위디렉토리 아래 대부분의 + 모듈에는 프로젝트파일이 있다.</p> + + <p><code>support\</code> 디렉토리에는 아파치를 실행하는데 + 필요하지는 않지만, 관리자가 아파치를 검사하거나 암호파일과 + 로그파일을 관리하는데 사용할 추가 프로그램들의 프로젝트파일이 + 있다. Windows 전용 지원 프로그램은 <code>support\win32\</code> + 디렉토리에 따로 있다.</p> + + <ol> + <li><code>support\ab.dsp</code></li> + + <li><code>support\htdigest.dsp</code></li> + + <li><code>support\htpasswd.dsp</code></li> + + <li><code>support\logresolve.dsp</code></li> + + <li><code>support\rotatelogs.dsp</code></li> + + <li><code>support\win32\ApacheMonitor.dsp</code></li> + + <li><code>support\win32\wintty.dsp</code></li> + </ol> + + <p>아파치를 컴파일하면 server root 디렉토리에 설치해야 한다. + 기본값은 같은 디스크의 <code>\Apache2</code> 디렉토리이다.</p> + + <p>컴파일하고 모든 파일을 원하는 폴더 <em>dir</em>에 자동으로 + 설치하려면 다음 <code>nmake</code> 명령어중 하나를 사용한다:</p> + + <div class="example"><pre>nmake /f Makefile.win installr INSTDIR=<em>dir</em> + +nmake /f Makefile.win installd INSTDIR=<em>dir</em> + </pre></div> + + <p><code>INSTDIR</code>의 <em>dir</em> 아규먼트는 설치디렉토리를 + 뜻한다. 생락하면 <code>\Apache2</code>에 아파치를 설치한다.</p> + + <p>다음과 같이 설치한다:</p> + + <ul> + <li><code><em>dir</em>\bin\Apache.exe</code> - 아파치 + 실행파일</li> + + <li><code><em>dir</em>\bin\ApacheMonitor.exe</code> - + 서비스 감시용 작업표시줄 아이콘 도구</li> + + <li><code><em>dir</em>\bin\htdigest.exe</code> - Digest + auth 암호파일 도구</li> + + <li><code><em>dir</em>\bin\htdbm.exe</code> - SDBM auth + 데이터베이스 암호파일 도구</li> + + <li><code><em>dir</em>\bin\htpasswd.exe</code> - Basic + auth 암호파일 도구</li> + + <li><code><em>dir</em>\bin\logresolve.exe</code> - 로그파일에서 + dns 이름을 찾는 도구</li> + + <li><code><em>dir</em>\bin\rotatelogs.exe</code> - 로그파일 + 순환 도구</li> + + <li><code><em>dir</em>\bin\wintty.exe</code> - 콘솔창 + 도구</li> + + <li><code><em>dir</em>\bin\libapr.dll</code> - Apache + Portable Runtime 공유 라이브러리</li> + + <li><code><em>dir</em>\bin\libaprutil.dll</code> - Apache + Utility Runtime 공유 라이브러리</li> + + <li><code><em>dir</em>\bin\libhttpd.dll</code> - Apache + Core 라이브러리</li> + + <li><code><em>dir</em>\modules\mod_*.so</code> - 읽어들일 + 수 있는 아파치 모듈</li> + + <li><code><em>dir</em>\conf</code> - 설정 디렉토리</li> + + <li><code><em>dir</em>\logs</code> - 비어있는 로그 + 디렉토리</li> + + <li><code><em>dir</em>\include</code> - C 언어 헤더파일</li> + + <li><code><em>dir</em>\lib</code> - 링크 라이브러리파일</li> + </ul> + + <h3><a name="projectcomponents-warn" id="projectcomponents-warn">개발중인 아파치 버전을 컴파일할때 경고</a></h3> + + + + <div class="note"><code>.dsp</code> 파일은 <code>release</code>마다 + 새로 만들어진다. 개발자의 시간낭비를 막기위해 + <code>.mak</code> 파일은 새로 만들지 않는다. 그러므로 + <code>NMAKE</code> 명령어를 사용하여 새로운 <code>.dsp</code> + 프로젝트파일을 컴파일할 수 없다. 프로젝트에서 직접 모든 + <code>.mak</code> 파일을 export해야 한다. Microsoft Developer + Studio 환경에서 컴파일한다면 이 작업이 필요없다.</div> + + <div class="note">또, makefile을 export하기 전에 <code>BuildBin</code> + 프로젝트를 (혹은 <code>_apacher</code>나 <code>_apached</code> + 명령행 대상) 컴파일하면 매우 도움이 된다. 컴파일중에 많은 + 파일이 자동으로 만들어진다. 전체를 컴파일해야만 정상적으로 + 컴파일할때 필요한 의존파일을 모두 만든다.</div> + + <p>배포용 <code>.mak</code> 파일을 만드려면 항상 + <code>.mak</code> (혹은 <code>.dep</code>)에서 Platform + SDK 등의 의존성을 점검하라. + <code>DevStudio\SharedIDE\bin\</code> (VC5)나 + <code>DevStudio\Common\MSDev98\bin\</code> (VC6) 디렉토리에는 + 모든 예외 목록이 담긴 <code>sysincl.dat</code> 파일이 + 있다. 이 파일에 의존성 정보를 추가한다 + (<code>sys/time.h</code>와 <code>sys\time.h</code>와 같이, + 경로는 슬래쉬를 사용한 것과 백슬래쉬를 사용한 것 모두를 + 추가한다). 배포할 <code>.mak</code> 파일에 현재 컴퓨터에만 + 해당하는 설치경로가 있다면 컴파일이 완전히 실패한다. + 그러므로 <code>srclib/apr/build/fixwin32mak.pl</code>을 + 실행해하여 <code>.mak</code> 파일에 있는 절대경로를 없애야 + 한다.</p> + + + + </div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/platform/win_compiling.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/win_compiling.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/win_compiling.html" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/win_compiling.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/windows.html b/docs/manual/platform/windows.html new file mode 100644 index 0000000..030298b --- /dev/null +++ b/docs/manual/platform/windows.html @@ -0,0 +1,13 @@ +# GENERATED FROM XML -- DO NOT EDIT + +URI: windows.html.en +Content-Language: en +Content-type: text/html; charset=UTF-8 + +URI: windows.html.fr.utf8 +Content-Language: fr +Content-type: text/html; charset=UTF-8 + +URI: windows.html.ko.euc-kr +Content-Language: ko +Content-type: text/html; charset=EUC-KR diff --git a/docs/manual/platform/windows.html.en b/docs/manual/platform/windows.html.en new file mode 100644 index 0000000..5f0ef46 --- /dev/null +++ b/docs/manual/platform/windows.html.en @@ -0,0 +1,664 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Using Apache HTTP Server on Microsoft Windows - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Using Apache HTTP Server on Microsoft Windows</h1> +<div class="toplang"> +<p><span>Available Languages: </span><a href="../en/platform/windows.html" title="English"> en </a> | +<a href="../fr/platform/windows.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/windows.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + <p>This document explains how to install, configure and run + Apache 2.4 under Microsoft Windows. If you have questions after + reviewing the documentation (and any event and error logs), you + should consult the peer-supported + <a href="http://httpd.apache.org/userslist.html">users' mailing + list</a>.</p> + + <p>This document assumes that you are installing a binary + distribution of Apache. If you want to compile Apache yourself + (possibly to help with development or tracking down bugs), + see <a href="win_compiling.html">Compiling Apache for Microsoft + Windows</a>.</p> + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#req">Operating System Requirements</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#down">Downloading Apache for Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cust">Customizing Apache for Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#winsvc">Running Apache as a Service</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#wincons">Running Apache as a Console Application</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#test">Testing the Installation</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#windrivemap">Configuring Access to Network Resources</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#tuning">Windows Tuning</a></li> +</ul><h3>See also</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="req" id="req">Operating System Requirements</a></h2> + + + <p>The primary Windows platform for running Apache 2.4 is Windows + 2000 or later. Always obtain and + install the current service pack to avoid operating system bugs.</p> + + <div class="note">Apache HTTP Server versions later than 2.2 will not run on any + operating system earlier than Windows 2000.</div> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="down" id="down">Downloading Apache for Windows</a></h2> + + + <p>The Apache HTTP Server Project itself does not provide binary releases of + software, only source code. Individual committers <em>may</em> provide + binary packages as a convenience, but it is not a release deliverable.</p> + <p>If you cannot compile the Apache HTTP Server + yourself, you can obtain a binary package from numerous binary distributions + available on the Internet.</p> + + <p>Popular options for deploying Apache httpd, and, optionally, PHP + and MySQL, on Microsoft Windows, include:</p> + <ul> + <li><a href="http://www.apachehaus.com/cgi-bin/download.plx">ApacheHaus</a></li> + <li><a href="http://www.apachelounge.com/download/">Apache Lounge</a></li> + <li><a href="http://bitnami.com/stack/wamp">Bitnami WAMP Stack</a></li> + <li><a href="http://www.wampserver.com/">WampServer</a></li> + <li><a href="http://www.apachefriends.org/en/xampp.html">XAMPP</a></li> + </ul> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="cust" id="cust">Customizing Apache for Windows</a></h2> + + + <p>Apache is configured by the files in the <code>conf</code> + subdirectory. These are the same files used to configure the Unix + version, but there are a few different directives for Apache on + Windows. See the <a href="../mod/directives.html">directive index</a> + for all the available directives.</p> + + <p>The main differences in Apache for Windows are:</p> + <ul> + <li><p>Because Apache for Windows is multithreaded, it does not + use a separate process for each request, as Apache can on Unix. + Instead there are usually only two Apache processes running: a + parent process, and a child which handles the requests. Within + the child process each request is handled by a separate thread. + </p> + + <p>The process management directives are also different:</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>: + Like the Unix directive, this controls how many connections a single + child process will serve before exiting. + However, unlike on Unix, a replacement process is not instantly + available. Use the default <code>MaxConnectionsPerChild 0</code>, + unless instructed to change the behavior to overcome a memory leak + in third party modules or in-process applications.</p> + + <div class="warning"><strong>Warning: The server configuration + file is reread when a new child process is started. If you have + modified <code>httpd.conf</code>, the new child may not start or + you may receive unexpected results.</strong></div> + + <p><code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>: + This directive is new. It tells the server how many threads it + should use. This is the maximum number of connections the server + can handle at once, so be sure to set this number high enough for + your site if you get a lot of hits. The recommended default is + <code>ThreadsPerChild 150</code>, but this must be adjusted to + reflect the greatest anticipated number of simultaneous + connections to accept.</p></li> + + <li><p>The directives that accept filenames as arguments must use + Windows filenames instead of Unix ones. However, because Apache + may interpret backslashes as an "escape character" sequence, you + should consistently use forward slashes in path names, not + backslashes.</p></li> + + <li><p>While filenames are generally case-insensitive on + Windows, URLs are still treated internally as case-sensitive + before they are mapped to the filesystem. For example, the + <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, + <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, and <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> directives all use + case-sensitive arguments. For this reason, it is particularly + important to use the <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> directive when attempting + to limit access to content in the filesystem, since this + directive applies to any content in a directory, regardless of + how it is accessed. If you wish to assure that only lowercase + is used in URLs, you can use something like:</p> + + <pre class="prettyprint lang-config">RewriteEngine On +RewriteMap lowercase int:tolower +RewriteCond "%{REQUEST_URI}" "[A-Z]" +RewriteRule "(.*)" "${lowercase:$1}" [R,L]</pre> +</li> + + <li><p>When running, Apache needs write access only to the logs + directory and any configured cache directory tree. Due to the + issue of case insensitive and short 8.3 format names, Apache must + validate all path names given. This means that each directory + which Apache evaluates, from the drive root up to the directory + leaf, must have read, list and traverse directory permissions. + If Apache2.4 is installed at C:\Program Files, then the root + directory, Program Files and Apache2.4 must all be visible + to Apache.</p></li> + + <li><p>Apache for Windows contains the ability to load modules at + runtime, without recompiling the server. If Apache is compiled + normally, it will install a number of optional modules in the + <code>\Apache2.4\modules</code> directory. To activate these or + other modules, the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> + directive must be used. For example, to activate the status + module, use the following (in addition to the status-activating + directives in <code>access.conf</code>):</p> + + <pre class="prettyprint lang-config">LoadModule status_module "modules/mod_status.so"</pre> + + + <p>Information on <a href="../mod/mod_so.html#creating">creating + loadable modules</a> is also available.</p></li> + + <li><p>Apache can also load ISAPI (Internet Server Application + Programming Interface) extensions such as those used by Microsoft + IIS and other Windows servers. <a href="../mod/mod_isapi.html">More + information is available</a>. Note that Apache <strong>cannot</strong> + load ISAPI Filters, and ISAPI Handlers with some Microsoft feature + extensions will not work.</p></li> + + <li><p>When running CGI scripts, the method Apache uses to find + the interpreter for the script is configurable using the + <code class="directive"><a href="../mod/core.html#scriptinterpretersource">ScriptInterpreterSource</a></code> + directive.</p></li> + + <li><p>Since it is often difficult to manage files with names + like <code>.htaccess</code> in Windows, you may find it useful to + change the name of this per-directory configuration file using + the <code class="directive"><a href="../mod/core.html#accessfilename">AccessFilename</a></code> + directive.</p></li> + + <li><p>Any errors during Apache startup are logged into the + Windows event log when running on Windows NT. This mechanism + acts as a backup for those situations where Apache is not yet + prepared to use the <code>error.log</code> file. You can + review the Windows Application Event Log by using the Event Viewer, + e.g. Start - Settings - Control Panel - Administrative Tools + - Event Viewer.</p></li> + </ul> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="winsvc" id="winsvc">Running Apache as a Service</a></h2> + + + <p>Apache comes with a utility called the Apache Service Monitor. + With it you can see and manage the state of all installed Apache + services on any machine on your network. To be able to manage an + Apache service with the monitor, you have to first install the + service (either automatically via the installation or manually). + </p> + + <p>You can install Apache as a Windows NT service as follows from + the command prompt at the Apache <code>bin</code> subdirectory:</p> + + <div class="example"><p><code> + httpd.exe -k install + </code></p></div> + + <p>If you need to specify the name of the service you want to + install, use the following command. You have to do this if you + have several different service installations of Apache on your + computer. If you specify a name during the install, you have to + also specify it during any other -k operation.</p> + + <div class="example"><p><code> + httpd.exe -k install -n "MyServiceName" + </code></p></div> + + <p>If you need to have specifically named configuration files for + different services, you must use this:</p> + + <div class="example"><p><code> + httpd.exe -k install -n "MyServiceName" -f "c:\files\my.conf" + </code></p></div> + + <p>If you use the first command without any special parameters except + <code>-k install</code>, the service will be called <code>Apache2.4</code> + and the configuration will be assumed to be <code>conf\httpd.conf</code>. + </p> + + <p>Removing an Apache service is easy. Just use:</p> + + <div class="example"><p><code> + httpd.exe -k uninstall + </code></p></div> + + <p>The specific Apache service to be uninstalled can be specified by using:</p> + + <div class="example"><p><code> + httpd.exe -k uninstall -n "MyServiceName" + </code></p></div> + + <p>Normal starting, restarting and shutting down of an Apache + service is usually done via the Apache Service Monitor, by using + commands like <code>NET START Apache2.4</code> and <code>NET STOP + Apache2.4</code> or via normal Windows service management. Before + starting Apache as a service by any means, you should test the + service's configuration file by using:</p> + + <div class="example"><p><code> + httpd.exe -n "MyServiceName" -t + </code></p></div> + + <p>You can control an Apache service by its command line switches, + too. To start an installed Apache service you'll use this:</p> + + <div class="example"><p><code> + httpd.exe -k start -n "MyServiceName" + </code></p></div> + + <p>To stop an Apache service via the command line switches, use + this:</p> + + <div class="example"><p><code> + httpd.exe -k stop -n "MyServiceName" + </code></p></div> + + <p>or</p> + + <div class="example"><p><code> + httpd.exe -k shutdown -n "MyServiceName" + </code></p></div> + + <p>You can also restart a running service and force it to reread + its configuration file by using:</p> + + <div class="example"><p><code> + httpd.exe -k restart -n "MyServiceName" + </code></p></div> + + <p>By default, all Apache services are registered to run as the + system user (the <code>LocalSystem</code> account). The + <code>LocalSystem</code> account has no privileges to your network + via any Windows-secured mechanism, including the file system, named + pipes, DCOM, or secure RPC. It has, however, wide privileges locally. + </p> + + <div class="warning"><strong>Never grant any network privileges to + the <code>LocalSystem</code> account! If you need Apache to be able + to access network resources, create a separate account for Apache as + noted below.</strong></div> + + <p>It is recommended that users create a separate account for running + Apache service(s). If you have to access network resources via Apache, + this is required.</p> + + <ol> + <li>Create a normal domain user account, and be sure to + memorize its password.</li> + + <li>Grant the newly-created user a privilege of <code>Log on + as a service</code> and <code>Act as part of the operating + system</code>. On Windows NT 4.0 these privileges are granted via + User Manager for Domains, but on Windows 2000 and XP you probably + want to use Group Policy for propagating these settings. You can + also manually set these via the Local Security Policy MMC snap-in. + </li> + + <li>Confirm that the created account is a member of the Users + group.</li> + + <li>Grant the account read and execute (RX) rights to all document + and script folders (<code>htdocs</code> and <code>cgi-bin</code> + for example).</li> + + <li>Grant the account change (RWXD) rights to the + Apache <code>logs</code> directory.</li> + + <li>Grant the account read and execute (RX) rights to the + <code>httpd.exe</code> binary executable.</li> + </ol> + + <div class="note">It is usually a good practice to grant the user the Apache + service runs as read and execute (RX) access to the whole Apache2.4 + directory, except the <code>logs</code> subdirectory, where the + user has to have at least change (RWXD) rights.</div> + + <p>If you allow the account to log in as a user and as a service, + then you can log on with that account and test that the account has + the privileges to execute the scripts, read the web pages, and that + you can start Apache in a console window. If this works, and you + have followed the steps above, Apache should execute as a service + with no problems.</p> + + <div class="note"><strong>Error code 2186</strong> is a good indication that + you need to review the "Log On As" configuration for the service, + since Apache cannot access a required network resource. Also, pay + close attention to the privileges of the user Apache is + configured to run as.</div> + + <p>When starting Apache as a service you may encounter an error + message from the Windows Service Control Manager. For example, + if you try to start Apache by using the Services applet in the + Windows Control Panel, you may get the following message:</p> + + <div class="example"><p><code> + Could not start the Apache2.4 service on \\COMPUTER <br /> + Error 1067; The process terminated unexpectedly. + </code></p></div> + + <p>You will get this generic error if there is any problem with + starting the Apache service. In order to see what is really causing + the problem you should follow the instructions for Running Apache + for Windows from the Command Prompt.</p> + + <p>If you are having problems with the service, it is suggested + you follow the instructions below to try starting httpd.exe from + a console window, and work out the errors before struggling to + start it as a service again.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="wincons" id="wincons">Running Apache as a Console Application</a></h2> + + + <p>Running Apache as a service is usually the recommended way to + use it, but it is sometimes easier to work from the command line, + especially during initial configuration and testing.</p> + + <p>To run Apache from the command line as a console application, + use the following command:</p> + + <div class="example"><p><code> + httpd.exe + </code></p></div> + + <p>Apache will execute, and will remain running until it is stopped + by pressing Control-C.</p> + + <p>You can also run Apache via the shortcut Start Apache in Console + placed to <code>Start Menu --> Programs --> Apache HTTP Server + 2.4.xx --> Control Apache Server</code> during the installation. + This will open a console window and start Apache inside it. If you + don't have Apache installed as a service, the window will remain + visible until you stop Apache by pressing Control-C in the console + window where Apache is running in. The server will exit in a few + seconds. However, if you do have Apache installed as a service, the + shortcut starts the service. If the Apache service is running + already, the shortcut doesn't do anything.</p> + + <p>If Apache is running as a service, you can tell it to stop by opening another console + window and entering:</p> + + <div class="example"><p><code> + httpd.exe -k shutdown + </code></p></div> + + <p>Running as a service should be preferred over running in a + console window because this lets Apache end any current operations + and clean up gracefully.</p> + + <p>But if the server is running in a console window, you can + only stop it by pressing Control-C in the same window.</p> + + <p>You can also tell Apache to restart. This forces it to reread + the configuration file. Any operations in progress are allowed to + complete without interruption. To restart Apache, either press + Control-Break in the console window you used for starting Apache, + or enter</p> + + <div class="example"><p><code> + httpd.exe -k restart + </code></p></div> + + <p>if the server is running as a service.</p> + + <div class="note">Note for people familiar with the Unix version of Apache: + these commands provide a Windows equivalent to <code>kill -TERM + <em>pid</em></code> and <code>kill -USR1 <em>pid</em></code>. The + command line option used, <code>-k</code>, was chosen as a reminder + of the <code>kill</code> command used on Unix.</div> + + <p>If the Apache console window closes immediately or unexpectedly + after startup, open the Command Prompt from the Start Menu --> + Programs. Change to the folder to which you installed Apache, type + the command <code>httpd.exe</code>, and read the error message. Then + change to the logs folder, and review the <code>error.log</code> + file for configuration mistakes. Assuming httpd was installed into + <code>C:\Program Files\Apache Software Foundation\Apache2.4\</code>, + you can do the following:</p> + + <div class="example"><p><code> + c: <br /> + cd "\Program Files\Apache Software Foundation\Apache2.4\bin" <br /> + httpd.exe + </code></p></div> + + <p>Then wait for Apache to stop, or press Control-C. Then enter the + following:</p> + + <div class="example"><p><code> + cd ..\logs <br /> + more < error.log + </code></p></div> + + <p>When working with Apache it is important to know how it will + find the configuration file. You can specify a configuration file + on the command line in two ways:</p> + + <ul> + <li><p><code>-f</code> specifies an absolute or relative path to + a particular configuration file:</p> + + <div class="example"><p><code> + httpd.exe -f "c:\my server files\anotherconfig.conf" + </code></p></div> + + <p>or</p> + + <div class="example"><p><code> + httpd.exe -f files\anotherconfig.conf + </code></p></div></li> + + <li><p><code>-n</code> specifies the installed Apache service + whose configuration file is to be used:</p> + + <div class="example"><p><code> + httpd.exe -n "MyServiceName" + </code></p></div> + </li> + </ul> + + <p>In both of these cases, the proper + <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> should be set in + the configuration file.</p> + + <p>If you don't specify a configuration file with <code>-f</code> + or <code>-n</code>, Apache will use the file name compiled into the + server, such as <code>conf\httpd.conf</code>. This built-in path + is relative to the installation directory. You can verify the compiled + file name from a value labelled as <code>SERVER_CONFIG_FILE</code> when + invoking Apache with the <code>-V</code> switch, like this:</p> + + <div class="example"><p><code> + httpd.exe -V + </code></p></div> + + <p>Apache will then try to determine its <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> by trying the following, in this order:</p> + + <ol> + <li>A <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> directive + via the <code>-C</code> command line switch.</li> + + <li>The <code>-d</code> switch on the command line.</li> + + <li>Current working directory.</li> + + <li>A registry entry which was created if you did a binary + installation.</li> + + <li>The server root compiled into the server. This is <code> + /apache</code> by default, you can verify it by using <code> + httpd.exe -V</code> and looking for a value labelled as + <code>HTTPD_ROOT</code>.</li> + </ol> + + <p>If you did not do a binary install, Apache will in some + scenarios complain about the missing registry key. This warning can + be ignored if the server was otherwise able to find its + configuration file.</p> + + <p>The value of this key is the + <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> directory which + contains the <code>conf</code> subdirectory. When Apache starts it + reads the <code>httpd.conf</code> file from that directory. If + this file contains a <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> + directive which contains a different directory from the one + obtained from the registry key above, Apache will forget the + registry key and use the directory from the configuration file. If + you copy the Apache directory or configuration files to a new + location it is vital that you update the + <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> directive in the + <code>httpd.conf</code> file to reflect the new location.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="test" id="test">Testing the Installation</a></h2> + + + <p>After starting Apache (either in a console window or as a + service) it will be listening on port 80 (unless you changed the + <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> directive in the + configuration files or installed Apache only for the current user). + To connect to the server and access the default page, launch a + browser and enter this URL:</p> + + <div class="example"><p><code> + http://localhost/ + </code></p></div> + + <p>Apache should respond with a welcome page and you should see + "It Works!". If nothing happens or you get an error, look in the + <code>error.log</code> file in the <code>logs</code> subdirectory. + If your host is not connected to the net, or if you have serious + problems with your DNS (Domain Name Service) configuration, you + may have to use this URL:</p> + + <div class="example"><p><code> + http://127.0.0.1/ + </code></p></div> + + <p>If you happen to be running Apache on an alternate port, you + need to explicitly put that in the URL:</p> + + <div class="example"><p><code> + http://127.0.0.1:8080/ + </code></p></div> + + <p>Once your basic installation is working, you should configure it + properly by editing the files in the <code>conf</code> subdirectory. + Again, if you change the configuration of the Windows NT service + for Apache, first attempt to start it from the command line to + make sure that the service starts with no errors.</p> + + <p>Because Apache <strong>cannot</strong> share the same port with + another TCP/IP application, you may need to stop, uninstall or reconfigure + certain other services before running Apache. These conflicting + services include other WWW servers, some firewall implementations, + and even some client applications (such as Skype) which will use port + 80 to attempt to bypass firewall issues.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="windrivemap" id="windrivemap">Configuring Access to Network Resources</a></h2> + + + <p>Access to files over the network can be specified using two + mechanisms provided by Windows:</p> + + <dl> + <dt>Mapped drive letters</dt> + <dd>e.g., <code>Alias "/images/" "Z:/"</code></dd> + + <dt>UNC paths</dt> + <dd>e.g., <code>Alias "/images/" "//imagehost/www/images/"</code></dd> + </dl> + + <p>Mapped drive letters allow the administrator to maintain the + mapping to a specific machine and path outside of the Apache httpd + configuration. However, these mappings are associated only with + interactive sessions and are not directly available to Apache httpd + when it is started as a service. <strong>Use only UNC paths for + network resources in httpd.conf</strong> so that the resources can + be accessed consistently regardless of how Apache httpd is started. + (Arcane and error prone procedures may work around the restriction + on mapped drive letters, but this is not recommended.)</p> + + <div class="example"><h3>Example DocumentRoot with UNC path</h3><pre class="prettyprint lang-config">DocumentRoot "//dochost/www/html/"</pre> +</div> + + <div class="example"><h3>Example DocumentRoot with IP address in UNC path</h3><pre class="prettyprint lang-config">DocumentRoot "//192.168.1.50/docs/"</pre> +</div> + + <div class="example"><h3>Example Alias and corresponding Directory with UNC path</h3><pre class="prettyprint lang-config">Alias "/images/" "//imagehost/www/images/" + +<Directory "//imagehost/www/images/"> +#... +</Directory></pre> +</div> + + <p>When running Apache httpd as a service, you must create a + separate account in order to access network resources, as described + above.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="tuning" id="tuning">Windows Tuning</a></h2> + + <ul> + <li><p>If more than a few dozen piped loggers are used on an operating system + instance, scaling up the "desktop heap" is often necessary. For + more detailed information, refer to the <a href="../logs.html#piped">piped logging</a> documentation.</p></li> + </ul> + </div></div> +<div class="bottomlang"> +<p><span>Available Languages: </span><a href="../en/platform/windows.html" title="English"> en </a> | +<a href="../fr/platform/windows.html" hreflang="fr" rel="alternate" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/windows.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/windows.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/windows.html.fr.utf8 b/docs/manual/platform/windows.html.fr.utf8 new file mode 100644 index 0000000..efe641f --- /dev/null +++ b/docs/manual/platform/windows.html.fr.utf8 @@ -0,0 +1,718 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head> +<meta content="text/html; charset=UTF-8" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Utilisation du serveur HTTP Apache sous Microsoft Windows - Serveur HTTP Apache Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p> +<p class="apache">Serveur HTTP Apache Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Notes sp챕cifiques 횪 un + syst챔me</a></div><div id="page-content"><div id="preamble"><h1>Utilisation du serveur HTTP Apache sous Microsoft Windows</h1> +<div class="toplang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/windows.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/windows.html" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/windows.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div> + + + <p>Ce document d챕crit l'installation, la configuration et + l'ex챕cution d'Apache 2.4 sous Microsoft Windows. Si vous avez des + questions apr챔s avoir lu la documentation, ou si vous avez rencontr챕 + des 챕v챔nements particuliers ou des rapports d'erreur, vous pouvez + consultez la <a href="http://httpd.apache.org/userslist.html">liste + de diffusion de la communaut챕 des utilisateurs</a>.</p> + + <p>Dans ce document, nous supposons que vous installez une + distribution binaire d'Apache. Si vous voulez compiler Apache + vous-m챗me (par exemple pour aider au d챕veloppement ou pour + rechercher des bogues), r챕f챕rez-vous au document <a href="win_compiling.html">Compilation d'Apache pour Microsoft + Windows</a>.</p> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#req">Pr챕requis du syst챔me d'exploitation</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#down">T챕l챕chargement d'Apache pour Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cust">Personnaliser Apache pour Windows</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#winsvc">Ex챕cuter Apache en tant que service</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#wincons">Ex챕cuter Apache depuis la console</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#test">V챕rification de l'installation</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#windrivemap">Configuration de l'acc챔s aux ressources r챕seau</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#tuning">Personnalisation sous Windows</a></li> +</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="req" id="req">Pr챕requis du syst챔me d'exploitation</a></h2> + + + <p>La plate-forme Windows de base pour l'ex챕cution d'Apache 2.4 est + Windows 2000 ou sup챕rieur. Veillez 횪 toujours vous procurer et installer le + dernier service pack afin d'챕viter les bogues du syst챔me + d'exploitation.</p> + + <div class="note">Les versions du serveur HTTP Apache sup챕rieures 횪 2.2 ne + fonctionneront sous aucun syst챔me d'exploitation d'une version + ant챕rieure 횪 Windows 2000.</div> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="down" id="down">T챕l챕chargement d'Apache pour Windows</a></h2> + + + <p>Le projet du serveur HTTP Apache proprement dit ne fournit pas de + distribution binaire mais seulement le code source. Certains membres + du projet <em>peuvent</em> mettre 횪 disposition des paquets binaires + 횪 titre individuel, mais ceux-ci n'ont pas vocation 횪 챗tre + distribu챕s publiquement.</p> + + <p>Si vous n'챗tes + pas en mesure de compiler le serveur HTTP Apache vous-m챗me, vous + pouvez vous procurer un paquet binaire aupr챔s des nombreuses + distributions disponibles sur Internet.</p> + + <p>Quelques solutions populaires pour d챕ployer Apache httpd, et + 챕ventuellement PHP et MySQL sous Microsoft Windows :</p> + <ul> + <li><a href="http://www.apachehaus.com/cgi-bin/download.plx">ApacheHaus</a></li> + <li><a href="http://www.apachelounge.com/download/">Apache Lounge</a></li> + <li><a href="http://bitnami.com/stack/wamp">Bitnami WAMP Stack</a></li> + <li><a href="http://www.wampserver.com/">WampServer</a></li> + <li><a href="http://www.apachefriends.org/en/xampp.html">XAMPP</a></li> + </ul> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="cust" id="cust">Personnaliser Apache pour Windows</a></h2> + + + <p>La configuration d'Apache est enregistr챕e dans les fichiers du + sous-r챕pertoire <code>conf</code>. Ce sont les m챗me fichiers que + ceux utilis챕s pour configurer la version Unix, mais il y a quelques + directives sp챕cifiques 횪 Apache pour Windows. Voir l'<a href="../mod/directives.html">index des directives</a> pour la liste + des directives disponibles.</p> + + <p>Les principales sp챕cificit챕s d'Apache pour Windows sont :</p> + <ul> + <li><p>Comme Apache pour Windows est un programme multithread, il + ne lance pas de processus s챕par챕 pour chaque requ챗te, comme Apache + peut le faire sous Unix. En fait, il n'y a en g챕n챕ral que deux + processus Apache en ex챕cution : un processus parent, et un + processus enfant qui traite les requ챗tes. Chaque requ챗te est + trait챕e par un thread s챕par챕 au sein du processus enfant.</p> + + <p>Les directives de gestion de processus diff챔rent 챕galement :</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code> + : comme dans la version Unix, cette directive contr척le le nombre + de connexions qu'un + processus enfant particulier va traiter avant de s'arr챗ter. + Cependant, 횪 la diff챕rence d'Unix, un processus de remplacement + n'est pas instantan챕ment disponible. Utilisez la d챕finition par + d챕faut <code>MaxConnectionsPerChild 0</code>, sauf si vous + risquez de manquer de m챕moire dans des modules tiers ou dans des + applications in-process.</p> + + <div class="warning"><strong>Attention : le fichier de + configuration du serveur est recharg챕 lorsqu'un nouveau processus + enfant est d챕marr챕. En cons챕quence, si vous avez modifi챕 + <code>httpd.conf</code>, le nouveau processus enfant peut ne pas + d챕marrer, ou vous pouvez obtenir des r챕sultats + inattendus.</strong></div> + + <p><code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code> : il + s'agit d'une nouvelle directive. Elle indique au serveur le nombre + de threads qu'il doit utiliser. Elle d챕finit le nombre maximum de + connexions simultan챕es que le serveur peut g챕rer ; vous devez + donc vous assurer que ce nombre soit suffisamment grand pour les + besoins de votre site. La valeur par d챕faut <code>ThreadsPerChild + 150</code> est recommand챕e, mais doit 챗tre ajust챕e 횪 la valeur + maximale estim챕e de connexions simultan챕es 횪 accepter.</p></li> + + <li><p>Les directives qui acceptent des noms de fichiers comme + arguments doivent utiliser des noms de fichiers Windows et non + Unix. Cependant, comme Apache peut interpr챕ter les anti-slashes + comme des s챕quences d'챕chappement de caract챔res, vous devez + absolument utiliser des slashes dans les noms de chemins 횪 la + place des anti-slashes.</p></li> + + <li><p>Alors que les noms de fichiers sont en g챕n챕ral insensibles + 횪 la casse sous Windows, les URLs sont encore sensibles 횪 la casse + en interne avant d'챗tre mises en correspondance avec le syst챔me de + fichiers. Par exemple, les directives <code class="directive"><a href="../mod/core.html#location"><Location></a></code>, <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, et <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code> utilisent toutes des + arguments sensibles 횪 la casse. Pour cette raison, il est + particuli챔rement recommand챕 d'utiliser la directive <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> lorsqu'on + d챕sire limiter l'acc챔s 횪 certains contenus du syst챔me de fichiers, + car cette directive s'applique 횪 tout contenu d'un r챕pertoire, + sans tenir compte de la mani챔re dont on y acc챔de. Pour vous + assurer que seules des minuscules sont utilis챕es dans les URLs, + vous pouvez utiliser ceci :</p> + + <pre class="prettyprint lang-config">RewriteEngine On +RewriteMap lowercase int:tolower +RewriteCond "%{REQUEST_URI}" "[A-Z]" +RewriteRule "(.*)" "${lowercase:$1}" [R,L]</pre> +</li> + + <li><p>Lors de son ex챕cution, Apache n'a besoin d'un acc챔s en + 챕criture qu'au r챕pertoire des journaux et 횪 toute arborescence de + r챕pertoires de cache configur챕e. Suite au probl챔me d'insensibilit챕 + 횪 la casse et au format de noms courts 8.3, Apache doit valider + tous les noms de chemins fournis. Cela signifie que chaque + r챕pertoire qu'Apache 챕value doit avoir les droits en lecture, + listage et parcours, et ceci depuis la racine jusqu'aux feuilles. + Si Apache2.4 est install챕 dans C:\Program Files, le r챕pertoire + racine, Program Files et Apache2.4 doivent tous 챗tre visibles pour + Apache</p></li> + + <li><p>Apache peut charger divers modules sans qu'il soit n챕cessaire + de recompiler le serveur. Si Apache est compil챕 + normalement, il va installer de nombreux modules optionnels dans + le r챕pertoire <code>\Apache2.4\modules</code>. Pour activer ces + modules ou d'autres modules, on doit utiliser la + directive <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>. Par + exemple, pour activer le module status, ajoutez la ligne suivante + (en plus des directives d'activation de status dans + <code>access.conf</code>) :</p> + + <pre class="prettyprint lang-config">LoadModule status_module "modules/mod_status.so"</pre> + + + <p>Des informations sont aussi 횪 votre disposition pour <a href="../mod/mod_so.html#creating">cr챕er des modules + chargeables</a></p></li> + + <li><p>Apache peut aussi charger des extensions ISAPI (Internet + Server Application Programming Interface), comme celles qu'utilise + Microsoft IIS et d'autres serveurs Windows. <a href="../mod/mod_isapi.html">Voir ici pour plus + d'informations</a>. Notez qu'Apache ne peut <strong>pas</strong> + charger de filtres ISAPI, et que les gestionnaires ISAPI contenant + des extensions de fonctionnalit챕s Microsoft ne fonctionneront + pas.</p></li> + + <li><p>Pour les scripts CGI, la m챕thode qu'utilise Apache pour + d챕terminer l'interpr챕teur du script est configurable gr창ce 횪 la + directive <code class="directive"><a href="../mod/core.html#scriptinterpretersource">ScriptInterpreterSource</a></code></p></li> + + <li><p>Comme il est souvent difficile de g챕rer des fichiers avec + des noms du style <code>.htaccess</code> sous Windows, vous avez + tout int챕r챗t 횪 changer le nom de ce fichier de configuration par + r챕pertoire 횪 l'aide de la directive <code class="directive"><a href="../mod/core.html#accessfilename">AccessFilename</a></code>.</p></li> + + <li><p>Toute erreur survenant au cours du processus de d챕marrage + d'Apache est enregistr챕e dans le journal des 챕v챔nements de + Windows si l'on est sous Windows NT. Ce m챕canisme fonctionne comme + une sauvegarde pour les situations o첫 Apache n'est pas encore pr챗t + 횪 utiliser le fichier <code>error.log</code>. Vous pouvez + consulter le journal des 챕v챔nements applicatifs Windows en + utilisant l'observateur d'챕v챔nements : D챕marrage - Param챔tres - + Panneau de configuration - Outils d'administration - Observateur + d'챕v챔nements.</p></li> + </ul> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="winsvc" id="winsvc">Ex챕cuter Apache en tant que service</a></h2> + + + <p>Apache fournit un utilitaire nomm챕 Apache Service Monitor + (Moniteur du service Apache). Gr창ce 횪 lui, vous pouvez voir et g챕rer + l'챕tat de tous les services Apache install챕s sur toutes les machines + du r챕seau. Pour pouvoir g챕rer un service Apache avec le moniteur, + vous devez d'abord installer le service (soit automatiquement au + cours de l'installation, soit manuellement).</p> + + <p>Vous pouvez installer Apache en tant que service Windows NT 횪 + partir de la ligne de commandes et depuis le sous-r챕pertoire Apache + <code>bin</code> comme suit :</p> + + <div class="example"><p><code> + httpd.exe -k install + </code></p></div> + + <p>Si vous avez install챕 plusieurs services Apache sur votre + ordinateur, vous devrez sp챕cifier le nom du service que vous voulez + installer en utilisant la commande suivante (notez que si vous + sp챕cifiez un nom durant l'installation, vous devrez aussi le + sp챕cifier pour toute op챕ration comportant l'option -k) :</p> + + <div class="example"><p><code> + httpd.exe -k install -n "Nom-service" + </code></p></div> + + <p>Si un service doit utiliser un fichier de configuration + sp챕cifique, utilisez ceci :</p> + + <div class="example"><p><code> + httpd.exe -k install -n "Nom-service" -f "c:\fichiers\Nom-service.conf" + </code></p></div> + + <p>Si vous utilisez la premi챔re commande sans param챔tre particulier, + except챕 <code>-k install</code>, le service aura pour nom + <code>Apache2.4</code> et le fichier de configuration sera cens챕 + 챗tre <code>conf\httpd.conf</code>.</p> + + <p>Supprimer un service Apache est tr챔s simple. Utilisez + simplement :</p> + + <div class="example"><p><code> + httpd.exe -k uninstall + </code></p></div> + + <p>On peut sp챕cifier un service Apache particulier en utilisant + :</p> + + <div class="example"><p><code> + httpd.exe -k uninstall -n "Nom service" + </code></p></div> + + <p>Normalement, le d챕marrage, le red챕marrage et l'arr챗t d'un + service Apache s'effectuent via le Moniteur de Service Apache, ou en + utilisant des commandes telles que <code>NET START Apache2.4</code> et + <code>NET STOP Apache2.4</code>, ou encore via le gestionnaire de + services standard de Windows. Avant de d챕marrer Apache en tant que + service dans quelque but que ce soit, vous devez tester le fichier + de configuration du service en utilisant :</p> + + <div class="example"><p><code> + httpd.exe -n "Nom-service" -t + </code></p></div> + + <p>Vous pouvez aussi contr척ler un service Apache 횪 l'aide de ses + options de ligne de commande. Avec cette m챕thode, pour d챕marrer un + service Apache install챕, vous utiliserez :</p> + + <div class="example"><p><code> + httpd.exe -k start -n "Nom-Service" + </code></p></div> + + <p>Pour arr챗ter un service Apache via les options de lignes de + commande, utilisez ceci :</p> + + <div class="example"><p><code> + httpd.exe -k stop -n "Nom-Service" + </code></p></div> + + <p>ou</p> + + <div class="example"><p><code> + httpd.exe -k shutdown -n "Nom-Service" + </code></p></div> + + <p>Vous pouvez aussi red챕marrer un service en ex챕cution et le forcer + 횪 relire son fichier de configuration en utilisant :</p> + + <div class="example"><p><code> + httpd.exe -k restart -n "Nom-Service" + </code></p></div> + + <p>Par d챕faut, tous les services Apache sont configur챕s pour + s'ex챕cuter sous l'utilisateur system (le compte + <code>LocalSystem</code>). Le compte <code>LocalSystem</code> n'a + pas de privil챔ges sur votre r챕seau, que ce soit via un m챕canisme + s챕curis챕 de Windows, y compris le syst챔me de fichiers, des tubes + nomm챕s, DCOM ou des RPC s챕curis챕s. Il a cependant des privil챔ges + 챕lev챕s en local.</p> + + <div class="warning"><strong>N'accordez jamais de privil챔ges r챕seau + au compte <code>LocalSystem</code> ! Si Apache doit pouvoir acc챕der + 횪 des ressources r챕seau, cr챕ez un compte s챕par챕 pour Apache comme + indiqu챕 ci-dessous.</strong></div> + + <p>Il est fortement fortement conseill챕 aux utilisateurs de cr챕er un + compte s챕par챕 pour ex챕cuter le(s) service(s) Apache, et m챗me + obligatoire si vous devez acc챕der 횪 des ressources r챕seau via + Apache.</p> + + <ol> + <li>Cr챕ez un compte d'utilisateur du domaine normal, et + assurez-vous de retenir son mot de passe.</li> + + <li>Accordez 횪 l'utilisateur nouvellement cr챕챕 les privil챔ges + <code>Log on as a service</code> et <code>Act as part of the + operating system</code>. Sous Windows NT 4.0, ces privil챔ges sont + accord챕s via le Gestionnaire des utilisateurs du Domaine, mais + sous Windows 2000 et XP, vous aurez plut척t int챕r챗t 횪 utiliser une + GPO pour propager ces configurations. Vous pouvez aussi effectuer + ces r챕glages via la Politique de S챕curit챕 Locale int챕gr챕e 횪 la + MMC.</li> + + <li>V챕rifiez que le compte nouvellement cr챕챕 est membre du groupe + Utilisateurs</li> + + <li>Accordez 횪 ce compte les droits Lecture et Ex챕cution (RX) sur + tous les documents et r챕pertoires de scripts (<code>htdocs</code> + et <code>cgi-bin</code> par exemple), et aussi sur l'ex챕cutable + binaire <code>httpd.exe</code>.</li> + + <li>Accordez aussi 횪 ce compte les droits de modification sur le + r챕pertoire <code>logs</code>.</li> + + </ol> + + <div class="note">Il est en g챕n챕ral de bonne pratique d'accorder 횪 l'utilisateur + sous lequel le service Apache s'ex챕cute les droits en lecture et + ex챕cution (RX) sur l'ensemble du r챕pertoire Apache2.4, sauf pour le + sous-r챕pertoire <code>logs</code>, sur lequel l'utilisateur doit + avoir au moins les droits de modification (RWXD).</div> + + <p>Si vous permettez 횪 ce compte de se connecter en tant + qu'utilisateur et service, vous pouvez ouvrir une session sous ce + compte et v챕rifier s'il a bien le droit d'ex챕cuter les scripts, de + lire les pages web, et si vous pouvez d챕marrer Apache 횪 partir d'une + console Windows. Si tout fonctionne, et si vous avez suivi les + 챕tapes ci-dessus, Apache devrait s'ex챕cuter en tant que service sans + probl챔me.</p> + + <div class="note"><strong>Le code d'erreur 2186</strong> indique probablement + qu'Apache ne peut pas acc챕der 횪 une ressource r챕seau n챕cessaire, et + que vous devez revoir la configuration "Log On As" (Se connecter en + tant que ...) du service.</div> + + <p>Lorsqu'Apache d챕marre en tant que service, il se peut que vous + obteniez un message d'erreur du Gestionnaire de Services Windows. + Par exemple, si vous essayez de d챕marrer Apache en utilisant + l'applet Services du Panneau de configuration de Windows, vous + pouvez obtenir le message suivant :</p> + + <div class="example"><p><code> + Could not start the Apache2.4 service on \\COMPUTER <br /> + Error 1067; The process terminated unexpectedly. + </code></p></div> + + <p>Vous obtiendrez cette erreur 횪 caract챔re g챕n챕ral pour tout + probl챔me survenant au cours du d챕marrage du service Apache. Afin de + d챕terminer exactement la cause du probl챔me, vous devez suivre les + instructions permettant d'ex챕cuter Apache pour Windows depuis la + ligne de commande.</p> + + <p>Si vous rencontrez des probl챔mes avec le service, il est + conseill챕 de suivre les instructions ci-dessous afin d'essayer de + d챕marrer httpd.exe depuis une console, et d'analyser les erreurs + plut척t que vous d챕mener 횪 essayer de d챕marrer le service.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="wincons" id="wincons">Ex챕cuter Apache depuis la console</a></h2> + + + <p>Il est en g챕n챕ral recommand챕 d'ex챕cuter Apache en tant que + service, mais il est parfois plus simple d'utiliser la ligne de + commande, en particulier au cours de la configuration initiale et + les tests.</p> + + <p>Pour ex챕cuter Apache depuis la ligne de commande et en tant + qu'application de console, utilisez la commande suivante :</p> + + <div class="example"><p><code> + httpd.exe + </code></p></div> + + <p>Apache va d챕marrer, et continuera son ex챕cution jusqu'횪 ce qu'on + l'arr챗te en tapant Ctrl-C.</p> + + <p>Vous pouvez 챕galement d챕marrer Apache via le raccourci "D챕marrer + Apache dans une console" plac챕 dans <code>D챕marrer --> + Programmes --> Apache HTTP Server 2.4.xx --> Control Apache + Server</code> au cours de l'installation. Ceci va + ouvrir une console Windows, et y d챕marrer Apache. + Si vous n'avez pas install챕 Apache en tant que service, la + fen챗tre Windows restera ouverte jusqu'횪 ce que vous arr챗tiez Apache + en tapant Ctrl-C dans cette fen챗tre. Le serveur va alors s'arr챗ter + au bout de quelques secondes. Cependant, si vous avez install챕 + Apache en tant que service, c'est ce dernier que le raccourci + ci-dessus va lancer. Si le service Apache est d챕j횪 en cours + d'ex챕cution, le raccourci va rester sans effet.</p> + + <p>Si Apache s'ex챕cute en tant que service, vous pouvez l'arr챗ter en + ouvrant une autre console et en entrant :</p> + + <div class="example"><p><code> + httpd.exe -k shutdown + </code></p></div> + + <p>Plut척t que de lancer Apache 횪 partir d'une console, il est + pr챕f챕rable de l'ex챕cuter en tant que service car dans ce cas, il + termine proprement les op챕rations en cours avant de s'챕teindre.</p> + + <p>Si le serveur a 챕t챕 lanc챕 depuis une console, vous ne pouvez + l'arr챗ter qu'en pressant la combinaison de touches Ctrl-C dans la + m챗me fen챗tre.</p> + + <p>Vous pouvez aussi red챕marrer Apache. Ceci le force 횪 recharger + son fichier de configuration. Toute op챕ration en cours peut 챗tre + achev챕e sans interruption. Pour red챕marrer Apache, vous pouvez soit + taper Control-Break dans la fen챗tre de console que vous avez + utilis챕e pour le d챕marrer, soit entrer :</p> + + <div class="example"><p><code> + httpd.exe -k restart + </code></p></div> + + <p>si le serveur s'ex챕cute en tant que service.</p> + + <div class="note">Note pour les utilisateurs familiers de la version Unix + d'Apache : les commandes ci-dessus repr챕sentent pour Windows + l'챕quivalent des commandes <code>kill -TERM <em>pid</em></code> et + <code>kill -USR1 <em>pid</em></code>. L'option de ligne de commande + <code>-k</code> a 챕t챕 choisie 횪 titre de rapprochement avec la + commande <code>kill</code> utilis챕e sous Unix.</div> + + <p>Si la fen챗tre de la console Apache se ferme imm챕diatement ou + inopin챕ment apr챔s le d챕marrage d'Apache, ouvrez une console Windows + depuis le menu D챕marrer --> Programmes. Placez-vous dans le + r챕pertoire d'installation d'Apache, tapez la commande + <code>httpd.exe</code>, et observez le message d'erreur. Allez + ensuite dans le r챕pertoire des journaux, et visualisez le fichier + <code>error.log</code> pour d챕tecter d'챕ventuelles erreurs de + configuration. Si Apache a 챕t챕 install챕 dans <code>C:\Program + Files\Apache Software Foundation\Apache2.4\</code>, vous + pouvez entrer ce qui suit :</p> + + <div class="example"><p><code> + c: <br /> + cd "\Program Files\Apache Software Foundation\Apache2.4\bin" <br /> + httpd.exe + </code></p></div> + + <p>Attendez ensuite qu'Apache s'arr챗te ou tapez Ctrl-C. Entrez alors + la commande suivante :</p> + + <div class="example"><p><code> + cd ..\logs <br /> + more < error.log + </code></p></div> + + <p>Lorsqu'on travaille avec Apache, il est important de comprendre + comment ce dernier trouve son fichier de configuration. Vous pouvez + sp챕cifier un fichier de configuration 횪 partir de la ligne de + commande de deux fa챌ons :</p> + + <ul> + <li><p>L'option <code>-f</code> permet de sp챕cifier un chemin + absolu ou relatif vers un fichier de configuration particulier + :</p>(sous Windows 9x, il est recommand챕 d'utiliser la ligne de + commande 횪 cause du manque de fiabilit챕 du support des services + fourni par ce syst챔me). + + <div class="example"><p><code> + httpd.exe -f "c:\fichiers-de-mon-serveur\autre-config.conf" + </code></p></div> + + <p>ou</p> + + <div class="example"><p><code> + httpd.exe -f fichiers-de-mon-serveur\autre-config.conf + </code></p></div></li> + + <li><p>L'option <code>-n</code> permet de sp챕cifier le service + Apache install챕 dont le fichier de configuration doit 챗tre utilis챕 + :</p> + + <div class="example"><p><code> + httpd.exe -n "Nom-service" + </code></p></div> + </li> + </ul> + + <p>Dans les deux cas, la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> doit 챗tre correctement d챕finie + dans le fichier de configuration.</p> + + <p>Si vous ne sp챕cifiez aucun fichier de configuration 횪 l'aide des + options <code>-f</code> ou <code>-n</code>, Apache utilisera le nom + du fichier de configuration compil챕 dans le serveur, en g챕n챕ral + <code>conf\httpd.conf</code>. Ce chemin cod챕 en dur est relatif au + r챕pertoire d'installation. Vous pouvez v챕rifier ce chemin 횪 partir + de la valeur de l'챕tiquette <code>SERVER_CONFIG_FILE</code> en + invoquant Apache avec l'option <code>-V</code>, comme ceci :</p> + + <div class="example"><p><code> + httpd.exe -V + </code></p></div> + + <p>Apache va ensuite essayer de d챕terminer la valeur de son + <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> en effectuant les + recherches suivantes, dans cet ordre :</p> + + <ol> + <li>Une directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> + via l'option de ligne de commande <code>-C</code>.</li> + + <li>L'option de ligne de commande <code>-d</code>.</li> + + <li>Le r챕pertoire de travail courant.</li> + + <li>Une entr챕e de la base de registre cr챕챕e dans le cas d'une + installation binaire.</li> + + <li>La racine des documents (<code>DocumentRoot</code>) cod챕e en dur + dans le serveur. Elle + correspond par d챕faut 횪 <code>/apache</code>, et vous pouvez le + v챕rifier en tapant <code>httpd.exe -V</code> et en recherchant + l'챕tiquette <code>HTTPD_ROOT</code>.</li> + </ol> + + <p>Si vous n'avez pas effectu챕 d'installation binaire, dans certains + sc챕narios, Apache va signaler l'absence de cette cl챕 de registre. + On peut passer outre cet avertissement si le serveur a 챕t챕 en mesure + de trouver son fichier de configuration d'une autre mani챔re.</p> + + <p>La valeur de cette cl챕 correspond au r챕pertoire <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> qui contient lui-m챗me le + sous-r챕pertoire <code>conf</code>. Lors de son d챕marrage, Apache lit + le fichier <code>httpd.conf</code> 횪 partir de ce r챕pertoire. Si ce + fichier contient une directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> qui sp챕cifie un r챕pertoire + diff챕rent de celui que contient la cl챕 de registre ci-dessus, Apache + oubliera la cl챕 de registre, et utilisera le r챕pertoire sp챕cifi챕 par + le fichier de configuration. Si vous d챕placez le r챕pertoire Apache + ou ses fichiers de configuration, il est vital de mettre 횪 jour la + directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> dans + <code>httpd.conf</code> afin de refl챕ter la nouvelle + localisation.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="test" id="test">V챕rification de l'installation</a></h2> + + + <p>Une fois Apache d챕marr챕 (soit 횪 partir d'une console Windows, + soit en tant que service), ce dernier va se mettre 횪 l'챕coute sur + le port 80 (횪 moins que vous ayiez modifi챕 la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> dans les fichiers de + configuration ou que vous ayiez install챕 Apache pour l'utilisateur + courant seulement). Pour vous connecter au serveur et acc챕der 횪 la + page par d챕faut, lancez un navigateur et entrez cette URL :</p> + + <div class="example"><p><code> + http://localhost/ + </code></p></div> + + <p>Apache devrait renvoyer une page de bienvenue et vous devriez + voir s'afficher "It Works!". Si rien ne se passe ou si vous obtenez + une erreur, consultez le fichier <code>error.log</code> dans le + sous-r챕pertoire <code>logs</code>. Si votre serveur n'est pas + connect챕 au r챕seau, ou si vous avez de s챕rieux probl챔mes avec la + configuration de votre DNS (Domain Name Service), vous devez + utiliser cette URL :</p> + + <div class="example"><p><code> + http://127.0.0.1/ + </code></p></div> + + <p>Si Apache 챕coute un port non standard, vous devez le pr챕ciser + explicitement dans l'URL :</p> + + <div class="example"><p><code> + http://127.0.0.1:8080/ + </code></p></div> + + <p>Apr챔s que votre installation de base fonctionne, vous devez la + configurer correctement en 챕ditant les fichiers du sous-r챕pertoire + <code>conf</code>. Encore une fois, si vous modifiez la + configuration du service Apache sous Windows NT, essayez d'abord de + red챕marrer le service depuis la ligne de commande afin de vous + assurer de l'absence d'erreur.</p> + + <p>Comme Apache <strong>ne peut pas</strong> partager le m챗me port + avec d'autres applications TCP/IP, il se peut que vous soyez amen챕 횪 + arr챗ter, d챕sinstaller ou reconfigurer certains services avant de + d챕marrer Apache. Ces services entrant en conflit avec Apache + comprennent les autres serveurs WWW, certaines impl챕mentations de + pare-feu, et m챗me certaines applications client (comme Skype) qui + utilisent le port 80 afin de contourner les pare-feu.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="windrivemap" id="windrivemap">Configuration de l'acc챔s aux ressources r챕seau</a></h2> + + + <p>L'acc챔s 횪 des fichiers par le r챕seau peut 챗tre sp챕cifi챕 via deux + m챕canismes fournis par Windows :</p> + + <dl> + <dt>Association de lettres de lecteur</dt> + <dd>Par exemple, <code>Alias "/images/" "Z:/"</code></dd> + + <dt>chemins UNC</dt> + <dd>Par exemple, <code>Alias "/images/" "//imagehost/www/images/"</code></dd> + </dl> + + <p>L'association de lettres de lecteur permet 횪 l'administrateur de + maintenir une correspondance avec une certaine machine et un certain + chemin en dehors de la configuration d'Apache httpd. Cependant, ces + associations ne sont possibles que dans le cadre des sessions + interactives, et ne sont pas directement disponibles pour Apache httpd + lorsqu'il est d챕marr챕 en tant que service. <strong>N'utilisez par + cons챕quent que des + chemins UNC pour les ressources r챕seau dans httpd.conf,</strong> de + fa챌on 횪 ce que les ressources soient accessibles quelle que soit la + mani챔re dont Apache httpd a 챕t챕 d챕marr챕 (des proc챕dures exotiques et + probablement sujettes aux erreurs peuvent permettre de contourner la + restriction due aux associations de lettres de lecteur, mais leur + utilisation est d챕conseill챕e).</p> + + <div class="example"><h3>Exemple de DocumentRoot avec chemin UNC</h3><pre class="prettyprint lang-config">DocumentRoot "//dochost/www/html/"</pre> +</div> + + <div class="example"><h3>Exemple de DocumentRoot avec adresse IP dans le chemin UNC</h3><pre class="prettyprint lang-config">DocumentRoot "//192.168.1.50/docs/"</pre> +</div> + + <div class="example"><h3>Exemple d'Alias et r챕pertoire correspondant avec + chemin UNC</h3><pre class="prettyprint lang-config">Alias "/images/" "//imagehost/www/images/" + +<Directory "//imagehost/www/images/"> +#... +</Directory></pre> +</div> + + <p>Lorsqu'Apache s'ex챕cute en tant que service, vous devez cr챕er un + compte sp챕cifique afin de pouvoir acc챕der aux ressources r챕seau, comme + d챕crit ci-dessus.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="tuning" id="tuning">Personnalisation sous Windows</a></h2> + + <ul> + <li><p>Si on utilise un grand nombre de redirections de journaux + via des pipes, il est souvent n챕cessaire d'augmenter la + taille de la m챕moire du bureau ("desktop heap"). Pour une information plus + d챕taill챕e, veuillez vous reporter 횪 la documentation sur les <a href="../logs.html#piped">redirections de journaux</a>.</p></li> + </ul> + </div></div> +<div class="bottomlang"> +<p><span>Langues Disponibles: </span><a href="../en/platform/windows.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/windows.html" title="Fran챌ais"> fr </a> | +<a href="../ko/platform/windows.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/windows.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Autoris챕 sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file diff --git a/docs/manual/platform/windows.html.ko.euc-kr b/docs/manual/platform/windows.html.ko.euc-kr new file mode 100644 index 0000000..03954a9 --- /dev/null +++ b/docs/manual/platform/windows.html.ko.euc-kr @@ -0,0 +1,716 @@ +<?xml version="1.0" encoding="EUC-KR"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" lang="ko" xml:lang="ko"><head> +<meta content="text/html; charset=EUC-KR" http-equiv="Content-Type" /> +<!-- + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + This file is generated from xml source: DO NOT EDIT + XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX + --> +<title>Microsoft Windows에서 아파치 사용법 - Apache HTTP Server Version 2.4</title> +<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> +<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> +<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" /> +<script src="../style/scripts/prettify.min.js" type="text/javascript"> +</script> + +<link href="../images/favicon.ico" rel="shortcut icon" /></head> +<body id="manual-page"><div id="page-header"> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p> +<p class="apache">Apache HTTP Server Version 2.4</p> +<img alt="" src="../images/feather.png" /></div> +<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div> +<div id="path"> +<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Microsoft Windows에서 아파치 사용법</h1> +<div class="toplang"> +<p><span>가능한 언어: </span><a href="../en/platform/windows.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/windows.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/windows.html" title="Korean"> ko </a></p> +</div> +<div class="outofdate">이 문서는 최신판 번역이 아닙니다. + 최근에 변경된 내용은 영어 문서를 참고하세요.</div> + + + <p>이 문서는 Microsoft Windows에서 아파치 2.0을 설치, 설정, + 실행하는 방법을 설명한다. 잘못된 부분이 있거나 다른 방법으로 + 도움을 주려면, <a href="http://httpd.apache.org/bug_report.html">버그 보고 + 페이지</a>를 사용하길 바란다.</p> + + <p>이 문서는 아파치 바이너리 배포본을 설치한다고 가정한다. + (아마도 개발 혹은 버그를 찾기위해) 직접 아파치를 컴파일하려면 + <a href="win_compiling.html">Microsoft Windows용 아파치 + 컴파일</a>을 참고하라.</p> + + <p><strong>현재 Microsoft Windows 운영체제군의 버전 정책상 + 이 문서는 다음과 같이 구분한다:</strong></p> + <ul> + <li><strong>Windows NT:</strong> Windows NT 커널을 기반으로 + 하는 모든 Windows 버전을 의미한다. Windows NT, Windows + 2000, Windows XP, Windows .Net Server 2003을 지칭한다.</li> + <li><strong>Windows 9x:</strong> 소비자 중심의 오래된 + Windows 버전을 뜻한다. Windows 95 (OSR2 포함), Windows + 98, Windows ME를 지칭한다.</li> + </ul> + + </div> +<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#req">운영체제 요구조건</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#down">Windows용 아파치 다운로드</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#inst">Windows용 아파치 설치하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#cust">Windows용 아파치 설정하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#winsvc">아파치를 Service로 실행하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#wincons">아파치를 콘솔 프로그램으로 실행하기</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#test">정상적으로 설치되었는지 검사하기</a></li> +</ul><h3>참고</h3><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="req" id="req">운영체제 요구조건</a></h2> + + + <p>아파치 2.0을 실행하기위한 기본 Windows 플래폼은 Windows + NT이다. 바이너리 설치프로그램은 Intel과 AMD와 같은 x86 개열 + 프로세서에서만 동작한다. 아파치는 Windows 9x에서 충분히 + 검사하지 않았기때문에 절대로 실제 서비스에 사용하지 않길 + 바란다. + </p> + + <p>운영체제에 설치한 TCP/IP 네트워크가 동작해야 한다. Windows + 95에서 실행한다면, Winsock 2 업그레이드를 설치해야 한다. + Windows 95용 Winsock 2는 <a href="http://www.microsoft.com/windows95/downloads/contents/WUAdminTools/S_WUNetworkingTools/W95Sockets2/Default.asp">여기</a>에서 + 다운받을 수 있다. + </p> + + <p>Windows NT 4.0을 사용한다면 서비스팩 4의 TCP/IP 문제와 + Winsock 문제가 다음 서비스팩에서 해결되었기때문에, 서비스팩 + 6을 설치하길 적극 권한다.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="down" id="down">Windows용 아파치 다운로드</a></h2> + + + <p>아파치 웹서버 <a href="http://httpd.apache.org/download.cgi">http://httpd.apache.org/download.cgi</a>에서 + 아파치 최신 버전에 대한 정보를 얻을 수 있다. 여기에는 최신 + 발표판과 알파 혹은 베타 테스트버전과, 아파치 웹서버를 다운로드할 + 수 있는 HTTP 미러와 FTP 미러 목록이 있다. 빠르고 안정하게 + 다운받으려면 가까운 미러를 사용하길 바란다.</p> + + <p>Windows에 설치하려면 확장자가 <code>.msi</code>인 Windows용 + 아파치 버전을 다운받아야 한다. 이 파일은 막바로 실행할 수 + 있는 아파치를 저장한 Microsoft 설치파일이다. 따로 소스코드만 + 묶어둔 <code>.zip</code> 파일이 있다. Microsoft Visual C++ + (Visual Studio)을 사용하여 직접 아파치를 컴파일할 수도 있다.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="inst" id="inst">Windows용 아파치 설치하기</a></h2> + + + <p>설치하려면 Microsoft Installer 1.2 이상 버전이 필요하다. + Windows 9x를 사용한다면 <a href="http://www.microsoft.com/downloads/release.asp?ReleaseID=32831">여기</a>에서 + Microsoft Installer를 2.0 버전으로 업그레이드할 수 있고, + Windows NT 4.0과 2000을 사용한다면 <a href="http://www.microsoft.com/downloads/release.asp?ReleaseID=32832">여기</a>에서 + 2.0 버전 업데이트를 구할 수 있다. Windows XP는 업데이트할 + 필요가 없다.</p> + + <p>바이너리 설치파일로는 같은 컴퓨터에 서로 다른 아파치 + 2.0 버전을 설치할 수 없음을 주의하라. 그러나 1.3 + 버전<strong>과</strong> 2.0 버전은 같은 컴퓨터에 아무 문제없이 + 설치할 수 있다. 같은 컴퓨터에 두가지 다른 2.0 버전을 설치하려면 + <a href="win_compiling.html">소스를 컴파일하여 아파치를 + 설치</a>해야 한다.</p> + + <p>위에서 다운받은 아파치 <code>.msi</code> 파일을 실행한다. + 설치할때 다음과 같은 것을 물어본다:</p> + + <ol> + <li><p><strong>네트워크 도메인 (Network Domain).</strong> + 등록된 서버의 DNS 도메인을 입력한다. 예를 들어, 서버의 + 전체 DNS 이름이 <code>server.mydomain.net</code>이라면 + 여기에 <code>mydomain.net</code>을 입력한다.</p></li> + + <li><p><strong>서버명 (Server Name).</strong> 서버의 전체 + DNS 이름. 위의 경우 여기에 <code>server.mydomain.net</code>을 + 입력한다.</p></li> + + <li><p><strong>관리자 전자우편 주소 (Administrator's Email + Address).</strong> 여기에 서버 관리자나 웹마스터의 전자우편 + 주소를 입력한다. 기본적으로 클라이언트에게 보내는 오류문에 + 이 주소를 기록한다.</p></li> + + <li><p><strong>사용자 대상 (For whom to install + Apache)</strong> 새로 설치하는 아파치가 80번 포트에서 + 요청을 기다리게 하려면 <code>for All Users, on Port 80, + as a Service - Recommended</code> (모든 사용자, 80번 포트, + service로 - 추천)를 선택한다. 아파치를 service로 실행한다 + (즉, 아파치는 서버에 로그인한 사람이 없어도 실행된다). + 개인적으로 테스트해보거나 이미 80번 포트를 사용하는 다른 + 웹서버가 있다면 <code>only for the Current User, on Port + 8080, when started Manually</code> (현재 사용자만, 8080번 + 포트, 직접 시작)를 선택한다.</p></li> + + <li><p><strong>설치 종류 (The installation type).</strong> + 모듈 개발에 필요한 소스코드와 라이브러리를 제외한 모든 + 것을 설치하려면 <code>Typical</code>을 선택한다. + <code>Custom</code>을 선택하면 설치할 내용을 지정할 수 + 있다. 전체 설치시 디스크에 빈 공간이 약 13 메가바이트 + 정도 필요하다. 이 수치는 웹사이트 크기를 <em>제외한</em> + 것이다.</p></li> + + <li><p><strong>설치 장소 (Where to install).</strong> + 기본 경로는 <code>C:\Program Files\Apache Group</code>이고, + 이곳에 <code>Apache2</code>라는 디렉토리를 만든다.</p></li> + </ol> + + <p>설치할 동안 아파치는 <code>conf</code> 하위디렉토리에 + 있는 파일들을 선택한 설치 디렉토리에 맞게 구성한다. 그러나 + 이 디렉토리에 설정파일이 이미 있다면 그대로 둔다. 대신, + 해당 파일의 새로운 복사본에 확장자 <code>.default</code>를 + 붙인다. 예를 들어, <code>conf\httpd.conf</code>가 이미 있다면 + <code>conf\httpd.conf.default</code>로 이름을 변경한다. + 설치후 <code>.default</code> 파일의 설정을 직접 살펴보고, + 필요하다면 기존 설정파일을 수정해야 한다.</p> + + <p>또, 이미 <code>htdocs\index.html</code>이라는 파일이 + 있다면 그대로 둔다 (<code>index.html.default</code>라고 + 복사하지도 않는다). 즉, 기존에 아파치가 설치되있더라도 안전하게 + 아파치를 새로 설치할 수 있다. 물론 설치하기 전에 서버를 + 중단하고, 설치후 새로운 서버를 시작해야 한다.</p> + + <p>아파치 설치후 필요하다면 <code>conf</code> 하위디렉토리에 + 있는 설정파일을 수정해야 한다. 파일은 아파치를 설치한 디렉토리의 + <code>htdocs</code> 하위디렉토리에 있는 문서를 서비스하도록 + 설정되있다. 실제로 아파치를 사용하기 전에 설정해야 할 옵션이 + 많다. 그러나 빨리 실행해볼 수 있도록 기본 설정파일로도 동작한다.</p> + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="cust" id="cust">Windows용 아파치 설정하기</a></h2> + + + <p>아파치는 <code>conf</code> 하위디렉토리에 있는 파일로 + 설정한다. 이 파일은 유닉스용과 같지만, Windows용 아파치 + 특유의 지시어가 몇개 있다. 사용가능한 모든 지시어를 보려면 + <a href="../mod/directives.html">지시어 목록</a>을 참고하라.</p> + + <p>Windows용 아파치의 주된 차이점은:</p> + <ul> + <li><p>Windows용 아파치는 다중쓰레드 방식을 사용하기때문에, + 유닉스와 달리 요청마다 다른 프로세스를 사용하지 않는다. + 대신 아파치 프로세스는 항상, 부모 프로세스와 요청을 처리하는 + 자식 프로세스, 2개이다. 자식 프로세스에 있는 여러 쓰레드들이 + 요청들을 처리한다. + </p> + + <p>프로세스 관리 지시어도 다르다:</p> + + <p><code class="directive"><a href="../mod/mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></code>: 유닉스와 + 같이, 자식 프로세스가 요청을 얼마만큼 처리하고 죽을지를 + 조정한다. 그러나 유닉스와 달리 프로세스가 한번에 한 요청만을 + 처리하지않고 한번에 모든 요청을 서비스하기때문에, 설정한다면 + 매우 큰 값을 설정하길 권한다. 권장하는 기본값 + <code>MaxRequestsPerChild 0</code>을 사용하면 자식 프로세스는 + 죽지않고 영원히 요청을 서비스한다.</p> + + <div class="warning"><strong>경고: 자식 프로세스는 새로 + 시작할 때마다 서버설정파일을 새로 읽는다. + <code>httpd.conf</code>를 수정했다면, 자식 프로세스가 + 시작하지 않거나 예기치않은 결과가 발생할 수 있다.</strong></div> + + <p><code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>: + 이 지시어는 새로 추가되었다. 이 지시어는 서버가 사용할 + 쓰레드 개수를 지정한다. 이 값이 서버가 한번에 처리할 수 + 있는 최대 연결개수이기때문에, 사이트에 접속량이 많다면 + 충분히 큰 값을 설정해야 한다. 권장하는 기본값은 + <code>ThreadsPerChild 50</code>이다.</p></li> + + <li><p>파일명을 아규먼트로 받는 지시어는 유닉스 파일명이 + 아닌 Windows 파일명을 사용해야 한다. 그러나 아파치 내부에서 + 유닉스식 이름을 사용하기때문에 백슬래쉬가 아닌 슬래쉬를 + 사용해야 한다. 드라이브 문자를 사용할 수 있다. 드라이브를 + 지정하지 않으면 아파치 실행파일이 있는 드라이브를 + 사용한다.</p></li> + + <li><p>Windows용 아파치는 서버를 다시 컴파일하지 않고 + 실행중에 모듈을 읽어들일 수 있다. 기본값으로 아파치를 + 컴파일하면 <code>\Apache2\modules</code> 디렉토리에 여러 + 선택가능한 모듈을 설치한다. 이 모듈 혹은 다른 모듈을 + 사용하려면 새로 생긴 <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> 지시어를 사용한다. + 예를 들어, status 모듈을 사용한다면 + (<code>access.conf</code>에 status관련 지시어와 함께) + 아래와 같이 설정한다:</p> + + <div class="example"><p><code> + LoadModule status_module modules/mod_status.so + </code></p></div> + + <p><a href="../mod/mod_so.html#creating">읽어들일 수 있는 + 모듈 만들기</a>에 대한 정보도 있다.</p></li> + + <li><p>아파치는 Microsoft IIS와 다른 Windows 서버가 사용하는 + ISAPI (Internet Server Application Programming Interface) + 확장을 (즉, 인터넷 서버 프로그램) 읽어들일 수도 있다. + <a href="../mod/mod_isapi.html">더 자세한 정보가 있다</a>. + 아파치는 ISAPI 필터를 읽어들일 수 <strong>없음을</strong> + 주의하라.</p></li> + + <li><p>CGI 스크립트를 사용한다면 <code class="directive"><a href="../mod/core.html#scriptinterpretersource">ScriptInterpreterSource</a></code> 지시어를 + 사용하여 아파치가 스크립트의 인터프리터를 찾는 방법을 + 설정할 수 있다.</p></li> + + <li><p>Windows에서 <code>.htaccess</code>와 같은 파일명을 + 다루기 힘드므로, <code class="directive"><a href="../mod/core.html#accessfilename">AccessFilename</a></code> 지시어를 사용하여 + 디렉토리별 설정파일 이름을 변경하면 편하다.</p></li> + + <li><p>Windows NT라면 아파치 시작시 발생한 오류를 Windows + 이벤트 로그에 기록한다. 그래서 아파치가 보통 사용하는 + <code>error.log</code> 파일을 사용할 수 없는 경우에 대비한다. + Windows 이벤트 로그는 Windows NT 4.0에서는 이벤트 뷰어 + 프로그램으로, 최신 Windows 버전에서는 이벤트 뷰어 MMC + 스냅인에서 볼 수 있다.</p> + + <div class="note"><strong>Windows 9x에는 Windows 이벤트 로그가 없기때문에 + 시작시 발생한 오류를 기록하지 않는다.</strong></div></li> + </ul> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="winsvc" id="winsvc">아파치를 Service로 실행하기</a></h2> + + + <p>Windows NT에서는 아파치를 service로 실행할 수 있다. Windows + 9x에는 매우 실험적인 방법으로 비슷한 기능을 지원한다.</p> + + <p>설치시 자동으로 아파치를 service로 설치할 수 있다. "모든 + 사용자"를 선택하면, 아파치 service가 만들어진다. "현재 + 사용자만"을 선택하더라도 설치후 직접 아파치를 service로 + 등록할 수 있다. service를 설치하려면 Administrators 그룹의 + 구성원이어야 한다.</p> + + <p>아파치에는 Apache Service Monitor라는 도구가 있다. 이 + 도구를 사용하면 네트웍에 있는 다른 컴퓨터에 설치된 아파치 + 상태도 확인하고 관리할 수 있다. monitor로 아파치 service를 + 관리하려면 먼저 service를 (설치시 자동으로 혹은 직접) 설치해야 + 한다. + </p> + + <p>아파치 <code>bin</code> 하위디렉토리에서 명령행 프롬프트에 + 다음과 같이 입력하면 아파치를 Windows NT service로 설치한다:</p> + + <div class="example"><p><code> + apache -k install + </code></p></div> + + <p>설치할 service 이름을 지정하고 싶다면 다음 명령어를 사용한다. + 컴퓨터에 아파치가 여러개 설치되있다면 이름을 다르게 주어야 + 한다.</p> + + <div class="example"><p><code> + apache -k install -n "MyServiceName" + </code></p></div> + + <p>service가 사용할 설정파일을 직접 지정하려면 다음과 같이 + 한다:</p> + + <div class="example"><p><code> + apache -k install -n "MyServiceName" -f "c:\files\my.conf" + </code></p></div> + + <p><code>-k install</code> 외에 다른 파라미터를 사용하지 + 않으면, service 이름은 <code>Apache2</code>가 되고 설정파일은 + <code>conf\httpd.conf</code>가 된다. + </p> + + <p>아파치 service를 제거하기 쉽다. 간단히:</p> + + <div class="example"><p><code> + apache -k uninstall + </code></p></div> + + <p>다음과 같이 제거할 아파치 service를 지정할 수 있다:</p> + + <div class="example"><p><code> + apache -k uninstall -n "MyServiceName" + </code></p></div> + + <p>보통 아파치 service 시작, 재시작, 종료는 Apache Service + Monitor나 <code>NET START Apache2</code>, <code>NET STOP + Apache2</code> 같은 명령어 혹은 Windows 서비스 관리창에서 + 한다. 어떤 방법을 사용하든지 아파치 service를 시작하기 전에 + 설정파일을 검사해봐야 한다:</p> + + <div class="example"><p><code> + apache -n "MyServiceName" -t + </code></p></div> + + <p>명령행 옵션으로도 아파치 service를 조정할 수 있다. 설치한 + 아파치 serivce를 시작하려면:</p> + + <div class="example"><p><code> + apache -k start + </code></p></div> + + <p>명령행 옵션으로 아파치 service를 종료하려면:</p> + + <div class="example"><p><code> + apache -k stop + </code></p></div> + + <p>혹은</p> + + <div class="example"><p><code> + apache -k shutdown + </code></p></div> + + <p>실행중인 service를 재시작하여 설정파일을 다시 읽도록 + 할 수 있다:</p> + + <div class="example"><p><code> + apache -k restart + </code></p></div> + + <p>기본적으로 모든 아파치 service는 시스템 사용자 + (<code>LocalSystem</code> 계정) 권한으로 실행하도록 등록된다. + Windows 보안구조상 <code>LocalSystem</code> 계정은 파일시스템, + named pipes, DCOM, secure RPC 등 어떤 방법을 사용하든지 + 네트웍에 접근할 수 없다. 그러나 해당 컴퓨터에서는 많은 권한을 + 가진다. + </p> + + <div class="warning"><strong><code>LocalSystem</code> 계정에게 + 네트웍 권한을 절대로 주지 마라! 아파치가 네트웍 자원에 접근해야 + 한다면, 아래에서 설명하는 방법으로 아파치를 위한 별도의 + 계정을 만들어라.</strong></div> + + <p>아파치 service를 실행하기위한 별도의 계정을 만들 수도 + 있다. 특히 아파치가 네트웍 자원에 접근해야 한다면 이 방법을 + 강력히 권한다.</p> + + <ol> + <li>일반 도메인 사용자 계정을 만들고 암호를 기억하라.</li> + + <li>새로 만든 계정에 <code>서비스로 로그온</code>와 + <code>운영 체제의 일부로 활동</code> 권한을 + 부여한다. Windows NT 4.0에서는 User Manager for Domains에서 + 권한을 부여할 수 있고, Windows 2000과 XP에서는 아마도 + "그룹 정책"을 사용해야 한다. "로컬 보안 설정" MMC + 스냅인에서 직접 설정해줄 수도 있다. + </li> + + <li>새로 만든 계정이 Users 그룹에 속하는지 확인한다.</li> + + <li>모든 문서와 스크립트 폴더에 (예를 들어 + <code>htdocs</code>와 <code>cgi-bin</code>) 대해 읽기 및 + 실행 (RX) 권한을 부여한다.</li> + + <li>아파치 <code>logs</code> 디렉토리에 수정 (RWXD) 권한을 + 부여한다.</li> + + <li><code>Apache.exe</code> 실행파일에 읽기 및 실행 (RX) + 권한을 부여한다.</li> + </ol> + + <div class="note">아파치 service를 실행하는 사용자에게 최소한 수정 (RWXD) + 권한이 필요한 <code>logs</code> 하위디렉토리를 제외하고 + Apache2 디렉토리 전체에 읽기 및 실행 (RX) 권한을 부여하는 + 것이 좋다.</div> + + <p>계정에 "로컬 로그온"과 "서비스로 로그온" 권한이 있다면, + 그 계정으로 로그온하여 계정이 스크립트를 실행하고 웹페이지를 + 읽으며 콘솔창에서 아파치를 시작할 수 있는지 검사해볼 수 + 있다. 여기서 문제가 없다면 아파치를 service로 실행해도 문제가 + 없다.</p> + + <div class="note"><strong>Error code 2186</strong>은 아파치가 필요한 + 네트웍 자원에 접근할 수 없다는 말로 service의 "로그온" + 설정을 확인하라. 또, 아파치를 실행하는 계정의 권한을 + 살펴봐라.</div> + + <p>아파치를 service로 실행하면 Windows Service Control + Manager에서 오류문을 볼 수 있다. 예를 들어, 제어판에서 + "서비스"를 사용하여 아파치를 시작하는 경우 다음과 같은 문구가 + 나올 수 있다:</p> + + <div class="example"><p><code> + Could not start the Apache2 service on \\COMPUTER <br /> + Error 1067; The process terminated unexpectedly. + </code></p></div> + + <p>아파치 service를 시작할때 문제가 있으면 일반적인 이런 + 오류가 나온다. 실제 어디가 문제인지 알려면 아파치를 콘솔 + 프로그램으로 실행해보라.</p> + + <p>Windows 9x에서 아파치는 Windows NT의 service와 비슷한 + 방법을 지원한다. 그러나 <strong>매우 실험적인</strong> 기능이다. + 실제 서비스에 사용할만큼 안정적이지 않고 앞으로 개선될지 + 보장할 수도 없다. 위험하므로 혹시나 사용한다면 주의해서 + 사용해야 한다!</p> + + <p>두가지 service의 중요한 차이점은 다음과 같다:</p> + + <ul> + <li><p>아파치가 성공적으로 시작하면 배경에서 실행한다. + 예를 들어, 데스크탑에 바로가기를 만들어서 다음 명령을 + 실행하는 경우,</p> + + <div class="example"><p><code> + apache -n "MyServiceName" -k start + </code></p></div> + + <p>service가 성공적으로 시작하면 콘솔창이 생겼다가 금방 + 사라진다. httpd.conf 설정파일에 잘못된 내용이 있는 등 + 아파치 시작시 오류가 발생하면 콘솔창을 계속 보인다. 콘솔창은 + 문제의 원인을 파악하는데 도움을 주는 오류문을 보여준다.</p></li> + + <li><p>Windows 9x는 <code>NET START</code>와 <code>NET + STOP</code> 명령어를 지원하지 않는다. 명령프롬프트에서 + <code>-k</code> 옵션을 사용하여 아파치 service를 조정해야 + 한다. + </p></li> + + <li><p> + 아파치와 Windows 9x는 네트웍 권한을 가진 특정 사용자로 + 아파치를 실행하지 못한다. 사실 Windows 9x는 보안을 제공하지도 + 않는다. 이것이 바로 Apache Software Foundation이 Windows + 9x 시스템을 공개 웹서버로 사용하길 권하지 않는 이유다. + 사용자가 웹 컨텐츠를 개발하고 아파치 서버 학습을 돕기위해, + 아니면 안전한 사설 네트웍에 위치할 인트라넷 서버를 위해, + Windows 9x를 지원할 뿐이다.</p></li> + + </ul> + + <p>아파치가 콘솔 프로그램으로 동작함을 확인하였다면 Windows + NT에서와 같은 명령어로 가상 service를 설치, 조절, 제거할 + 수 있다. 또, Apache Service Monitor를 사용하여 Windows 9x + 가상 service를 관리할 수 있다.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="wincons" id="wincons">아파치를 콘솔 프로그램으로 실행하기</a></h2> + + + <p>일반적으로 아파치를 service로 실행하길 권한다. 그러나 + 명령행에서 실행하는게 편한 경우가 있다 (Windows 9x에서는 + service를 안정적으로 지원하지 않기때문에 명령행에서 아파치를 + 실행하는 방법을 권한다).</p> + + <p>아파치를 콘솔 프로그램으로 실행하려면, 명령행에서 다음 + 명령어를 사용한다:</p> + + <div class="example"><p><code> + apache + </code></p></div> + + <p>아파치는 Control-C를 눌러서 정지할 때까지 실행된다.</p> + + <p>또, <code>시작 메뉴 --> 프로그램 --> Apache HTTP + Server 2.0.xx --> Control Apache Server</code>에 설치된 + Start Apache in Console 바로가기로 아파치를 실행할 수 있다. + 바로가기를 실행하면 콘솔창을 열고 그 안에서 아파치를 실행한다. + 아파치를 service로 설치하지 않았다면, 아파치를 실행하는 + 콘솔창에서 Control-C를 눌러 아파치를 중단할때까지 창이 떠있다. + 이 경우 서버는 몇초안에 종료한다. 그러나, 아파치를 service로 + 설치하였다면 바로가기는 service를 시작한다. 아파치 service가 + 이미 실행중이라면 바로가기는 아무일도 하지 않는다.</p> + + <p>다른 콘솔창을 열고 다음과 같이 입력하여 실행중인 아파치를 + 종료할 수 있다:</p> + + <div class="example"><p><code> + apache -k shutdown + </code></p></div> + + <p>이 방법은 아파치가 현재 작업을 마치고 점잖게 종료할 수 + 있기때문에 Control-C 보다 낫다.</p> + + <p>또, 아파치를 재시작할 수 있다. 이 경우 설정파일을 다시 + 읽는다. 진행중인 작업을 중간에 끊지않고 완료한다. 아파치를 + 재시작하려면:</p> + + <div class="example"><p><code> + apache -k restart + </code></p></div> + + <div class="note">유닉스용 아파치에 익숙한 사람을 위해: 이 명령어는 + <code>kill -TERM <em>pid</em></code>나 <code>kill -USR1 + <em>pid</em></code>의 Windows판이다. 명령행 옵션 + <code>-k</code>는 유닉스 <code>kill</code> 명령어 이름을 + 본따 지었다.</div> + + <p>아파치 콘솔창이 즉시 혹은 시작후 갑자기 닫치면 시작 메뉴 + --> 프로그램의 명령 프롬프트를 실행한다. 아파치를 설치한 + 폴더로 가서 <code>apache</code> 명령어를 실행해보고 발생한 + 오류문을 살펴본다. 그리고 logs 폴더로 가서, 설정파일이 + 잘못되었는지 <code>error.log</code> 파일을 살펴본다. 아파치를 + 설치할때 기본값을 사용했다면 다음과 같다:</p> + + <div class="example"><p><code> + c: <br /> + cd "\Program Files\Apache Group\Apache2\bin" <br /> + apache + </code></p></div> + + <p>아파치가 정지할 때까지 기다리거나 Control-C를 누른다. + 그리고 다음과 같이 입력한다:</p> + + <div class="example"><p><code> + cd ..\logs <br /> + more < error.log + </code></p></div> + + <p>아파치를 다룰때 아파치가 어떻게 설정파일을 찾는지 아는 + 것이 중요하다. 두가지 방법으로 명령행에서 설정파일을 지정할 + 수 있다:</p> + + <ul> + <li><p><code>-f</code>는 설정파일의 절대경로 혹은 상대경로를 + 지정한다:</p> + + <div class="example"><p><code> + apache -f "c:\my server files\anotherconfig.conf" + </code></p></div> + + <p>혹은</p> + + <div class="example"><p><code> + apache -f files\anotherconfig.conf + </code></p></div></li> + + <li><p><code>-n</code>은 아파치 service를 선택하고, 해당 + service의 설정파일을 사용한다:</p> + + <div class="example"><p><code> + apache -n "MyServiceName" + </code></p></div> + </li> + </ul> + + <p>두 경우 모두 설정파일이 적절한 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>를 지정해야 한다.</p> + + <p><code>-f</code>나 <code>-n</code>으로 설정파일을 지정하지 + 않으면, 아파치는 <code>conf\httpd.conf</code>와 같이 서버에 + 컴파일된 파일명을 사용한다. 이 기본 경로는 설치 디렉토리에 + 상대적이다. 다음과 같이 <code>-V</code> 옵션으로 아파치를 + 실행하면 <code>SERVER_CONFIG_FILE</code>이란 항목에서 서버가 + 사용할 설정파일을 알 수 있다:</p> + + <div class="example"><p><code> + apache -V + </code></p></div> + + <p>아파치는 다음 순서대로 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>를 찾는다:</p> + + <ol> + <li><code>-C</code> 명령행 옵션에 사용한 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> 지시어.</li> + + <li><code>-d</code> 명령행 옵션.</li> + + <li>현재 작업 디렉토리.</li> + + <li>바이너리 설치를 했다면 설치할때 만든 registry 항목.</li> + + <li>서버에 컴파일된 server root. 기본값은 + <code>/apache</code>이고, <code>apache -V</code>를 실행하면 + <code>HTTPD_ROOT</code>라는 항목에서 확인할 수 있다.</li> + </ol> + + <p>설치할때 윈도우즈 레지스트리에 버전 특유의 레지스트리 + 키를 만든다. 키의 위치는 설치 종류에 따라 다르다. install + Apache for all users를 선택하였다면 + <code>HKEY_LOCAL_MACHINE</code> 아래에 다음과 같은 키를 + 만든다 (물론 버전번호는 아파치 버전마다 다르다): + </p> + + <div class="example"><p><code> + HKEY_LOCAL_MACHINE\SOFTWARE\Apache Group\Apache\2.0.43 + </code></p></div> + + <p>"모든 사용자"를 대상으로 아파치를 설치하였다면 + <code>HKEY_CURRENT_USER</code> 아래 키가 생긴다. 내용은 + 현재 로그온한 사용자에 따라 다르다:</p> + + <div class="example"><p><code> + HKEY_CURRENT_USER\SOFTWARE\Apache Group\Apache\2.0.43 + </code></p></div> + + <p>키 이름이 서버에 컴파일되기때문에 현재 버전을 건드리지않고 + 새로운 버전을 설치하여 테스트해볼 수 있다. 물론 새 버전을 + 다른 버전과 같은 디렉토리에 설치하지않도록 주의해야 한다.</p> + + <p>바이너리 설치를 하지 않은 경우 아파치는 레지스트리 키가 + 없다고 불평할 수 있다. 서버가 다른 방법으로 설정파일을 찾을 + 수 있다면 이 경고를 무시해도 된다.</p> + + <p>키의 값은 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> + 디렉토리이며, 이 디렉토리에 <code>conf</code>라는 하위디렉토리가 + 있다. 아파치를 시작하면 이 하위디렉토리에서 + <code>httpd.conf</code> 파일을 읽는다. 이 파일에 나오는 + <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> 지시어가 + 레지스트리 키에 나온 디렉토리와 다르다면, 아파치는 레지스트리에서 + 얻은 값을 무시하고 앞으로 설정파일에 나온 디렉토리를 사용한다. + 아파치 디렉토리나 설정파일을 다른 장소로 복사하면 반드시 + <code>httpd.conf</code> 파일에 있는 <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> 지시어를 그 위치로 + 수정하라.</p> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> +<h2><a name="test" id="test">정상적으로 설치되었는지 검사하기</a></h2> + + + <p>(콘솔창이나 service를 통해) 아파치를 시작하면 (설정파일의 + <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> 지시어를 + 수정하거나 아파치를 "현재 사용자만" 대상으로 설치하지 않는 + 경우) 80번 포트를 기다린다. 브라우저를 시작하고 URL을 입력하여 + 서버의 기본 페이지에 접근하다:</p> + + <div class="example"><p><code> + http://localhost/ + </code></p></div> + + <p>아파치는 아파치 설명서 링크가 있는 환영페이지를 보여줘야 + 한다. 아무 일도 일어나지 않거나 오류가 나오면, <code>logs</code> + 하위디렉토리에 있는 <code>error.log</code> 파일을 살펴봐라. + 호스트가 네트웍에 연결되있지 않거나 DNS (Domain Name Service) + 설정에 문제가 있다면 다음 URL을 사용해야 한다:</p> + + <div class="example"><p><code> + http://127.0.0.1/ + </code></p></div> + + <p>기본 설치가 동작하면 <code>conf</code> 하위디렉토리에 + 있는 파일을 적절히 설정한다. 또, Windows NT 아파치 service + 설정을 수정한 경우 먼저 명령행에서 아파치를 시작하여 오류가 + 발생하지않는지 확인해야 한다.</p> + + <p>아파치가 다른 TCP/IP 프로그램과 같은 포트를 공유할 수 + <strong>없기때문에</strong> 아파치를 시작하기 전에 다른 + 서비스를 중단, 제거, 재설정해야 할지도 모른다. 다른 웹서버나 + 특정 방화벽 서버스와 충돌할 수 있다. + </p> + + </div></div> +<div class="bottomlang"> +<p><span>가능한 언어: </span><a href="../en/platform/windows.html" hreflang="en" rel="alternate" title="English"> en </a> | +<a href="../fr/platform/windows.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | +<a href="../ko/platform/windows.html" title="Korean"> ko </a></p> +</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div> +<script type="text/javascript"><!--//--><![CDATA[//><!-- +var comments_shortname = 'httpd'; +var comments_identifier = 'http://httpd.apache.org/docs/2.4/platform/windows.html'; +(function(w, d) { + if (w.location.hostname.toLowerCase() == "httpd.apache.org") { + d.write('<div id="comments_thread"><\/div>'); + var s = d.createElement('script'); + s.type = 'text/javascript'; + s.async = true; + s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; + (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); + } + else { + d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); + } +})(window, document); +//--><!]]></script></div><div id="footer"> +<p class="apache">Copyright 2023 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> +<p class="menu"><a href="../mod/">모듈</a> | <a href="../mod/directives.html">지시어들</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">용어</a> | <a href="../sitemap.html">사이트맵</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- +if (typeof(prettyPrint) !== 'undefined') { + prettyPrint(); +} +//--><!]]></script> +</body></html>
\ No newline at end of file |