Solaris 7(SPARC 平台版)安裝程式庫

第 8章 存取線上文件

本章解釋如何安裝與使用本 AnswerBook2TM 產品以瀏覽、搜尋及列印線上文件。它包括下列資訊:

AnswerBook2 產品簡介

本 AnswerBook2 產品是 Sun 線上文件系統。它使用可讓您查看與列印各種 SolarisTM資訊的網路瀏覽器介面,包括以 SGML 為基礎的 AnswerBookTM 聚集、顯示 PostScriptTM AnswerBook 聚集及線上援助頁。

本 AnswerBook2 產品提供您可尋找整個文件程式庫的資訊搜尋引擎。您可以在集中式文件伺服器或區域伺服器上安裝文件聚集。


註解 -

於整份 AnswerBook2 文件內,名詞 AnswerBook1 係指以 Solaris 作業環境的前 2.6 版所提供的 AnswerBook 產品的版本。


AnswerBook2 特色與功能

本 AnswerBook2 產品提供下列特色與功能:

此版次的新 AnswerBook2 功能

以下列表識別此版次的 AnswerBook2 軟體所提供的新的或實際增強的功能。

各部分簡介

本 AnswerBook2 產品是由下列元素所構成:

常見的問題

此部分列出一些有關 AnswerBook2 產品常見的問題以及這些問題的答案。

什麼是 AnswerBook2?

本 AnswerBook2 產品使用以-為基礎的標準文件伺服器,經由您最喜愛的網路瀏覽器傳送線上文件。本 AnswerBook2 介面可以讓您瀏覽、搜尋與列印各種 Solaris 資訊,包括 AnswerBook1 聚集與線上援助頁。

AnswerBook2 與 AnswerBook 有何不同?

前 AnswerBook 產品(現稱為 AnswerBook1) 使用顯示 PostScript 顯示主要為紙上傳送所發展的文件電子版。本 AnswerBook2 產品使用網路瀏覽器顯示為使用 SGML的線上傳送所發展的文件,並顯示現存的 AnswerBook1 文件。

一些產品之間的主要差別為:

  • 網路瀏覽器介面 - 您可以使用任何平台上、任何符合 HTML 3.2 的瀏覽器查看具有 AnswerBook2 產品的線上文件。

  • 來源彈性 - 本 AnswerBook2 伺服器可以傳送 AnswerBook1(顯示PostscriptTM)文件或 AnswerBook2(SGML)文件。

  • 主從式支援 - 本 AnswerBook2 產品允許您在中央位置安裝伺服器與文件聚集,並從其它系統查看文件。此外,它包括 "失敗結束" 機制,在其中文件管理者可以定義多重文件伺服器,因此文件之間的連結可以一直運作。

  • 交叉平台 - 關於此版次,AnswerBook2 文件伺服器必須在 Solaris 7 作業環境(SPARC或 Intel)中執行。然而,AnswerBook2 客戶機可以在任何平台上執行,而未來的版次可能會在其餘平台上提供伺服器功能。

  • 內定搜尋行為 - 本 AnswerBook2 產品使用「和」作為其內定搜尋行為而非「或」(AnswerBook1 產品中的內定搜尋行為)。

我仍然可以用 AnswerBook2 查看我的舊 AnswerBook 聚集嗎?

可以,除非您的舊 AnswerBook 文件是在 Solaris 2.2 作業環境的版次之前建立的。如果要將 AnswerBook1 聚集增加至 AnswerBook2 伺服器的資料庫,文件管理者會使用AnswerBook2 "增加聚集" 功能,並指到包含 AnswerBook1 ab_cardcatalog 檔案的目錄。

AnswerBook2 對於 AnswerBook1 與 AnswerBook2 文件提供相同的功能嗎?

不。為了一致,AnswerBook1 文件的 AnswerBook2 介面與 AnswerBook1 產品介面是類似的。因此,本 AnswerBook2 產品在 AnswerBook1 與 AnswerBook2 聚集的功能中提供下列不同之處:

  • 您無法顯示或隱藏 AnswerBook1 目錄列表的所有層次;只可顯示或隱藏目錄中特定區段的詳細資訊。

  • AnswerBook1 內容頁不包括其它主題區段。如果要從一頁導覽到另一頁,您可以使用 Next Topic 連結或返回目錄並選取書中另一區段。

  • AnswerBook1 內容頁一次顯示整章,而不是較小的區段。

  • 搜尋結果圖像不太能表示符合 AnswerBook1 資訊的機率;圖像傾向於完全填滿或完全空白。

  • AnswerBook1 文字中未選取的搜尋名詞。

  • 有些 AnswerBook1 圖形無法在線內顯示;它們是由當按一下顯示圖形的 PostScript 影像時的圖像來識別。

  • Man Pages by Keyword 搜尋的線上援助頁只包括伺服器上的 AnswerBook2(以 SGML 為基礎的)線上援助頁,不包括 AnswerBook1 線上援助頁。

  • AnswerBook1 線上援助頁使用與其它 AnswerBook1 文件相同的介面;並沒有特殊的線上援助頁介面。

文件在何處?

文件伺服器軟體與 Solaris 7 文件聚集是在 Solaris 7 Documentation CD。圖 8-1 經由 圖 8-6 列表可供使用的特定文件聚集並識別這些文件可供使用的僅有硬本(列印的)格式。

圖 8-1 桌上管理系統文件

Graphic

圖 8-2 參考文件(線上援助頁)

Graphic

圖 8-3 系統管理文件 - 第一部分

Graphic

圖 8-4 系統管理文件 - 第二部分

Graphic

圖 8-5 設計者文件 - 第一部分

Graphic

圖 8-6 設計者文件 - 第二部分

Graphic

開始

如果要使用 AnswerBook2 系統查看線上文件,您需要用與 HTML 3.2-相容的瀏覽器(例如 HotJavaTM、Netscape 導航器TM 或 LynxTM),和至文件伺服器的存取權(識別機器的 URL,機器上安裝了文件聚集,且其執行以網路為基礎的伺服器將聚集傳送給您)。若需更多的資訊,從下列選擇:

有關使用本 AnswerBook2 產品或管理文件伺服器的詳細資訊,只要您有可存取的文件伺服器,就可使用 AnswerBook2 輔助說明。

我需要安裝任何東西嗎?

下表指出您需要做的事或安裝的東西以提供特定的 AnswerBook2 功能。

表 8-1 何時安裝與安裝何物
 如果您希望... 那麼...
 從您的桌上管理系統(任何平台、任何作業環境)查看線上文件。啟動網路瀏覽器並輸入文件伺服器的 URL(例如,http://imaserver:8888/)。請參閱 "啟動 AnswerBook2 查看器程式"
 從您的桌上管理系統以適當的伺服器 URL 自動啟動網路瀏覽器。如果您正在執行 Solaris 7 作業環境,識別文件伺服器並從 CDE 輔助說明功能表或 OpenWindowsTM 程式功能表選擇 AnswerBook2 選項。請參閱"啟動 AnswerBook2 查看器程式"
 使您的系統(機器)能夠傳送(伺服)文件。從 Solaris 7 Documentation CD 安裝文件伺服器軟體。請參閱 "安裝文件伺服器軟體"
 從 Solaris 7 Documentation CD 或其它位置增加文件到您的文件伺服器。文件管理者是唯一授權執行此功能的使用者。請參閱 "如果要在伺服器上安裝文件聚集"

啟動 AnswerBook2 查看器程式

如果您正在執行 Solaris 2.6(或較新版本)作業環境,系統會以文件伺服器的 URL 啟動網路瀏覽器,在此情況下,您可以選擇以下其中一個:

系統藉由搜尋您的路徑及啟動 Netscape 導航器TM 或其找到的第一個網路瀏覽器,決定要啟動的網路瀏覽器。有關系統如何決定文件伺服器的 URL 的資訊,請參閱 "尋找文件伺服器"

您也可以從任何符合 HTML 3.2 的網路瀏覽器存取 AnswerBook2 產品。啟動您的網路瀏覽器並輸入適當的文件伺服器 URL。例如,如果您的系統管理者使用內定通訊埠編號在系統 imaserver 上安裝 AnswerBook2 文件伺服器,您將可鍵入 URL:http://imaserver:8888/

查看資訊

只要您已啟動 AnswerBook2 查看器程式,您就可以在底線文字上按一下(視如何配置您的瀏覽器以顯示其連結而定)以導覽至書籍或章節。若需更多關於如何經由 AnswerBook2 系統導覽的更多資訊,請參閱 AnswerBook2 輔助說明。

尋找文件伺服器

當您從 Solaris 作業環境啟動 AnswerBook2 查看器程式時,軟體會顯示安裝在內定文件伺服器上的聚集列表。內定伺服器是使用此順序中的下列機制做識別的:

  1. 如果您已定義環境變數 AB2_DEFAULTSERVER, 本 AnswerBook2 查看器程式使用由該變數所定義的 URL 來啟動。

    例如,您的 .cshrc 檔案中可能會有下行:


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

  2. 如果您由該處起始 AnswerBook2 功能的機器是文件伺服器,AnswerBook2 查看器程式會使用 URL 啟動: http://localhost:port

    port 是通訊埠編號,其上執行文件伺服器且內定值為 8888

  3. 如果您的文件管理者已註冊具有 FNS(聯合式命名服務)的 AnswerBook2 伺服器,AnswerBook2 查看器程式會使用已註冊伺服器的 URL。

如果您沒有可使用的文件伺服器,但是您有網際網路存取權,您也可以於:http://docs.sun.com/ 存取 Sun 的主文件伺服器

安裝文件伺服器軟體

本節解釋在您安裝 AnswerBook2 伺服器軟體之前必須達到的需求及您應該作的決定。

本節只適用於管理 AnswerBook2 伺服器系統者。只查看線上文件的使用者不需要閱讀本節。沒有特定安裝需要成為 AnswerBook2 客戶機。


註解 -

此產品沒有客戶機層次的存取控制。如果客戶機機器可以存取文件伺服器的 URL,它便可以在該伺服器上查看文件。


此區段包含以下的資訊:

有關管理文件伺服器的詳細資訊,只要您已安裝文件伺服器軟體,就可以從 AnswerBook2 介面使用可使用的線上輔助說明。

安裝伺服器軟體之前

在您開始安裝處理之前,驗證您的系統符合 "硬體與軟體需求" 中所列的需求,並依照 "安裝選擇" 中的解釋決定您要將軟體安裝於何處。

硬體與軟體需求

在您開始安裝程序之前,請驗證您計畫安裝 AnswerBook2 伺服器軟體的系統符合列表於 表 8-2表 8-3 中的硬體與軟體需求。

表 8-2 硬體與軟體需求

元件 

需求 

文件伺服器系統硬體 

SPARCstationTM 2 電腦或更高的(建議 SPARCstation 5 電腦)

以 Intel 為基礎的個人電腦 

作業環境 

Solaris 7(使用於SPARC 或 x86,視適當情況而定) 

管理 GUI 與 AnswerBook2 客戶機查看器程式 

任何符合 HTML 3.2 的瀏覽器,例如 Netscape 導航器、HotJava 或 Lynx 

表 8-3 磁碟空間需求表

目錄路徑 

說明 

空間 

/usr/lib/ab2/

包含可執行檔案、伺服器處理檔案、程式庫檔案,以及產品介面的圖形與文件來源檔案。 

26.0 MB 

/var/log/ab2/

如果登錄功能被啟動,則包含目錄檔與登錄檔。 

5.0 MB(當伺服器使用之時,建議的成長為 - ) 

/etc/init.d/ab2mgr

伺服器啟動檔案 

0.01 MB 

此外,您需要保留一些磁碟空間(建議保留 600 MB)給實際的書籍檔案。確實的空間量取決於特定聚集。有關 Solaris 7 Documentation CD 上可使用的聚集列表,請參閱位於該 CD 上的 讀我 檔案。

安裝選擇

在您安裝本 AnswerBook2 伺服器軟體之前,您應該考慮您的安裝選擇:

如果要安裝 AnswerBook2 伺服器軟體

如果要安裝伺服器軟體,您可以使用來自 Solaris Web StartTM 公用程式可供使用的點按介面,或是您可以使用標準的安裝公用程式,例如 pkgadd

  1. 將 Solaris 7 Documentation CD 插入您的 CD-ROM 光碟機。

    音量管理者應會自動裝載 CD。

  2. 如果您選擇使用 Solaris Web Start 公用程式安裝您的產品,在 installer 圖像上連按兩下,遵循 Web Start 螢幕上的指令,並到 步驟 6

    Web Start 公用程式提供事先選擇好的套裝軟體群組供您安裝。請按照 Web Start 螢幕上的指示繼續。

  3. 如果您選擇使用 pkgadd 公用程式或 swmtool 公用程式,在文件伺服器機器上登入為 高階使用者

    例如,在指令行輸入如下:


    % su -
    
  4. 變更目錄至文件伺服器套裝軟體的位置。

    例如,您可能會輸入類似以下的指令以移至 SPARC 伺服器伺服器套裝軟體的位置:


    # cd cdrom/Solaris_2.7_Doc/sparc/Product/ 
    

    cdrom 是 CD-ROM 裝置的裝載點並內定為:/cdrom/sol_2_7_doc

  5. 啟動安裝公用程式並選擇伺服器套裝軟體。

    例如,使用以下指令以啟動 pkgadd 公用程式:


    # pkgadd -d .
    

    選擇這些伺服器套裝軟體:

    • SUNWab2r(0.25 MB)-- 安裝於 root 分割區中並提供配置與啟動檔案。

    • SUNWab2s(1.00 MB)-- 提供執行文件處理的共用檔案。

    • SUNWab2u(26.00 MB)-- 提供伺服器與管理功能的可執行與返回端處理檔案。

  6. 如有需要,啟動伺服器。

    安裝套裝軟體應會引起伺服器在 8888 的內定通訊埠上啟動。如果它沒有啟動,使用以下指令啟動它:


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

  7. 安裝書籍聚集。

    如果沒有為其安裝可伺服的文件,您的文件伺服器便無法執行其工作。您可以從 Solaris 7 Documentation CD 或從其它位置安裝聚集,例如現存文件聚集或跟隨著其它 CD 的聚集。若需安裝文件聚集的更多資訊,請參閱 "如果要在伺服器上安裝文件聚集"

  8. (選擇性的)變更配置檔案並建立連結,以在現存 httpd 伺服器上執行文件伺服器為 CGI 處理。

    如果您在您的系統上已經執行 httpd 伺服器,您可以在該伺服器上執行文件伺服器為 CGI 處理。您必須安裝標準文件伺服器軟體,然後變更幾個配置檔案並建立連結,以執行文件伺服器為 CGI 處理。若需更多的資訊,請參閱 "執行 AnswerBook2 伺服器如 CGI 處理"

  9. (選擇性的)註冊伺服器。

    如果您希望其他使用者經由聯合式命名服務(FNS)自動找到您的文件伺服器,您需要註冊伺服器。如果要註冊您的伺服器,請使用以下指令:


    # /usr/lib/ab2/bin/ab2regsvr server_url
    

    server_url 是擷取此伺服器完全合格的 URL(例如:http://imaserver.eng.sun.com:8888/ )。若需更多的資訊,請參閱 "註冊伺服器"

如果要在伺服器上安裝文件聚集

如果沒有為其安裝可伺服的文件,您的文件伺服器便無法執行其工作。您可以從 Solaris 7 Documentation CD或從其它位置安裝聚集,例如現存文件聚集或伴隨其它 CD 的聚集。

如果要從 Solaris 7 Documentation CD 安裝文件聚集套裝軟體,您可以使用來自 Solaris Web Start 公用程式可供使用的點按介面,或是您可以使用標準安裝公用程式,例如pkgadd。如果要安裝文件聚集:

  1. 請將 Solaris 7 Documentation CD 插入您的 CD-ROM 光碟機。

    Volume Manager 應會自動地裝載 CD。

  2. 如果您選擇使用 Solaris Web Start 公用程式安裝您的產品,在 installer 圖像上連按兩下,遵循 Web Start 螢幕上的指令,並到步驟 6.

    Web Start 公用程式提供事先選擇好的套裝軟體群組供您安裝。請按照 Web Start 螢幕上的指示繼續。

  3. 如果您選擇使用 pkgadd 公用程式或 swmtool 公用程式,在文件伺服器機器上登入為 高階使用者

    例如,在指令行輸入如下:


    % su -
    
  4. 變更目錄至文件聚集套裝軟體的位置。

    例如:


    # cd cdrom/Solaris_2.7_Doc/common/Product/ 
    

    cdrom 是 CD-ROM 裝置的裝載點並內定為 /cdrom/sol_2_7_doc

  5. 啟動安裝公用軟體並選擇文件聚集套裝軟體以安裝。

    例如,如果要啟動 pkgadd 公用程式:


    # pkgadd -d
    

    有關 Solaris 7 Documentation CD 上所包括的文件聚集的詳細列表,請參閱位於該 CD 上的 讀我 檔案。

  6. Solaris 7 Documentation CD 上所包括的文件聚集套裝軟體包括增加聚集至伺服器的資料庫,並重新啟動伺服器的事後安裝指令集。

    如果您從 Solaris 7 Documentation CD 以外的任何其它位置安裝聚集套裝軟體,您可能會需要使用管理GUI 的 Add Collection to List 功能或 ab2admin -o add_coll 指令增加這些聚集至文件伺服器的資料庫。

    如果您的系統上已經安裝了文件聚集,您可以使用管理 GUI 的 >Scan for Locally Installed Collections功能或 ab2admin -o scan 指令找出這些聚集並將其增加至文件伺服器的資料庫。此功能只適用於區域安裝的套裝軟體。

    如果要伺服位於一些其它系統上的文件聚集,使用 Add Collection to List 功能或 ab2admin-o add_coll 指令並提供完整的路徑名稱給 ab_cardcatalogcollinfo 檔案。例如,如果文件伺服器是 imaserver,而且您想要它伺服位於系統 elsewhere 的文件聚集,您可能會使用下列指令:


    # /usr/lib/ab2/bin/ab2admin -o \
    add_coll -d/net/elsewhere/books/SUNWdtad/collinfo
    

註冊伺服器

如果要附予使用者能尋找您的文件伺服器而不需知道 URL 的能力,您可以用 FNS 系統註冊您的伺服器的名稱。如果使用者知道 URL,他們仍然可以存取未註冊的文件伺服器。

您如何註冊您的伺服器取決於兩件事:

使用 ab2regsvr 指令註冊您的伺服器

如果要註冊您的伺服器,請使用 ab2regsvr 指令。 ab2regsvr 指令會察看您的系統配置並為您的伺服器設定合適的名稱空間。

如果要註冊您的伺服器,請鍵入:


# /usr/lib/ab2/bin/ab2regsvr server_url

server_url 是到達此伺服器的完全合格 URL(例如: http://imaserver.eng.sun.com:8888/)。

ab2regsvr 指令也提供一些您可能會覺得有用的其它選項:

有關 ab2regsvr 指令的更多資訊,請參閱 ab2regsvr(1m) 線上援助頁

使用標準 FNS 指令註冊您的伺服器

如果您想要使用 FNS 指令註冊您的伺服器,且您的位置已經安裝了 FNS,請使用下列的指令將設定的 URL 註冊為您的組織(領域)文件伺服器:


# fnbind -r thisorgunit/server/answerbook2 onc_answerbook2 \
onc_addr_answerbook2 server_url

server_url 是到達此伺服器的完全合格的 URL(例如:http://imaserver.eng.sun.com:8888/)。

如果要找出目前註冊的伺服器為何,使用下列指令:


% fnlookup -v thisorgunit/service/answerbook2

此動作會回覆看起來與下列類似的註冊伺服器列表:


參考類型: onc_answerbook2 位址類型onc_addr_answerbook2 
  長度: 19
   資料: 0x68 0x74 0x74 0x70 0x3a 0x2f 0x2f 0x61 0x6e 0x73  http://ans
         0x77 0x65 0x72 0x73 0x3a 0x38 0x38 0x38 0x38       wers:8888

在此範例中,註冊的伺服器是 http://answers:8888/

如果您取得與下列類似的回應,那便表示沒有文件伺服器是以 FNS 註冊的:


'thisorgunit/service/answerbook2' 的尋找失敗:\ 
找不到名稱:'answerbook2'

有關 FNS 更多的資訊,包括如何安裝,請參閱 FNS 文件。

名稱服務與 AnswerBook2 使用者

與其使用描述的名稱服務找出文件伺服器,使用者可以使用環境變數 AB2_DEFAULTSERVER 定義內定的 AnswerBook2 伺服器。例如,使用者在 .cshrc檔案中可以有下列行:


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

如果使用者未定義環境變數,當使用者從桌上管理系統啟動 AnswerBook2 產品時,產品會察看從其啟動的系統是否正在執行文件伺服器。如果是,其便會使用 URL 啟動:http://localhost:portport 內定為 8888

如果使用者未定義環境變數,且目前系統不是文件伺服器,當使用者從桌上管理系統啟動AnswerBook2 時,系統會執行 fnlookup thisorgunit/service/answerbook2 指令找出可使用的文件伺服器為何。然後選擇這些伺服器之一,並使用 URL 的該伺服器名稱啟動 AnswerBook2 瀏覽器。

從 Solaris 7 Documentation CD 執行文件伺服器

  1. 將 Solaris 7 Documentation CD 插入您的 CD-ROM 光碟機。

  2. 確定您以高階使用者登入。


    % su -
    
  3. 變更目錄至(或帶出 並到)CD-ROM 音量的最頂層。

    這看起來應與下列位置類似:


    /cdrom/sol_2_7_doc/ 

    此目錄包含一個目錄、一個 讀我 檔案、 installer 公用程式,以及 ab2cd 指令集。使用 ab2cd 指令集直接由 CD 執行文件伺服器。

  4. 鍵入下列的指令:


    # ./ab2cd
    
  5. 使用此 URL 存取文件伺服器:


    http://server:8888/
    

    server 是 CD-ROM 光碟機所連接的機器名稱。

    注意,從 CD 執行的文件伺服器總是執行於通訊埠 8888 上。

  6. (選擇性的) 如果文件聚集已經安裝在您的伺服器機器上,而且您想要 CD 導向的伺服器軟體認出這些聚集,請使用下列的指令: .


    # ab2cd -s
    

    這種指令的形式會導致 CD 導向的伺服器軟體尋找安裝在此系統上的其它聚集,並將它們增加到其資料庫。

  7. 如果要停止從 CD 執行伺服器,請鍵入:


    # /cdrom/sol_2_7_doc/ab2cd stop
    

小心 - 小心 -

直接從 CD 執行文件伺服器容易緩慢。如果您期望其他使用者存取此文件伺服器,請勿使用此方法。


從 CD 執行 AnswerBook2 伺服器時的重要注意事項

當您從 CD 執行此伺服器時,請將這些事情謹記在心:

有關執行兩個伺服器的注意事項

如果要執行兩個 AnswerBook2 伺服器(一個在您的系統上,一個來自 CD),請將這些規則謹記在心:

執行 AnswerBook2 伺服器如 CGI 處理

依照內定值, AnswerBook2 文件伺服器的執行一如包括在 SUNWab2u 套裝軟體中,插入 httpd 伺服器上的NSAPI。因為 AnswerBook2 伺服器符合標準的全球資訊網協定,所以您可以選擇作為CGI(共用通徑介面)處理一般在一些已經於您系統上的其它全球資訊網伺服器上執行文件伺服器(例如,Netscape 伺服器或 Sun Web 伺服器)。

如果您從內定 AnswerBook2 全球資訊網伺服器做變更,請注意,下列的功能將無法運作:

您將會需要使用您的伺服器的啟動與停止功能來代替。

如果要變更為以 CGI 為基礎的伺服器

因為特定詳細資訊視全球資訊網伺服器而有所不同,所以此程序描述您需要遵循的一般步驟使用以 CGI 為基礎的全球資訊網伺服器,而非內定(NSAPI 插入)伺服器。特定範例包括於 Sun Web 伺服器Netscape 伺服器之下。

  1. 如果 AnswerBook2 伺服器正在執行,請將其關閉。

    使用下列指令之一:


    # /usr/lib/ab2/bin/ab2admin -o stop
    #/etc/init.d/ab2mgr stop
    
  2. 編輯您全球資訊網伺服器的配置檔案並使圖像可供使用。

    您的全球資訊網伺服器文件應解釋特定的詳細資訊,例如要到何處尋找配置檔案。登錄/icons/ 應指到 /usr/lib/ab2/data/docs/icons/

    如果 /icons/已被使用,請於 /usr/lib/ab2/data/docs/icons/ 中連結所有檔案至現存的 /icons/ 目錄。

  3. 連結 AnswerBook2 輔助說明文件至目前的文件根目錄。

    到您的全球資訊網伺服器的文件根目錄並建立軟式連結至/usr/lib/ab2/data/docs/

  4. 使 AnswerBook2 cgi-bin 檔案可使用於您的伺服器。

    到您的全球資訊網伺服器的 cgi-bin 目錄並建立軟式連結至下列:


    /usr/lib/ab2/bin/cgi/admin
    /usr/lib/ab2/bin/cgi/nph-dweb
    /usr/lib/ab2/bin/cgi/gettransbitmap 
    /usr/lib/ab2/bin/cgi/getepsf
    /usr/lib/ab2/bin/cgi/getframe
    /usr/lib/ab2/bin/cgi/ab2srwrap
  5. 編輯您的全球資訊網伺服器的配置檔案與對應 /ab2/ 以呼叫 AnswerBook2 cgi

    您的全球資訊網伺服器文件應解釋特定詳細資訊,例如到何處尋找配置檔案。您需要變更/ab2/ 的登錄至 /usr/lib/ab2/bin/cgi/nph-dweb/ab2/

  6. 編輯 AnswerBook2 管理配置檔案。

    您需要編輯 /usr/lib/ab2/bin/cgi/nph-dweb 檔案並變更 伺服器類型錯誤登錄存取登錄 的登錄。

如果要在 Sun WebServer 上如 CGI處理的方式一般執行 AnswerBook2 伺服器

依照內定值, Sun Web Server 配置檔案是 /etc/http/httpd.conf 且檔案是在/var/http/demo/ 中。如果您沒有安裝 於內定位置 (/usr/),所有以 /usr/lib/ab2/ 開始的路徑應為您安裝檔案的路徑(例如,/usr2/lib/ab2/)。

  1. 編輯 /etc/http/httpd.conf 檔案並將下行放在檔案的 伺服器 區段中:


    map/icons /usr/lib/ab2/data/docs/icons

    當您作出此變更時,使用以下指令重新啟動 SWS 伺服器:


    # /etc/init.d/httpd start
    

    如果要驗證您的變更,請在您的全球資訊網瀏覽器中輸入以下的 URL 查看輔助說明圖像:


    http://localhost:port/icons/ab2_help.gif
    

    port 是您的文件伺服器在其上執行的通訊埠編號,且其內定值為 8888

  2. /var/http/demo/public/ 目錄,並放在以下軟式連結中:


    # ln -s/usr/lib/ab2/data/docs/Help 
    Help
    

    如果要驗證您的變更,在您的全球資訊網瀏覽器中輸入以下 URL 看輔助說明圖像:


    http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif
    

    port 是您的文件伺服器在其上執行的通訊埠編號,且內定值為 8888

  3. /var/http/demo/cgi-bin/ 目錄並建立下列軟式連結:


    # ln -s /usr/lib/ab2/bin/cgi/admin
    # ln -s /usr/lib/ab2/bin/cgi/nph-dweb 
    # ln -s /usr/lib/ab2/bin/cgi/gettransbitmap
    # ln -s /usr/lib/ab2/bin/cgi/getepsf 
    # ln -s /usr/lib/ab2/bin/cgi/getframe # ln -s /usr/lib/ab2/bin/cgi/ab2srwrap

    如果要驗證您的變更,請在您的全球資訊網瀏覽器中輸入以下的 URL 查看 AnswerBook2 程式庫頁:


    http://localhost:port/cgi-bin/nph-dweb/ab2
    

    port是您的文件伺服器在其上執行的通訊埠編號,且內定值為 8888

  4. 編輯 /etc/http/httpd.conf 檔案,並將以下登錄增加到檔案的主機區段中:


    map /ab2 /var/http/demo/cgi-bin/nph-dweb/ab2 cgi

    使用以下指令重新啟動 SWS 伺服器:


    # /etc/init.d/httpd start
    

    如果要驗證您的變更,請在您的全球資訊網瀏覽器中輸入以下的 URL 查看 AnswerBook2 程式庫頁:


    http://localhost:port/ab2
    

    port 是您的文件伺服器在其上執行的通訊埠編號,且內定值為 8888

  5. 編輯 /usr/lib/ab2/bin/cgi/nph-dweb 檔案並變更下列登錄:


    setenv servertype sws
    setenv errorlog
    setenv accesslog /var/http/logs/http.elf.1
要在 Netscape 伺服器上如 CGI 處理一般執行 AnswerBook2 伺服器

有關此範例,Netscape 伺服器配置檔案是 /ul/netscape/suitespot/httpd- threads1/config/obj.conf 且檔案在 /ul/netscape/suitespot/docs/ 中。如果您沒有安裝 於內定位置 (/usr/),所有以 /usr/lib/ab2/ 開始的路徑應為您安裝檔案的路徑(例如,/usr2/lib/ab2/)。

  1. 編輯 /ul/netscape/suitespot/httpd-threads1/config/obj.conf 檔案並增加下行:


    NameTrans fn="pfx2dir" from="/icons" dir="/usr/lib/ab2/data/docs/icons"

    如果要驗證您的變更,重新啟動 Netscape 伺服器。然後,在您的全球資訊網瀏覽器中輸入以下的 URL 來看輔助說明圖像:


    http://localhost:port/icons/ab2_help.gif
    
  2. /ul/netscape/suitespot/docs/ 目錄並放在以下軟式連結中:


    # ln -s /usr/lib/ab2/data/docs/Help Help
    

    如果要驗證您的變更,在您的全球資訊網瀏覽器中輸入以下的 URL 來看輔助說明圖像:


    http://localhost:port/Help/C/Help/books/Help/figures/ab2_help.gif
    

    port 是您的文件伺服器在其上執行的通訊埠編號,且其內定值為 8888

  3. /ul/netscape/suitespot/cgi-bin/ 目錄並建立下列的軟式連結:


    # ln -s /usr/lib/ab2/bin/cgi/admin 
    # ln -s /usr/lib/ab2/bin/cgi/nph-dweb
    # ln -s /usr/lib/ab2/bin/cgi/gettransbitmap
    # ln -s /usr/lib/ab2/bin/cgi/getepsf 
    # ln -s /usr/lib/ab2/bin/cgi/getframe
    # ln -s /usr/lib/ab2/bin/cgi/ab2srwrap
    

    如果要驗證您的變更,在您的全球資訊網瀏覽器中輸入以下的 URL 來看 AnswerBook2 程式庫頁:


    http://localhost:port/cgi-bin/nph-dweb/ab2
    

    port 是您的文件伺服器在其上執行的通訊埠編號,且其內定值為 8888

  4. 編輯 /ul/netscape/suitespot/httpd-threads1/config/obj.conf 檔案並增加以下的登錄:


    NameTrans fn="pfx2dir" from="/ab2" dir="/ul/netscape/suitespot/cgi-bin/nph-dweb/ab2" 
    name="cgi"

    如果要驗證您的變更,請重新啟動 Netscape 伺服器並在您的全球資訊網瀏覽器中輸入以下的URL 來看 AnswerBook2 程式庫頁:


    http://localhost:port/ab2
    

    port 是您的文件伺服器在其上執行的通訊埠編號,且其內定值為 8888

  5. 編輯 /usr/lib/ab2/bin/cgi/nph-dweb 檔案並變更下列的登錄:


    setenv servertype netscape setenv errorlog /ul/netscape/suitespot/httpd-threads1/logs/errors 
    setenv accesslog /ul/netscape/suitespot/httpd-threads1/logs/access

解決 AnswerBook2 問題

表 8-4列出 AnswerBook2 產品中一些已知的困惑範圍,並提供如何回應的建議。

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

有關此問題... 

考慮如此做... 

亦可參閱... 

瀏覽器委託錯誤

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

例如,不要使用此行:


set ServerHost imaserver;#
,使用

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

如果問題持續,請嘗試關閉全球資訊網瀏覽器上的委託。 

瀏覽器錯誤指令文件伺服器未回應

如果文件伺服器未回應,重新啟動它。 

若需停止與啟動伺服器的資訊,請參閱 AnswerBook2 輔助說明。 

Error 404, File not Found

伺服器處理執行中,然而伺服器軟體已刪除。重新安裝伺服器軟體。

若需安裝軟體的資訊,請參閱 "安裝文件伺服器軟體"

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

驗證聚集樣板檔案(/usr/lib/ab2/dweb/data/config/ab2_collections.template)不包含任何空白或複製登錄。

如果改正樣板檔案無法更正問題,您可能會需要重新安裝文件聚集或伺服器軟體。若需安裝軟體的資訊,請參閱 "如果要安裝 AnswerBook2 伺服器軟體"

使用者報告看見紅色文字與一本書籍(或數本書籍)中的「BUG」字 

書籍的來源包含 AnswerBook2 無法辨識的改寫標籤且 AB2_DEBUG 環境變數在伺服器上設定為"1"。 

如果要關閉錯誤顯示,請將 AB2_DEBUG 環境變數設定為"0",停止伺服器並啟動伺服器。

連絡任何提供書籍者以修改標籤。 

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

文件伺服器使用存取控制機制以識別可以執行管理功能的使用者。AnswerBook2 管理工具允許伺服器機器的文件管理者增加與刪除伺服器的管理使用者並變更其密碼。 

如果要增加或刪除您伺服器的管理使用者,請參閱 AnswerBook2 輔助說明。如果您需要存取至其它伺服器,請連絡該伺服器的文件管理者。 

無法從 AnswerBook2 管理 GUI(瀏覽器介面)執行管理指令

因許可權問題,來自管理 GUI 的特定功能無效。請嘗試從 ab2admin 指令行介面執行相同的功能。

有關指令行選項的資訊,請參閱 ab2admin(1m)線上援助頁

Scan for Locally Installed Collections 功能未列出安裝於區域裝載點上的文件聚集

驗證其中安裝了聚集的目錄是否已 讀取 其它所設定的存取。

 

您增加了 AnswerBook1 聚集,但是使用者在其程式庫中並未看到此聚集 

驗證 /var/log/ab2/catalog/ab1_cardcatalog 中的資訊是否正確。

這表示 ab_cardcatalog 檔案中的聚集資料有些錯誤。

當您嘗試經由管理 GUI 增加聚集時,您看到訊息 增加聚集失敗。

驗證聚集的 collinfoab_cardcatalog 檔案的路徑是否正確。

 

使用 restart 指令重新啟動文件伺服器失敗或未製造出期望的結果

在某些例子中,restart 指令未正確運作。

使用 stopstart 指令來代替。

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

使用管理 GUI 中的 ab2admin -o del_coll 功能或 Delete Collections from List 以從文件伺服器的資料庫刪除這些聚集。

然後,在安裝新的套裝軟體之前,使用 pkgrm 以從伺服器將其刪除。

若需刪除聚集的更多資訊,請參閱 AnswerBook2 輔助說明。