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
/3GB
operating 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
ControlMaxOutRate
toON
. When set toON
, basic throttling of hits to the canisters is enabled. - Configure the
Outflow Control Mode
setting, 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 Second
setting. - Set
Max Outflow Hits Per Second
to1000
. - Set
Max Outflow Bytes Per Second
to 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 Bytes
value, then set the value toMax Ctree Bytes
- 1.
- For