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

3.5에서 Application Engine 업그레이드 구성(JBoss Application Server)

Application Engine 서버를 버전 3.5에서 업그레이드한 후에는 Application Engine과 함께 작동하도록 JBoss Application Server를 구성해야 합니다. 선택적 모드(예: SSO)에 대한 변경사항도 구성할 수 있습니다.

High availability 중요사항: 고가용성 환경에서 모든 노드의 애플리케이션 서버에 Application Engine 업그레이드를 구성해야 합니다.

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

  1. 실행 중인 경우 JBoss Application Server를 중지하십시오.
  2. run.conf 파일의 백업 사본 및 시작 스크립트(플랫폼에 따라 다름)를 작성하십시오.
    옵션 설명
    UNIX® run.sh
    Windows® run.bat
  3. run.conf 파일 Java 설정을 편집하십시오.
    1. 다음 예제(Windows)에 표시된 것과 같이, JBoss Application Server에서 제공하는 JDK의 경로를 지정하는 행을 추가하십시오. 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 Java를 사용하는 경우, 이전 하위 단계의 행 바로 뒤에 있는 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 파일(UNIX) 또는 run.bat(Windows)의 "$JAVA" $JAVA_OPTS(UNIX) 또는 "%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. Content Engine 설정과 정확히 일치하도록 Application Engine에 대한 LDAP 설정을 구성하십시오.
    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. 변경사항을 Application Engine 서버의 login-config.xml 파일에 저장하십시오.
    7. 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. "로컬 파일에 메시지 보존"을 삭제하거나 주석 처리하여 서버 로그를 해제하십시오.
    4. HTTP 액세스 로깅을 해제하려면 텍스트 편집기에서 jboss-service.xml을 연 다음 "액세스 로거" 섹션을 삭제하거나 주석 처리하십시오.

      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)