Configuring Java Virtual Machine settings for JAAS login and memory

Use the Java™ Virtual Machine settings in the WebSphere® Application Server to set up JAAS login information for authentication and memory settings for resource usage.

Remember: 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.

1. Log in to the WebSphere administrative console.
2. Navigate to the Java Virtual Machine settings at Servers > Server Types > WebSphere application servers > server_name > Java & Process Management > Process Definition > Java Virtual Machine.
3. In the Generic JVM arguments field, add the following entry:

   -Djava.security.auth.login.config=AE_install_path
   \CE_API\config\jaas.conf.WebSphere

   Replace AE_install_path in the entry above with your actual installation path, for example:

   AIX®, HPUX, Linux, Linux on System z®, Solaris:

   -Djava.security.auth.login.config=opt/FileNet/AE
   /CE_API/config/jaas.conf.WebSphere

   Windows:

   -Djava.security.auth.login.config=C:\Progra~1\FileNet\AE
   \CE_API\config\jaas.conf.WebSphere

   Windows 64-bit server with Application Engine installed in the Program Files (x86) directory:

   -Djava.security.auth.login.config=C:\Progra~2\FileNet\AE
   \CE_API\config\jaas.conf.WebSphere

   Your path might be slightly different based on the version of your client installations, or whether you have chosen a custom path for the installation. Verify the location of this file and specify the install path location before you enter the path.

   Important: Do not copy and paste the text from this guide into the field in the console because hidden formatting can cause problems with the entry. Use a paste special option in a text editor to remove formatting first, or type the entry into the field.
   Important: (Windows only) The path cannot contain a space. You must use 8.3-notation for the install path portion of the full JAAS login entry described above.

   If AE_install_path is:

   C:\Program Files\FileNet\AE

   use:

   C:\Progra~1\FileNet\AE
4. Set the Initial heap size and Maximum heap size, and save your changes.

   For example, you might set the Initial heap size to 512 and the Maximum heap size to 1024. However, these values vary significantly depending on your machine size.

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

5. (For installations with Content Platform Engine and Application Engine collocated on the WebSphere server, but in different WebSphere profiles) Create an additional JVM property for different WebSphere profiles.

   Perform the following steps on both the Content Platform Engine profile and the Application Engine profile:

   1. In the Java Virtual Machine settings, create a Custom Property:

      com.ibm.websphere.orb.uniqueServerName

   2. Set the Value to true.
   3. Save your changes.
   4. Restart WebSphere Application Server.