ab2admin(1M) (安裝和管理一個AnswerBook2 伺服器

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

ab2admin(1M)

名稱

ab2admin- 管理AnswerBook2的指令行介面

SYNOPSIS

/usr/lib/ab2/bin/ab2admin

-h

指令

-o

指令

引數

DESCRIPTION

ab2admin 指令是一種管理特定 AnswerBook2 伺服器上的 AnswerBook2 合集及文件的指令行介面。此指令可以安裝與解除安裝一個伺服器的 AnswerBook1 及 AnswerBook2 合集，掃描本機安裝的合集，並且更新伺服器資料庫，及取得一個合集和書籍清單。

ab2admin 伺服器的管理功能包括﹕停止伺服器，啟動伺服器，重新啟動伺服器，開啟或關閉伺服器記錄檔，以及輪換記錄檔。可以將伺服器設置為解析到位於其他 AnswerBook2 伺服器之上的書籍的鏈結。

ab2admin 也可以用來在管理使用者群組中新增或刪除使用者以控制伺服器的存取。存取權控制可以被開啟或關閉。

ab2admin 可以連接至任何 AnswerBook2 伺服器（本機或遠端）。特定功能（例如停止、啟動、以及重新啟動）只能應用到本機的 AnswerBook2 伺服器。如果 AnswerBook2 伺服器是由密碼保護，就需要一個使用者 ID 及密碼來起始管理工作。

若要互動式地執行 ab2admin，從指令行鍵入ab2admin，然後依照提示輸入適當指令。也可以使用-o選項，完全從指令行來執行。

OPTIONS

支援以下選項﹕

-h [指令]: 顯示有關一個 指令的說明及指定的說明。
-o 子指令[ 引數]: 下方列出支援的子指令﹕

子指令

支援以下-o 選項的子-指令﹕

access_off [ -m伺服器] [ -p server_port_number ]: 關閉伺服器存取記錄檔。
access_on [ -m 伺服器] [ -p server_port_number ]: 啟動伺服器存取記錄檔。
add_admin -u user_id [ -m 伺服器] [ -p server_port_number ]: 新增一個使用者至伺服器管理員的授權清單。
add_coll -d 路徑 [ -m 伺服器] [ -p server_port_number ]: 新增 AnswerBook1 或 AnswerBook2 合集到指定的 AnswerBook2 伺服器資料庫。
add_server -M 替代伺服器 -P alternate_server_port_number [ -m 伺服器] [ -p server_port_number ]: 新增替代伺服器到指定的伺服器。
auth_off [ -m 伺服器] [ -p server_port_number ]: 關閉伺服器管理認證。
auth_on [ -m 伺服器] [ -p server_port_number ]: 啟動伺服器管理認證。
autostart_no [ -m 伺服器] [ -p server_port_number ]: 防止 AnswerBook2 伺服器在重新啟動系統時自動開啟。
autostart_yes [ -m 伺服器] [ -p server_port_number ]: 導致 AnswerBook2 伺服器在系統時重新啟動會自動開啟。
瀏覽器 [ -m 伺服器] [ -p server_port_number ]: 啟動一個全球資訊網瀏覽器以存取 AnswerBook2 管理頁面。
change_password -u admin_id [ -m 伺服器] [ -p server_port_number ]: 變更授權管理員的密碼。
del_admin -u user_id [ -m 伺服器] [ -p server_port_number ]: 從授權伺服器管理員清單中刪除一個使用者。
del_coll -t collection_title [ -m 伺服器] [ -p server_port_number ]: 從指定的伺服器資料庫中移除 AnswerBook1 或 AnswerBook2 合集。
del_server -M alternate_server -P alternate_server_port_number [ -m 伺服器] [ -p server_port_number ]: 從指定的伺服器已知的伺服器清單中刪除替代伺服器。
error_off [ -m 伺服器] [ -p server_port_number ]: 關閉伺服器錯誤記錄檔。
error_on [ -m 伺服器] [ -p server_port_number ]: 啟動伺服器錯誤記錄檔。
help [ 指令]: 列出關於一個特定或所有指令的所有資訊。
清單 [ -m 伺服器] [ -p server_port_number ]: 列出指定的伺服器可用的 AnswerBook1 和 AnswerBook2 合集。清單中會包括合集中所含的書籍。
list_server [ -m 伺服器] [ -p server_port_number ]: 列出指定的伺服器定義的所有替代伺服器。
功能表: 顯示指令選項的一份濃縮清單。
modify_server_name -s new_server_name [ -m 伺服器] [ -p server_port_number ]: 修改伺服器名稱。
modify_server_port -a new_server_port_number [ -m 伺服器] [ -p server_port_number ]: 修改伺服器的連接埠編號。
重新啟動: 重新啟動本機的 AnswerBook2 伺服器。需要 root 存取權限。
rotate_access [ -m 伺服器] [ -p server_port_number ]: 儲存與重設伺服器存取記錄檔。
rotate_error [ -m 伺服器] [ -p server_port_number ]: 儲存與重設伺服器錯誤記錄檔。
掃描 [ -m 伺服器] [ -p server_port_number ]: 掃描本機安裝的合集（AnswerBook1 或 AnswerBook2）並且更新在指定伺服器資料庫之上的合集。
啟動: 啟動本機的 AnswerBook2 伺服器。需要 root 存取權限。
啟動 -D: 以除錯模式啟動本機的 AnswerBook2 伺服器。需要 root 存取權限。
停止: 停止本機的 AnswerBook2 伺服器。需要 root 存取權限。
view_access [ -m 伺服器] [ -p server_port_number ]: 檢視伺服器存取記錄檔的內容。
view_config [ -m 伺服器] [ -p server_port_number ]: 檢視伺服器的設置設定值。
view_error [ -m 伺服器] [ -p server_port_number ]: 檢視伺服器錯誤記錄檔的內容。

使用

退出: 離開互動模式。
q: 離開互動模式。
再見: 離開互動模式。
離開: 離開互動模式。
? [指令]: 取得互動模式的說明。
h [指令]: 取得互動模式的說明。

EXAMPLES

範例 1 列出一個伺服器之上可用的 AnswerBook2 合集

若要列出一個名為 foo.com 伺服器上可用的合集，請使用連接埠編號 8888﹕

example% ab2admin -o 清單 -m foo.com -p 8888

範例 2 使用互動模式來列出合集

若要以互動模式使用 ab2admin 來進行上面所示的相同操作﹕

example% ab2admin
>> 清單 -m foo.com -p 8888

範例 3 安裝一個 AnswerBook2 合集

若要使用pkgadd 公用程式來安裝一個AnswerBook2合集﹕

example# pkgadd -d package_directory/ SUNWabsdk

合集目錄結構會被複製到系統（依預設值）中的/opt/answerbooks/

範例 4 安裝一個伺服器資料庫中未更新的 AnswerBook2 合集

若要安裝一個已引進系統中（透過pkgadd）但尚未被更新至伺服器資料庫的 AnswerBook2 合集﹕

example# ab2admin -o add_coll -d
/opt/answerbooks/english/solaris_2.6/SUNWabsdk

（備註﹕ -d 路徑 必須包括 collinfo 檔（若是一個 AnswerBook2 合集）或 ab_cardcatalog 檔（若是一個 AnswerBook1 合集）。

範例 5 檢視一個 AnswerBook1 合集的定義

要檢視一個 AnswerBook1 合集是如何定義﹕

example% cat /opt/SUNWans/ab_cardcatalog
:id=SUNWab_10_4: \
:version=: \
:title=Solaris XGL 3.1 AnswerBook: \
:tocpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/toc: \:
pspath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/ps: \
:indexpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/inde

範例 6 檢視一個 AnswerBook1 合集的定義

要檢視一個 AnswerBook2 合集是如何定義﹕

example% cat/opt/answerbooks/english/solaris_2.6/SUNabsd/collinfo
dwCollections {
  coll.45.4 dwCollection
}
dwSetParam coll.45.4 {
  location /opt/answerbooks/english/solaris_2.6/SUNWabsdk
  title "Solaris 2.6 Software Developer AnswerBook Vol 1"
  type EbtCollection
}

FILES

/var/log/ab2/catalog/local.socat: 目錄檔
/var/log/ab2/catalog/remote.socat: 目錄檔
/var/log/ab2/catalog/delegate.socat: 目錄檔
/var/log/ab2/catalog/libcat.socat: 目錄檔
/var/log/ab2/logs/access_8888.log: 預設的存取記錄檔
/var/log/ab2/logs/errors_8888.log: 預設的錯誤記錄檔
/usr/lib/ab2/dweb/data/config/ab2_collections.template: AnswerBook2 合集資料庫
/var/log/ab2/catalog/ab1_cardcatalog: AnswerBook2 合集資料庫
/usr/lib/ab2/dweb/data/config/admin_passwd: 包含 username:password 的檔案

ATTRIBUTES

請參見 屬性(5) 中有關下列屬性的說明﹕

屬性種類	屬性值
可得性	`SUNWab2u`