After you install the Application Engine server, you must configure JBoss Application Server to work with Application Engine. You can also configure changes for optional modes like SSO.
To configure JBoss Application Server for Application Engine:
Option | Description |
---|---|
UNIX® | run.sh |
Windows® | run.bat |
If your JDK is different from version 1.5.0, substitute your version for the one listed.
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.
In the JAVA_OPTS line, change the -Xms and -Xmx values for your configuration.
Example (Windows): set JAVA_OPTS=%JAVA_OPTS% -Xms 128m -Xmx 512 m
See your application server vendor recommendation for Initial and Maximum heap size values. For IBM® specific recommendations, see the IBM FileNet P8 Performance Tuning Guide.
UNIX
JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:MaxPermSize=128m
Windows
set JAVA_OPTS=%JAVA_OPTS% -Xms128m -Xmx512m -XX:MaxPermSize=128m
This increased value prevents out of memory errors that can stop JBoss Application Server.
JAVA_OPTS="$JAVA_OPTS
and change it to this (without a carriage return):
JAVA_OPTS="$JAVA_OPTS -Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5"
set JAVA_OPTS=%JAVA_OPTS%
and change it to this (without a carriage return):
set JAVA_OPTS=%JAVA_OPTS% -Dfilenet.pe.peorb.pool.min=2 -Dfilenet.pe.peorb.pool.max=5
Add one of the following right after the "$JAVA" $JAVA_OPTS (UNIX) or "%JAVA%" %JAVA_OPTS (Windows) entry in the run.sh file for UNIX or the run.bat for Windows.
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.
"$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 $@
"%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 %*
On Windows, the following is only required for NTFS formatted partitions.
If the user that runs the application server is different from the user that installed Application Engine, you must give the user read and write permissions on the folder where you installed Application Engine (AE_install_path).
In development mode, JBoss Application Server creates many HTTP Access, "INFO", "DEBUG" and "TRACE" log messages. This can cause unexpected behavior in the deployed IBM FileNet® software. You can limit this type of excessive JBoss Application Server logging.
When logging is disabled, error messages still display in the JBoss Application Server console.
Location of jboss-service.xml:
JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/META-INF
Location of web.xml:
JBoss_Home/server/server_name/deploy/jbossweb-tomcat55.sar/conf