This is an old revision of the document!


SIP Transaction Timers

The timers of the tm module can be confusing and normally you do not have to (or should) tweak timers except the `fr_inv_timer` (controlling "how long to ring"). The table below gives an overview of the timers that can be changed from SER configuration file and their relationship to the timer names in RFC3261 and how/why you would want to change it.

Starting in SER 2.0 the timer implementation has been completely rewritten. The timers are now controlled in milliseconds and (not in seconds as in SER 0.9), for example
modparam("tm", "fr_timer", 30000) # default value of 30s.

Timers have a resolution of 1/TIMER_TICKS_HZ. This is by default 62.5 ms. Thus, the timer can fire every 62.5 ms. Note that this also is the error interval (they can fire anywhere in a 62.5 ms interval from their "theoretical" expire point).

fr_timer

This timer is used for all SIP requests. It hits if no reply for an INVITE request or other request has been received (F in milliseconds). If a provisional reply is received for an INVITE (any 1xx), then the fr_inv_timer will be used instead. And if no replies (at all) for an INVITE are received before `fr_timer` hits, the transaction is terminated with a 408 in failure route.

See fr_inv_timer for description of handling of multiple branches and local generation of 408 vs. 408s received from the network etc.

Intention of the RFC is having this value equal to the time required to send seven requests.

  • Corresponding RFC 3261 timers: Timer F and Timer B
  • Default value: 30000 ms
  • Example: modparam("tm", "fr_timer", 20000)

This timer can also be changed per transaction (INVITE) by calling

t_set_fr(timer_fr_inv, timeout_fr);

in a route section of the configuration file. If one of the vaules is 0, the corresponding timer won't be changed (e.g t_set_fr(0, 15000) changes only the fr_timer).

fr_inv_timer

This is the timer which hits if no final reply for an INVITE arrives after a provisional message was received (in milliseconds). This means that this timer controls how long time a phone will ring before a 408 timeout is generated in failure_route. Note that it will not always be the 108 reply that will be seen in the failure_route as SER will choose a reply from all the replies received on all the branches and the "winner" will get to the failure route.

  • Corresponding RFC 3261 timers: Timer C
  • Default value: 120000 ms
  • Example: modparam("tm", "fr_inv_timer", 100000)

This timer can also be changed per transaction (INVITE) by calling t_set_fr(timer_fr_inv, timeout_fr) in a route section of the configuration file. If one of the vaules is 0, the corresponding timer won't be changed (e.g t_set_fr(0, 15000) changes only the fr_timer).

The tm module parameter restart_fr_on_each_reply controls whether the fr_inv_timer is restarted every time a provisonal reply is received, default is 1 (yes).

Setting the parameter to 0 is not RFC conformant but is very usefull for dealing with phones that will periodically retransmit the 18x Ringing, which otherwise could make the transaction live forever or mess up your voicemail activation.

In the failure route, the new tm module functions:

  1. t_branch_timeout
  2. t_branch_replied
  3. t_any_timeout
  4. t_any_replied

can be used to find out if the failure route is executed as a result of a timeout (even if the selected reply is a 408, it could be something forwarded from downstream and not a local timeout), and if it is a timeout, to find out which kind (no reply or "ringing").

if (!t_branch_timeout() && t_check_status("408")) ...  # a 408 received from the network.
if (t_branch_timeout() && ! t_branch_replied()) ... # a local transaction timed out w/o any reply received.
if (t_branch_timeout() && t_branch_replied()) ... # a local timeout after some provsional reply.

Even more script functions:

  1. t_any_timeout: true if any of the transaction branches did timeout
  2. t_any_replied: true if at least one branch received a reply (when used from an on_reply route it will ignore the "current" reply)
  3. t_is_canceled: true if the current transaction has been canceled

For more information see the documentation of tm module.

wt_timer

Time for which a transaction stays in memory to absorb delayed messages after it is completed. Also, when this timer hits, retransmissions of local CANCELs are stopped.

  • Corresponding RFC 3261 timers: Timer I and Timer K
  • Default value: 5000 ms
  • Example: modparam("tm", "wt_timer", 10000)

Within this time, retransmissions will be absorbed by the server. After this time, the transaction is cleared and late retransmissions not recognized. Increase if there is an extreme problem with late retransmissions.

The longer this timer is, the longer the transaction will be kept in memory and memory consumtion increases (Try to set it to a lower value if you want to minimize memory consumption).

retr_timer1

Initial retransmission timer (for everything). On the first retransmit of INVITEs, timer A is set to this value. For each subsequent retransmit, the timer value is doubled until fr_timer hits (RFC 3261: Timer B).

For non-INVITE transactions, the timer is set to MIN(4 * retr_timer1, retr_timer2) until fr_timer hits (RFC 3261: Timer F).

  • Corresponding RFC 3261 timers: Timer T1, initial value for A, E, and G.
  • Default value: 500 ms
  • Example: modparam("tm", "retr_timer1", 1000)

If you have a network with very long roundtrip time (above 1 sec), you may increase this value (but change fr_timer as well).

retr_timer2

The maximum length between two retransmits (for everything).

  • Corresponding RFC 3261 timers: Timer T2, maximum value for A, E, and G.
  • Default value: 4000 ms
  • Example: modparam("tm", "retr_timer2", 8000)

delete_timer

This is the amount of time for which the deletion of a transaction will be delayed if the transaction is still use.

  • Corresponding RFC 3261 timers: No corresponding timer, SER specific
  • Default value: 200 ms
  • Example: modparam("tm", "retr_timer1", 1000)

In general there's no need to change it except for testing ways to minimize the memory consumption (setting it to 100ms might help).


Navigation

Wiki

Other

QR Code
QR Code ref_manual:timers (generated for current page)