|
| |
| Sun Java System Portal Server 6 2004Q2 管理員指南 | |
附錄 A
配置檔案本附錄描述 desktopconfig.properties 和 search.conf 配置檔案。
本附錄包含下列章節：
Sun Java System Portal Server 配置檔案摘要
Sun Java™ System Portal Server 使用特定檔案來管理 [桌面] 和 [搜尋] 服務的配置。[桌面] 配置檔案 desktopconfig.properties 定義伺服器特定的參數，而在本附錄中會針對此檔案加以討論。
有作為 Sun Java™ System Identity Server 服務的 Portal Server (請參閱附錄 B)。
[搜尋] 服務會使用特定配置檔案。本附錄中涵蓋了 search.conf 檔案的配置考量。
在安裝時，系統會提供您選擇定義數值或在 Base Directory (/opt)、Deployment URI (/portal) 和 Deploy Instance (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 Java System 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
可檢查另稱為相同位址的伺服器數量。可以在 [自動器模擬器] 底下的管理主控台中重新設定。
filters-check-redirect
on
檢查任何伺服器重導。可以在 [自動器模擬器] 底下的管理主控台中重新設定。
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
分類法索引資料庫的邏輯名稱。
taxonomy-description-refresh-rate
3600 -> 60
自動化分類法重新載入的輪詢間隔。
taxonomy-description
$CSROOT/config/taxonomy.rdm
RDM 分類法定義。使用 [種類] 底下的 [種類編輯器] 進行編輯。安裝時已定義。
tmpdir
$CSROOT/tmp
安裝時已定義。可以在 [自動器耙梳] 底下的管理主控台中重新設定。
robot-refresh
30000
在管理主控台中的 [自動器控制] 頁更新之間所間隔的毫秒數。
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。