在 Novell NetWare 中使用 Apache

需求

Apache 2.0 設計用於在 NetWare 6.0 Service Pack 3 及更高版本上運行。如果您運行的是低於 SP3 的 Service Pack，則必須安裝最新的 適用於 C 的 NetWare 函式庫 (LibC)。

NetWare Service Pack 可在此處 獲得。

只要安裝了最新的 Service Pack 或最新版本的 適用於 C 的 NetWare 函式庫 (LibC)，也可以在 NetWare 5.1 環境中運行適用於 NetWare 的 Apache 2.0。警告：適用於 NetWare 的 Apache 2.0 並非針對此環境，也未在此環境中進行測試。

下載適用於 NetWare 的 Apache

有關最新版本 Apache 的資訊，請訪問 Apache 網頁伺服器 http://www.apache.org/。這將列出當前版本、任何更新的 Alpha 或 Beta 測試版本，以及鏡像網站和匿名 FTP 網站的詳細資訊。可以從 此處下載適用於 NetWare 的 Apache 2.0 最新版本的二進位版本。

安裝適用於 NetWare 的 Apache

目前沒有適用於 NetWare 的 Apache 安裝程式。如果您要從原始碼構建適用於 NetWare 的 Apache 2.0，則需要手動將檔案複製到伺服器。

按照以下步驟從二進位下載安裝 Apache 到 NetWare（假設您將安裝到 sys:/apache2）

• 將二進位下載檔案解壓縮到 SYS: 磁碟區的根目錄（可以安裝到任何磁碟區）
• 編輯 httpd.conf 檔案，設定 ServerRoot 和 ServerName 以及任何檔案路徑值，以反映您正確的伺服器設定
• 將 SYS:/APACHE2 新增到搜尋路徑，例如

  SEARCH ADD SYS:\APACHE2

按照以下步驟從您自己的構建原始碼手動將 Apache 安裝到 NetWare（假設您將安裝到 sys:/apache2）

• 在 NetWare 磁碟區上建立一個名為 Apache2 的目錄
• 將 APACHE2.NLM、APRLIB.NLM 複製到 SYS:/APACHE2
• 在 SYS:/APACHE2 下建立一個名為 BIN 的目錄
• 將 HTDIGEST.NLM、HTPASSWD.NLM、HTDBM.NLM、LOGRES.NLM、ROTLOGS.NLM 複製到 SYS:/APACHE2/BIN
• 在 SYS:/APACHE2 下建立一個名為 CONF 的目錄
• 將 HTTPD-STD.CONF 檔案複製到 SYS:/APACHE2/CONF 目錄並重新命名為 HTTPD.CONF
• 將 MIME.TYPES、CHARSET.CONV 和 MAGIC 檔案複製到 SYS:/APACHE2/CONF 目錄
• 將 \HTTPD-2.0\DOCS\ICONS 中的所有檔案和子目錄複製到 SYS:/APACHE2/ICONS
• 將 \HTTPD-2.0\DOCS\MANUAL 中的所有檔案和子目錄複製到 SYS:/APACHE2/MANUAL
• 將 \HTTPD-2.0\DOCS\ERROR 中的所有檔案和子目錄複製到 SYS:/APACHE2/ERROR
• 將 \HTTPD-2.0\DOCS\DOCROOT 中的所有檔案和子目錄複製到 SYS:/APACHE2/HTDOCS
• 在伺服器上建立目錄 SYS:/APACHE2/LOGS
• 在伺服器上建立目錄 SYS:/APACHE2/CGI-BIN
• 建立目錄 SYS:/APACHE2/MODULES 並將所有 nlm 模組複製到 modules 目錄
• 編輯 HTTPD.CONF 檔案，搜尋所有 @@Value@@ 標記，並將它們替換為適當的設定
• 將 SYS:/APACHE2 新增到搜尋路徑，例如

  SEARCH ADD SYS:\APACHE2

Apache 可以安裝到預設 SYS 磁碟區以外的其他磁碟區。

在構建過程中，將關鍵字 "install" 新增到 makefile 命令列將自動在子目錄 DIST 下產生一個完整的發行套件。只需將 makfiles 產生的發行套件複製到 NetWare 磁碟區的根目錄即可安裝 Apache（請參閱：下面的 為 NetWare 編譯 Apache）。

運行適用於 NetWare 的 Apache

要啟動 Apache，只需在控制台中輸入 apache。這將在作業系統位址空間中載入 apache。如果您希望在受保護的位址空間中載入 Apache，可以使用 load 語句指定位址空間，如下所示

這會將 Apache 載入到名為 apache2 的位址空間中。通過將每個實例載入到其自己的受保護位址空間中，可以在 NetWare 上同時運行多個 Apache 實例。

啟動 Apache 後，它將監聽埠 80（除非您更改了配置檔案中的 Listen 指令）。要連接到伺服器並訪問預設頁面，請啟動瀏覽器並輸入伺服器的名稱或位址。這應該會回應一個歡迎頁面，以及一個指向 Apache 手冊的連結。如果沒有任何反應或出現錯誤，請查看 logs 目錄中的 error_log 檔案。

基本安裝完成後，您應該通過編輯 conf 目錄中的檔案來正確配置它。

要卸載在作業系統位址空間中運行的 Apache，只需在控制台中輸入以下內容

或

如果 apache 在受保護的位址空間中運行，請在 unload 語句中指定位址空間

使用 Apache 時，了解它如何找到配置檔案非常重要。您可以在命令列上通過兩種方式指定配置檔案

• -f 指定特定配置檔案的路徑

在這些情況下，應在配置檔案中設定正確的 ServerRoot。

如果您沒有使用 -f 指定配置檔案名稱，Apache 將使用編譯到伺服器中的檔案名稱，通常為 conf/httpd.conf。使用 -V 參數調用 Apache 將顯示此值，標記為 SERVER_CONFIG_FILE。然後，Apache 將按以下順序嘗試確定其 ServerRoot

• 通過 -C 參數的 ServerRoot 指令。
• 命令列上的 -d 參數。
• 目前工作目錄
• 編譯到伺服器中的伺服器根目錄。

編譯到伺服器中的伺服器根目錄通常為 sys:/apache2。使用 -V 參數調用 apache 將顯示此值，標記為 HTTPD_ROOT。

適用於 NetWare 的 Apache 2.0 包括一組命令列指令，可用於修改或顯示有關正在運行的網頁伺服器實例的資訊。這些指令僅在 Apache 運行時可用。這些指令前面都必須加上關鍵字 APACHE2。

RESTART

指示 Apache 在所有正在運行的輔助執行緒變為閒置狀態時終止它們，重新讀取配置檔案，並根據新配置重新啟動每個輔助執行緒。

VERSION

顯示有關當前正在運行的 Apache 實例的版本資訊。

MODULES

顯示已載入模組的列表，包括內建模組和外部模組。

DIRECTIVES

顯示所有可用指令的列表。

SETTINGS

啟用或禁用控制台上的執行緒狀態顯示。啟用後，每個正在運行的執行緒的狀態將顯示在 Apache 控制台螢幕上。

SHUTDOWN

終止正在運行的 Apache 網頁伺服器實例。

HELP

描述每個運行時指令。

預設情況下，這些指令是針對在作業系統位址空間中運行的 Apache 實例發出的。要針對在受保護位址空間中運行的特定實例發出指令，請包含 -p 參數以及位址空間的名稱。有關更多資訊，請在命令列上輸入 "apache2 Help"。

配置適用於 NetWare 的 Apache

Apache 通過讀取通常儲存在 conf 目錄中的配置檔案來配置。這些檔案與用於配置 Unix 版本的檔案相同，但適用於 NetWare 的 Apache 有一些不同的指令。有關所有可用指令，請參閱 Apache 模組文檔。

適用於 NetWare 的 Apache 的主要區別是

• 由於適用於 NetWare 的 Apache 是多執行緒的，因此它不像 Apache 在某些 Unix 實現中那樣為每個請求使用單獨的進程。相反，只有執行緒在運行：一個父執行緒和多個處理請求的子執行緒或輔助執行緒。

  因此，“進程”管理指令有所不同

  MaxConnectionsPerChild - 與 Unix 指令類似，這控制輔助執行緒在退出之前將服務多少個連接。建議的預設值 MaxConnectionsPerChild 0 會導致執行緒無限期地繼續服務請求。建議在 NetWare 上，除非有特殊原因，否則此指令始終保持設定為 0。

  StartThreads - 此指令告訴伺服器最初應該啟動多少個執行緒。建議的預設值為 StartThreads 50。

  MinSpareThreads - 此指令指示伺服器，如果閒置執行緒的數量低於此值，則產生額外的輔助執行緒。建議的預設值為 MinSpareThreads 10。

  MaxSpareThreads - 此指令指示伺服器，如果閒置執行緒的數量超過此值，則開始終止輔助執行緒。建議的預設值為 MaxSpareThreads 100。

  MaxThreads - 此指令將輔助執行緒的總數限制為最大值。建議的預設值為 ThreadsPerChild 250。

  執行緒堆疊大小 (ThreadStackSize) - 此指令告訴伺服器每個工作執行緒要使用多大的堆疊。建議的預設值是 ThreadStackSize 65536。

• 接受檔案名稱作為參數的指令必須使用 NetWare 檔案名稱而不是 Unix 名稱。但是，由於 Apache 內部使用 Unix 樣式名稱，因此必須使用正斜線而不是反斜線。建議所有根檔案路徑都以磁碟區名稱開頭。如果省略，Apache 會假設為 SYS: 磁碟區，這可能不正確。

• 適用於 NetWare 的 Apache 能夠在執行時期載入模組，而無需重新編譯伺服器。如果 Apache 是正常編譯的，它會在 \Apache2\modules 目錄中安裝許多可選模組。要啟用這些或其他模組，必須使用 載入模組 (LoadModule) 指令。例如，要啟用狀態模組，請使用以下指令

  LoadModule status_module modules/status.nlm

  也提供有關 建立可載入模組 的資訊。

其他 NetWare 特定指令

• CGI 映射擴展名 (CGIMapExtension) - 此指令將 CGI 檔案擴展名映射到腳本直譯器。

• 安全監聽 (SecureListen) - 為指定的埠啟用 SSL 加密。

• NWSSLTrustedCerts - 新增用於建立與代理伺服器的安全連線的可信憑證。

• NWSSLUpgradeable - 允許在指定地址/埠上建立的連線升級為 SSL 連線。

編譯適用於 NetWare 的 Apache

編譯 Apache 需要 MetroWerks CodeWarrior 6.x 或更高版本。建置 Apache 後，可以將其安裝到任何 NetWare 磁碟區的根目錄。預設目錄是 sys:/Apache2。

在執行伺服器之前，您必須填寫 conf 目錄。從發佈的 conf 目錄複製檔案 HTTPD-STD.CONF 並將其重新命名為 HTTPD.CONF。編輯 HTTPD.CONF 檔案，搜尋所有 @@Value@@ 標記並將其替換為適當的設定。同時複製 conf/magic 和 conf/mime.types 檔案。或者，可以通過在調用 makefile 時包含關鍵字 install 來建置完整的發佈版本。

需求

建置適用於 NetWare 的 Apache 2.0 需要以下開發工具

• Metrowerks CodeWarrior 6.0 或更高版本，以及 NetWare PDK 3.0 或更高版本。
• NetWare Libraries for C (LibC)
• LDAP Libraries for C
• ZLIB 壓縮庫原始碼
• AWK 工具程式（awk、gawk 或類似工具）。可以從 http://developer.novell.com/ndk/apache.htm 下載 AWK。該工具程式必須位於您的 Windows 路徑中，並且必須命名為 awk.exe。
• 要使用 makefile 建置，您需要 GNU make 3.78.1 版 (GMake)，可從 http://developer.novell.com/ndk/apache.htm 取得。

使用 NetWare makefile 建置 Apache

• 將環境變數 NOVELLLIBC 設定為 NetWare Libraries for C SDK 的位置，例如

  Set NOVELLLIBC=c:\novell\ndk\libc

• 將環境變數 METROWERKS 設定為您安裝 Metrowerks CodeWarrior 編譯器的位置，例如

  Set METROWERKS=C:\Program Files\Metrowerks\CodeWarrior

  如果您安裝到預設位置 C:\Program Files\Metrowerks\CodeWarrior，則無需設定此項。
• 將環境變數 LDAPSDK 設定為您安裝 LDAP Libraries for C 的位置，例如

  Set LDAPSDK=c:\Novell\NDK\cldapsdk\NetWare\libc

• 將環境變數 ZLIBSDK 設定為您安裝 ZLib 庫原始碼的位置，例如

  Set ZLIBSDK=D:\NOVELL\zlib

• 將環境變數 PCRESDK 設定為您安裝 PCRE 庫原始碼的位置，例如

  Set PCRESDK=D:\NOVELL\pcre

• 將環境變數 AP_WORK 設定為 httpd 原始碼目錄的完整路徑。

  Set AP_WORK=D:\httpd-2.0.x

• 將環境變數 APR_WORK 設定為 apr 原始碼目錄的完整路徑。通常是 \httpd\srclib\apr，但 APR 專案可以位於 httpd 目錄結構之外。

  Set APR_WORK=D:\apr-1.x.x

• 將環境變數 APU_WORK 設定為 apr-util 原始碼目錄的完整路徑。通常是 \httpd\srclib\apr-util，但 APR-UTIL 專案可以位於 httpd 目錄結構之外。

  Set APU_WORK=D:\apr-util-1.x.x

• 確保 AWK 工具程式和 GNU make 工具程式 (gmake.exe) 的路徑已包含在系統的 PATH 環境變數中。
• 下載原始碼並解壓縮到您工作站上的適當目錄。
• 將目錄更改為 \httpd-2.0 並通過執行 "gmake -f nwgnumakefile prebuild" 來建置預建工具程式。此目標將建立目錄 \httpd-2.0\nwprebuild 並將完成以下建置步驟所需的每個工具程式複製到此位置。
• 將檔案 \httpd-2.0\nwprebuild\GENCHARS.nlm 和 \httpd-2.0\nwprebuild\DFTABLES.nlm 複製到 NetWare 伺服器的 SYS: 磁碟區，並使用以下命令執行它們

  SYS:\genchars > sys:\test_char.h
SYS:\dftables sys:\chartables.c


• 將檔案 test_char.h 和 chartables.c 複製到建置機器上的目錄 \httpd-2.0\os\netware。
• 將目錄更改為 \httpd-2.0 並通過執行 "gmake -f nwgnumakefile" 來建置 Apache。您可以通過在命令中新增 install 參數來建立發佈目錄，例如

  gmake -f nwgnumakefile install

其他 make 選項

• gmake -f nwgnumakefile

  建置所有二進位檔案的發行版本，並將它們複製到 \release 目標目錄。

• gmake -f nwgnumakefile DEBUG=1

  建置所有二進位檔案的偵錯版本，並將它們複製到 \debug 目標目錄。

• gmake -f nwgnumakefile install

  在 \dist\Apache2 目錄中建立完整的 Apache 發佈版本，其中包含二進位檔案、文件和其他支援檔案。

• gmake -f nwgnumakefile prebuild

  建置所有預建工具程式，並將它們複製到 \nwprebuild 目錄。

• gmake -f nwgnumakefile installdev

  與 install 相同，但還會在目標目錄中建立 \lib 和 \include 目錄，並複製標頭檔和匯入檔案。

• gmake -f nwgnumakefile clean

  從 \release.o 或 \debug.o 建置區域清除所有目標檔案和二進位檔案，具體取決於是否已定義 DEBUG。

• gmake -f nwgnumakefile clobber_all

  與 clean 相同，並且還會刪除發佈目錄（如果存在）。

其他環境變數選項

• 要建置所有實驗性模組，請設定環境變數 EXPERIMENTAL

  Set EXPERIMENTAL=1

• 要使用標準 BSD 樣式套接字而不是 Winsock 建置 Apache，請設定環境變數 USE_STDSOCKETS

  Set USE_STDSOCKETS=1

為 NetWare 平台建置 mod_ssl

默認情況下，適用於 NetWare 的 Apache 使用內建模組 mod_nw_ssl 來提供 SSL 服務。此模組只是啟用 NetWare 作業系統中實現的原生 SSL 服務來處理給定埠的所有加密。或者，也可以像在其他平台上一樣使用 mod_ssl。

在為 NetWare 平台建置 mod_ssl 之前，必須提供 OpenSSL 庫。這可以通過以下步驟完成

• 從 OpenSSL 原始碼 頁面下載最新的 OpenSSL 0.9.8 發行版原始碼（舊的 0.9.7 版本需要修補，因此不建議使用）。
• 編輯檔案 NetWare/set_env.bat 並修改任何工具和工具程式路徑，使其與您的建置環境相對應。
• 從 OpenSSL 原始碼目錄的根目錄執行以下腳本

  Netware\set_env netware-libc
Netware\build netware-libc

  出於效能原因，您應該啟用使用 ASM 程式碼進行建置。從 SF 網站 下載 NASM。然後將 OpenSSL 配置為使用 ASM 程式碼

  Netware\build netware-libc nw-nasm enable-mdc2 enable-md5

  警告：不要使用 CodeWarrior 組譯器 - 它會產生損壞的程式碼！
• 在建置 Apache 之前，將環境變數 OSSLSDK 設定為 openssl 原始碼目錄根目錄的完整路徑，并将 WITH_MOD_SSL 設定為 1。

  Set OSSLSDK=d:\openssl-0.9.8x
Set WITH_MOD_SSL=1