Before you configure the session agent, you must acquire the maximum available memory in the Short Term Canister. This value is displayed as the Max Ctree Bytes setting in the Services Controls tab of the Canister configuration in TMS. Write this value down for later use.
To properly throttle the session agent, you must configure the appropriate data outflow to avoid the following problems:
- Canister unable to process hits to meet the incoming rate
- Running out of memory address space in the Short Term Canister
- ctree memory limit configured too close to the maximum address space
- Spooling
Note: Do not set the outflow rate to a value greater than the maximum available bytes in any destination Short Term Canister.
- For 32-bit systems, Tealeaf does not support the use of the
/3GBoperating system switch. - Using a 64-bit operating system enables access to more memory for the Short Term Canister.
Use the steps below to configure the outflow rate.
- In the Short Term Canister Thresholds section of the Extended Decouple session agent configuration, review the value for
Canister Max % Memory Used.Write this value down. - In the Globals section of the Extended Decouple session agent configuration, set
ControlMaxOutRatetoON. When set toON, basic throttling of hits to the canisters is enabled. - Configure the
Outflow Control Modesetting, which manages how the session agent manages the maximum outflow rate. Set this figure toBytes, which pegs the outflow rate to theMax Outflow Bytes Per Secondsetting. - Set
Max Outflow Hits Per Secondto1000. - Set
Max Outflow Bytes Per Secondto the following formula:Max Ctree Bytes * Canister Max % Memory Used + (Max Outflow Hits Per Second *60)- For
Canister Max % Memory Used, convert the value to a decimal. For example, a figure of 85% is inserted into the formula as0.85. - If this value is greater than
Max Ctree Bytesvalue, then set the value toMax Ctree Bytes- 1.
- For