Configuring JBoss Application Server for Content Platform Engine

JBoss Application Server requires some configurations before you install Content Platform Engine.

About this task

Note: JBoss Application Server clusters do not use a separate administrative server, and configuration changes are implemented on each cluster node separately in a highly available environment.

Important: You must use Configuration Manager, rather than a manual method, to create the data sources that Content Platform Engine uses to connect to a database. A data source that you create manually (by interacting directly with an application server interface) can include, by default, many unnecessary and potentially harmful custom properties. Also, for some combinations of database type and application server type, Configuration Manager adds some special custom properties to the data source it creates, which you might fail to include if you create the data source manually. Without these added custom properties, runtime errors can occur when Content Platform Engine tries to connect to a database.

To configure JBoss Application Server for Content Platform Engine:

1. Navigate to the configuration file set directory.

   Option	Description
   Standard deployment	jboss_install_dir/server
   Cluster deployment (required for high availability)	jboss_install_dir/all

2. Create a new configuration file set by copying the configuration file set to a new directory. For JBoss Application Server 5.0.0 and higher, the configuration file set is the standard subdirectory. For JBoss Application Server versions less than 5.0.0, the configuration file set is the default directory.

   Option	Description
   Standard deployment	Copy the configuration file set to a new directory within the /server directory. For example, copy the files to jboss_install_dir/server/server1.
   Cluster deployment	Copy the configuration file set to a new directory within the /all directory. For example, copy the files to jboss_install_dir/all/server1.

   jboss_install_dir is the directory where JBoss is installed.
3. 
   Record application server values in your customized Installation and Upgrade Worksheet. To find these properties, use the Autofilter drop-down arrow in Column E, Installation or Configuration Program, to select CM: Create New Installation Profile. Then use the Autofilter drop-down arrow in Column D, ISV Component Vendor, to select JBoss.
4. In the jboss_install_dir/bin directory, edit the configuration file run.conf (AIX®, HPUX, and Linux), run.bat (Windows and JBoss 5.0), or run.conf.bat (Windows and JBoss 5.1):
   1. Add a line to specify the path to the JAVA Development Kit (JDK) on the machine where JBoss Application Server is installed, as shown in the following example:

      JAVA_HOME="path_to_Java_JDK"

   2. In the JAVA_OPTS line, change the -Xms and -Xmx values from -Xms128m -Xmx512m to -Xms512m -Xmx1024m.
   3. Set the following JVM parameters:
      • -Duser.language=en
      • -Duser.region=US
      • -Duser.country=US
   4. Save your edits.
5. Refer to theIBM FileNet® P8 system requirements for information on the JDBC driver file for the database type that you need for the GCD or for an object store you will be creating later.
6. Install JDBC drivers on the JBoss Application Server machine, as follows:
   1. Obtain the JDBC drivers, depending on your database type.

      DB2®

      Find the latest version of the Redistributable DB2 JDBC Driver 4.0 driver from the IBM® website by searching for JDBC 4.0.

      Microsoft SQL Server

      Find the version of Microsoft JDBC Driver at Microsoft Support that matches the version of the JDK on the JBoss Application Server machine.

      Oracle

      Access the Oracle JDBC Driver Downloads website and find the JDBC driver file that matches the version of the JDK on the JBoss Application Server machine.

   2. Place the file JDBC driver file in the CLASSPATH.

      Standard deployment

      Copy the JDBC driver file to the jboss_install_dir/server/server1/lib directory.

      Cluster deployment

      Copy the JDBC driver file to the jboss_install_dir/all/server1/lib directory.

7. If you are deploying multiple instances of Content Platform Engine on the same server, do the following for each additional instance:
   1. Copy the configuration file set that you just created and modified from the jboss_install_dir/server/server1 directory to a new directory. Use a separate directory for each instance. For example, copy the jboss_install_dir/server/server1 directory to jboss_install_dir/server/server2 and jboss_install_dir/server/server3.
   2. Assign unique port numbers to each instance. Refer to your JBoss Application Server documentation for details.
8. If it is not already running, start the web application server as follows, and leave the command window open:

   Option	Description
   AIX, HPUX, Linux, Solaris, and JBoss 5.0 and 5.1	./run.sh -c server1 -b 0.0.0.0
   Windows and JBoss 5.0	run.bat -c server1 -b 0.0.0.0
   Windows and JBoss 5.1	run.conf.bat -c server -b 0.0.0.0