test

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

第 2章 安裝 AnswerBook2 伺服器軟體

這一節說明如何安裝AnswerBook2伺服器軟體。

註解 -

您若要以AnswerBook2客戶機的身分查看線上文件，就不需進行安裝。不過您需要知道文件伺服器的 URL。或者如果您可以存取 Internet 的話，您也可以在http://docs.sun.com 查看已發行的 Sun 文件。

註解 -

這個產品沒有客戶機層次的存取權控制。如果客戶機電腦可以存取文件伺服器的 URL，它就可以查看那個伺服器上的文件。

這一節包含以下資訊：

重要 - 作業環境限制

AnswerBook2 伺服器可以在 Solaris 2.5.1 作業環境 (或相容的版本) 之上執行。然而，特定的作業環境版本會限制您在下列各方面的安裝﹕

  1. 支援多字元組的語言，例如許多亞洲區域 - 所用的字元語言。Solaris 作業環境使用一種公用程式（iconv），可以將字元從一種內碼集轉換為另一種。如果您執行 Solaris 2.5.1 作業環境，可能必須安裝或更新以下這些套裝軟體﹕

    • SUNWciu8 - 簡體中文 iconv UTF-8 模組

    • SUNWhiu8 - 繁體中文 iconv UTF-8 模組

    • SUNWjiu8 - 日文 iconv UTF-8 模組

    • SUNWkiu8 - 韓文 iconv UTF-8 模組

    • SUNWuiu8 - 通用 iconv UTF-8 模組

  2. 支援聯合式命名服務 (FNS) - 如果您想要註冊您的 AnswerBook2 伺服器，好讓使用者自動存取該伺服器" 您必須在系統上安裝FNS。這個公用程式不屬於 Solaris 2.5.1 核心作業環境，所以您必須安裝 SUNWfns 套裝軟體。

安裝前的核對清單

使用此核對清單以簡化您的安裝程序。

您的系統是否與 AnswerBook2 軟體相容？

要讓您的系統作為一個說明文件伺服器來執行，它必須符合下列其中一種系統設置﹕執行 Solaris 2.5.1 SPARC 平台版作業環境 (或相容版本) 的

  • SPARCstationTM 2 (最基本的 SPARCstation 5) 系統

  • 執行 Solaris 2.5.1 Intel Platform 平台版作業環境 (或相容版本) 以 Intel 為基礎的個人電腦系統

此外，您的伺服器系統必須提供大約 34MB 的可用磁碟空間給伺服器軟體，以及大約 600MB 的可用磁碟空間來安裝文件合集。

要透過一個網路瀏覽器及 URL 來存取一個說明文件伺服器，並無特定的系統需求，不過您必須執行一個與 HTML 3.2- 相容的瀏覽器，例如 Netscape NavigatorTM 或 Lynx。

您需要安裝哪些軟體元件？

需要安裝的軟體元件視您想要的功能而定。

  • 如果您組織的系統已安裝了一個 AnswerBook2 伺服器，要讀取線上文件時，只要啟動一個與 HTML 3.2- 相容的瀏覽器並且輸入該伺服器的 URL（例如 http://imaserver:8888/）即可。要查看 Sun 的發行文件，請到此 URL﹕http://docs.sun.com/

  • 要啟動您的系統到"伺服器"文件，請在您的系統上安裝說明文件伺服器軟體以及文件合集。您也可以將伺服器軟體安裝在一個系統之上而將文件合集安裝在另一個系統上。請參閱"安裝 AnswerBook2 軟體" 和 Missing Cross Reference Target。

軟體在哪里？

AnswerBook2 伺服器軟體可由多處取得，例如 Solaris 文件光碟，其他 Sun 光碟，或是直接從 Sun的網站下載。因此您如何存取套裝軟體的步驟會有所不同，要看當時的情況而定。在安裝程序中，software-location 會指出您必須在何時選擇適於您使用狀況的動作。

您是否已在此系統上執行一個全球資訊網伺服器？

根據預設值，AnswerBook2 說明文件伺服器是作為 SUNWab2u 套裝軟體中指明的 httpd 伺服器上層的一個 NSAPI 外掛程式來執行。由於 AnswerBook2 伺服器採用標準的全球資訊網通訊協定，您可以將您的說明文件伺服器作為系統上其他某些全球資訊網伺服器（例如 Netscape 伺服器或 Sun WebServer）上層的 CGI（共用閘道介面）程序來執行。請參閱"執行 AnswerBook2 伺服器作為一個 CGI 程序"

您是否希望公司內的其他使用者找到您的伺服器？

要讓使用者在不知道 URL 的情況下找到您的說明文件伺服器，可以向 FNS 系統登錄您的伺服器名稱。如果使用者知道未登錄的說明文件伺服器正確的 URL 的話，仍然可以存取它們。請參閱"註冊您的文件伺服器"。

取得 AnswerBook2 軟體

數種 Sun 產品光碟中包括 AnswerBook2 軟體，例如 Solaris 7 文件光碟。如果您有一個包含此軟體的產品光碟，或是從 Sun 的網站下載了 SUNWab2r、SUNWab2s、以及 SUNWab2u 套裝軟體，請到"安裝 AnswerBook2 軟體"。否則您必須先取得 AnswerBook2 軟體才能繼續。

安裝 AnswerBook2 軟體

註解 -

某些包括 AnswerBook2 軟體的產品光碟可以支援點按式的安裝公用程式 (Solaris Web Start)。若需該公用程式的使用資訊，請參閱光碟中的參考文件

要安裝 AnswerBook2 伺服器軟體﹕

  1. 以超級使用者的身份登入說明文件伺服器。

    您可以從「桌面登入」螢幕中登入為root，或在指令行鍵入su，然後輸入您系統的 root 密碼﹕

  2. 將光碟插入您的光碟機中，或是移到軟體的位置。

    如果是從一張光碟安裝，「磁卷管理員」應該會自動裝載光碟。

  3. 如果有必要，請將目錄變更為說明文件伺服器套裝軟體的位置。

    輸入此指令﹕


    # cd 軟體位置

    其中 軟體位置 視您是由一張光碟安裝或是已經由一個網站取得套裝軟體而定。例如，Solaris 7 說明文件光碟的 軟體位置 是預設為 /cdrom/sol_7_doc/Solaris_2.7_Doc/sparc/Product/。

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

    例如，請使用下列指令來啟動 pkgadd 公用程式﹕


    # pkgadd -d .

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

    • SUNWab2r (0.03 MB) - 會安裝至 root 同位元並且提供設置及啟動檔案。不要將此套裝軟體安裝至一個非預設的位置。

    • SUNWab2s (1.40 MB) - 提供執行文件處理的共享檔案。不要將此套裝軟體安裝至一個非預設的位置。

    • SUNWab2u (30.00 MB) - 提供伺服器及管理功能的可執行及後端處理檔案。要將此套裝軟體安裝至一個非預設的位置，請使用 pkgadd 指令的互動式表格﹕


      # pkgadd -a none -d .

  5. 在適當時機回答超級使用者的提示。

    當您看到一個類似下列的訊息時﹕


    此套裝軟體包含指令集，可在安裝此套裝軟體的過程中以超級使用者的權限來執行。您是否想要繼續安裝程序 [y,n,?]

    請回答 y。

  6. 如果有必要，請啟動伺服器。

    在完成 SUNWab2u 安裝程序之後，會有一個指令集嘗試啟動 8888 預設連接埠上的伺服器。要確認伺服器已經啟動，請使用下列其中一個方式﹕

    • 啟動一個與 HTML 3.2- 相容的網路瀏覽器，然後鍵入下列 URL﹕http://localhost:8888/

      您應該會看到一個「"AnswerBook2程式庫"」頁面，其中至少包含一個文件合集 (「AnswerBook2說明」合集)，視所安裝的合集而定。

    • 使用下列指令來尋找伺服器處理﹕ 


      # ps -eaf | grep dwhttpd

    如果並未啟動伺服器，請使用下列指令來將它啟動﹕


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

  7. 在完成安裝程序之後，您的伺服器會使用預設的設置資訊來啟動。

    欲知有關變更您伺服器設置的資訊，請參見下列﹕

  8. 安裝文件合集。

    如果您的伺服器上安裝了文件合集，安裝處理便會尋找它們，然後將其新增至伺服器的資料庫中。您可以從產品光碟來安裝合集，或是更新伺服器資料庫以識別其他系統上安裝的現存文件合集。請參見 "安裝文件聚集"。

  9. (選擇性的) 登錄伺服器。

    如果您想要其他使用者透過聯合命名服務 (FNS) 來自動尋找您的說明文件伺服器，就必須登錄伺服器。要登錄您的伺服器，請使用下列指令﹕


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

    其中 server_url 是到達此伺服器的完全合格 URL (例如﹕http://imaserver.eng.sun.com:8888/)。請參見 "註冊您的文件伺服器" 以取得更多資訊。

安裝文件聚集

註解 -

某些包括 AnswerBook2 軟體的產品光碟可以支援點按式的安裝公用程式 (Solaris Web Start)。若需該公用程式的使用資訊，請參閱光碟中的參考文件

如果沒有安裝任何要您的說明文件伺服器來伺服的文件，它便無法執行工作。

要安裝文件合集﹕

  1. 以超級使用者的身份登入說明文件伺服器。

    您可以從「桌面登入」螢幕登入為 root，或是在指令行鍵入 su，然後輸入您系統的 root 密碼﹕

  2. 將光碟插入您的光碟機或是移到軟體的位置。

    如果是從一張光碟來安裝，「磁卷管理員」應該會自動裝載光碟。

  3. 移到文件合集套裝軟體的位置。

    您可以從 軟體位置 或是從其他位置，例如現存的文件合集或來自其他光碟上的合集來安裝合集。

    鍵入下列指令﹕


    # cd 軟體位置

    其中 軟體位置 視您是由一張光碟安裝或是已經由一個網站取得套裝軟體而定。例如，Solaris 7 說明文件光碟的 軟體位置 是預設為 /cdrom/sol_7_doc/Solaris_2.7_Doc/sparc/Product/。

  4. 啟動安裝公用程式並且選擇要安裝的伺服器套裝軟體。

    例如，要啟動 pkgadd 公用程式﹕


    # pkgadd -d .

    如欲取得特定光碟上所含的一份詳細的文件合集清單，請參見光碟上的 README 檔案。

  5. AnswerBook2 文件合集套裝軟體應該會包括一個後安裝指令集，可以將合集新增至伺服器的資料庫中，然後將伺服器重新啟動。

    如果沒有發生上述情況，或是如果您是在安裝 AnswerBook1 合集套裝軟體，您必須使用「AnswerBook2管理」頁面的「新增合集至清單」功能或是 ab2admin -o add_coll 指令來將這些合集新增至說明文件伺服器的資料庫中。

    如果您的系統上已經安裝了某些文件合集的話，您可以使用 AnswerBook2「管理」頁面的「掃描本機安裝的合集」功能或是 ab2admin -o scan 指令來找到它們，然後新增至說明文件伺服器的資料庫中。此功能只適用於本機安裝的套裝軟體。

    要移除位於其他系統之上的文件合集，請使用「新增合集至清單」功能或是 ab2admin -o add_coll 指令，並且提供至 ab_cardcatalog 或 collinfo 檔案的完整路徑名稱。例如，說明文件伺服器是 imaserver，而您想要它來伺服位於系統 elsewhere 之上的文件合集，您可以使用下列的指令﹕


    imaserver# 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 指令的資訊，請參見 附錄 B, 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 x2.74 0x2.74 0x2.70 0x3a 0x2f 0x2f 0x61 0x6e 0x2.73  http://ans         0x2.72.7 0x65 0x2.72 0x2.73 0x3a 0x38 0x38 0x38 0x38       wers:8888

在此例中，登錄的伺服器為 http://answers:8888/。

如果您得到類似以下的回應，那就表示沒有向 FNS 登錄的文件伺服器：


查找 'thisorgunit/service/answerbook2' 失敗：\ 找不到名稱：'answerbook2'

?Pub Caret>欲知更多有關 FNS 的資訊，包括如何安裝的方法，請參見 FNS 說明文件。

命名服務以及 AnswerBook2 使用者

在Solaris 2.6 或Solaris 7作業環境中，使用者可以使用環境變數AB2_DEFAULTSERVER來定義內定的 AnswerBook2 伺服器。例如，使用者可以將以下的指令行輸入.cshrc檔案中：


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

如果使用者尚未定義環境變數，當使用者從桌面啟動AnswerBook2產品時，此產品會去查看將其啟動的系統是否在執行文件伺服器。如果是的話，它就會用此URL啟動：http://localhost:通訊埠，其中通訊埠的內定值是8888。

如果使用者尚未定義環境變數，而目前的系統也不是文件伺服器，那麼當使用者從桌面啟動 AnswerBook2 時，系統會執行fnlookup thisorgunit/service/answerbook2指令來找出有哪些文件伺服器可用。然後，系統便會從其中選擇一個伺服器並使用URL的伺服器名稱來啟動 AnswerBook2 瀏覽程式。

執行 AnswerBook2 伺服器作為一個 CGI 程序

根據預設，AnswerBook2 說明文件伺服器會作為 SUNWab2u 套裝軟體所含 httpd 伺服器之上的一個 NSAPI 外掛程式來執行。因為 AnswerBook2 伺服器是以標準網路協定所編譯的，您可以選擇要將說明文件伺服器作為一個已經在系統上的其他某些網路伺服器 (例如﹕Netscape Server 或 Sun WebServer) 之上的 CGI (共用閘道介面) 處理來執行。

註解 -

您必須具有全球資訊網的專業知識才能在此層級變更伺服器的行為 "expert"。除非您已經徹底熟悉網路伺服器的設置和特定的需求，否則您不應嘗試執行此項工作。

請注意，如果您從預設的 AnswerBook2 網路伺服器變更的話，下列功能將無法正常運作﹕

您必須改用您伺服器的開始及停止功能。

要變更為一個以 CGI 為基礎的伺服器
註解 -

由於網路伺服器科技日新月異，此處不可能將所有可能的網路伺服器設置都加以說明。因此，下列的一般性程序將可作為您的指示。您必須在執行此程序之前，先徹底熟悉您網路瀏覽器的設置及獨特的需求。

此程序將會說明使用一個以 CGI 為基礎的網路伺服器而非預設 (NSAPI 外掛程式) 伺服器的一般性步驟。

  1. 重新將系統開機時停用自動啟動 AnswerBook2 伺服器。

    使用「AnswerBook2管理」頁面的「修正伺服器設置」頁面，或是使用下列指令﹕


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

  2. 關閉預設文件伺服器的管理性存取控制。

    使用下列指令﹕


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

  3. 關閉執行中的 AnswerBook2 伺服器。

    使用下列其中一個指令﹕


    # /usr/lib/ab2/bin/ab2admin -o stop# 
/etc/init.d/ab2mgr stop

  4. 編輯您的網路伺服器設置檔案並且使圖示成為有效狀態。

    您網路伺服器的說明文件應該會解釋特定的細節，例如﹕到何處尋找設置檔案。應該修正/icons/ 項目以指向 /usr/lib/ab2/data/docs/icons/。

    如果已經在使用 /icons/ 的話，請將 /usr/lib/ab2/data/docs/icons/ 中的所有檔案鏈結到現存的 /icons/ 目錄中。

    當您完成變更動作時，請重新啟動您的伺服器。

    要確認您的變更，請在您的網路瀏覽器中鍵入下列 URL 以尋找一個「說明」圖示﹕


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

    其中 port 是您的說明文件伺服器所執行的連接埠編號。

  5. 將 AnswerBook2「說明」文件與目前的說明文件 root 目錄鏈結。

    移到您網路伺服器的說明文件 root 目錄中，並且建立一個到 /usr/lib/ab2/data/docs/Help 的符號 (軟式) 鏈結。

    要確認您的變更，請在您的網路瀏覽器中鍵入下列 URL 以尋找一個「說明」圖示﹕


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

    其中 port 是您的說明文件伺服器所執行的連接埠編號。

  6. 使 AnswerBook2 cgi 檔案成為伺服器可用的有效狀態。

    移到您網路伺服器的 cgi-bin 目錄並且建立與下列相連的符號鏈結﹕


    /usr/lib/ab2/bin/ab2bin/admin /usr/lib/ab2/bin/ab2bin/nph-dweb /usr/lib/ab2/bin/ab2bin/gettransbitmap /usr/lib/ab2/bin/ab2bin/getepsf /usr/lib/ab2/bin/ab2bin/getframe

    要確認您的變更，請在您網路瀏覽器中鍵入下列的 URL 以查看 AnswerBook2 程式庫頁面﹕


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

    其中 port 是您的說明文件伺服器所執行的連接埠編號。

  7. 編輯您伺服器的設置檔案及對映圖 /ab2/ 以呼叫 AnswerBook2 cgi。

    您網路伺服器的說明文件應該會解釋特定的細節，例如﹕到何處尋找設置檔案。您必須將 /ab2/ 的項目變更為 /usr/lib/ab2/bin/ab2bin/nph-dweb/ab2/。

    要確認您的變更，請重新啟動您的伺服器並且在您的網路瀏覽器中鍵入下列 URL 以查看 AnswerBook2 程式庫頁面﹕


    http://localhost:port/ab2

    其中 port 是您的說明文件伺服器所執行的連接埠編號。

  8. 如果您想要使用者在不需要在 URL 的結尾指定 /ab2 的情況下能夠存取說明文件伺服器的話，請將您伺服器的設置檔案及對映圖 / 變更為 /ab2/。

    您網路伺服器的說明文件應該會解釋特定的細節，例如﹕到何處尋找設置檔案。您必須將 / 的項目變更為 /ab2/ 並且新增一個 remote 旗標至對映中。

    要確認您的變更，請重新啟動您的伺服器並且在您的網路瀏覽器中鍵入下列 URL 以查看 AnswerBook2 程式庫頁面﹕


    http://localhost:port

    其中 port 是您的說明文件伺服器所執行的連接埠編號。

  9. 編輯 AnswerBook2 管理設置檔案。

    您必須編輯 /usr/lib/ab2/bin/ab2bin/nph-dweb 檔案並且變更 servertype、errorlog、及 accesslog 的項目。


    setenv servertype server_typesetenv errorlog 
complete_path_to_error_logsetenv accesslog 
complete_path_to_access_log

    這里:

    • server_type 識別您所執行的伺服器，例如 sws。

    • complete_path_to_error_log 是到您網路伺服器錯誤記錄檔的路徑。

    • complete_path_to_access_log 是到您網路伺服器存取記錄檔的路徑。

  10. 設定 AnswerBook2 管理介面的存取控制。

    要控制由誰在文件伺服器之上執行管理性功能，請使用您 http 伺服器的正確存取控制機制來限制下列 URL 的存取權限﹕/ab2/@Ab2Admin