This is archived documentation for an older version of Nirvana (v2.0). Please refer to documentation for the latest version if required.

Setting Transaction Timeout on a Nirvana Realm

 

The MaxTransactionTime is the time that the Nirvana server stores details of each transaction for. During this time isCommited can be called to ascertain if the transaction has been committed etc.

It is the only property in a Nirvana Realm that requires a restart of the server. It is not something that would be changed during normal operation and should be given a value based on what the publish level is and the amount of memory the server has been assigned.

The difference with MaxTransactionTime is that its value is stored in the channels.nst file, and in the pcbtxchannel****.mem as opposed to all other properties which are stored in <configGroup>.cfg files. So if these files are created before this value is changed, and the realm has been running prior to the change, the new value will not take effect until the channels.nst and pxbtxchannel.mem files have been removed and the realm restarted. Here are the steps to take to change the MaxTransactionTime.

Please follow the 5 steps below to change the MaxTransactionTime property

1) Using the realm manager or the admin API, set the MaxTransactionTime to your desired value in milliseconds.


2) Shutdown the server
3) Delete the channels.nst
4) Delete the pcb******.mem files
5) Restart the server. The server will then automatically recreate the TX channels with the new MaxTransactionTime.