FileNet P8 Application Engine, 버전 5.0.+       애플리케이션 서버:  JBOSS Application Server     

JBoss Application Server에서 Application Engine 구성

Application Engine 서버를 설치한 후 JBoss Application ServerApplication Engine과 사용하도록 구성해야 합니다. 또한 SSO 등의 선택 모드에 대한 변경 사항을 구성할 수 있습니다.

High availability 알아두기: 팜 및 클러스터 환경에서 모든 노드에 JBoss Application ServerApplication Engine을 구성하십시오.
High availability clustered server environments 알아두기: 고가용성의 클러스터된 서버 구성에서 JVM(Java™ Virtual Machine) 설정을 작성해야 하는 단계의 경우 애플리케이션 서버 구성의 모든 노드에 해당 변경사항을 작성해야 합니다.

JBoss Application ServerApplication Engine에 대해 구성하려면 다음을 수행하십시오.

  1. JBoss Application Server가 실행 중이면 중지하십시오.
  2. 사용 중인 플랫폼에 따라 run.conf 파일과 시작 스크립트의 백업 사본을 만드십시오.
    옵션 설명
    UNIX® run.sh
    Windows® run.bat
  3. run.conf 파일 Java 설정을 편집하십시오.
    1. 다음 예제를 참조하여 JBoss Application Server에서 제공되는 JDK 경로를 지정하는 행을 추가하십시오(Windows). set JAVA_HOME=C:\Program Files\Java\jdk1.5.0_06

      사용 중인 JDK의 버전이 1.5.0이 아니면 표시된 버전을 사용 중인 버전으로 대체하십시오.

    2. 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를 참조하십시오.

    3. (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를 중지시킬 수 있는 메모리 부족 오류가 방지됩니다.

    4. 애플리케이션 서버에서 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

    5. 편집 내용을 저장하고 파일을 닫으십시오.
  4. 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 %*
  5. run.sh 또는 run.bat 파일을 저장한 후 닫으십시오.
  6. Application Engine의 LDAP 설정을 Content Engine 설정과 완전히 동일하게 구성하십시오.
    1. Application Engine 서버에서, JBoss_home/server/server_name/conf에 위치한 login-config.xml 파일을 편집기에서 여십시오.
    2. <application-policy name="FileNet"> 항목을 Content Engine 서버에 있는 login-config.xml 파일의 해당 항목과 동일하게 설정하십시오.
    3. <application-policy name="FileNetP8Engine"> 항목을 Content Engine 서버에 있는 login-config.xml 파일의 해당 항목과 동일하게 설정하십시오.
    4. <application-policy name="FileNetP8Engine"> 항목을 복사한 후 방금 복사한 <application-policy name="FileNetP8Engine"> 항목 바로 앞에 붙여넣으십시오.
    5. 첫 번째 <application-policy name="FileNetP8Engine"> 인스턴스를 <application-policy name="FileNetP8">로 변경하십시오.
    6. FileNet과 관련된 모든 <application-policy name=> 항목을 <application-policy name="other"> 항목 위로 이동하십시오.
    7. Application Engine 서버에서 login-config.xml 파일의 변경 사항을 저장하십시오.
    8. JBoss Application Server를 다시 시작하십시오.
  7. 애플리케이션 서버를 실행하는 사용자의 권한을 설정하십시오.

    Windows의 경우, 다음 단계는 NTFS 파티션에만 필요합니다.

    애플리케이션 서버를 실행할 사용자가 Application Engine을 설치한 사용자와 다른 경우, Application Engine(AE_install_path) 설치 폴더에 대한 읽기 및 쓰기 권한을 부여해야 합니다.

  8. (선택사항) JBoss Application Server 로깅을 사용하지 않도록 설정하십시오.

    개발 모드에서, JBoss Application Server는 HTTP 액세스, "INFO", "DEBUG" 및 "TRACE" 등의 많은 로그 메시지를 작성합니다. 이로 인해, 배치된 IBM FileNet® 소프트웨어가 예기치 않게 동작할 수 있습니다. 이러한 유형의 과도한 JBoss Application Server 로깅을 제한할 수 있습니다.

    로깅을 사용하지 않도록 설정해도 JBoss Application Server 콘솔에는 오류 메시지가 계속 표시됩니다.

    1. log4j.xml 파일 (JBOSS_home/server/server_name/conf/log4j.xml)을 편집기에서 여십시오.
    2. 모든 임계값과 우선순위 값을 "INFO", "DEBUG" 또는 "TRACE"에서 "ERROR"로 변경하십시오.
    3. "Preserve messages in a local file"을 삭제하거나 주석 처리하여 서버 로그를 끄십시오.
    4. HTTP 액세스 로깅을 끄려면 jboss-service.xml을 텍스트 편집기에서 열고 "Access logger" 섹션을 삭제하거나 주석 처리하십시오.

      jboss-service.xml의 위치:

      JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/META-INF

    5. web.xml을 편집기에서 열고 logVerbosityLevel을 "FATAL"로 변경하십시오.

      web.xml의 위치:

      JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/conf

    6. JBoss Application Server 서버를 다시 시작하십시오.


피드백

마지막 업데이트 날짜: 2010년 11월


© Copyright IBM Corp. 2010.
이 Information Center는 Eclipse 기술로 구현됩니다. (http://www.eclipse.org)