Configuring the JBoss server transaction and authentication timeouts

The default values for the JBoss tuning parameters, TransactionTimeout, DefaultCacheTimeout, and DefaultCacheResolution, are set during the installation. The out-of-the-box values are adequate for most purposes, but you can change the values for these tuning parameters for transactions and re-authentication.

Although you can change these parameters values for any installation, you will most likely need to change them for a remote (federated databases) deployment of BMC IT Business management Suite. In such cases, because there is a significant latency between the JBoss server and the BMC Remedy AR System database server, and if there is much organizational unit data to synchronize, you might need to adjust the values by using the following instructions.

Changing transaction timeouts

If a background job cannot finish before timing out, you must increase the value of the TransactionTimeout parameter. For example, synchronizing a large organizational unit hierarchy with BMC IT Business Management Suite can take longer than a typical job.

To change the transaction timeout

1. Locate the jboss-service.xml file:
   • In JBoss Enterprise Edition, go to production\conf.
   • In JBoss Community Edition, go to default\conf.

2. In the following section, set the TransactionTimeout attribute value to 3600, which is 60 minutes (the default is 300, which is 5 minutes): 

   
   <!-- JBoss Transactions JTA -->
   <mbean code="com.arjuna.ats.jbossatx.jta.TransactionManagerService"
     name="jboss:service=TransactionManager">
     <attribute name="TransactionTimeout">3600</attribute>
     <attribute name="ObjectStoreDir">${jboss.server.data.dir}/tx-object-store</attribute>
   </mbean>
   
3. To apply the changes, restart JBoss.

Changing the JBoss user re-authentication interval

JBoss re-authenticates each logged-on user regularly. For example, BMC IT Business Management Suite contacts the BMC Remedy AR System server periodically to check the user's credentials. The default interval is 60 seconds (1 minute).

To increase the time interval

1. Locate the jboss-service.xml file:
   • In JBoss Enterprise Edition, go to production\conf.
   • In JBoss Community Edition, go to default\conf.
2. Locate the DefaultCacheTimeout and DefaultCacheResolution attributes.
3. Change their values to 1800 seconds.
4. To apply the changes, restart JBoss.