FileNet P8 Application Engine, Version 5.2.1       Application server:  WebLogic Application Server     

Configuring the application server files

As part of the configuration of Application Engine on WebLogic Server, configure the application server files to set up JAAS login information for authentication and memory settings for resource usage.

About this task

High availability clustered server environmentsRemember: In high availability clustered server configurations, for steps that require Java™ Virtual Machine (JVM) settings to be made make sure to make these changes for every node in the application server configuration.
To modify the application server files:

Procedure

  1. Stop the WebLogic Server instance if it is running.
  2. Make a backup copy of the setDomainEnv file.

    For Windows, back up setDomainEnv.cmd.

    For AIX®, HPUX, Linux, Linux on System z® or Solaris, back up setDomainEnv.sh.

  3. Edit the MEM_ARGS variable.

    Adjusting this setting prevents the application server from running out of memory, a condition in which users would not be able to log in to Workplace.

    If the MEM_ARGS variable does not exist, add it to the startup script.

    • For all systems except those using JRockit JAVA.
      Append the following to the MEM_ARGS variable:
      -XX:MaxPermSize= size m
      where size is the value, in MB, of the MaxPermSize.

      Refer to your application server vendor recommendation for Initial and Maximum heap size values. For IBM® specific recommendations, see Performance tuning IBM FileNet® P8 components.

    • For systems using JRockit JAVA.
      Append the following to the MEM_ARGS variable:
      -Xgc:gencon
  4. If your application server uses the IBM JVM, edit the JAVA_OPTIONS variable to improve performance.
    AIX, HPUX, Linux, Linux on System z, Solaris
    Immediately before the following line in the setDomainEnv file:
    SAVE_JAVA_OPTIONS=$JAVA_OPTIONS
    insert this line (without a carriage return):
    JAVA_OPTIONS="$JAVA_OPTIONS -Dprogram.name=$PROGNAME
     -Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5"
    Windows
    Immediately before the following line in the setDomainEnv file
    set SAVE_JAVA_OPTIONS=%JAVA_OPTIONS%
    insert this line (no carriage return):
    set JAVA_OPTIONS=%JAVA_OPTIONS% -Dprogram.name=%PROGNAME%
     -Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5
  5. Configure JAAS login.

    Add one of the following right after the classpath entry for WebLogic Server.

    Important: Enter the jaas_login entry as a single line without line breaks. Do not copy and paste the text from this guide because hidden formatting can cause problems with the entry. Instead, type the entry into the script.
    Tip: Your path might be slightly different depending on the version of your client installations, or whether you have chosen a custom path for installation. Verify the location of the file before you enter the path.
    HPUX, Linux, Linux on System z, Solaris
    # Jaas Login configuration setting
    JAAS_LOGIN="${JAAS_LOGIN}" -Djava.security.auth.login.config=
    "AE_install_path/CE_API/config/jaas.conf.WebLogic"
    AIX
    # Jaas Login configuration setting
    JAAS_LOGIN="${JAAS_LOGIN}" -Djava.security.auth.login.config=
    "AE_install_path/CE_API/config/jaas.conf.WebLogic"
    JAAS_LOGIN="${JAAS_LOGIN}"
    -Dlogin.configuration.provider=com.ibm.security.auth.login.ConfigFile
    Windows
    @REM Jaas Login configurationsetting
    set JAAS_LOGIN=%JAAS_LOGIN% -Djava.security.auth.login.config=
    "AE_install_path\CE_API\config\jaas.conf.WebLogic"
  6. Make a backup copy of the application server startup script.

    For Windows, back up startWebLogic.cmd.

    For AIX, HPUX, Linux, Linux on System z, Solaris, back up startWebLogic.sh

    If you are not using a WebLogic domain, back up these files:

    For Windows, back up startWLS.cmd

    For AIX, HPUX, Linux, Linux on System z, Solaris, back up startWLS.sh.

  7. Add the %JAAS_LOGIN% section to the application server startup script as indicated in the following examples.
    AIX, HPUX, Linux, Linux on System z, Solaris - in the WLS_REDIRECT_LOG settings
    ${JAVA_HOME}/bin/java ${JAVA_VM} -version
    
    if [ "${WLS_REDIRECT_LOG}" = "" ] ; then
    echo "Starting WLS with line:"
    echo "${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS}
    -Dweblogic.Name=${SERVER_
    NAME} -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy
    ${PROXY_SETTINGS} ${SERVER_CLASS
    }"
     ${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS} 
    ${JAAS_LOGIN}-Dweblogic.Name=${SERVER_NAME}
    -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy
    ${PROXY_SETTINGS} ${SERVER_
    CLASS}
    else
    echo "Redirecting output from WLS window to ${WLS_REDIRECT_LOG}"
    ${JAVA_HOME}/bin/java ${JAVA_VM} ${MEM_ARGS} ${JAVA_OPTIONS} 
    ${JAAS_LOGIN} -Dweblogic.Name=${SERVER_NAME}
    -Djava.security.policy=${WL_HOME}/server/lib/weblogic.policy
    ${PROXY_SETTINGS} ${SERVER_
    CLASS} >"${WLS_REDIRECT_LOG}" 2>&1
    fi
    Windows - in the WLS_REDIRECT_LOG settings
    If "%WLS_REDIRECT_LOG%"==""(
    echo Starting WLS with line:
    echo %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% 
    %JAAS_LOGIN% -Dweblogic.Name=%SERVER_NAME% 
    -Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy 
    %PROXY_SETTINGS% %SERVER_CLASS% %JAVA_HOME%\bin\java %JAVA_VM% 
    %MEM_ARGS% %JAVA_OPTIONS% %JAAS_LOGIN% 
    -Dweblogic.Name=%SERVER_NAME% 
    -Dweblogic.management.username=%WLS_USER%
    -Dweblogic.management.password=%WLS_PW%
    -Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy 
    %PROXY_SETTINGS% %SERVER_CLASS%
    ) else (
    echo Redirecting output from WLS window to %WLS_REDIRECT_LOG%
    %JAVA_HOME%\bin\java %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% 
    %JAAS_LOGIN% -Dweblogic.Name=%SERVER_NAME% 
    -Dweblogic.management.username=%WLS_USER%
    -Dweblogic.management.password=%WLS_PW%
    -Djava.security.policy=%WL_HOME%\server\lib\weblogic.policy 
    %PROXY_SETTINGS% %SERVER_CLASS% >"%WLS_REDIRECT_LOG%" 2>&1
    )
  8. Save and close the application server startup script.


Last updated: March 2016
p8pin126.htm

© Copyright IBM Corporation 2013, 2016.