test

Solaris 7（SPARC 平台版）安裝程式庫

安裝文件伺服器軟體

本節解釋在您安裝 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_cardcatalog 或collinfo 檔案。例如，如果文件伺服器是 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:port，port 內定為 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