|
23 | 23 | <manualpage metafile="netware.xml.meta"> |
24 | 24 | <parentdocument href="./">Platform Specific Notes</parentdocument> |
25 | 25 |
|
26 | | - <title>Using Apache With Novell NetWare</title> |
| 26 | + <title>Using Apache HTTP Server With Novell NetWare</title> |
27 | 27 |
|
28 | 28 | <summary> |
29 | 29 |
|
30 | 30 | <p>This document explains how to install, configure and run |
31 | | - Apache 2.0 under Novell NetWare 6.0 and above. If you find any bugs, |
| 31 | + Apache HTTP Server 2.0 under Novell NetWare 6.0 and above. If you find any bugs, |
32 | 32 | or wish to contribute in other ways, please use our |
33 | 33 | <a href="http://httpd.apache.org/bug_report.html">bug reporting |
34 | 34 | page.</a></p> |
35 | 35 |
|
36 | 36 | <p>The bug reporting page and dev-httpd mailing list are |
37 | 37 | <em>not</em> provided to answer questions about configuration or |
38 | | - running Apache. Before you submit a bug report or request, first |
| 38 | + running httpd. Before you submit a bug report or request, first |
39 | 39 | consult this document, the <a |
40 | 40 | href="http://wiki.apache.org/httpd/FAQ">Frequently Asked |
41 | 41 | Questions</a> page and the other relevant documentation topics. If |
42 | 42 | you still have a question or problem, post it to the <a |
43 | 43 | href="news://developer-forums.novell.com/novell.devsup.webserver"> |
44 | | - novell.devsup.webserver</a> newsgroup, where many Apache users are |
| 44 | + novell.devsup.webserver</a> newsgroup, where many httpd users are |
45 | 45 | more than willing to answer new and obscure questions about using |
46 | | - Apache on NetWare.</p> |
| 46 | + httpd on NetWare.</p> |
47 | 47 |
|
48 | | - <p>Most of this document assumes that you are installing Apache |
49 | | - from a binary distribution. If you want to compile Apache |
| 48 | + <p>Most of this document assumes that you are installing httpd |
| 49 | + from a binary distribution. If you want to compile httpd |
50 | 50 | yourself (possibly to help with development, or to track down |
51 | | - bugs), see the section on <a href="#comp">Compiling Apache for |
| 51 | + bugs), see the section on <a href="#comp">Compiling Apache httpd for |
52 | 52 | NetWare</a> below.</p> |
53 | 53 |
|
54 | 54 | </summary> |
|
57 | 57 |
|
58 | 58 | <title>Requirements</title> |
59 | 59 |
|
60 | | - <p>Apache 2.0 is designed to run on NetWare 6.0 service pack 3 |
| 60 | + <p>httpd 2.0 is designed to run on NetWare 6.0 service pack 3 |
61 | 61 | and above. If you are running a service pack less |
62 | 62 | than SP3, you must install the latest |
63 | 63 | <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries |
|
66 | 66 | <p>NetWare service packs are available <a |
67 | 67 | href="http://support.novell.com/misc/patlst.htm#nw">here</a>.</p> |
68 | 68 |
|
69 | | - <p>Apache 2.0 for NetWare can also be run in a NetWare 5.1 environment |
| 69 | + <p>httpd 2.0 for NetWare can also be run in a NetWare 5.1 environment |
70 | 70 | as long as the latest service pack or the latest version |
71 | 71 | of the <a href="http://developer.novell.com/ndk/libc.htm">NetWare Libraries |
72 | | - for C (LibC)</a> has been installed . <strong>WARNING:</strong> Apache 2.0 |
| 72 | + for C (LibC)</a> has been installed . <strong>WARNING:</strong> httpd 2.0 |
73 | 73 | for NetWare has not been targeted for or tested in this environment.</p> |
74 | 74 |
|
75 | 75 | </section> |
76 | 76 |
|
77 | 77 | <section id="down"> |
78 | 78 |
|
79 | | - <title>Downloading Apache for NetWare</title> |
| 79 | + <title>Downloading Apache httpd for NetWare</title> |
80 | 80 |
|
81 | | - <p>Information on the latest version of Apache can be found on |
82 | | - the Apache web server at <a |
| 81 | + <p>Information on the latest version of httpd can be found on |
| 82 | + the httpd web server at <a |
83 | 83 | href="http://www.apache.org/">http://www.apache.org/</a>. This |
84 | 84 | will list the current release, any more recent alpha or |
85 | 85 | beta-test releases, together with details of mirror web and |
86 | 86 | anonymous ftp sites. Binary builds of the latest releases of |
87 | | - Apache 2.0 for NetWare can be downloaded from |
| 87 | + httpd 2.0 for NetWare can be downloaded from |
88 | 88 | <a href="http://www.apache.org/dist/httpd/binaries/netware">here</a>.</p> |
89 | 89 |
|
90 | 90 | </section> |
91 | 91 |
|
92 | 92 | <section id="inst"> |
93 | 93 |
|
94 | | - <title>Installing Apache for NetWare</title> |
| 94 | + <title>Installing Apache httpd for NetWare</title> |
95 | 95 |
|
96 | | - <p>There is no Apache install program for NetWare currently. If you |
97 | | - are building Apache 2.0 for NetWare from source, you will need to |
| 96 | + <p>There is no httpd install program for NetWare currently. If you |
| 97 | + are building httpd 2.0 for NetWare from source, you will need to |
98 | 98 | copy the files over to the server manually.</p> |
99 | 99 |
|
100 | | - <p>Follow these steps to install Apache on NetWare from the |
| 100 | + <p>Follow these steps to install httpd on NetWare from the |
101 | 101 | binary download (assuming you will install to |
102 | 102 | <code>sys:/apache2</code>):</p> |
103 | 103 |
|
|
116 | 116 |
|
117 | 117 | </ul> |
118 | 118 |
|
119 | | - <p>Follow these steps to install Apache on NetWare manually |
| 119 | + <p>Follow these steps to install httpd on NetWare manually |
120 | 120 | from your own build source (assuming you will install to |
121 | 121 | <code>sys:/apache2</code>):</p> |
122 | 122 |
|
|
174 | 174 | </li> |
175 | 175 | </ul> |
176 | 176 |
|
177 | | - <p>Apache may be installed to other volumes besides the default <code>SYS</code> volume.</p> |
| 177 | + <p>httpd may be installed to other volumes besides the default <code>SYS</code> volume.</p> |
178 | 178 |
|
179 | 179 | <p>During the build process, adding the keyword "install" to the makefile command line |
180 | 180 | will automatically produce a complete distribution package under the subdirectory |
181 | | - <code>DIST</code>. Install Apache by simply copying the distribution that was produced |
182 | | - by the makfiles to the root of a NetWare volume (see: <a href="#comp">Compiling Apache for |
| 181 | + <code>DIST</code>. Install httpd by simply copying the distribution that was produced |
| 182 | + by the makfiles to the root of a NetWare volume (see: <a href="#comp">Compiling Apache httpd for |
183 | 183 | NetWare</a> below).</p> |
184 | 184 |
|
185 | 185 | </section> |
186 | 186 |
|
187 | 187 | <section id="run"> |
188 | 188 |
|
189 | | - <title>Running Apache for NetWare</title> |
| 189 | + <title>Running Apache httpd for NetWare</title> |
190 | 190 |
|
191 | | - <p>To start Apache just type <code>apache</code> at the |
| 191 | + <p>To start httpd just type <code>apache</code> at the |
192 | 192 | console. This will load apache in the OS address space. If you |
193 | | - prefer to load Apache in a protected address space you may |
| 193 | + prefer to load httpd in a protected address space you may |
194 | 194 | specify the address space with the load statement as follows:</p> |
195 | 195 |
|
196 | 196 | <example> |
197 | 197 | load address space = apache2 apache2 |
198 | 198 | </example> |
199 | 199 |
|
200 | | - <p>This will load Apache into an address space called apache2. |
201 | | - Running multiple instances of Apache concurrently on NetWare is |
| 200 | + <p>This will load httpd into an address space called apache2. |
| 201 | + Running multiple instances of httpd concurrently on NetWare is |
202 | 202 | possible by loading each instance into its own protected |
203 | 203 | address space.</p> |
204 | 204 |
|
205 | | - <p>After starting Apache, it will be listening to port 80 |
| 205 | + <p>After starting httpd, it will be listening to port 80 |
206 | 206 | (unless you changed the <directive module="mpm_common">Listen</directive> |
207 | 207 | directive in the configuration files). |
208 | 208 | To connect to the server and access the default page, |
209 | 209 | launch a browser and enter the server's name or address. This |
210 | | - should respond with a welcome page, and a link to the Apache |
| 210 | + should respond with a welcome page, and a link to the httpd |
211 | 211 | manual. If nothing happens or you get an error, look in the |
212 | 212 | <code>error_log</code> file in the <code>logs</code> |
213 | 213 | directory.</p> |
|
216 | 216 | configure it properly by editing the files in the |
217 | 217 | <code>conf</code> directory.</p> |
218 | 218 |
|
219 | | - <p>To unload Apache running in the OS address space just type |
| 219 | + <p>To unload httpd running in the OS address space just type |
220 | 220 | the following at the console:</p> |
221 | 221 |
|
222 | 222 | <example> |
|
236 | 236 | unload address space = apache2 apache2 |
237 | 237 | </example> |
238 | 238 |
|
239 | | - <p>When working with Apache it is important to know how it will |
| 239 | + <p>When working with httpd it is important to know how it will |
240 | 240 | find the configuration files. You can specify a configuration |
241 | 241 | file on the command line in two ways:</p> |
242 | 242 |
|
|
257 | 257 | should be set in the configuration file.</p> |
258 | 258 |
|
259 | 259 | <p>If you don't specify a configuration file name with <code>-f</code>, |
260 | | - Apache will use the file name compiled into the server, usually |
261 | | - <code>conf/httpd.conf</code>. Invoking Apache with the <code>-V</code> |
| 260 | + httpd will use the file name compiled into the server, usually |
| 261 | + <code>conf/httpd.conf</code>. Invoking httpd with the <code>-V</code> |
262 | 262 | switch will display this value labeled as <code>SERVER_CONFIG_FILE</code>. |
263 | | - Apache will then determine its <directive module="core">ServerRoot</directive> |
| 263 | + httpd will then determine its <directive module="core">ServerRoot</directive> |
264 | 264 | by trying the following, in this order:</p> |
265 | 265 |
|
266 | 266 | <ul> |
|
278 | 278 | invoking apache with the <code>-V</code> switch will display this value labeled as |
279 | 279 | <code>HTTPD_ROOT</code>.</p> |
280 | 280 |
|
281 | | - <p>Apache 2.0 for NetWare includes a set of command line directives that can |
| 281 | + <p>httpd 2.0 for NetWare includes a set of command line directives that can |
282 | 282 | be used to modify or display information about the running instance of the |
283 | | - web server. These directives are only available while Apache is running. Each |
| 283 | + web server. These directives are only available while httpd is running. Each |
284 | 284 | of these directives must be preceded by the keyword <code>APACHE2</code>.</p> |
285 | 285 |
|
286 | 286 | <dl> |
287 | 287 | <dt>RESTART</dt> |
288 | | - <dd>Instructs Apache to terminate all running worker |
| 288 | + <dd>Instructs httpd to terminate all running worker |
289 | 289 | threads as they become idle, reread the configuration file and restart each |
290 | 290 | worker thread based on the new configuration.</dd> |
291 | 291 |
|
292 | 292 | <dt>VERSION</dt> |
293 | 293 | <dd>Displays version information about the currently |
294 | | - running instance of Apache.</dd> |
| 294 | + running instance of httpd.</dd> |
295 | 295 |
|
296 | 296 | <dt>MODULES</dt> |
297 | 297 | <dd>Displays a list of loaded modules both built-in |
|
303 | 303 | <dt>SETTINGS</dt> |
304 | 304 | <dd>Enables or disables the thread status display |
305 | 305 | on the console. When enabled, the state of each running threads is displayed |
306 | | - on the Apache console screen.</dd> |
| 306 | + on the httpd console screen.</dd> |
307 | 307 |
|
308 | 308 | <dt>SHUTDOWN</dt> |
309 | | - <dd>Terminates the running instance of the Apache |
| 309 | + <dd>Terminates the running instance of the httpd |
310 | 310 | web server.</dd> |
311 | 311 |
|
312 | 312 | <dt>HELP</dt> |
313 | 313 | <dd>Describes each of the runtime directives.</dd> |
314 | 314 | </dl> |
315 | 315 |
|
316 | | - <p>By default these directives are issued against the instance of Apache running |
| 316 | + <p>By default these directives are issued against the instance of httpd running |
317 | 317 | in the OS address space. To issue a directive against a specific instance running |
318 | 318 | in a protected address space, include the -p parameter along with the name of the |
319 | 319 | address space. For more information type "apache2 Help" on the command line.</p> |
|
322 | 322 |
|
323 | 323 | <section id="use"> |
324 | 324 |
|
325 | | - <title>Configuring Apache for NetWare</title> |
| 325 | + <title>Configuring Apache httpd for NetWare</title> |
326 | 326 |
|
327 | | - <p>Apache is configured by reading configuration files usually stored |
| 327 | + <p>httpd is configured by reading configuration files usually stored |
328 | 328 | in the <code>conf</code> directory. These are the same as files used |
329 | 329 | to configure the Unix version, but there are a few different directives for |
330 | | - Apache on NetWare. See the <a href="../mod/">Apache module |
| 330 | + httpd on NetWare. See the <a href="../mod/">httpd module |
331 | 331 | documentation</a> for all the available directives.</p> |
332 | 332 |
|
333 | | - <p>The main differences in Apache for NetWare are:</p> |
| 333 | + <p>The main differences in httpd for NetWare are:</p> |
334 | 334 |
|
335 | 335 | <ul> |
336 | 336 | <li> |
337 | | - <p>Because Apache for NetWare is multithreaded, it does not |
338 | | - use a separate process for each request, as Apache does on some Unix |
| 337 | + <p>Because httpd for NetWare is multithreaded, it does not |
| 338 | + use a separate process for each request, as httpd does on some Unix |
339 | 339 | implementations. Instead there are only threads running: a parent |
340 | 340 | thread, and multiple child or worker threads which handle the requests.</p> |
341 | 341 |
|
|
374 | 374 |
|
375 | 375 | <li> |
376 | 376 | <p>The directives that accept filenames as arguments must use |
377 | | - NetWare filenames instead of Unix names. However, because Apache |
| 377 | + NetWare filenames instead of Unix names. However, because httpd |
378 | 378 | uses Unix-style names internally, forward slashes must be used |
379 | 379 | rather than backslashes. It is recommended that all rooted file paths |
380 | | - begin with a volume name. If omitted, Apache will assume the |
| 380 | + begin with a volume name. If omitted, httpd will assume the |
381 | 381 | <code>SYS:</code> volume which may not be correct.</p> |
382 | 382 | </li> |
383 | 383 |
|
384 | 384 | <li> |
385 | | - <p>Apache for NetWare has the ability to load modules at |
386 | | - runtime, without recompiling the server. If Apache is |
| 385 | + <p>httpd for NetWare has the ability to load modules at |
| 386 | + runtime, without recompiling the server. If httpd is |
387 | 387 | compiled normally, it will install a number of optional |
388 | 388 | modules in the <code>\Apache2\modules</code> directory. |
389 | 389 | To activate these, or other modules, the <directive |
|
428 | 428 |
|
429 | 429 | <section id="comp"> |
430 | 430 |
|
431 | | - <title>Compiling Apache for NetWare</title> |
| 431 | + <title>Compiling Apache httpd for NetWare</title> |
432 | 432 |
|
433 | | - <p>Compiling Apache requires MetroWerks CodeWarrior 6.x or higher. Once |
434 | | - Apache has been built, it can be installed to the root of any NetWare |
| 433 | + <p>Compiling httpd requires MetroWerks CodeWarrior 6.x or higher. Once |
| 434 | + httpd has been built, it can be installed to the root of any NetWare |
435 | 435 | volume. The default is the <code>sys:/Apache2</code> directory.</p> |
436 | 436 |
|
437 | 437 | <p>Before running the server you must fill out the <code>conf</code> |
|
448 | 448 | <title>Requirements:</title> |
449 | 449 |
|
450 | 450 | <p>The following development tools are required to build |
451 | | - Apache 2.0 for NetWare:</p> |
| 451 | + httpd 2.0 for NetWare:</p> |
452 | 452 |
|
453 | 453 | <ul> |
454 | 454 | <li>Metrowerks CodeWarrior 6.0 or higher with the |
|
475 | 475 |
|
476 | 476 | <section id="comp-make"> |
477 | 477 |
|
478 | | - <title>Building Apache using the NetWare makefiles:</title> |
| 478 | + <title>Building Apache httpd using the NetWare makefiles:</title> |
479 | 479 |
|
480 | 480 | <ul> |
481 | 481 | <li>Set the environment variable <code>NOVELLLIBC</code> to the |
|
548 | 548 | <li>Copy the files <code>test_char.h</code> and <code>chartables.c</code> |
549 | 549 | to the directory <code>\httpd-2.0\os\netware</code> on the build machine.</li> |
550 | 550 |
|
551 | | - <li>Change directory to <code>\httpd-2.0</code> and build Apache by running |
| 551 | + <li>Change directory to <code>\httpd-2.0</code> and build httpd by running |
552 | 552 | "<code>gmake -f nwgnumakefile</code>". You can create a distribution directory by |
553 | 553 | adding an install parameter to the command, for example: |
554 | 554 | <example>gmake -f nwgnumakefile install</example> |
|
568 | 568 | <li><code>gmake -f nwgnumakefile DEBUG=1</code><p>Builds debug versions of all of the |
569 | 569 | binaries and copies them to a <code>\debug</code> destination directory.</p></li> |
570 | 570 |
|
571 | | - <li><code>gmake -f nwgnumakefile install</code><p>Creates a complete Apache |
| 571 | + <li><code>gmake -f nwgnumakefile install</code><p>Creates a complete httpd |
572 | 572 | distribution with binaries, docs and additional support files in a |
573 | 573 | <code>\dist\Apache2</code> directory.</p></li> |
574 | 574 |
|
|
599 | 599 | <example>Set EXPERIMENTAL=1</example> |
600 | 600 | </li> |
601 | 601 |
|
602 | | - <li>To build Apache using standard BSD style sockets rather than |
| 602 | + <li>To build httpd using standard BSD style sockets rather than |
603 | 603 | Winsock, set the environment variable <code>USE_STDSOCKETS</code>: |
604 | 604 | <example>Set USE_STDSOCKETS=1</example> |
605 | 605 | </li> |
|
612 | 612 |
|
613 | 613 | <title>Building mod_ssl for the NetWare platform</title> |
614 | 614 |
|
615 | | - <p>By default Apache for NetWare uses the built-in module |
| 615 | + <p>By default httpd for NetWare uses the built-in module |
616 | 616 | <module>mod_nw_ssl</module> to provide SSL services. This module |
617 | 617 | simply enables the native SSL services implemented in NetWare OS |
618 | 618 | to handle all encryption for a given port. Alternatively, mod_ssl |
|
647 | 647 | Warning: don't use the CodeWarrior Assembler - it produces broken code! |
648 | 648 | </li> |
649 | 649 |
|
650 | | - <li>Before building Apache, set the environment variable |
| 650 | + <li>Before building httpd, set the environment variable |
651 | 651 | <code>OSSLSDK</code> to the full path to the root of the openssl |
652 | 652 | source code directory, and set WITH_MOD_SSL to 1. |
653 | 653 | <example> |
|
0 commit comments