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

第 4章 解決 AnswerBook2 的問題

這一節說明如何解決AnswerBook2產品的已知問題,包括的資訊如下:

伺服器錯誤

以下的表格列出了當您提供線上文件時可能遇到的問題。

表 4-1 可能的伺服器問題

如果您看到這個... 

請嘗試... 

請參閱... 

瀏覽程式委託錯誤

編輯/usr/lib/ab2/dweb/data/config/dwhttpd.cfg檔並變更主機名稱為主機名稱.區域

例如,不要使用以下的指令行:


set ServerHost imaserver ;#
而用這個指令行:

set ServerHost imaserver.eng.sun.com ;#
然後,重新啟動文件伺服器。

如果問題依然存在,請嘗試關閉全球資訊網瀏覽程式的委託。 

瀏覽程式錯誤表示文件伺服器 沒有回應

如果文件伺服器沒有回應,請將其重新啟動。 

若需要停止和啟動伺服器的資訊,請參閱"啟動與停止說明文件伺服器"

錯誤 404嘗試存取文件伺服器時,"找不到檔案"

伺服器程序正在執行,但是伺服器軟體已刪除。重新安裝伺服器軟體。

若需要安裝軟體的資訊,請參閱"安裝 AnswerBook2 軟體"

使用者表示程式庫頁只顯示導航軸,而沒有文件聚集

確定聚集樣板檔案(/usr/lib/ab2/dweb/data/config/ab2_collections.template)沒有任何空白或複製的登錄。

如果修改樣板檔案仍然無法解決這個問題,您可能需要重新安裝文件聚集或伺服器軟體。若需關於安裝軟體的資訊,請參閱"安裝 AnswerBook2 軟體"

使用者報告在一本書中(或好幾本書中)看到紅色的文字及"BUG"這個字樣 

書籍的來源中有 AnswerBook2 無法辨識的標記(markup tags),而 AB2_DEBUG 環境變數 在伺服器上的設定為"1"。 

要關閉錯誤顯示,請將 AB2_DEBUG 旗號設定為"0",停止伺服器再啟動伺服器。 

請洽詢提供書籍者,將此標記的問題解決。 

無法在文件伺服器上存取管理功能

AnswerBook2 文件伺服器使用存取權控制機制來辨識可以執行管理功能的使用者。 AnswerBook2 管理工具可以讓伺服器機器的文件管理者新增和刪除伺服器的管理使用者,並變更他們的密碼。 

若要為您的伺服器新增或刪除管理使用者,請參閱"控制管理性存取"。如果您需要存取其他的伺服器,請洽詢那個伺服器的文件管理者。

無法從 AnswerBook2 管理頁面(瀏覽程式介面)執行管理指令

由於許可權的問題,所以有一些特定的功能無法從AnswerBook2運作。請嘗試從ab2admin指令行介面執行同樣的功能。

若需要關於指令行選項的資訊,請參閱附錄 A, ab2admin(1M) 線上援助頁

"掃描區域性安裝的聚集"功能不會列出安裝在區域裝載點的文件聚集 

確定聚集安裝的目錄 已經被設定為對其他的目錄有讀取的存取權。

 

您新增了一個 AnswerBook1聚集,但是使用者在他們的程式庫看不到這個聚集 

這表示ab_cardcatalog檔中的聚集資料有問題。請確定/var/log/ab2/catalog/ab1_cardcatalog中的資訊是正確的。

 

當您嘗試要透過AnswerBook2管理 頁面新增聚集時,看到這個訊息無法新增聚集

確定到聚集的collinfoab_cardcatalog檔的路徑是正確的。

 

使用重新啟動指令來重新啟動文件伺服器失敗或沒有產生預期的結果

在某些情況中,重新啟動指令沒有正確運作。使用停止啟動指令來代替。

若需要更進一步的資訊,請參閱"啟動與停止說明文件伺服器"

文件聚集似乎已毀壞,需要重新安裝 

使用ab2admin -o del_coll功能或AnswerBook2 管理頁面中的"從清單刪除聚集",從文件伺服器的資料庫中移除這些聚集。

然後用 pkgrm 在安裝新的文件聚集前把文件在伺服器上去掉。

若需要更進一步去掉文件的資訊,請參閱"移除 AnswerBook2 合集"。若需要更進一步增設文件的資訊,請參閱"新增合集"

AnswerBook2 錯誤訊息

本節將說明有關 AnswerBook2 的錯誤訊息及其因應之道。

驗證失敗,請再試一次。

意思是:管理使用者鍵入錯誤的管理密碼。

因應之道:重新鍵入密碼。如果還是失敗,請確定此管理員及密碼對您所要管理的伺服器仍為有效。

找不到要管理的本機 AnswerBook2 伺服器。

意思是:answerbook2_admin嘗試使用指令集或嘗試從 CDE 前方面板啟動AnswerBook2失敗,因為系統中沒有說明文件伺服器。

因應之道:可以到說明文件伺服器所在的系統,再依照同樣的程序執行一次,或者輸入您要在瀏覽器中管理的說明文件伺服器的 URL。

無法與替代伺服器交談server_name.

意思是﹕嘗試與特定的替代伺服器聯繫失敗,不是因為伺服器名稱或連接埠不存在,就是因為以您公司網路之外的伺服器存取被攔截。

因應之道﹕請確認替代伺服器的名稱及連接埠都正確。如果是的話,請確認替代伺服器位於您公司的防火牆之內。如果您試著新增的替代伺服器是屬於您公司防火牆之外,基於網路安全性方面的顧慮,可能無法將它新增為一個替代伺服器。

找不到 AnswerBook2 說明文件伺服器。

意思是:嘗試要使用answerbook2指令集,或嘗試要從 CDE 前方面板啟動客戶端檢視器失敗,因為沒有已定義的預設說明文件伺服器。

因應之道:客戶端檢視器會以下列方法來尋找預設的說明文件伺服器:

  1. 如果您已經定義了環境變數AB2_DEFAULTSERVER,AnswerBook2檢視器便會以該變數所定義的 URL 來啟動。例如,您可能會看見下面這行字出現在.cshrc檔案中:


    setenv AB2_DEFAULTSERVER http://imaserver.eng.sun.com:8888/
    

  2. 如果您用於起始AnswerBook2功能的電腦是說明文件伺服器,AnswerBook2檢視器會嘗試存取 URL:http://localhost:8888

  3. 如果AnswerBook2伺服器是向 FNS(聯合命名服務)登錄的,AnswerBook2檢視器會採用登錄伺服器的 URL。