netware.html.en revision 84810256daf58bf5b46751b4d3dd31152cbf8520
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence This file is generated from xml source: DO NOT EDIT
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<title>Using Apache With Novell NetWare - Apache HTTP Server</title>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<link href="/images/favicon.ico" rel="shortcut icon" /></head>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<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>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<p class="apache">Apache HTTP Server Version 2.1</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<img alt="" src="/images/feather.gif" /></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">Platform Specific Notes</a></div><div id="page-content"><div id="preamble"><h1>Using Apache With Novell NetWare</h1>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<p><span>Available Languages: </span><a href="/en/platform/netware.html" title="English"> en </a> |
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<a href="/ko/platform/netware.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>This document explains how to install, configure and run
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Apache 2.0 under Novell NetWare 6.0 and above. If you find any bugs,
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence or wish to contribute in other ways, please use our
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <a href="http://httpd.apache.org/bug_report.html">bug reporting
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <p>The bug reporting page and dev-httpd mailing list are <em>not</em>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence provided to answer questions about configuration or running Apache.
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Before you submit a bug report or request, first consult this document, the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <a href="/faq/">Frequently Asked Questions</a> page and the other
7046378cf8713c123361da9c658c5808b7fbcd61David Lawrence relevant documentation topics. If you still have a question or problem,
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence post it to the <a href="news://developer-forums.novell.com/novell.devsup.webserver">
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence novell.devsup.webserver</a> newsgroup, where many Apache users are more than
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence willing to answer new and obscure questions about using Apache on NetWare.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Most of this document assumes that you are installing Apache
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence from a binary distribution. If you want to compile Apache
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence yourself (possibly to help with development, or to track down
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence bugs), see the section on <a href="#comp">Compiling Apache for
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#req">Requirements</a></li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<li><img alt="" src="/images/down.gif" /> <a href="#down">Downloading Apache for NetWare</a></li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<li><img alt="" src="/images/down.gif" /> <a href="#inst">Installing Apache for NetWare</a></li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<li><img alt="" src="/images/down.gif" /> <a href="#run">Running Apache for NetWare</a></li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<li><img alt="" src="/images/down.gif" /> <a href="#use">Configuring Apache for NetWare</a></li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<li><img alt="" src="/images/down.gif" /> <a href="#comp">Compiling Apache for NetWare</a></li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<h2><a name="req" id="req">Requirements</a></h2>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Apache 2.0 is designed to run on NetWare 6.0 service pack 3
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence and above. If you are running a service pack less
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence than SP3, you must install the latest
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>NetWare service packs are available <a href="http://support.novell.com/misc/patlst.htm#nw">here</a>.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Apache 2.0 for NetWare can also be run in a NetWare 5.1 environment
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence as long as the latest service pack or the latest version
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence of the <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence for C (LibC)</a> has been installed . <strong>WARNING:</strong> Apache 2.0
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence for NetWare has not been targeted for or tested in this environment.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<h2><a name="down" id="down">Downloading Apache for NetWare</a></h2>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <p>Information on the latest version of Apache can be found on
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence the Apache web server at <a href="http://www.apache.org/">http://www.apache.org/</a>. This
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence will list the current release, any more recent alpha or
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence beta-test releases, together with details of mirror web and
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence anonymous ftp sites. Binary builds of the latest releases of
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence Apache 2.0 for NetWare can be downloaded from
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <a href="http://www.apache.org/dist/httpd/binaries/netware">here</a>.</p>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<h2><a name="inst" id="inst">Installing Apache for NetWare</a></h2>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>There is no Apache install program for NetWare currently. If you
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence are building Apache 2.0 for NetWare from source, you will need to
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence copy the files over to the server manually.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Follow these steps to install Apache on NetWare from the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence binary download (assuming you will install to
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Unzip the binary download file to the root of the <code>SYS:</code>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence volume (may be installed to any volume)</li>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <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
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence to reflect your correct server settings</li>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li>Add <code>SYS:/APACHE2</code> to the search path, for example:
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <div class="example"><p><code>SEARCH ADD SYS:\APACHE2</code></p></div>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <p>Follow these steps to install Apache on NetWare manually
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence from your own build source (assuming you will install to
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Create a directory called <code>Apache2</code> on a
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence NetWare volume</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy <code>APACHE2.NLM</code>, <code>APRLIB.NLM</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Create a directory under <code>SYS:/APACHE2</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy <code>HTDIGEST.NLM</code>, <code>HTPASSWD.NLM</code>,
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>HTDBM.NLM</code>, <code>LOGRES.NLM</code>, <code>ROTLOGS.NLM</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Create a directory under <code>SYS:/APACHE2</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy the <code>HTTPD-STD.CONF</code> file to the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>SYS:/APACHE2/CONF</code> directory and rename to
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy the <code>MIME.TYPES</code>, <code>CHARSET.CONV</code> and
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>MAGIC</code> files to <code>SYS:/APACHE2/CONF</code> directory</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\ICONS</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\MANUAL</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\ERROR</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\DOCROOT</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Create the directory <code>SYS:/APACHE2/LOGS</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence on the server</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Create the directory <code>SYS:/APACHE2/CGI-BIN</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence on the server</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Create the directory <code>SYS:/APACHE2/MODULES</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence and copy all nlm modules into the <code>modules</code> directory</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Edit the <code>HTTPD.CONF</code> file searching for all
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>@@Value@@</code> markers and replacing them with the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence appropriate setting</li>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li>Add <code>SYS:/APACHE2</code> to the search path, for example:
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <div class="example"><p><code>SEARCH ADD SYS:\APACHE2</code></p></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Apache may be installed to other volumes besides the default <code>SYS</code> volume.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>During the build process, adding the keyword "install" to the makefile command line
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence will automatically produce a complete distribution package under the subdirectory
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>DIST</code>. Install Apache by simply copying the distribution that was produced
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence by the makfiles to the root of a NetWare volume (see: <a href="#comp">Compiling Apache for
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<h2><a name="run" id="run">Running Apache for NetWare</a></h2>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>To start Apache just type <code>apache</code> at the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence console. This will load apache in the OS address space. If you
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence prefer to load Apache in a protected address space you may
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence specify the address space with the load statement as follows:</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence load address space = apache2 apache2
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>This will load Apache into an address space called apache2.
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Running multiple instances of Apache concurrently on NetWare is
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence possible by loading each instance into its own protected
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence address space.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>After starting Apache, it will be listening to port 80
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence (unless you changed the <code class="directive"><a href="/mod/mpm_common.html#listen">Listen</a></code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence directive in the configuration files).
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence To connect to the server and access the default page,
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence launch a browser and enter the server's name or address. This
0bd4e3591ac1a729c7ec8f811844119473350975David Lawrence should respond with a welcome page, and a link to the Apache
0bd4e3591ac1a729c7ec8f811844119473350975David Lawrence manual. If nothing happens or you get an error, look in the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>error_log</code> file in the <code>logs</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence directory.</p>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <p>Once your basic installation is working, you should
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence configure it properly by editing the files in the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>To unload Apache running in the OS address space just type
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence the following at the console:</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence unload apache2
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence apache2 shutdown
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>If apache is running in a protected address space specify the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence address space in the unload statement:</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence unload address space = apache2 apache2
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>When working with Apache it is important to know how it will
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence find the configuration files. You can specify a configuration
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence file on the command line in two ways:</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li><code>-f</code> specifies a path to a particular
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence configuration file</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>In these cases, the proper <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence should be set in the configuration file.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>If you don't specify a configuration file name with <code>-f</code>,
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Apache will use the file name compiled into the server, usually
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>conf/httpd.conf</code>. Invoking Apache with the <code>-V</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence switch will display this value labeled as <code>SERVER_CONFIG_FILE</code>.
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Apache will then determine its <code class="directive"><a href="/mod/core.html#serverroot">ServerRoot</a></code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence by trying the following, in this order:</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>A <code>ServerRoot</code> directive via a
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>The <code>-d</code> switch on the command line.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>The server root compiled into the server.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>The server root compiled into the server is usually <code>sys:/apache2</code>.
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence invoking apache with the <code>-V</code> switch will display this value labeled as
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Apache 2.0 for NetWare includes a set of command line directives that can
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence be used to modify or display information about the running instance of the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence web server. These directives are only available while Apache is running. Each
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence of these directives must be preceded by the keyword <code>APACHE2</code>.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <dd>Instructs Apache to terminate all running worker
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence threads as they become idle, reread the configuration file and restart each
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence worker thread based on the new configuration.</dd>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <dd>Displays version information about the currently
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence running instance of Apache.</dd>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <dd>Displays a list of loaded modules both built-in
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence and external.</dd>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <dd>Displays a list of all available directives.</dd>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <dd>Enables or disables the thread status display
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence on the console. When enabled, the state of each running threads is displayed
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence on the Apache console screen.</dd>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <dd>Terminates the running instance of the Apache
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence web server.</dd>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <dd>Describes each of the runtime directives.</dd>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>By default these directives are issued against the instance of Apache running
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence in the OS address space. To issue a directive against a specific instance running
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence in a protected address space, include the -p parameter along with the name of the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence address space. For more information type "apache2 Help" on the command line.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<h2><a name="use" id="use">Configuring Apache for NetWare</a></h2>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <p>Apache is configured by reading configuration files usually stored
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence in the <code>conf</code> directory. These are the same as files used
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence to configure the Unix version, but there are a few different directives for
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence Apache on NetWare. See the <a href="../">Apache
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence documentation</a> for all the available directives.</p>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <p>The main differences in Apache for NetWare are:</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Because Apache for NetWare is multithreaded, it does not
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence use a separate process for each request, as Apache does on some Unix
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence implementations. Instead there are only threads running: a parent
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence thread, and multiple child or worker threads which handle the requests.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Therefore the "process"-management directives are different:</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p><code class="directive"><a href="/mod/mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Like the Unix directive, this controls how many requests
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence a worker thread will serve before exiting. The recommended default,
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>MaxRequestsPerChild 0</code>, causes the thread to continue servicing
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence request indefinitely. It is recommended on NetWare, unless there is some
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence specific reason, that this directive always remain set to <code>0</code>.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p><code class="directive"><a href="/mod/mpm_common.html#startthreads">StartThreads</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence This directive tells the server how many threads it should start initially.
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence The recommended default is <code>StartThreads 50</code>.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p><code class="directive"><a href="/mod/mpm_common.html#minsparethreads">MinSpareThreads</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence This directive instructs the server to spawn additional worker threads
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence if the number of idle threads ever falls below this value. The recommended
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence default is <code>MinSpareThreads 10</code>.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p><code class="directive"><a href="/mod/mpm_common.html#maxsparethreads">MaxSpareThreads</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence This directive instructs the server to begin terminating worker threads
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence if the number of idle threads ever exceeds this value. The recommended
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence default is <code>MaxSpareThreads 100</code>.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p><code class="directive"><a href="/mod/mpm_netware.html#maxthreads">MaxThreads</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence This directive limits the total number of work threads to a maximum
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence value. The recommended default is <code>ThreadsPerChild 250</code>.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p><code class="directive"><a href="/mod/mpm_common.html#threadstacksize">ThreadStackSize</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence This directive tells the server what size of stack to use
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence for the individual worker thread. The recommended default
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>The directives that accept filenames as arguments must use
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence NetWare filenames instead of Unix names. However, because Apache
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence uses Unix-style names internally, forward slashes must be used
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence rather than backslashes. It is recommended that all rooted file paths
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence begin with a volume name. If omitted, Apache will assume the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>SYS:</code> volume which may not be correct.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Apache for NetWare has the ability to load modules at
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence runtime, without recompiling the server. If Apache is
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence compiled normally, it will install a number of optional
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence modules in the <code>\Apache2\modules</code> directory.
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence To activate these, or other modules, the <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code> directive
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence must be used. For example, to active the status module, use
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence the following:</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Information on <a href="/mod/mod_so.html#creating">creating loadable
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <h3><a name="use-add" id="use-add">Additional NetWare specific directives:</a></h3>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li><code class="directive"><a href="/mod/core.html#cgimapextension">CGIMapExtension</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence This directive maps a CGI file extension to a script interpreter.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li><code class="directive"><a href="/mod/mod_nw_ssl.html#securelisten">SecureListen</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Enables SSL encryption for a specified port.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li><code class="directive"><a href="/mod/mod_nw_ssl.html#nwssltrustedcerts">NWSSLTrustedCerts</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Adds trusted certificates that are used to create secure connections to proxied servers.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li><code class="directive"><a href="/mod/mod_nw_ssl.html#nwsslupgradeable">NWSSLUpgradeable</a></code> -
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Allow a connection created on the specified address/port to be upgraded to an SSL connection.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<h2><a name="comp" id="comp">Compiling Apache for NetWare</a></h2>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Compiling Apache requires MetroWerks CodeWarrior 6.x or higher. Once
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Apache has been built, it can be installed to the root of any NetWare
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence volume. The default is the <code>sys:/Apache2</code> directory.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>Before running the server you must fill out the <code>conf</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence directory. Copy the file <code>HTTPD-STD.CONF</code> from the distribution
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>conf</code> directory and rename it to <code>HTTPD.CONF</code>.
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Edit the <code>HTTPD.CONF</code> file searching for all <code>@@Value@@</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence markers and replacing them with the appropriate setting. Copy over
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence the <code>conf/magic</code> and <code>conf/mime.types</code> files as well.
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Alternatively, a complete distribution can be built by including the keyword
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>install</code> when invoking the makefiles.</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <h3><a name="comp-req" id="comp-req">Requirements:</a></h3>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <p>The following development tools are required to build
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Apache 2.0 for NetWare:</p>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Metrowerks CodeWarrior 6.0 or higher with the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <a href="http://developer.novell.com/ndk/cwpdk.htm">NetWare PDK 3.0</a>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence or higher.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li><a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li><a href="http://developer.novell.com/ndk/cldap.htm">LDAP Libraries
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li><a href="http://www.gzip.org/zlib/">ZLIB Compression Library source code</a></li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>AWK utility (awk, gawk or similar). AWK can be downloaded from
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>.
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence The utility must be found in your windows path and must be named <code>awk.exe</code>.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>To build using the makefiles, you will need GNU make version 3.78.1 (GMake) available at
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <h3><a name="comp-make" id="comp-make">Building Apache using the NetWare makefiles:</a></h3>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Set the environment variable <code>NOVELLLIBC</code> to the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence location of the NetWare Libraries for C SDK, for example:
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <div class="example"><p><code>Set NOVELLLIBC=c:\novell\ndk\libc</code></p></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Set the environment variable <code>METROWERKS</code> to the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence location where you installed the Metrowerks CodeWarrior compiler,
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <div class="example"><p><code>Set METROWERKS=C:\Program Files\Metrowerks\CodeWarrior</code></p></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence If you installed to the default location <code>C:\Program
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence Files\Metrowerks\CodeWarrior</code>, you don't need to set this.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Set the environment variable <code>LDAPSDK</code> to the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence location where you installed the LDAP Libraries for C, for example:
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <div class="example"><p><code>Set LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc</code></p></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Set the environment variable <code>ZLIBSDK</code> to the
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence location where you installed the source code for the ZLib Library,
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <div class="example"><p><code>Set ZLIBSDK=D:\NOVELL\zlib</code></p></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Set the environment variable <code>AP_WORK</code> to the full path of
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence the <code>httpd</code> source code directory.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Set the environment variable <code>APR_WORK</code> to the full path of
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence the <code>apr</code> source code directory. Typically <code>\httpd\srclib\apr</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence but the APR project can be outside of the httpd directory structure.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Set the environment variable <code>APU_WORK</code> to the full path of
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence the <code>apr-util</code> source code directory. Typically <code>\httpd\srclib\apr-util</code>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence but the APR-UTIL project can be outside of the httpd directory structure.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Make sure that the path to the AWK utility and the GNU make utility
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence (<code>gmake.exe</code>) have been included in the system's
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Download the source code and unzip to an appropriate directory on
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence your workstation.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Change directory to <code>\httpd-2.0\srclib\apr-util\uri</code> and build
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>GENURI.nlm</code> by running "<code>gmake -f nwgnumakefile</code>".</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy the file <code>GENURI.nlm</code> to the <code>SYS:</code> volume
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence of a NetWare server and run using the following command:
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <div class="example"><p><code>SYS:\genuri > sys:\uri_delims.h</code></p></div>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy the file <code>uri_delims.h</code> to the directory
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>\httpd-2.0\srclib\apr-util\uri</code> on the build machine.</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Change directory to <code>\httpd-2.0\srclib\apr</code> and build APR
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence by running "<code>gmake -f nwgnumakefile</code>"</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Change directory to <code>\httpd-2.0\srclib\pcre</code> and build
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>DFTABLES.nlm</code> by running "<code>gmake -f nwgnumakefile</code>"</li>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li>Change directory to <code>\httpd-2.0\server</code> and build
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>GENCHARS.nlm</code> by running "<code>gmake -f nwgnumakefile</code>"</li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li>Copy the files <code>GENCHARS.nlm</code> and <code>DFTABLES.nlm</code>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence from their respective directories to the <code>SYS:</code> volume of a
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence NetWare server and run them using the following commands:
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li>Copy the files <code>test_char.h</code> and <code>chartables.c</code>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence to the directory <code>\httpd-2.0\os\netware</code> on the build machine.</li>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li>Change directory to <code>\httpd-2.0</code> and build Apache by running
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence "<code>gmake -f nwgnumakefile</code>". You can create a distribution directory by
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence adding an install parameter to the command, for example:
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <div class="example"><p><code>gmake -f nwgnumakefile install</code></p></div>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <h3><a name="comp-add" id="comp-add">Additional make options</a></h3>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li><code>gmake -f nwgnumakefile</code><p>Builds release versions of all of the
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence binaries and copies them to a <code>\release</code> destination directory.</p></li>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li><code>gmake -f nwgnumakefile DEBUG=1</code><p>Builds debug versions of all of the
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence binaries and copies them to a <code>\debug</code> destination directory.</p></li>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li><code>gmake -f nwgnumakefile install</code><p>Creates a complete Apache
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence distribution with binaries, docs and additional support files in a
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <code>\dist\Apache2</code> directory.</p></li>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li><code>gmake -f nwgnumakefile installdev</code><p>Same as install but also creates a
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <code>\lib</code> and <code>\include</code> directory in the destination directory
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence and copies headers and import files.</p></li>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence <li><code>gmake -f nwgnumakefile clean</code><p>Cleans all object files and binaries
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence from the <code>\release</code> or <code>\debug</code> build areas depending on whether
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <code>DEBUG</code> has been defined.</p></li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence <li><code>gmake -f nwgnumakefile clobber_all</code><p>Same as clean and also deletes
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence the distribution directory if it exists.</p></li>
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<p><span>Available Languages: </span><a href="/en/platform/netware.html" title="English"> en </a> |
fc80027fb54b501cdd88461bf879d078259e0226David Lawrence<a href="/ko/platform/netware.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence<p class="apache">Copyright 1999-2004 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>
229f8a97f7887774963cfbd07d392c4373363af5David Lawrence<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>