Application Engine 서버를 설치한 후
JBoss Application Server를 Application Engine과
사용하도록 구성해야 합니다. 또한 SSO 등의 선택 모드에 대한 변경 사항을
구성할 수 있습니다.
알아두기: 팜 및 클러스터 환경에서 모든 노드에
JBoss Application Server의
Application Engine을 구성하십시오.
알아두기: 고가용성의 클러스터된 서버 구성에서 JVM(Java™ Virtual
Machine) 설정을 작성해야 하는 단계의 경우 애플리케이션 서버 구성의 모든 노드에 해당 변경사항을 작성해야 합니다.
JBoss Application Server를
Application Engine에 대해 구성하려면 다음을 수행하십시오.
- JBoss Application Server가 실행 중이면
중지하십시오.
- 사용 중인 플랫폼에 따라 run.conf 파일과 시작 스크립트의
백업 사본을 만드십시오.
옵션 |
설명 |
UNIX® |
run.sh |
Windows® |
run.bat |
- run.conf 파일 Java 설정을 편집하십시오.
- 다음 예제를 참조하여 JBoss Application Server에서 제공되는 JDK 경로를 지정하는 행을
추가하십시오(Windows). set
JAVA_HOME=C:\Program Files\Java\jdk1.5.0_06
사용 중인 JDK의 버전이
1.5.0이 아니면 표시된 버전을 사용 중인 버전으로
대체하십시오.
- JAVA_OPTS 메모리 설정을 업데이트하십시오.
이 설정을 조정하면 애플리케이션 서버의 메모리 부족으로 사용자가
Workplace에 로그온하지 못하는 상황이
방지됩니다.
JAVA_OPTS 행에서 -Xms 및 -Xmx 값을
현재 구성에 맞게 변경하십시오.
예제
(Windows): set JAVA_OPTS=%JAVA_OPTS%
-Xms 128m -Xmx 512 m
초기 및 최대 힙 크기 값은 애플리케이션 서버 벤더의 권장사항을
참조하십시오. IBM® 고유 권장사항은
IBM FileNet P8 Performance Tuning
Guide를 참조하십시오.
- (Sun JVM 사용자만 해당) JAVA_OPTS의 MaxPermSize 값을
128m으로 설정하십시오(다음 참조).
UNIX
JAVA_OPTS=%JAVA_OPTS%
-Xms128m -Xmx512m -XX:MaxPermSize=128m
Windows
set JAVA_OPTS=%JAVA_OPTS%
-Xms128m -Xmx512m -XX:MaxPermSize=128m
값을 이렇게 늘리면 JBoss Application Server를 중지시킬 수 있는
메모리 부족 오류가 방지됩니다.
- 애플리케이션 서버에서 IBM JVM을 사용하는 경우
run.conf 파일에서 JAVA_OPTS 변수(이전 하위 단계에서 편집한 행의
바로 다음 행)를 편집하십시오. JAVA_OPTS를 편집하면 성능이 향상됩니다.
- UNIX
- run.conf 파일에서 다음 행을 찾으십시오.
JAVA_OPTS="$JAVA_OPTS
이 행을
다음과 같이 변경하십시오(캐리지 리턴 제외).
JAVA_OPTS="$JAVA_OPTS
-Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5"
- Windows
- run.conf 파일에서 다음 행을 찾으십시오.
set
JAVA_OPTS=%JAVA_OPTS%
이 행을
다음과 같이 변경하십시오(캐리지 리턴 제외).
set JAVA_OPTS=%JAVA_OPTS% -Dfilenet.pe.peorb.pool.min=2
-Dfilenet.pe.peorb.pool.max=5
- 편집 내용을 저장하고 파일을 닫으십시오.
- JAAS 로그인을 구성하십시오.
다음 중 하나를 run.sh 파일의
"$JAVA" $JAVA_OPTS(UNIX) 또는
run.bat 파일의
"%JAVA%" %JAVA_OPTS(Windows) 항목
바로 뒤에 추가하십시오.
중요사항: jaas_login 항목을 줄 바꿈 없이
한 줄로 입력하십시오. 이 안내서의 텍스트에는 입력 문제를 일으킬 수 있는
포맷팅이 숨겨져 있으므로 이 안내서의 텍스트를 복사하여 붙여넣지 마십시오.
대신, 스크립트에 항목을 입력하십시오.
설치한 클라이언트의 버전이나
설치 시 사용자 정의 경로를 선택했는지 여부에 따라
경로가 약간 다를 수 있습니다. 경로를 입력하기 전에
파일의 위치를 확인하십시오.
- UNIX
"$JAVA" $JAVA_OPTS
-Djava.security.auth.login.config=
"/opt/FileNet/AE/CE_API/config/jaas.conf.JBoss"
"-Djava.endorsed.dirs=$JBOSS_ENDORSED_DIRS" -classpath
"$JBOSS_CLASSPATH" org.jboss.Main $@
- Windows
"%JAVA%" %JAVA_OPTS%
"-Djava.security.auth.login.config=C:\Program
Files\FileNet\AE\CE_API\config\jaas.conf.JBoss"
"-Djava.endorsed.dirs=%JBOSS_ENDORSED_DIRS%" -classpath
"%JBOSS_CLASSPATH%" org.jboss.Main %*
- run.sh 또는 run.bat 파일을 저장한 후 닫으십시오.
- Application Engine의 LDAP 설정을
Content Engine 설정과 완전히 동일하게 구성하십시오.
- Application Engine 서버에서,
JBoss_home/server/server_name/conf에 위치한
login-config.xml 파일을 편집기에서
여십시오.
- <application-policy name="FileNet"> 항목을 Content Engine 서버에 있는 login-config.xml 파일의
해당 항목과 동일하게 설정하십시오.
- <application-policy name="FileNetP8Engine"> 항목을
Content Engine 서버에 있는
login-config.xml 파일의 해당 항목과 동일하게
설정하십시오.
- <application-policy name="FileNetP8Engine"> 항목을 복사한 후
방금 복사한 <application-policy name="FileNetP8Engine"> 항목 바로 앞에
붙여넣으십시오.
- 첫 번째 <application-policy name="FileNetP8Engine"> 인스턴스를
<application-policy name="FileNetP8">로 변경하십시오.
- FileNet과 관련된 모든 <application-policy name=> 항목을
<application-policy name="other"> 항목 위로 이동하십시오.
- Application Engine 서버에서
login-config.xml 파일의 변경 사항을 저장하십시오.
- JBoss Application Server를 다시 시작하십시오.
- 애플리케이션 서버를 실행하는 사용자의 권한을 설정하십시오.
Windows의 경우,
다음 단계는 NTFS 파티션에만 필요합니다.
애플리케이션 서버를 실행할 사용자가 Application Engine을
설치한 사용자와 다른 경우, Application Engine(AE_install_path)
설치 폴더에 대한 읽기 및 쓰기 권한을
부여해야 합니다.
- (선택사항) JBoss Application Server 로깅을 사용하지 않도록 설정하십시오.
개발 모드에서, JBoss Application Server는
HTTP 액세스, "INFO", "DEBUG" 및 "TRACE" 등의 많은 로그 메시지를
작성합니다. 이로 인해, 배치된 IBM FileNet® 소프트웨어가 예기치 않게 동작할 수 있습니다. 이러한 유형의
과도한 JBoss Application Server 로깅을 제한할 수 있습니다.
로깅을 사용하지 않도록 설정해도
JBoss Application Server 콘솔에는 오류 메시지가 계속 표시됩니다.
- log4j.xml 파일
(JBOSS_home/server/server_name/conf/log4j.xml)을
편집기에서 여십시오.
- 모든 임계값과 우선순위 값을 "INFO", "DEBUG" 또는 "TRACE"에서
"ERROR"로 변경하십시오.
- "Preserve messages in a local file"을 삭제하거나
주석 처리하여 서버 로그를 끄십시오.
- HTTP 액세스 로깅을 끄려면 jboss-service.xml을
텍스트 편집기에서 열고 "Access logger" 섹션을 삭제하거나
주석 처리하십시오.
jboss-service.xml의 위치:
JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/META-INF
- web.xml을 편집기에서 열고
logVerbosityLevel을 "FATAL"로 변경하십시오.
web.xml의
위치:
JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/conf
- JBoss Application Server 서버를 다시 시작하십시오.