| Sun ONE Portal Server 6.2 管理员指南 |
附录 A
配置文件本附录介绍 desktopconfig.properties 和 search.conf 配置文件。
本附录包含以下部分：
Sun ONE Portal Server 配置文件概述
Sun ONE Portal Server 使用某些文件来管理桌面服务和搜索服务的配置。桌面配置文件 desktopconfig.properties 用于定义服务器特定参数，本附录中对该文件进行了介绍。
Portal Server 可用作 Sun ONE Identity Server 的服务程序（请参阅附录 B）。
搜索服务使用特定的配置文件。本附录内容包括 search.conf 文件的配置注意事项。
安装时，您可选择为“基本目录”(/opt)、“部署 URI”(/portal) 和“部署实例”(cate.sesta.com) 分别定义值或使用默认值。
桌面配置属性
desktopconfig.properties 文件定义初始化期间桌面读取的服务器特定参数。对此文件所作的任何更改都需要重新启动服务器才能生效。默认情况下，此文件位于 /etc/opt/SUNWps/desktop 目录下。
标记为“内部”的参数是不能自定义的参数。因此，您只可为其它类配置调试级别和基本目录。表 A-1 表格包含两列；第一列列出参数及其默认值，第二列对参数功能和可能的值进行说明。
表 A-1 desktopconfig.properties 参数
参数/默认值
说明
debugLevel=error
由桌面生成的调试级别信息。调试输出信息存储在 /var/opt/SUNWam/debug/desktop.debug 中。增加 logLevel 的值时请务必小心，因为过多的记录会导致 IO 操作集中，从而使性能降低。
可能的值包括：（按记录由少到多的升序排列）off、error、warning, message 或 on
默认值：error
perfLevel=off
[内部]
由桌面记录的性能度量级别。输出信息存储在 /var/opt/SUNWam/debug/desktop.perf 中。在生产环境下，此参数应始终为 off。
可能的值包括：off 或 message
默认值：off
serviceAppContextClassName=com.sun.portal.desktop.context.DSAMEServiceAppContext
[内部]
默认值：com.sun.portal.desktop.context.DSAMEServiceAppContext
templateBaseDir=/etc/opt/SUNWps/desktop/
[内部]
根目录，所有临时文件均位于此根目录下。
默认值：/etc/opt/SUNWps/desktop/
providerClassBaseDir=/etc/opt/SUNWps/desktop/classes
根目录，客户可在此根目录下放置提供者类，无论这些类是覆盖现成的提供者类，还是其本身特有的新提供者类（通常是此种情况）。必须将提供者类放置在此目录中，可放置在顶级 jar 目录下，或者放置在 com（或任意其它）软件包目录下。
默认值：/etc/opt/SUNWps/desktop/classes
jjspCompilerWARClassPath=<Used only on application server> jjspCompilerWARClassPath=/export/home/ias60sp3/ias/APPS/modules/ps/WEB-INF/lib
[内部]
仅在应用程序服务器上使用。
默认值：
defaultDesktopType=default
[内部]
当 DesktopAppContext 可用，但 DesktopContext 不可用时，由 ErrorProvider 使用的默认桌面类型。
默认值：default
getterPoolMinSize=0
[内部]
默认值： 0
getterPoolMaxSize=0
[内部]
默认值： 0
getterPoolPartitionSize=0
[内部]
默认值： 0
callerPoolMinSize=0
[内部]
默认值： 0
callerPoolMaxSize=0
[内部]
默认值： 0
callerPoolPartitionSize=0
[内部]
默认值： 0
cookiePrefix=desktop.
[内部]
所有桌面 cookie 使用的前缀。
默认值： desktop。
templateScanInterval
定义每隔多少秒对 /etc/opt/SUNWps 目录中的临时文件进行一次扫描（为进行更改而检查）。由于服务器会使用在扫描的间隔时间内存入高速缓存的信息，因此利用此时间间隔可提高服务器的性能和可量测性。默认值为 30 秒
搜索配置属性
默认安装情况下，search.conf 文件安装在 /var/opt/SUNWps/https-instancename/portal/config 目录下。search.conf 文件列出您已设置的所有特定搜索值。/opt/SUNWps/samples/config 目录中包含一个 search.conf 示例文件。
代码示例 A-2 search.conf 文件
#
# search.conf - Search configuration
#
csid=x-catalog://cate.sesta.com:80/cate.sesta.com
bindir=/opt/SUNWps/bin
database-directory=/var/opt/SUNWps/https-cate.sesta.com/portal/db
database-root=/var/opt/SUNWps/https-cate.sesta.com/portal/db
database-max-concurrent=8
database-name=default
database-logdir=db
security-mode=OFF
security-manager=com.sun.portal.search.rdmserver.DSameSecurityManager
debug-logfile=/var/opt/SUNWps/https-cate.sesta.com/portal/logs/rdmserver.log
debug-loglevel=1
filters-check-dns=on
filters-check-redirect=on
filters-check-virtual=on
import-config=/var/opt/SUNWps/https-cate.sesta.com/portal/config/import.conf
libdir=/opt/SUNWps/lib
logfile=/var/opt/SUNWps/https-cate.sesta.com/portal/logs/rdm.log
disable-rdm-log=false
multiple-classifications=3
classification-stats-during-browse=true
browse-root-classification=false
search-logfile=/var/opt/SUNWps/https-cate.sesta.com/portal/logs/searchengine.log
search-max-index-batch=2000
search-query-threads=6
search-index-threads=1
search-index-type=AWord
search-index-partition-size=32
search-dictionary-type=partial
search-lookup-limit=-1
search-highlights=true
search-max-passages=3
search-passage-context=6
#search-field-multipliers=”title 1.0”
reports-exclude-gv-queries=false
reports-exclude-browse=false
rdmgr-logfile=/var/opt/SUNWps/https-cate.sesta.com/portal/logs/rdmgr.log
# comment rdmgr-pidfile to prevent rdmgr daemonization
# rdmgr-pidfile=/var/opt/SUNWps/https-cate.sesta.com/portal/logs/rdmgr.pid
schema-description=/var/opt/SUNWps/https-cate.sesta.com/portal/config/schema.rdm
server-description=/var/opt/SUNWps/https-cate.sesta.com/portal/config/server.rdm
server-root=/var/opt/SUNWps/https-cate.sesta.com/portal
taxonomy-database-name=taxonomy
taxonomy-description-refresh-rate=60
taxonomy-description=/var/opt/SUNWps/https-cate.sesta.com/portal/config/taxonomy.rdm
tmpdir=/var/opt/SUNWps/https-cate.sesta.com/portal/tmp
rlog-max-logs=10
robot-refresh=30000
admin-category_editor_nodes_per_page=25,50,100,250,500,-1
admin-category_editor_max_combo_element=10
默认安装会将 $CSROOT 分配给 /var/opt/SUNWps/http-instancename/portal，将 $CSBIN 分配给 /opt/SUNWps/bin，并将 $CSLIB 分配给 /opt/SUNWps/lib。其中的大多数参数均可在 Sun ONE Application Server Enterprise Edition 管理控制台中“搜索服务器设置”或“搜索服务器高级设置”内进行更改。
表 A-2 表格包含三列。第一列列出全部可更改的参数，第二列列出相应参数的默认值，第三列提供参数的简要说明。
表 A-2 search.conf 参数
参数
默认值
说明
csid
x-catalog://$HOST:$PORT/$NICK
在安装时定义。服务器标识符字符串，主要用于与 Compass Server 向后兼容。
bindir
$CSBIN
在安装时定义。二进制文件的位置。
database-directory
$CSROOT/db
在安装时定义。数据库（由服务器使用）的位置。
database-root
$CSROOT/db
在安装时定义。数据库（由索引创建程序使用）的位置。
database-max-concurrent
8
用于限制每次可访问数据库的服务器线程的数量。您可根据性能要求更改此值，但为获得最佳性能，可将其设置为索引线程数量的 1.25 倍。
database-name
default
逻辑数据库的名称。您可将此值更改为另一数据库（包括外部数据库）的名称。
database-logdir
db
数据库事务日志所在的目录。
security-mode
OFF
启用或禁用文档级安全。可在管理控制台的“服务器设置”下重新设置。
security-manager
com.sun.portal.search.rdmserver.DSameSecurityManager
安全管理器类名。请勿编辑。
security-dsame-group
OFF
对于安全控制，除了使用用户角色外，是否使用组。
debug-logfile
$CSROOT/logs/rdmserver.log
记录内部服务器活动。在安装时定义。可在管理控制台的“服务器高级设置”下重新设置。
debug-loglevel
1
设置默认日志级别。可在管理控制台的“服务器高级设置”下重新设置。
filters-check-dns
on
检查同一地址的服务器别名数量。可在管理控制台的“Robot 模拟器”下重新设置。
filters-check-redirect
on
检查所有服务器重定向。可在管理控制台的“Robot 模拟器”下重新设置。
import-config
$CSROOT/config/import.conf
在安装时定义。当您在管理控制台的“数据库导入”下定义导入代理时，由搜索服务器生成的内容。
libdir
$CSLIB
在安装时定义。
logfile
$CSROOT/logs/rdm.log
RDM 服务器请求的日志。在安装时定义。可在管理控制台的“服务器高级设置”下重新设置。
disable-rdm-log
false
禁用 RDM 请求记录。可在管理控制台的“服务器高级设置”下重新设置。
classification-stats-during-browse
true
如果为 true，则服务器会记录在每个浏览类别中找到的文档数量。
browse-root-classification
false
是否在类别树的根部浏览文档。
search-logfile
$CSROOT/logs/searchengine.log
搜索引擎日志文件。在安装时定义。可在管理控制台的“服务器高级设置”下重新设置。
search-max-index-batch
2000
每个索引批中文档数量的最大值。
search-query-threads
6
搜索查询线程的数量。应根据需要为每个中央处理器设置 3 至 6 个线程。
search-index-threads
1
搜索索引线程的数量。通常为 1。
search-index-type
AWord
搜索引擎索引的格式。请勿编辑。
search-index-partition-size
32
索引合并期间使用的块划分系数。请勿编辑。
search-dictionary-type
partial
搜索字典的格式。请勿编辑。
search-lookup-limit
-1
控制慢速通配符搜索的超时(毫秒)。-1 表示没有限制。
search-highlights
true
启用突出显示搜索结果。
search-max-passages
3
要生成的动态汇总段的最大数量。
search-passage-context
6
每个突出显示的段所包含的相关内容的大小（单位为字）。
#search-field-multipliers
”title 1.0”
搜索分配给不同文档字段的权数。可以是用逗号分隔的列表。
rdmgr-logfile
$CSROOT/logs/rdmgr.log
索引创建程序进程的日志文件。在安装时定义。可在管理控制台的“服务器高级设置”下重新设置。
schema-description
$CSROOT/config/schema.rdm
默认的“搜索引擎模式”。在安装时定义。
server-description
$CSROOT/config/server.rdm
由服务器说明请求返回的 RDM 服务器说明。在安装时定义。
server-root
$CSROOT
服务器实例根目录。在安装时定义。可在管理控制台的“服务器设置”下重新设置。
taxonomy-database-name
分类法
分类法索引数据库的逻辑名。
taxonomy-description-refresh-rate
3600 -> 60
分类法自动重载的轮询间隔。
taxonomy-description
$CSROOT/config/taxonomy.rdm
“RDM 分类法”的定义。可使用“类别”下的“类别编辑器”进行编辑。在安装时定义。
tmpdir
$CSROOT/tmp
在安装时定义。可在管理控制台的“Robot 搜寻”下重新设置。
robot-refresh
30000
每隔多少毫秒刷新一次管理控制台的“Robot 控制”页。
admin-category_editor_nodes_per_page
25,50,100,250,500,-1
可用选择的列表，定义每页最多可显示的类别数量。
-1 表示显示整个树。admin-category_editor_max_combo_element
10
目标类别的类别编辑器下拉选择列表中的最大元素数量。
注意
未使用以下参数，因此这些参数未包括在表 A-2 中：filters-check-virtual、multiple-classifications、reports-exclude-gv-queries、reports-exclude-browse、rdmgr-pidfile，以及 rlog-max-logs。
