安装和管理 AnswerBook2 服务器 - zh

附录 A `ab2admin(1M)` 手册页

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 path [ -m 服务器 ] [ -p server_port_number ]: 将AnswerBook1 或 AnswerBook2 集合添加到指定的 AnswerBook2 服务器数据库。
add_server -M alternate_server -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 ]: 起用服务器的错误登录文件。
帮助 [ 命令]: 将有关某一具体命令或所有命令的一切信息列表。
列表 [ -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 服务器。要求根访问权。
rotate_access [ -m 服务器 ] [ -p server_port_number ]: 保存和复原服务器的访问记录文件。
rotate_error [ -m 服务器 ] [ -p server_port_number ]: 保存和复原服务器的错误记录文件。
扫描 [ -m 服务器 ] [ -p server_port_number ]: 扫描本地安装的集合 (AnswerBook1 或 AnswerBook2) 并更新指定服务器数据库的集合。
起始: 起始本地的 AnswerBook2 服务器。要求根访问权。
起始 -D: 起始处于调试模式的本地 AnswerBook2 服务器。要求根访问权。
停止: 停止本地的 AnswerBook2 服务器。要求根访问权。
view_access [ -m 服务器 ] [ -p server_port_number ]: 查看服务器的访问记录文件的内容。
view_config [ -m 服务器 ] [ -p server_port_number ]: 查看服务器的配置设置。
view_error [ -m 服务器 ] [ -p server_port_number ]: 查看服务器错误记录文件的内容。

USAGE

结束: 退出交互模式。
q: 退出交互模式。
bye: 退出交互模式。
退出: 退出交互模式。
? [命令]: 在交互模式中获得帮助。
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 检查 AnswerBook2 集合的定义

检查 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: AnswerBook1 集合数据库
/usr/lib/ab2/dweb/data/config/admin_passwd: 包含 username:password 的文件

ATTRIBUTES

请参阅 属性(5) 以讨论下述属性：

属性类型	属性值
可用性	`SUNWab2u`

附录 A ab2admin(1M) 手册页