安裝和管理一個AnswerBook2 伺服器 - zh_TW

設置說明文件伺服器

要檢視目前的伺服器設置,請從AnswerBook2「管理」頁面選擇「檢視目前的設置」。要變更這些設定值,請從AnswerBook2「管理」頁面選擇「修正伺服器設置」。

檢視說明文件伺服器的設置

「檢視目前的設置」頁面列出 表 3-1表 3-2 中所示的設定值。這些設定值都儲存在 server_config_path/dwhttpd.cfg 檔案中 (預設為 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg)。


註解 -

如果您正在執行一個以 CGI 為基礎的伺服器,而非預設的 NSAPI 伺服器,那麼「管理」頁面的介面中只能看到某些伺服器的設置選項。如欲取得更多資訊,請參見 "將伺服器作為一個 CGI 處理來執行時的設置議題".


表 3-1 可由使用者設置的伺服器設置的設定值

標籤 

預設值及說明 

伺服器名稱 

預設值﹕本機主機名稱 (例如﹕ imaserver)。這是客戶端用來存取此伺服器上的文件名稱。要改進回應時間,請放入一個完全合格的名稱 (例如﹕ imaserver.eng.sun.com)。如果您想要領域之外的人能夠存取此文件伺服器的話,您就必須放入完全合格的名稱。

伺服器連接埠 

預設值﹕8888。這是用以通訊的連接埠編號。您可以選擇任何未佔用的連接埠,不過建議您最好使用預設的連接埠。

最大的執行緒數目 

預設值﹕32。這是伺服器會執行的最大 AnswerBook1 同時搜尋的數目。如果您擁有許多的 AnswerBook1 合集,而且人們經常搜尋它們的話,最好是將此數目增加一點,不過這樣一來又會減慢伺服器的回應時間。

最大的伺服器要求數目 

預設值﹕1024。這會告知伺服器執行 "housekeeping" 活動,並且在達到特定的 http 要求數目之後自行重新啟動。

存取檔案 

預設值﹕/var/log/ab2/logs/access-8888.log。這是存取記錄檔的完整路徑名稱,此檔包含有關本機伺服器的每一次存取的資訊。

錯誤檔案 

預設值﹕/var/log/ab2/logs/error-8888.log。這是錯誤記錄檔的完整路徑名稱,此檔包含有關所發生的任何錯誤的資訊。

管理存取控制 

預設值﹕On。這會告知您是否可以控制什麼人有在此伺服器上存取管理性功能的權限。當您第一次安裝文件伺服器時,雖然管理性存取控制是開啟的,但卻沒有定義任何預設的使用者姓名及密碼。欲知有關設定起始管理存取的資訊,請參見 "設定起始的管理性存取"

 在重新開機之後自動啟動 AnswerBook2 伺服器

預設值﹕yes。這會決定 AnswerBook2 伺服器軟體是否會在您重新將系統開機之後自動啟動。


註解 -

文件管理員不應手動變更 表 3-2 中所示的設定值。系統會在您安裝伺服器軟體時設置這些設定值。


表 3-2 修復伺服器的設置設定值

標籤 

預設值及說明 

伺服器設置路徑 

預設值﹕/usr/lib/ab2/dweb/data/config

這是儲存此伺服器設置檔案的路徑名稱。 

伺服器使用者 

預設值﹕daemon

這是伺服器處理的所有者。變更此變數的數值會在執行伺服器或存取此伺服器之上的合集時產生嚴重的問題。 

外掛程式檔案 

預設值﹕/usr/lib/ab2/dweb/data/config/nsapi.cfg

這是定義所有伺服器外掛程式的檔案完整路徑名稱。 

Mime 檔案 

預設值﹕/usr/lib/ab2/dweb/data/config/mime.types

這是定義所有 MIME 資訊檔案的完整路徑名稱。 

文件 root 

預設值﹕/usr/lib/ab2/data/docs

這是此伺服器的文件檔案的儲存路徑名稱。 

記錄目錄 

預設值﹕/var/log/ab2/logs

這是此伺服器記錄檔的儲存路徑名稱。 

AnswerBook1 合集資料庫 

預設值﹕/var/log/ab2/catalog/ab1_cardcatalog

此檔可以辨識此伺服器之上安裝的 AnswerBook1 合集。 

AnswerBook2 合集資料庫 

預設值﹕/usr/lib/ab2/dweb/data/config/ab2_collections.template

此檔可以辨識此伺服器之上安裝的 AnswerBook2 合集。 

您也可以使用下列的指令來檢視目前的伺服器設置﹕


% /usr/lib/ab2/bin/ab2admin -o view_config [-m server_name] [-p server_port]

變更說明文件伺服器的設置

當您安裝 AnswerBook2 伺服器軟體時,某些變數會被設定為預設值。請使用「修正伺服器設置」頁面上的欄位來變更這些數值。您可以變更下表所列的伺服器設定值﹕

表 3-3 修正伺服器設置

伺服器名稱 

當您安裝說明文件伺服器時,AnswerBook2 軟體會自動將此變數設定為目前的主機名稱 (例如﹕cats)。如果您想要領域之外的人能夠存取此伺服器之上的文件的話,請將名稱變更為一個完全合格的名稱 (例如﹕cats.house.pets.com)。

伺服器連接埠編號 

要使用一個 8888 以外的連接埠來執行 AnswerBook2 伺服器,請在此欄位中輸入連接埠編號。要使用一個低於 1024 的連接埠編號,您必須執行某些額外的步驟。如欲取得更多資訊,請參見 "使用一個 1024 以外的連接埠編號"

最大的執行緒數目 

這是伺服器會執行的最大 AnswerBook1 同時搜尋的數目。如果您擁有許多的 AnswerBook1 合集,而且人們經常搜尋它們的話,最好是將此數目增加一點,不過這樣一來又會減慢伺服器的回應時間。 

最大的伺服器要求數目 

這會告知伺服器執行 "housekeeping" 活動並且自行重新啟動。此數字表示對伺服器的 http 要求數目。

存取記錄檔 

按一下適當的項目以開啟或關閉存取記錄功能。如果預期到有許多使用者會存取您的說明文件伺服器,最好是定期儲存並重新啟動此記錄檔。欲知更多有關輪換存取記錄檔的資訊,請參見 "輪換記錄檔"

錯誤記錄檔 

按一下適當的項目以開啟或關閉錯誤記錄功能。如果預期到大量的伺服器錯誤,最好是定期儲存並重新啟動此記錄檔。欲知更多有關輪換錯誤記錄檔的資訊,請參見 "輪換記錄檔"

管理存取控制 

按一下適當的項目以開啟或關閉管理性存取控制。當開啟存取控制時,只有那些被定義而擁有管理性存取權限的使用者可以執行此伺服器的管理性功能。 

在重新將系統開機之後自動啟動 AnswerBook2 伺服器 

按一下適當的項目以開啟或關閉此功能。 

這些功能也可以透過管理指令行介面來使用 (ab2admin)。欲知更多有關指令行介面的詳細資訊,請參見 附錄 A, ab2admin(1M) 線上援助頁。您也可以編輯 server_config_path/dwhttpd.cfg 檔案 (它預設為 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg) 以變更這些數值。


註解 -

如果您變更任何這些數值,您必須停止並啟動說明文件伺服器。以 root 的身份登入伺服器,然後鍵入下列指令﹕


# /usr/lib/ab2/bin/ab2admin -o stop# 
/usr/lib/ab2/bin/ab2admin -o start

使用一個 1024 以外的連接埠編號

低於 1024 的連接埠編號是保留作為系統之用。要使用這些編號其中之一 (例如﹕連接埠編號 80) 來執行 AnswerBook2 伺服器﹕

  1. 請使用AnswerBook2「管理」頁面的「修正設置設定值」功能,或是編輯 /usr/lib/ab2/dweb/data/config/dwhttpd.cfg 檔案以將伺服器的連接埠編號變更為 80

  2. 編輯 /usr/lib/ab2/dweb/data/config/nsapi.cfg 檔案以將伺服器的連接埠編號變更為 80

    您應該會看到如下一行文字﹕


    set ServerPort 80
  3. 編輯 /etc/init.d/ab2mgr 檔案以將下列一行文字從 daemon 變更為 root


    su daemon -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG > /dev/null"

    to this:


    su root -c "LD_PRELOAD=$pre_load;LANG=$LNG;AB2_ORIG_LANG=$ORGLNG;LD_LIBRARY_PATH=$LD_LIBP;EBT_REGISTRY=$ER;export LD_PRELOAD LD_LIBRARY_PATH LANG AB2_ORIG_LANG LC_ALL EBT_REGISTRY; $AB2BIN/dwhttpd $AB2CFG > /dev/null"

    這個變更會使母dwhttpd處理作為 root 來執行,因而使用連接埠 80。請注意,子dwhttpd處理仍然作為常駐程式執行。

將伺服器作為一個 CGI 處理來執行時的設置議題

因為 AnswerBook2 伺服器是依照標準的網路協定,您可以將 AnswerBook2 伺服器作為現存伺服器,而非預設 NSAPI 伺服器之上的一個 CGI 處理來執行。欲知有關如何設置您的伺服器以如此執行的資訊,請參見 "執行 AnswerBook2 伺服器作為一個 CGI 程序"

如果您將說明文件伺服器作為一個 CGI 處理來執行,下列設置設定值將不會顯示在AnswerBook2「管理」頁面的「檢視設置設定值」頁面中﹕

「修正伺服器設置」頁面上唯一可用的選項將可開啟或關閉存取控制。所有其他的功能都不會被顯示出來。

下列 ab2admin 指令的選項將無法使用﹕