netware.xml revision 099bc5f9727a146abb455628a40015b707619b46
842ae4bd224140319ae7feec1872b93dfd491143fielding<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
842ae4bd224140319ae7feec1872b93dfd491143fielding<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
842ae4bd224140319ae7feec1872b93dfd491143fielding<!-- $Revision: 1.12 $ -->
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding Copyright 2002-2004 The Apache Software Foundation
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding Licensed under the Apache License, Version 2.0 (the "License");
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd you may not use this file except in compliance with the License.
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd You may obtain a copy of the License at
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding Unless required by applicable law or agreed to in writing, software
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding distributed under the License is distributed on an "AS IS" BASIS,
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
db3fa7db7c7910f2f23c3e3ffe0cf9f41a1899b9trawick See the License for the specific language governing permissions and
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding limitations under the License.
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <parentdocument href="./">Platform Specific Notes</parentdocument>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>This document explains how to install, configure and run
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding Apache 2.0 under Novell NetWare 6.0 and above. If you find any bugs,
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding or wish to contribute in other ways, please use our
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <a href="http://httpd.apache.org/bug_report.html">bug reporting
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>The bug reporting page and dev-httpd mailing list are <em>not</em>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding provided to answer questions about configuration or running Apache.
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding Before you submit a bug report or request, first consult this document, the
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <a href="/faq/">Frequently Asked Questions</a> page and the other
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding relevant documentation topics. If you still have a question or problem,
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding post it to the <a href="news://developer-forums.novell.com/novell.devsup.webserver">
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding novell.devsup.webserver</a> newsgroup, where many Apache users are more than
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding willing to answer new and obscure questions about using Apache on NetWare.</p>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>Most of this document assumes that you are installing Apache
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding from a binary distribution. If you want to compile Apache
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding yourself (possibly to help with development, or to track down
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding bugs), see the section on <a href="#comp">Compiling Apache for
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>Apache 2.0 is designed to run on NetWare 6.0 service pack 3
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding and above. If you are running a service pack less
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding than SP3, you must install the latest
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding href="http://support.novell.com/misc/patlst.htm#nw">here</a>.</p>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>Apache 2.0 for NetWare can also be run in a NetWare 5.1 environment
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding as long as the latest service pack or the latest version
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding of the <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding for C (LibC)</a> has been installed . <strong>WARNING:</strong> Apache 2.0
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding for NetWare has not been targeted for or tested in this environment.</p>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>Information on the latest version of Apache can be found on
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding the Apache web server at <a
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding href="http://www.apache.org/">http://www.apache.org/</a>. This
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding will list the current release, any more recent alpha or
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding beta-test releases, together with details of mirror web and
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding anonymous ftp sites. Binary builds of the latest releases of
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm Apache 2.0 for NetWare can be downloaded from
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <a href="http://www.apache.org/dist/httpd/binaries/netware">here</a>.</p>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>There is no Apache install program for NetWare currently. If you
1ccd992d37d62c8cb2056126f2234f64ec189bfddougm are building Apache 2.0 for NetWare from source, you will need to
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding copy the files over to the server manually.</p>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>Follow these steps to install Apache on NetWare from the
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding binary download (assuming you will install to
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Unzip the binary download file to the root of the <code>SYS:</code>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding volume (may be installed to any volume)</li>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Edit the <code>httpd.conf</code> file setting <directive
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding module="core">ServerRoot</directive> and <directive
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding module="core">ServerName</directive> along with any file path values
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding to reflect your correct server settings</li>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Add <code>SYS:/APACHE2</code> to the search path, for example:
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>Follow these steps to install Apache on NetWare manually
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding from your own build source (assuming you will install to
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Create a directory called <code>Apache2</code> on a
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding NetWare volume</li>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Copy <code>APACHE2.NLM</code>, <code>APRLIB.NLM</code>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Create a directory under <code>SYS:/APACHE2</code>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Copy <code>HTDIGEST.NLM</code>, <code>HTPASSWD.NLM</code>,
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <code>HTDBM.NLM</code>, <code>LOGRES.NLM</code>, <code>ROTLOGS.NLM</code>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Create a directory under <code>SYS:/APACHE2</code>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Copy the <code>HTTPD-STD.CONF</code> file to the
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <code>SYS:/APACHE2/CONF</code> directory and rename to
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Copy the <code>MIME.TYPES</code>, <code>CHARSET.CONV</code> and
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <code>MAGIC</code> files to <code>SYS:/APACHE2/CONF</code> directory</li>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\ICONS</code>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\MANUAL</code>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\ERROR</code>
43c3e6a4b559b76b750c245ee95e2782c15b4296jim <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\DOCROOT</code>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Create the directory <code>SYS:/APACHE2/LOGS</code>
43c3e6a4b559b76b750c245ee95e2782c15b4296jim on the server</li>
43c3e6a4b559b76b750c245ee95e2782c15b4296jim <li>Create the directory <code>SYS:/APACHE2/CGI-BIN</code>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding on the server</li>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <li>Create the directory <code>SYS:/APACHE2/MODULES</code>
43c3e6a4b559b76b750c245ee95e2782c15b4296jim and copy all nlm modules into the <code>modules</code> directory</li>
43c3e6a4b559b76b750c245ee95e2782c15b4296jim <li>Edit the <code>HTTPD.CONF</code> file searching for all
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <code>@@Value@@</code> markers and replacing them with the
43c3e6a4b559b76b750c245ee95e2782c15b4296jim appropriate setting</li>
43c3e6a4b559b76b750c245ee95e2782c15b4296jim <li>Add <code>SYS:/APACHE2</code> to the search path, for example:
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>Apache may be installed to other volumes besides the default <code>SYS</code> volume.</p>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>During the build process, adding the keyword "install" to the makefile command line
43c3e6a4b559b76b750c245ee95e2782c15b4296jim will automatically produce a complete distribution package under the subdirectory
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <code>DIST</code>. Install Apache by simply copying the distribution that was produced
43c3e6a4b559b76b750c245ee95e2782c15b4296jim by the makfiles to the root of a NetWare volume (see: <a href="#comp">Compiling Apache for
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>To start Apache just type <code>apache</code> at the
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding console. This will load apache in the OS address space. If you
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding prefer to load Apache in a protected address space you may
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding specify the address space with the load statement as follows:</p>
43c3e6a4b559b76b750c245ee95e2782c15b4296jim load address space = apache2 apache2
43c3e6a4b559b76b750c245ee95e2782c15b4296jim </example>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding <p>This will load Apache into an address space called apache2.
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding Running multiple instances of Apache concurrently on NetWare is
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding possible by loading each instance into its own protected
43c3e6a4b559b76b750c245ee95e2782c15b4296jim address space.</p>
43c3e6a4b559b76b750c245ee95e2782c15b4296jim <p>After starting Apache, it will be listening to port 80
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding (unless you changed the <directive module="mpm_common">Listen</directive>
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding directive in the configuration files).
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding To connect to the server and access the default page,
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding launch a browser and enter the server's name or address. This
43c3e6a4b559b76b750c245ee95e2782c15b4296jim should respond with a welcome page, and a link to the Apache
43c3e6a4b559b76b750c245ee95e2782c15b4296jim manual. If nothing happens or you get an error, look in the
09fe0b69d3d1e8c8041c9ce99ee77b8b44b5e3b1fielding directory.</p>
href="/mod/mod_so.html#creating">creating loadable
<a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>.
<a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>.</li>