📄 netware.html.en
字号:
<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="../">Apache
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#maxrequestsperchild">MaxRequestsPerChild</a></code> -
Like the Unix directive, this controls how many requests
a worker thread will serve before exiting. The recommended default,
<code>MaxRequestsPerChild 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_netware.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>AP_WORK</code> to the full path of
the <code>\httpd-2.0</code> directory.</li>
<li>Set the environment variable <code>APR_WORK</code> to the full path of
the <code>\httpd-2.0\srclib\apr</code> directory.</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\srclib\apr-util\uri</code> and build
<code>GENURI.nlm</code> by running "<code>gmake -f nwgnumakefile</code>".</li>
<li>Copy the file <code>GENURI.nlm</code> to the <code>SYS:</code> volume
of a NetWare server and run using the following command:
<div class="example"><p><code>SYS:\genuri > sys:\uri_delims.h</code></p></div>
</li>
<li>Copy the file <code>uri_delims.h</code> to the directory
<code>\httpd-2.0\srclib\apr-util\uri</code> on the build machine.</li>
<li>Change directory to <code>\httpd-2.0\srclib\apr</code> and build APR
by running "<code>gmake -f nwgnumakefile</code>"</li>
<li>Change directory to <code>\httpd-2.0\srclib\pcre</code> and build
<code>DFTABLES.nlm</code> by running "<code>gmake -f nwgnumakefile</code>"</li>
<li>Change directory to <code>\httpd-2.0\server</code> and build
<code>GENCHARS.nlm</code> by running "<code>gmake -f nwgnumakefile</code>"</li>
<li>Copy the files <code>GENCHARS.nlm</code> and <code>DFTABLES.nlm</code>
from their respective directories 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 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</code> or <code>\debug</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>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/platform/netware.html" title="English"> en </a> |
<a href="../ko/platform/netware.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div id="footer">
<p class="apache">Copyright 2006 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
</body></html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -