| 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
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.
[내부]
모든 데스크탑 쿠키에 사용되는 접두어.
기본값: 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는 3열로 된 표입니다. 첫 번째 열은 변경할 수 있는 매개 변수, 두 번째 열은 매개 변수의 기본값 그리고 세 번째 열은 간단한 설명입니다.
표 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
기본값
논리적 데이터베이스의 이름. 이 값을 외부 데이터베이스를 포함하여 다른 데이터베이스로 변경할 수 있습니다.
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
설정
같은 주소에 대한 별명을 사용하는 서버의 수를 확인합니다. 관리 콘솔의 로봇 시뮬레이터 아래에서 재설정할 수 있습니다.
filters-check-redirect
설정
서버 리디렉션을 확인합니다. 관리 콘솔의 로봇 시뮬레이터 아래에서 재설정할 수 있습니다.
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
검색 쿼리 스레드의 수. 사용할 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-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.
