第 3章 管理AnswerBook2伺服器

軟體包含執行下列動作的功能，其所包括的特定工作如下﹕

• "管理說明文件伺服器"

• "啟動與停止說明文件伺服器"

• "開啟或關閉文件來源除錯功能"

• "控制管理性存取"

• "以文件合集工作"

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

• "以其他說明文件伺服器工作"

• "以伺服器報告工作"

• "共用管理頁面導航功能"

管理說明文件伺服器

AnswerBook2 軟體提供使用者一個網路瀏覽器介面 (AnswerBook2「管理」頁面) 以及一個指令行介面 (ab2admin)，您可以用來管理說明文件伺服器。這兩個介面都包括其中大多數的功能。

如果是從一張光碟執行說明文件伺服器，那麼就無法使用管理功能。

要存取主要AnswerBook2「管理」頁面，請從 AnswerBook2 瀏覽器的「選項」頁面選擇AnswerBook2 「管理」，或是存取 URL: http://server:port/ab2/@Ab2Admin，其中 server 是您伺服器的名稱，而 port 則是伺服器所執行的連接埠編號, 。 「管理」頁面中的所有頁面包括橫跨頁面頂端的共用頁面導航功能。

要存取指令行介面，請使用 /usr/lib/ab2/bin/ab2admin 指令。欲知有關指令行介面的詳細資訊，請參見 附錄 A, ab2admin(1M) 線上援助頁。

只有授權的管理性使用者可以存取管理性功能。如欲取得更多資訊，請參見 "控制管理性存取"。

啟動與停止說明文件伺服器

當您將執行說明文件伺服器的系統開機之後，伺服器可以自動啟動 (利用 /etc/init.d/ab2mgr 指令集)。您也可以在必要時手動開始、停止、並重新啟動說明文件伺服器。例如﹕您必須在安裝一個新的文件合集之後，重新啟動說明文件伺服器。

要執行這些功能，以 root 的身份登入說明文件伺服器，然後使用 ab2admin 指令行介面。

• 要啟動說明文件伺服器，請使用下列指令﹕

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

• 要停止說明文件伺服器，請使用下列指令﹕

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

• 要重新啟動說明文件伺服器，請使用下列指令﹕

  # /usr/lib/ab2/bin/ab2admin -o restart

  如果重新啟動伺服器沒有達到預期中的目的，請停止並再次啟動伺服器。

• 要在啟用除錯功能的狀態下啟動說明文件伺服器，請使用如下所示的啟動指令﹕

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

• 要阻止伺服器在重新將系統開機時自動啟動，請使用此指令﹕

  # /usr/lib/ab2/bin/ab2admin -o autostart_no

開啟或關閉文件來源除錯功能

AnswerBook2 伺服器有一個除錯選項，在啟用時會在檢視器中以紅色的 "BUG" 一字來顯示書籍來源中無法辨識的標記。此功能有助於在書籍無法正常顯示時找出問題的所在。

要開啟除錯功能，以 root 的身份登入說明文件伺服器的系統，然後將環境變數設為 AB2_DEBUG 1。例如﹕

% su -# 
setenv AB2_DEBUG 1

要關閉除錯功能，以 root 的身份登入說明文件伺服器的系統，然後將環境變數設為 AB2_DEBUG 0。例如﹕

% su -# 
setenv AB2_DEBUG 0

在您變更除錯參數之後，您必須 重新啟動說明文件伺服器。要重新啟動說明文件伺服器，請鍵入﹕

# /usr/lib/ab2/bin/ab2admin -o restart

要在您啟動伺服器時控制除錯功能，請使用如下所示的啟動指令﹕

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

控制管理性存取

一位管理性使用者就是經特別定義以執行文件管理性功能的使用者。AnswerBook2 產品會利用密碼來確認某一位特定的管理員是否有權限在伺服器上執行管理性功能。

設定起始的管理性存取

AnswerBook2 軟體已經將執行管理性功能的存取控制開啟，但是卻沒有定義任何預設的管理性使用者。當您第一次嘗試存取 AnswerBook2 管理性功能時，軟體會通知您存取控制已開啟，但沒有定義任何使用者。您可以由此執行下列兩者其中之一﹕

• 關閉存取控制。

  要關閉存取控制，以 root 的身份登入說明文件伺服器，然後鍵入下列文字﹕

  # /usr/lib/ab2/bin/ab2admin -o auth_off

  ---

  小心 -

  如果您將存取控制關閉的話，任何可以存取您的說明文件伺服器的使用者便都能修正您的說明文件伺服器。

  ---

• 定義一位管理性使用者及密碼.

  要定義一位管理性使用者，以 root 的身份登入說明文件伺服器，然後鍵入下列文字﹕

  # /usr/lib/ab2/bin/ab2admin -o add_admin -u admin-id

  其中 admin-id 是管理此說明文件伺服器的登入識別碼。admin-id 並不需要與使用者的系統登入識別碼相符，它只是在一個特定的伺服器之上執行與文件有關的管理性功能所需。

  軟體會提示您為此使用者輸入一個密碼，然後再重新輸入一次以作為確認之用。

新增AnswerBook2管理員的存取權限

要新增一個管理性使用者，請從AnswerBook2「管理」頁面選擇「資訊管理員」。要新增管理性使用者﹕

1. 在「管理員識別碼」欄位中鍵入管理員的登入識別碼。

   admin-id 並不需要與使用者的系統登入識別碼相符，它只是在一個特定的伺服器之上執行與文件有關的管理性功能所需。

2. 鍵入管理員的密碼。

   此密碼被儲存在一個AnswerBook2密碼資料庫中。它並不需要與使用者的系統密碼相符。

您必須分別輸入密碼兩次以作為確認之用。

您也可以使用下列指令以執行此功能﹕

% /usr/lib/ab2/bin/ab2admin -o add_admin -u admin-id [-m server_name] [-p server_port]

變更一位管理員的密碼

要變更一位管理員的密碼，請從AnswerBook2「管理」頁面選擇「變更密碼」。要修正密碼﹕

1. 從「管理員識別碼」即現式清單中選擇管理性使用者。

2. 在「舊密碼」欄位中鍵入管理員現存的密碼 。

3. 在「新密碼」欄位中鍵入管理員的新密碼。

4. 在「重新輸入新密碼」欄位中再次鍵入管理員的新密碼。

5. 按一下「變更密碼」以套用此變更。

當您按一下「變更密碼」之後，AnswerBook2 軟體會檢查以確定「新密碼」及「重新輸入新密碼」欄位中所輸入的資料相符。如果是的話，新的密碼就會被儲存在資料庫中。如果不符，軟體便會顯示一個錯誤訊息。

您也可以使用下列指令以執行此功能﹕

% /usr/lib/ab2/bin/ab2admin -o change_password -u admin-id [-m server_name] [-p server_port]

移除一位管理員的存取權限

要將一位使用者從此伺服器的管理性使用者清單中移除，請從AnswerBook2「管理」頁面選擇「刪除管理員」。要移除管理員﹕

1. 按一下您想要從管理員清單中移除的管理員登入識別碼旁邊的核選方塊。

   這是管理員的識別碼，而非個人的系統或使用者識別碼。

2. 按一下「刪除管理員」。

   ---

   註解 -

   這對個人作為一位使用者來存取 AnswerBook2 文件的權限沒有任何影響。它只會移除個人執行管理性功能的權限。

   ---

您也可以使用下列指令以執行此功能﹕

% /usr/lib/ab2/bin/ab2admin -o del_admin -u admin-id [-m server_name] [-p server_port]

以文件合集工作

一個AnswerBook2 合集是一種邏輯性的書籍組合。例如﹕您可以有一個包含所有Solaris^TM與開發者相關書籍的合集。此合集可以是一個 AnswerBook2 (SGML) 合集，或是一個 AnswerBook1 (顯示 PostScript^TM) 合集。

列出合集

要查看一份您伺服器上安裝的所有合集清單，請從AnswerBook2「管理」頁面選擇「可用合集的檢視清單」。此份清單會包括 AnswerBook1 合集以及 AnswerBook2 合集。

您也可以使用下列指令以執行此功能﹕

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

新增合集

要將一個合集新增至伺服器的資料庫中，請從AnswerBook2「管理」頁面選擇「將合集新增至清單」。此功能會假設合集已經存在，作為伺服器的系統或其他某些伺服器存取的系統上一個安裝的套裝軟體。如果尚未安裝合集，請先使用 pkgadd 來新增合集，然後再使用此功能。如果是新的合集 (例如 Solaris 2.6 說明文件光碟上的合集)，如果您在伺服器上執行 pkgadd 指令，它會自動將此合集新增至伺服器的清單中。

執行下列步驟以安裝合集﹕

1. 在「合集路徑」欄位中鍵入一個到合集檔案的有效路徑。

   例如﹕/opt/answerbooks/english/solaris_2.7/SUNWaman/collinfo。此路徑必須指向一個目錄，其中包含一個AnswerBook2合集的 collinfo 檔案，或是一個 AnswerBook1 合集的 ab_cardcatalog 檔案。

2. 按一下「新增合集」。

您也可以使用下列指令以執行此功能﹕

% /usr/lib/ab2/bin/ab2admin -o add_coll -d path_to_collection

在您安裝一個合集之後，您必須重新啟動說明文件伺服器。要重新啟動說明文件伺服器，請按一下「管理」頁面狀態頁上的「重新啟動」按鈕，或是從指令行鍵入下列文字﹕

# /usr/lib/ab2/bin/ab2admin -o restart

新增現存的合集

AnswerBook2 伺服器可以掃描您目前的系統，以尋找在本機安裝的 AnswerBook1 及 AnswerBook2 合集，並且將它們新增至伺服器的資料庫中。要讓伺服器為您執行此功能，請從AnswerBook2「管理」頁面選擇「掃描本機安裝的合集」。此功能會建立與顯示一份它在本機系統之上找出的所有有效文件合集清單。

要將一個合集新增至伺服器的資料庫﹕

1. 按一下您想要新增的合集旁邊的核選方塊。

   旁邊沒有核選方塊的合集表示已經在資料庫中。

2. 當您選定想要新增的所有合集之後，請按一下「新增選定的合集」。

如果清單並不包括安裝在一個本機裝載點之上的文件合集，請確認安裝合集目錄的read存取是設定為others。

您也可以使用下列指令以執行此功能﹕

% /usr/lib/ab2/bin/ab2admin -o scan

掃描功能的指令行會新增找到的所有合集；它無法讓您自行選取要新增的合集。

在您安裝一個合集之後，您必須重新啟動說明文件伺服器。要重新啟動說明文件伺服器，請按一下「管理」頁面狀態頁上的「重新啟動」按鈕，或是從指令行鍵入下列文字﹕

# /usr/lib/ab2/bin/ab2admin -o restart

移除 AnswerBook2 合集

要從伺服器的資料庫中移除一個 AnswerBook2 或 AnswerBook1 合集，請從AnswerBook2「管理」頁面選擇「從清單刪除合集」。要移除合集﹕

1. 從「合集」清單中，按一下您想要移除的合集標題旁的核選方塊。(要取消一個選定項目的選取，請再按一下該核選方塊。)

2. 在您選定想要移除的所有合集之後，請按一下「刪除合集」。

您也可以使用下列指令以執行此功能﹕

% /usr/lib/ab2/bin/ab2admin -o del_coll -t collection_title

這些功能不會從系統中移除合集套裝軟體；它們只會從伺服器的資料庫中移除該合集的項目。要從系統中移除套裝軟體，請使用 pkgrm 公用程式。

在移除一個合集之後，您必須重新啟動說明文件伺服器。要重新啟動說明文件伺服器，請按一下「管理」頁面狀態頁上的「重新啟動」按鈕，或是從指令行鍵入下列文字﹕

# /usr/lib/ab2/bin/ab2admin -o restart

設置說明文件伺服器

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

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

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

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

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

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

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

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

當您安裝 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「管理」頁面的「檢視設置設定值」頁面中﹕

• 最大的執行緒數目

• 最大的伺服器要求數目

• 伺服器設置路徑

• 伺服器使用者

• 外掛程式檔案

• Mime 檔案

• 文件 Root

• 記錄目錄

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

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

• -o access_on

• -o access_off

• -o error_off

• -o error_on

• -o modify_server_name

• -o modify_server_port

以其他說明文件伺服器工作

當一位使用者按一下一本書上的鏈結時，AnswerBook2 伺服器會跟隨該鏈結來到另一個 AnswerBook2 伺服器。如果目前的說明文件伺服器上存在此書籍，鏈結便會來到該處。然而，如果鏈結的書籍不在目前的伺服器之上，則AnswerBook2 伺服器"就會轉移到" 定義給它存取的任何替代說明文件伺服器之上。您可以使用此功能來在各個伺服器上配送文件，或者是建立一份文件的備份。

辨識替代說明文件伺服器

要查看所定義的替代伺服器，請從AnswerBook2「管理」頁面「選擇檢視替代伺服器的清單」。這會顯示一份目前定義為 "轉移" 伺服器的伺服器清單。如果一位使用者按一下一本書上的鏈結，而該書籍不唯一目前的伺服器之上，則AnswerBook2 產品會檢視從清單中的伺服器，以找出鏈結的目標。AnswerBook2 伺服器有一個事先定義的替代伺服器 http://docs.sun.com/，它是 Sun 的主要說明文件伺服器，其中包含相關的 Sun 說明文件。

為目前的伺服器所定義的每個替代伺服器，此頁面會顯示伺服器的名稱、其連接埠編號、以及與一份伺服器上安裝的合集清單的鏈結。當您按一下顯示合集清單時，您會被提示要輸入替代伺服器一個有效的管理性識別碼及密碼 (如果該替代伺服器定義了管理性存取控制的話)。換句話說，您可以新增一個沒有管理性存取的替代伺服器，但是如果您讓它擁有管理性存取的話，您便只能在替代伺服器之上檢視合集清單。

您也可以使用下列指令以執行此功能﹕

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

新增替代說明文件伺服器

要啟用您目前的伺服器以存取位於其他伺服器之上的書籍 (為了跟隨書籍之間的鏈結)，請從AnswerBook2「管理」頁面中選擇「新增替代伺服器」。

1. 在AnswerBook2「伺服器名稱」欄位中鍵入替代伺服器的名稱。

2. 在「伺服器連接埠編號」欄位中鍵入替代伺服器的AnswerBook2連接埠編號。如果您不確定連接埠編號為何，請試 8888 (AnswerBook2 預設連接埠編號)。

3. 按一下「新增伺服器」。

   ---

   註解 -

   如果您想要新增的替代伺服器位於公司網路之外，您可能無法將它新增。這通常是有關"firewall" 的問題。

   ---

您也可以使用下列指令以執行此功能﹕

% /usr/lib/ab2/bin/ab2admin -o add_server -M add_server_name -P add_server_port  [
-m server_name] [-p server_port]

移除額外的說明文件伺服器

要從您的替代伺服器清單中移除一個伺服器，請從AnswerBook2「管理」頁面選擇「刪除替代伺服器」。

1. 從「伺服器清單」中選擇伺服器。

2. 按一下「刪除伺服器」。

這會將伺服器從本機說明文件伺服器的替代伺服器清單中移除。它不會阻止被移除的伺服器作為一個說明文件伺服器來運行。

您也可以使用下列指令以執行此功能﹕

% /usr/lib/ab2/bin/ab2admin -o del_server -M del_server_name -P del_server_port  [
-m server_name] [-p server_port]

修正替代伺服器的順序

當您將一個替代伺服器新增至您的伺服器可以使用的清單中，此替代伺服器會被新增至伺服器順序的最底端。此順序會決定您的伺服器存取替代伺服器以跟隨文件鏈結的序列。如果有一位使用者向程式庫要求一份特定的文件，而預設伺服器之上沒有該份文件，那麼伺服器便會依照預定的序列來搜尋替代伺服器的清單，以尋找該份文件。

要變更您的系統所能用的伺服器順序，請從AnswerBook2「管理」頁面選擇「修正伺服器順序」。

1. 從伺服器的清單中選擇一個伺服器。

2. 按一下「在清單中上移」或「在清單中下移」。

3. 按一下「移動」。

沒有可以執行此功能的指令行選項。

以伺服器報告工作

AnswerBook2 伺服器軟體會保留一份記錄，顯示伺服器錯誤及伺服器的存取情況。此外，也會提供一份摘要報告，指出文件合集被存取的頻繁性，以及有多少錯誤發生。

書籍存取摘要報告

要查看伺服器上書籍的存取摘要，請從AnswerBook2「管理」頁面選擇「檢視書籍存取摘要」。書籍存取報告會綱要性地說明伺服器上的每一本書被存取的頻繁性。它會為伺服器之上的每一本書顯示下列內容﹕

• 書籍標題 - 書籍在程式庫頁面出現的標題

• 書籍短名 - 書籍設置檔案中所指的書籍的短名

• 合集名稱 - 書籍所屬合集的短名，如 collinfo 檔案中所指

• 次數 - 書籍被存取的次數

• 錯誤 - 與書籍有關的錯誤數目

存取記錄檔

要開啟或關閉存取記錄功能，請從AnswerBook2「管理」頁面選擇「修正伺服器設置」。

• 要將有關是誰在說明文件伺服器上存取的資訊寫入存取記錄檔中，請按一下「開啟」旁邊的按鈕，然後按一下套用」。此檔預設的位置為 /var/log/ab2/logs/access-8888.log。

• 要停止將資訊寫入存取記錄檔，按一下「關閉」旁的按鈕，然後按一下「套用」。

您也可以使用下列指令以執行這些功能﹕

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

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

在您變更記錄功能之後，您必須 停止並啟動說明文件伺服器。以 root 的身份登入伺服器，然後鍵入下列指令﹕

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

檢視存取記錄

要檢視存取記錄檔，請從AnswerBook2「管理」頁面選擇「檢視記錄檔」，然後按一下「檢視存取記錄檔」。存取記錄檔是一個文字檔案，其中列出說明文件伺服器上的每一次存取。存取記錄檔中的每一行看起來都如下所示﹕

129.146.83.55 - - [04/Nov/1996:15:07:05 -0800] "GET /icons/ab2_curr_home.gif HTTP/1.0" 200 1938

其中﹕

• 第一組數字是客戶端的 IP (網際網路通訊協定) 位址。例如﹕129.146.83.55。

• 三角形括號中間的資訊是存取的日期及時間。例如﹕[04/Nov/1996:15:07:05 -0800] 。

• 雙引號之間的資訊表示發生什麼存取。這通常會辨識出一個 URL 或檔案名稱，以及用來回應存取要求的協定。例如﹕"GET /icons/ab2_curr_home.gif HTTP/1.0" 讓您得知存取嘗試使用 HTTP 1.0 協定來取得 /icons/ab2_curr_home.gif 檔案。

• 倒數第二個編號表示存取成功 (200) 與否 (其他情況)。

• 最後一個編號表示任何傳回要求者的資訊大小 (KB)。例如﹕1938 是所擷取.gif 檔案的大小。

您也可以使用下列指令以執行此功能﹕

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

錯誤記錄檔

要開啟或關閉錯誤記錄功能，請從AnswerBook2「管理」頁面選擇「修正伺服器設置」。

• 要將在說明文件伺服器上發生的任何錯誤資訊寫入錯誤記錄檔中，請按一下開啟旁的按鈕，然後按一下「套用」。此檔案的預設位置為 /var/log/ab2/logs/errors-8888.log。

• 要讓資訊停止寫入錯誤記錄檔，請按一下關閉旁的按鈕，然後按一下「套用」。

您也可以使用下列指令以執行這些功能﹕

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

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

在您變更記錄功能之後，您必須停止並啟動說明文件伺服器。以 root 的身份登入伺服器，然後鍵入下列指令﹕

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

檢視錯誤記錄檔

要檢視錯誤記錄檔，請從AnswerBook2「管理」頁面選擇「檢視記錄檔」，然後按一下「檢視錯誤記錄檔」。錯誤記錄檔會列出此說明文件伺服器上所發生的每一個錯誤。您可以利用此資訊來決定伺服器問題或任何不尋常行徑的原因。這些錯誤通常可以指出與此錯誤有關的伺服器及連接埠，以及某些說明錯誤的文字。

您也可以使用下列指令以執行此功能﹕

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

輪換記錄檔

您可以將目前的存取或錯誤記錄檔儲存到一個檔案，然後開始將資訊記錄到一個空白的檔案中。

• 要輪換錯誤記錄檔，請從AnswerBook2「管理」頁面選擇「輪換錯誤記錄檔」。

• 要輪換存取記錄檔，請從AnswerBook2「管理」頁面選擇「輪換存取記錄檔」。

當「輪換存取 (錯誤) 記錄檔」頁面出現時﹕

1. 在「儲存記錄檔」欄位中鍵入要儲存的檔案名稱。

   預設值是 current_date.current_log_file_name.log，其中 current_date 是 YearYearYearYear_MonthMonth_DayDay_HourHour的形式，而 current_log_file_name預設為access-8888.log 或 error-8888.log (例如﹕1997_02_26_14.access-8888.log)。

   請注意，「記錄檔位置」欄位會顯示您儲存檔案的所在。您無法變更頁面上的這項資訊。

2. 按一下「套用」。

在您變更記錄功能之後，您必須停止並啟動說明文件伺服器。以 root 的身份登入伺服器，然後鍵入下列指令﹕

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

您也可以使用下列指令以執行這些功能﹕

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

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

共用管理頁面導航功能

在 AnswerBook2 產品中每一個頁面頂端，都有一系列的共用導航功能。下表將說明您從「管理」頁面選擇這些功能之後可以執行的功能。

在許多「管理」頁面之上，按一下 圖示就可帶您到主要的 AnswerBook2 「管理」頁面。