Sun ONE Portal Server 6.2 管理者ガイド |
付録 A
設定ファイルこの付録では、設定ファイル desktopconfig.properties および search.conf について説明します。
この付録で説明する内容は次のとおりです。
Sun ONE Portal Server の設定ファイルの概要
Sun ONE Portal Server は、デスクトップサービスと検索サービスの設定を管理するために、特定のファイルを使用します。この付録で説明するデスクトップ設定ファイル (desktopconfig.properties) は、サーバー固有のパラメータを定義します。
Sun ONE Identity Server のサービスとしての Portal 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
serviceAppContextClass Name=com.sun.portal.de sktop.context.DSAMESer viceAppContext
[内部使用]
デフォルト値 : com.sun.portal.desktop.context.DSAMEServiceAppContext
templateBaseDir=/etc/o pt/SUNWps/desktop/
[内部使用]
すべてのテンプレートファイルが格納されるルートディレクトリ
デフォルト値 : /etc/opt/SUNWps/desktop/
providerClassBaseDir=/ etc/opt/SUNWps/desktop /classes
顧客がプロバイダクラスの配置を許可されるルートディレクトリ。これ らのプロバイダは、標準のプロバイダに優先して適用されるプロバイダ か、または顧客独自の新規プロバイダである (通常は後者)。プロバイダ クラスは最上位の jar か、com などのパッケージ ディレクトリに配置す る必要がある
デフォルト値 : /etc/opt/SUNWps/desktop/classes
jjspCompilerWARClassPa th=<Used only on application server> jjspCompilerWARClassPa th=/export/home/ias60s p3/ias/APPS/modules/ps /WEB-INF/lib
[内部使用]
アプリケーションサーバーだけで使用される
デフォルト値 :
defaultDesktopType=def ault
[内部使用]
DesktopAppContext を使用できて、DesktopContext を使用できない場合 に、ErrorProvider が使用するデフォルトのデスクトップタイプ
デフォルト値 : default
getterPoolMinSize=0
[内部使用]
デフォルト値 : 0
getterPoolMaxSize=0
[内部使用]
デフォルト値 : 0
getterPoolPartitionSiz e=0
[内部使用]
デフォルト値 : 0
callerPoolMinSize=0
[内部使用]
デフォルト値 : 0
callerPoolMaxSize=0
[内部使用]
デフォルト値 : 0
callerPoolPartitionSiz e=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.l og
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.r dm
server-description=/var/opt/SUNWps/https-cate.sesta.com/portal/config/server.r dm
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/taxono my.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 は、変更可能なパラメータ、パラメータのデフォルト値、およびその簡単な説明を示しています。最初の列は変更できるパラメータ、2 番目の列はそのパラメータのデフォルト値、3 番目の列は簡単な説明を示します。
表 A-2 search.conf のパラメータ
パラメータ
デフォルト
説明
csid
x-catalog:/ /$HOST:$POR T/$NICK
インストール時に定義される。主に Compass Server と の逆互換性を維持するために使用されるサーバー識別 文字列
bindir
$CSBIN
インストール時に定義される。バイナリの格納場所
database-directory
$CSROOT/db
インストール時に定義される。サーバーが使用する データベースの場所
database-root
$CSROOT/db
インストール時に定義される。インデクサが使用する データベースの場所
database-max-concurren t
8
データベースに同時にアクセスできるサーバースレッ ドの数を制限する。この値を変更することでパフォー マンスを向上できる。最適なパフォーマンスを維持す るには、インデックススレッドの約 1.25 倍に設定する 必要がある
database-name
default
論理データベース名。この値は外部データベースを含 む別のデータベースに変更できる
database-logdir
db
データベースのトランザクションログが格納される ディレクトリ
security-mode
OFF
ドキュメントレベルのセキュリティを有効または無効 にする。管理コンソールの「サーバー/設定」でリ セットできる
security-manager
com.sun.por tal.search. rdmserver.D SameSecurit yManager
セキュリティマネージャクラス名。編集不可
security-dsame-group
OFF
セキュリティ制御のためにユーザーロールの他にグ ループを使用するかどうかを指定する
debug-logfile
$CSROOT/logs/rdmserver.log
内部サーバーアクティビティをログに記録する。イン ストール時に定義される。管理コンソールの「サー バー/詳細」でリセットできる
debug-loglevel
1
デフォルトのログレベルを設定する。管理コンソール の「サーバー/詳細」でリセットできる
filters-check-dns
on
アドレスが同じエイリアスのサーバーの数をチェック する。管理コンソールの「ロボット/シミュレータ」 でリセットできる
filters-check-redirect
on
サーバーのリダイレクトをチェックする。管理コン ソールの「ロボット/シミュレータ」でリセットでき る
import-config
$CSROOT/con fig/import. conf
インストール時に定義される。管理コンソールの 「データベース/インポート」でインポートエージェン トを定義した場合に、検索サーバーによって生成され るコンテンツ
libdir
$CSLIB
インストール時に定義される。
logfile
$CSROOT/log s/rdm.log
RDM サーバー要求のログ。インストール時に定義され る。管理コンソールの「サーバー/詳細」でリセット できる
disable-rdm-log
false
RDM 要求のロギングを無効にする。管理コンソールの 「サーバー/詳細」でリセットできる
classification-stats-d uring-browse
true
true に設定した場合、サーバーは見つかったドキュメ ントの数をブラウザカテゴリ別に記録する
browse-root-classifica tion
false
カテゴリツリーのルートでドキュメントを参照するか どうかを指定する
search-logfile
$CSROOT/log s/searcheng ine.log
検索エンジンのログファイル。インストール時に定義 される。管理コンソールの「サーバー/詳細」でリ セットできる
search-max-index-batch
2000
各インデックスバッチのドキュメントの最大数
search-query-threads
6
検索クエリスレッドの数。使用する CPU 単位あたり 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-multipli ers
"title 1.0"
それぞれのドキュメントフィールドに割り当てられる 検索の重み。カンマで区切られたリストで指定できる
rdmgr-logfile
$CSROOT/log s/rdmgr.log
インデクサプロセスのログファイル。インストール時 に定義される。管理コンソールの「サーバー/詳細」 でリセットできる
schema-description
$CSROOT/con fig/schema. rdm
デフォルトの検索エンジンスキーマ。インストール時 に定義される
server-description
$CSROOT/config/server.rdm
サーバー記述要求で返される RDM サーバー記述。イ ンストール時に定義される
server-root
$CSROOT
サーバーインスタンスのルートディレクトリ。インス トール時に定義される。管理コンソールの「サーバー /設定」でリセットできる
taxonomy-database-name
分類
分類インデックスデータベースの論理名
taxonomy-description-r efresh-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,2 50,500,-1
ページごとに表示されるカテゴリの最大数を定義する、 使用できる選択項目のリスト。-1 を指定するとすべて のツリーが表示される
admin-category_editor_ max_combo_element
10
ターゲットカテゴリのカテゴリエディタのドロップダ ウン選択リストに含まれる要素の最大数
注
次のパラメータは使用されなauため、表 A-2 には示されていません。 filters-check-virtual、multiple-classifications、 reports-exclude-gv-queries、reports-exclude-browse、 rdmgr-pidfile、および rlog-max-logs。