netware.xml revision db479b48bd4d75423ed4a45e15b75089d1a8ad72
842ae4bd224140319ae7feec1872b93dfd491143fielding<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
842ae4bd224140319ae7feec1872b93dfd491143fielding<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
842ae4bd224140319ae7feec1872b93dfd491143fielding<!-- $LastChangedRevision$ -->
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse Licensed to the Apache Software Foundation (ASF) under one or more
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd contributor license agreements. See the NOTICE file distributed with
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse this work for additional information regarding copyright ownership.
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd The ASF licenses this file to You under the Apache License, Version 2.0
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd (the "License"); you may not use this file except in compliance with
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd the License. You may obtain a copy of the License at
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd Unless required by applicable law or agreed to in writing, software
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd distributed under the License is distributed on an "AS IS" BASIS,
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd See the License for the specific language governing permissions and
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd limitations under the License.
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd <parentdocument href="./">Platform Specific Notes</parentdocument>
67139e2d50d1e11558d87f7042f61cb04bb0d1d2jim <p>This document explains how to install, configure and run
1660a5facf5797acb7aa1300f5ef86756a0bf493jorton Apache 2.0 under Novell NetWare 6.0 and above. If you find any bugs,
1660a5facf5797acb7aa1300f5ef86756a0bf493jorton or wish to contribute in other ways, please use our
a943533fd4d91d114af622731a405407990c4fb1rse <a href="http://httpd.apache.org/bug_report.html">bug reporting
c12917da693bae4028a1d5a5e8224bceed8c739dsf <p>The bug reporting page and dev-httpd mailing list are <em>not</em>
c12917da693bae4028a1d5a5e8224bceed8c739dsf provided to answer questions about configuration or running Apache.
c12917da693bae4028a1d5a5e8224bceed8c739dsf Before you submit a bug report or request, first consult this document, the
c12917da693bae4028a1d5a5e8224bceed8c739dsf <a href="/faq/">Frequently Asked Questions</a> page and the other
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse relevant documentation topics. If you still have a question or problem,
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse post it to the <a href="news://developer-forums.novell.com/novell.devsup.webserver">
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse novell.devsup.webserver</a> newsgroup, where many Apache users are more than
7933d4a963def02417113b6798d87a36395053b0rse willing to answer new and obscure questions about using Apache on NetWare.</p>
71c00f988beb28388702e14cb7fe06f08bd792bbdougm <p>Most of this document assumes that you are installing Apache
71c00f988beb28388702e14cb7fe06f08bd792bbdougm from a binary distribution. If you want to compile Apache
71c00f988beb28388702e14cb7fe06f08bd792bbdougm yourself (possibly to help with development, or to track down
7933d4a963def02417113b6798d87a36395053b0rse bugs), see the section on <a href="#comp">Compiling Apache for
7933d4a963def02417113b6798d87a36395053b0rse <p>Apache 2.0 is designed to run on NetWare 6.0 service pack 3
d1bb6e2664788e0437acc18e877562c9a796d7cerse and above. If you are running a service pack less
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse than SP3, you must install the latest
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg href="http://support.novell.com/misc/patlst.htm#nw">here</a>.</p>
7933d4a963def02417113b6798d87a36395053b0rse <p>Apache 2.0 for NetWare can also be run in a NetWare 5.1 environment
7933d4a963def02417113b6798d87a36395053b0rse as long as the latest service pack or the latest version
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg of the <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries
53c239bee62c6d55b5ddfba5d99376d4c8de924ejwoolley for C (LibC)</a> has been installed . <strong>WARNING:</strong> Apache 2.0
7933d4a963def02417113b6798d87a36395053b0rse for NetWare has not been targeted for or tested in this environment.</p>
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse <p>Information on the latest version of Apache can be found on
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse the Apache web server at <a
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse href="http://www.apache.org/">http://www.apache.org/</a>. This
e726f34f8da08c01ee8bc90904b26196b69c8587wrowe will list the current release, any more recent alpha or
7933d4a963def02417113b6798d87a36395053b0rse beta-test releases, together with details of mirror web and
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg anonymous ftp sites. Binary builds of the latest releases of
e9eabac76b50e8f00d0c391f6070d0f42db77aa2wrowe Apache 2.0 for NetWare can be downloaded from
e9eabac76b50e8f00d0c391f6070d0f42db77aa2wrowe <a href="http://www.apache.org/dist/httpd/binaries/netware">here</a>.</p>
7933d4a963def02417113b6798d87a36395053b0rse </section>
7933d4a963def02417113b6798d87a36395053b0rse <p>There is no Apache install program for NetWare currently. If you
7933d4a963def02417113b6798d87a36395053b0rse are building Apache 2.0 for NetWare from source, you will need to
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg copy the files over to the server manually.</p>
7933d4a963def02417113b6798d87a36395053b0rse <p>Follow these steps to install Apache on NetWare from the
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg binary download (assuming you will install to
7a4e3510f3516132ff057ac986fd6350164b7950kbrand <li>Unzip the binary download file to the root of the <code>SYS:</code>
7a4e3510f3516132ff057ac986fd6350164b7950kbrand volume (may be installed to any volume)</li>
7a4e3510f3516132ff057ac986fd6350164b7950kbrand <li>Edit the <code>httpd.conf</code> file setting <directive
7933d4a963def02417113b6798d87a36395053b0rse module="core">ServerName</directive> along with any file path values
7933d4a963def02417113b6798d87a36395053b0rse to reflect your correct server settings</li>
7933d4a963def02417113b6798d87a36395053b0rse <li>Add <code>SYS:/APACHE2</code> to the search path, for example:
e335319a08e12eb7daff9afa80e985dc53f652b8jorton <p>Follow these steps to install Apache on NetWare manually
e335319a08e12eb7daff9afa80e985dc53f652b8jorton from your own build source (assuming you will install to
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg <li>Create a directory called <code>Apache2</code> on a
7933d4a963def02417113b6798d87a36395053b0rse NetWare volume</li>
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg <li>Copy <code>APACHE2.NLM</code>, <code>APRLIB.NLM</code>
7933d4a963def02417113b6798d87a36395053b0rse <li>Copy <code>HTDIGEST.NLM</code>, <code>HTPASSWD.NLM</code>,
7933d4a963def02417113b6798d87a36395053b0rse <code>HTDBM.NLM</code>, <code>LOGRES.NLM</code>, <code>ROTLOGS.NLM</code>
a1de5cf47c9ccfbf493264e8a3fa7ddd5a9c80d1kbrand <code>SYS:/APACHE2/CONF</code> directory and rename to
1fd6337111a9607570691e38857dcece7fb84abekbrand <li>Copy the <code>MIME.TYPES</code>, <code>CHARSET.CONV</code> and
1fd6337111a9607570691e38857dcece7fb84abekbrand <code>MAGIC</code> files to <code>SYS:/APACHE2/CONF</code> directory</li>
7efe7de73c89c26518714a504359244d03cfbbc5jorton <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\ICONS</code>
807c436563a054c3513648163fd2e36612b68c9atrawick <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\MANUAL</code>
2b4e45d87889ab2f6b432690cc993a42bc607fafjorton <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\ERROR</code>
e3715027f352040ef98da03359b00f13ddb506cbrpluem <li>Copy all files and subdirectories in <code>\HTTPD-2.0\DOCS\DOCROOT</code>
099c357f282d4aebf2b32264f7dce6ffc0497c37sf on the server</li>
099c357f282d4aebf2b32264f7dce6ffc0497c37sf <li>Create the directory <code>SYS:/APACHE2/CGI-BIN</code>
099c357f282d4aebf2b32264f7dce6ffc0497c37sf on the server</li>
099c357f282d4aebf2b32264f7dce6ffc0497c37sf <li>Create the directory <code>SYS:/APACHE2/MODULES</code>
099c357f282d4aebf2b32264f7dce6ffc0497c37sf and copy all nlm modules into the <code>modules</code> directory</li>
e8f95a682820a599fe41b22977010636be5c2717jim <li>Edit the <code>HTTPD.CONF</code> file searching for all
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse <code>@@Value@@</code> markers and replacing them with the
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse appropriate setting</li>
cde1010d880fb6230f80c9d697842ea0b1cb79c7dougm <li>Add <code>SYS:/APACHE2</code> to the search path, for example:
7933d4a963def02417113b6798d87a36395053b0rse <p>Apache may be installed to other volumes besides the default <code>SYS</code> volume.</p>
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg <p>During the build process, adding the keyword "install" to the makefile command line
8fdc55d1624c714391fe1f93ebafe98ace427f4adougm will automatically produce a complete distribution package under the subdirectory
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse <code>DIST</code>. Install Apache by simply copying the distribution that was produced
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg by the makfiles to the root of a NetWare volume (see: <a href="#comp">Compiling Apache for
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg <p>To start Apache just type <code>apache</code> at the
a72de14bfdbf0be9d935be9bdc2df631ca5e032bdougm console. This will load apache in the OS address space. If you
a72de14bfdbf0be9d935be9bdc2df631ca5e032bdougm prefer to load Apache in a protected address space you may
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg specify the address space with the load statement as follows:</p>
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg load address space = apache2 apache2
7933d4a963def02417113b6798d87a36395053b0rse <p>This will load Apache into an address space called apache2.
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse Running multiple instances of Apache concurrently on NetWare is
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg possible by loading each instance into its own protected
7933d4a963def02417113b6798d87a36395053b0rse address space.</p>
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg <p>After starting Apache, it will be listening to port 80
44985e4f931d3a75a7e5108705010cc21605ee34druggeri (unless you changed the <directive module="mpm_common">Listen</directive>
44985e4f931d3a75a7e5108705010cc21605ee34druggeri directive in the configuration files).
44985e4f931d3a75a7e5108705010cc21605ee34druggeri To connect to the server and access the default page,
44985e4f931d3a75a7e5108705010cc21605ee34druggeri launch a browser and enter the server's name or address. This
8f2700898323915da289644dc1f3ee11a5e5b4earpluem should respond with a welcome page, and a link to the Apache
d58a822aff1dfda25384d3d009f88f1883c95436kbrand manual. If nothing happens or you get an error, look in the
d58a822aff1dfda25384d3d009f88f1883c95436kbrand directory.</p>
d58a822aff1dfda25384d3d009f88f1883c95436kbrand <p>Once your basic installation is working, you should
d58a822aff1dfda25384d3d009f88f1883c95436kbrand configure it properly by editing the files in the
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse <p>To unload Apache running in the OS address space just type
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse the following at the console:</p>
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg unload apache2
7933d4a963def02417113b6798d87a36395053b0rse </example>
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse apache2 shutdown
509111f5f58a9effd4c832f6a0cbd6ad9d549188jorton <p>If apache is running in a protected address space specify the
509111f5f58a9effd4c832f6a0cbd6ad9d549188jorton address space in the unload statement:</p>
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg unload address space = apache2 apache2
39c7699ec0799d394d3f67145d4a12ed82f587b8jorton <p>When working with Apache it is important to know how it will
7988a91d9a1c6413f2c1a2138847f513d20de856fuankg find the configuration files. You can specify a configuration
a2558ec3af4391b7da7fe61e1e53383bbd0174b9jorton file on the command line in two ways:</p>
a2558ec3af4391b7da7fe61e1e53383bbd0174b9jorton configuration file</li>
89b8bbc89404e7071e573c4f0a17f528996e855djorton <p>In these cases, the proper <directive module="core">ServerRoot</directive>
89b8bbc89404e7071e573c4f0a17f528996e855djorton should be set in the configuration file.</p>
89b8bbc89404e7071e573c4f0a17f528996e855djorton <p>If you don't specify a configuration file name with <code>-f</code>,
89b8bbc89404e7071e573c4f0a17f528996e855djorton Apache will use the file name compiled into the server, usually
89b8bbc89404e7071e573c4f0a17f528996e855djorton <code>conf/httpd.conf</code>. Invoking Apache with the <code>-V</code>
89b8bbc89404e7071e573c4f0a17f528996e855djorton switch will display this value labeled as <code>SERVER_CONFIG_FILE</code>.
89b8bbc89404e7071e573c4f0a17f528996e855djorton Apache will then determine its <directive module="core">ServerRoot</directive>
89b8bbc89404e7071e573c4f0a17f528996e855djorton by trying the following, in this order:</p>
1366443dc565c33e7b449ae428bbfc4c86f33935drh <p>The server root compiled into the server is usually <code>sys:/apache2</code>.
1366443dc565c33e7b449ae428bbfc4c86f33935drh invoking apache with the <code>-V</code> switch will display this value labeled as
1366443dc565c33e7b449ae428bbfc4c86f33935drh <p>Apache 2.0 for NetWare includes a set of command line directives that can
e6e65585927961caf45d4e9e932bb1f4e9e89ca1jerenkrantz be used to modify or display information about the running instance of the
e8f95a682820a599fe41b22977010636be5c2717jim web server. These directives are only available while Apache is running. Each
e6e65585927961caf45d4e9e932bb1f4e9e89ca1jerenkrantz of these directives must be preceded by the keyword <code>APACHE2</code>.</p>
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse <dd>Instructs Apache to terminate all running worker
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse threads as they become idle, reread the configuration file and restart each
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse worker thread based on the new configuration.</dd>
7933d4a963def02417113b6798d87a36395053b0rse <dd>Displays version information about the currently
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe running instance of Apache.</dd>
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe <dd>Displays a list of loaded modules both built-in
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe and external.</dd>
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe <dd>Enables or disables the thread status display
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe on the console. When enabled, the state of each running threads is displayed
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe on the Apache console screen.</dd>
aafba4d7e3ecc7fcaa87efa8d7fae3e700d2428bdrh <dd>Terminates the running instance of the Apache
aafba4d7e3ecc7fcaa87efa8d7fae3e700d2428bdrh web server.</dd>
56bd16e394f49423a22aa82643eb27f26db2c748jorton <p>By default these directives are issued against the instance of Apache running
56bd16e394f49423a22aa82643eb27f26db2c748jorton in the OS address space. To issue a directive against a specific instance running
56bd16e394f49423a22aa82643eb27f26db2c748jorton in a protected address space, include the -p parameter along with the name of the
a73ec375db18806018eabc968baa85b250bbbf5djorton address space. For more information type "apache2 Help" on the command line.</p>
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe <p>Apache is configured by reading configuration files usually stored
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe in the <code>conf</code> directory. These are the same as files used
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe to configure the Unix version, but there are a few different directives for
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe documentation</a> for all the available directives.</p>
71c00f988beb28388702e14cb7fe06f08bd792bbdougm <p>The main differences in Apache for NetWare are:</p>
c12917da693bae4028a1d5a5e8224bceed8c739dsf <p>Because Apache for NetWare is multithreaded, it does not
c12917da693bae4028a1d5a5e8224bceed8c739dsf use a separate process for each request, as Apache does on some Unix
c12917da693bae4028a1d5a5e8224bceed8c739dsf implementations. Instead there are only threads running: a parent
c12917da693bae4028a1d5a5e8224bceed8c739dsf thread, and multiple child or worker threads which handle the requests.</p>
e8f95a682820a599fe41b22977010636be5c2717jim <p>Therefore the "process"-management directives are different:</p>
b5451913a64155af2eab4f12ecbaf16e15acafc3wrowe <p><directive module="mpm_common">MaxRequestsPerChild</directive> -
8aced0b621ea45e8621c7073b0bfbe5ea91c2329wrowe Like the Unix directive, this controls how many requests
b5451913a64155af2eab4f12ecbaf16e15acafc3wrowe a worker thread will serve before exiting. The recommended default,
93350a0dfa22a2c523cdcbad3357327013ecc145martin <code>MaxRequestsPerChild 0</code>, causes the thread to continue servicing
2c038bf2465bf2150c396f4e67f68ebc5bb9e6e9wrowe request indefinitely. It is recommended on NetWare, unless there is some
b5451913a64155af2eab4f12ecbaf16e15acafc3wrowe specific reason, that this directive always remain set to <code>0</code>.</p>
b5451913a64155af2eab4f12ecbaf16e15acafc3wrowe <p><directive module="mpm_common">StartThreads</directive> -
8a5120efd60acf0323371cb30cba489723b03819jorton This directive tells the server how many threads it should start initially.
b5451913a64155af2eab4f12ecbaf16e15acafc3wrowe The recommended default is <code>StartThreads 50</code>.</p>
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe <p><directive module="mpm_common">MinSpareThreads</directive> -
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe This directive instructs the server to spawn additional worker threads
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe if the number of idle threads ever falls below this value. The recommended
2b7078b0c4fd5b6054f6f2d4f626177844f5c6f7wrowe <p><directive module="mpm_common">MaxSpareThreads</directive> -
af5dd1c93d2185f7e37f8783c593b64fd35ea8a6wrowe This directive instructs the server to begin terminating worker threads
af5dd1c93d2185f7e37f8783c593b64fd35ea8a6wrowe if the number of idle threads ever exceeds this value. The recommended
b79b480213d7452db127eec054e52eb2b4fa6153wrowe <p><directive module="mpm_netware">MaxThreads</directive> -
417f504d4d11631c0d062be85347f82a26c88677aaron This directive limits the total number of work threads to a maximum
11f2c481e1d57bedb3f758565307501e9a2730ddtrawick value. The recommended default is <code>ThreadsPerChild 250</code>.</p>
11f2c481e1d57bedb3f758565307501e9a2730ddtrawick <p><directive module="mpm_common">ThreadStackSize</directive> -
2792780a6fb0951dc304b940ba9274ed1e37fe26wrowe This directive tells the server what size of stack to use
11f2c481e1d57bedb3f758565307501e9a2730ddtrawick for the individual worker thread. The recommended default
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm <p>The directives that accept filenames as arguments must use
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm NetWare filenames instead of Unix names. However, because Apache
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm uses Unix-style names internally, forward slashes must be used
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm rather than backslashes. It is recommended that all rooted file paths
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm begin with a volume name. If omitted, Apache will assume the
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm <code>SYS:</code> volume which may not be correct.</p>
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm <p>Apache for NetWare has the ability to load modules at
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem runtime, without recompiling the server. If Apache is
2ce2fc3287632e20f1b8759aa17e571f68c6fe6dsf compiled normally, it will install a number of optional
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem modules in the <code>\Apache2\modules</code> directory.
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm To activate these, or other modules, the <directive
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm must be used. For example, to active the status module, use
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm the following:</p>
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem href="/mod/mod_so.html#creating">creating loadable
cde1010d880fb6230f80c9d697842ea0b1cb79c7dougm <title>Additional NetWare specific directives:</title>
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm <li><directive module="core">CGIMapExtension</directive> -
621bd763d2e4d32f19013ac8b76b375b5a01851fdougm This directive maps a CGI file extension to a script interpreter.</li>
621bd763d2e4d32f19013ac8b76b375b5a01851fdougm <li><directive module="mod_nw_ssl">SecureListen</directive> -
621bd763d2e4d32f19013ac8b76b375b5a01851fdougm Enables SSL encryption for a specified port.</li>
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem <li><directive module="mod_nw_ssl">NWSSLTrustedCerts</directive> -
621bd763d2e4d32f19013ac8b76b375b5a01851fdougm Adds trusted certificates that are used to create secure connections to proxied servers.</li>
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem <li><directive module="mod_nw_ssl">NWSSLUpgradeable</directive> -
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem Allow a connection created on the specified address/port to be upgraded to an SSL connection.</li>
621bd763d2e4d32f19013ac8b76b375b5a01851fdougm <p>Compiling Apache requires MetroWerks CodeWarrior 6.x or higher. Once
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm Apache has been built, it can be installed to the root of any NetWare
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm volume. The default is the <code>sys:/Apache2</code> directory.</p>
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm <p>Before running the server you must fill out the <code>conf</code>
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton directory. Copy the file <code>HTTPD-STD.CONF</code> from the distribution
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <code>conf</code> directory and rename it to <code>HTTPD.CONF</code>.
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton Edit the <code>HTTPD.CONF</code> file searching for all <code>@@Value@@</code>
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton markers and replacing them with the appropriate setting. Copy over
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton the <code>conf/magic</code> and <code>conf/mime.types</code> files as well.
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton Alternatively, a complete distribution can be built by including the keyword
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <code>install</code> when invoking the makefiles.</p>
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <p>The following development tools are required to build
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton Apache 2.0 for NetWare:</p>
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <li>Metrowerks CodeWarrior 6.0 or higher with the
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <a href="http://developer.novell.com/ndk/cwpdk.htm">NetWare PDK 3.0</a>
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton or higher.</li>
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <li><a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <li><a href="http://developer.novell.com/ndk/cldap.htm">LDAP Libraries
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <li><a href="http://www.gzip.org/zlib/">ZLIB Compression Library source code</a></li>
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <li>AWK utility (awk, gawk or similar). AWK can be downloaded from
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>.
8a2483ae14c7d9c1ee21a92e4251202456af5747jorton The utility must be found in your windows path and must be named <code>awk.exe</code>.</li>
7933d4a963def02417113b6798d87a36395053b0rse <li>To build using the makefiles, you will need GNU make version 3.78.1 (GMake) available at
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem <a href="http://developer.novell.com/ndk/apache.htm">http://developer.novell.com/ndk/apache.htm</a>.</li>
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm <title>Building Apache using the NetWare makefiles:</title>
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem <li>Set the environment variable <code>NOVELLLIBC</code> to the
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem location of the NetWare Libraries for C SDK, for example:
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem <li>Set the environment variable <code>METROWERKS</code> to the
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem location where you installed the Metrowerks CodeWarrior compiler,
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm for example:
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm <example>Set METROWERKS=C:\Program Files\Metrowerks\CodeWarrior</example>
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm If you installed to the default location <code>C:\Program
a943533fd4d91d114af622731a405407990c4fb1rse Files\Metrowerks\CodeWarrior</code>, you don't need to set this.</li>
a943533fd4d91d114af622731a405407990c4fb1rse <li>Set the environment variable <code>LDAPSDK</code> to the
a943533fd4d91d114af622731a405407990c4fb1rse location where you installed the LDAP Libraries for C, for example:
a943533fd4d91d114af622731a405407990c4fb1rse <example>Set LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc</example>
2261f694ce2fc09f9df6c65bd8e1f4230313696bjorton <li>Set the environment variable <code>ZLIBSDK</code> to the
2261f694ce2fc09f9df6c65bd8e1f4230313696bjorton location where you installed the source code for the ZLib Library,
baa6746bc66ff1daa1852a3a085906d2dfa96bb6sf for example:
a943533fd4d91d114af622731a405407990c4fb1rse <li>Set the environment variable <code>AP_WORK</code> to the full path of
469549ac22c6f7b9ecdd9df2565925563e4df84djwoolley <li>Set the environment variable <code>APR_WORK</code> to the full path of
469549ac22c6f7b9ecdd9df2565925563e4df84djwoolley the <code>apr</code> source code directory. Typically <code>\httpd\srclib\apr</code>
d0ba3b97557d47323bd055fb4002ed7692f703b9jerenkrantz but the APR project can be outside of the httpd directory structure.
baa6746bc66ff1daa1852a3a085906d2dfa96bb6sf <li>Set the environment variable <code>APU_WORK</code> to the full path of
71c00f988beb28388702e14cb7fe06f08bd792bbdougm the <code>apr-util</code> source code directory. Typically <code>\httpd\srclib\apr-util</code>
a943533fd4d91d114af622731a405407990c4fb1rse but the APR-UTIL project can be outside of the httpd directory structure.
71c00f988beb28388702e14cb7fe06f08bd792bbdougm <li>Make sure that the path to the AWK utility and the GNU make utility
a943533fd4d91d114af622731a405407990c4fb1rse (<code>gmake.exe</code>) have been included in the system's
931b4fd1cc9dd3da096c45f4bf7ddcc14e0985c1dougm <li>Download the source code and unzip to an appropriate directory on
a943533fd4d91d114af622731a405407990c4fb1rse your workstation.</li>
a943533fd4d91d114af622731a405407990c4fb1rse <li>Change directory to <code>\httpd-2.0</code> and build the prebuild utilities
a943533fd4d91d114af622731a405407990c4fb1rse by running "<code>gmake -f nwgnumakefile prebuild</code>". This target will create
a943533fd4d91d114af622731a405407990c4fb1rse the directory <code>\httpd-2.0\nwprebuild</code> and copy each of the utilities
a943533fd4d91d114af622731a405407990c4fb1rse to this location that are necessary to complete the following build steps.
ea6ff3396df1d6d43ee0ecfa3e26ada981d8e9a3sctemme <li>Copy the files <code>\httpd-2.0\nwprebuild\GENCHARS.nlm</code> and
c947acd3d1a604a0acad6a53ef685312d4410fc5dougm <code>\httpd-2.0\nwprebuild\DFTABLES.nlm</code> to the <code>SYS:</code> volume of a
a943533fd4d91d114af622731a405407990c4fb1rse NetWare server and run them using the following commands:
a943533fd4d91d114af622731a405407990c4fb1rse </example>
7b6ba9c468f26bdb3492d5e8cb79628a3b04e8c8wrowe <li>Copy the files <code>test_char.h</code> and <code>chartables.c</code>
7933d4a963def02417113b6798d87a36395053b0rse to the directory <code>\httpd-2.0\os\netware</code> on the build machine.</li>
a943533fd4d91d114af622731a405407990c4fb1rse <li>Change directory to <code>\httpd-2.0</code> and build Apache by running
2f32a3d146dc55d81b31660386e17c3b83ad61b8bnicholes "<code>gmake -f nwgnumakefile</code>". You can create a distribution directory by
a943533fd4d91d114af622731a405407990c4fb1rse adding an install parameter to the command, for example:
7933d4a963def02417113b6798d87a36395053b0rse </section>
71c00f988beb28388702e14cb7fe06f08bd792bbdougm <li><code>gmake -f nwgnumakefile</code><p>Builds release versions of all of the
71c00f988beb28388702e14cb7fe06f08bd792bbdougm binaries and copies them to a <code>\release</code> destination directory.</p></li>
7933d4a963def02417113b6798d87a36395053b0rse <li><code>gmake -f nwgnumakefile DEBUG=1</code><p>Builds debug versions of all of the
7933d4a963def02417113b6798d87a36395053b0rse binaries and copies them to a <code>\debug</code> destination directory.</p></li>
e726f34f8da08c01ee8bc90904b26196b69c8587wrowe <li><code>gmake -f nwgnumakefile install</code><p>Creates a complete Apache
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem distribution with binaries, docs and additional support files in a
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem <li><code>gmake -f nwgnumakefile prebuild</code><p>Builds all of the prebuild utilities
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem and copies them to the <code>\nwprebuild</code> directory.</p></li>
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem <li><code>gmake -f nwgnumakefile installdev</code><p>Same as install but also creates a
807c9f7266ad3a966b6714fe578f3c9da1ca868brpluem <code>\lib</code> and <code>\include</code> directory in the destination directory
e726f34f8da08c01ee8bc90904b26196b69c8587wrowe <li><code>gmake -f nwgnumakefile clean</code><p>Cleans all object files and binaries
e726f34f8da08c01ee8bc90904b26196b69c8587wrowe from the <code>\release.o</code> or <code>\debug.o</code> build areas depending on whether
e726f34f8da08c01ee8bc90904b26196b69c8587wrowe <li><code>gmake -f nwgnumakefile clobber_all</code><p>Same as clean and also deletes
e726f34f8da08c01ee8bc90904b26196b69c8587wrowe <title>Additional environment variable options</title>
e726f34f8da08c01ee8bc90904b26196b69c8587wrowe <li>To build all of the experimental modules, set the environment
e726f34f8da08c01ee8bc90904b26196b69c8587wrowe <li>To build Apache using standard BSD style sockets rather than
e726f34f8da08c01ee8bc90904b26196b69c8587wrowe Winsock, set the environment variable <code>USE_STDSOCKETS</code>:
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse <title>Building mod_ssl for the NetWare platform</title>
cc003103e52ff9d5fe9bed567ef9438613ab4fbfrse <p>By default Apache for NetWare uses the built-in module
a943533fd4d91d114af622731a405407990c4fb1rse <module>mod_nw_ssl</module> to provide SSL services. This module
7933d4a963def02417113b6798d87a36395053b0rse simply enables the native SSL services implemented in NetWare OS
7933d4a963def02417113b6798d87a36395053b0rse to handle all encryption for a given port. Alternatively, mod_ssl
825479074daa2c65852666c4b26d771dff957507jorton can also be used in the same manner as on other platforms.</p>
825479074daa2c65852666c4b26d771dff957507jorton <p>Before mod_ssl can be built for the NetWare platform, the OpenSSL
825479074daa2c65852666c4b26d771dff957507jorton libraries must be provided. This can be done through the following
a943533fd4d91d114af622731a405407990c4fb1rse steps:</p>
d2ffb32434f79782ff7a364ffa31064698c5c645jorton <li>Download the latest NetWare patch for OpenSSL from the
a943533fd4d91d114af622731a405407990c4fb1rse <a href="http://www.openssl.org/contrib/">OpenSSL Contribution</a>
fa599e0e097d4d933c4dc378ffbfc3c045dd589ewrowe <li>Download the corresponding OpenSSL source code from the
a943533fd4d91d114af622731a405407990c4fb1rse <a href="http://www.openssl.org/source/">OpenSSL Source</a>
a943533fd4d91d114af622731a405407990c4fb1rse <li>At the root of the OpenSSL source directory, apply the NetWare
a72211e92bab814bfa28ee086ca9b2a1a6095c92chrisd patch using the "patch" utility, for example:
a72211e92bab814bfa28ee086ca9b2a1a6095c92chrisd <example>patch -p 1 -i netwarepatch-0.9.7g.diff</example></li>
a72211e92bab814bfa28ee086ca9b2a1a6095c92chrisd <li>Edit the file <code>NetWare/set_env.bat</code> and modify any
825479074daa2c65852666c4b26d771dff957507jorton tools and utilities paths so that they correspond to your build
dfaea9dfb7e6fd2c97b9d35a75d7bcab94af8ff8dougm environment.</li>
9cb81d96f6b556cec1aa456191f43f7932aabaaedougm <li>From the root of the OpenSSL source directory, run the following
fc58f0ff708564b67cd578c626b6500d1cd63a51sf <li>Before building Apache, set the environment variable
fc58f0ff708564b67cd578c626b6500d1cd63a51sf <code>OSSLSDK</code> to the full path to the root of the openssl
fc58f0ff708564b67cd578c626b6500d1cd63a51sf source code directory.
fc58f0ff708564b67cd578c626b6500d1cd63a51sf </section>
7933d4a963def02417113b6798d87a36395053b0rse </section>
6ace32dacb8313226eb9019275d0e4fa45a15148rse</manualpage>