Advanced Hardware Features

From TBwiki
(Difference between revisions)
Jump to: navigation, search
(Uniformize CAS R2 naming)
(Updated so that it looks better)
 
Line 2: Line 2:
  
 
Advanced hardware features allow to tune the system for particular applications or environments. To modify this, go to:  
 
Advanced hardware features allow to tune the system for particular applications or environments. To modify this, go to:  
<pre>Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced</pre>  
+
<pre>Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters</pre>  
The options below require a restart of the main telecom module. Once all the changes have been done, go to:  
+
'''NOTE:''' The options below require a restart of the main telecom module. Once all the changes have been done, go to:  
 
<pre>Hardware -&gt; Status -&gt; TB00xxxx -&gt; Reboot adapter [Yes] -&gt; Apply States</pre>  
 
<pre>Hardware -&gt; Status -&gt; TB00xxxx -&gt; Reboot adapter [Yes] -&gt; Apply States</pre>  
 
<br>  
 
<br>  
Line 10: Line 10:
  
 
'''Enable HTTP or telnet access''' are set to allow the usage of the direct HTTP or telnet access to the main telecom module. Most of the time this is not needed, so they can be disabled. When using the TMP platform, the user needs to ssh to the TMG unit before accessing HTTP or telnet.  
 
'''Enable HTTP or telnet access''' are set to allow the usage of the direct HTTP or telnet access to the main telecom module. Most of the time this is not needed, so they can be disabled. When using the TMP platform, the user needs to ssh to the TMG unit before accessing HTTP or telnet.  
 
+
<pre>Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Enable HTTP access
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Enable Telnet access</pre>
 
<br>  
 
<br>  
  
 
=== V34 fax  ===
 
=== V34 fax  ===
  
'''Enable V34 FAX''' feature allows V.34 fax feature, in addition to V.17 fax. V.34 fax allows for faster fax transmission speeds. This should be selected only if there are V.34 faxes, since it reduces slightly the amount of channels available for fax. Please check the TBVoipWizard.html tool in the tb-doc.zip package.  
+
'''Enable V34 FAX''' feature allows V.34 fax feature, in addition to V.17 fax. V.34 fax allows for faster fax transmission speeds. This should be selected only if there are V.34 faxes, since it reduces slightly the amount of channels available for fax. Please check the TBVoipWizard.html tool in the tb-doc.zip package.
 
+
To enable V.34 fax:
 +
<pre>Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Enable V34 FAX</pre> 
 
<br>  
 
<br>  
  
 
=== CPU optimization  ===
 
=== CPU optimization  ===
  
Depending on the application, it may be useful to optimize the CPU usage. Signaling stacks have the ability to run on either CPU of the main telecom module. It is possible to verify memory and cpu usage and optimize the load of these modules:<br>  
+
Depending on the application, it may be useful to optimize the CPU usage. Signaling stacks have the ability to run on either CPU of the main telecom module. It is possible to verify memory and cpu usage and optimize the load of these modules. The default configuration for these modules for maximum performance is like this:<br>  
 
+
*'''CAS R2'''
+
*'''ISDN'''
+
*'''ISUP'''
+
*'''M2PA'''
+
*'''M2UA'''
+
*'''M3UA'''
+
*'''SIP'''
+
*'''IUA'''
+
*'''LAPD'''
+
  
 +
<pre>Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; CAS R2 -&gt; 60% 
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; ISDN  -&gt; 60%
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Load ISUP on secondary CPU -&gt; Yes
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Load M2PA on secondary CPU -&gt; No 
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Load M2UA on secondary CPU -&gt; No 
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Load M3UA on secondary CPU -&gt; No
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Load SIP  on secondary CPU -&gt; Yes
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Load IUA  on secondary CPU -&gt; No
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Load LAPD on secondary CPU -&gt; Yes</pre> 
 
<br>
 
<br>
  
Line 40: Line 41:
  
 
*'''Increase SIP Stack Allowed RAM''': this allocates more memory to the SIP module. This should always be selected on unit sold since 2008.  
 
*'''Increase SIP Stack Allowed RAM''': this allocates more memory to the SIP module. This should always be selected on unit sold since 2008.  
*'''SIP Dynamic/Event/Signal memory size and SIP Signal Pool size''': This is to control individual memory allocation on different modules of the SIP stack.  
+
*'''SIP Dynamic/Event/Signal memory size and SIP Signal Pool size''': This is to control individual memory allocation on different modules of the SIP stack. A value of 0 lets the system select the memory allocation.
*'''Reduced timer''': Default timer for keeping call information from terminated SIP calls is 32 seconds. When the Start threshold is reached the timer will be reduced so that the memory is freed faster, until the Stop threshold is reached. Default is [4], or 40%, for Start threshold and [5], or 50%, Stop threshold
+
*'''Reduced timer''': Default timer for keeping call information from terminated SIP calls is 32 seconds. When the Start threshold is reached the timer will be reduced so that the memory is freed faster, until the Stop threshold is reached.
*'''Congestion''': When the Start threshold is reached, the SIP stack will start refusing calls with congestion (503) error code. Default is [2], or 20%, for Start threshold and [4], or 40%, Stop threshold
+
*'''Congestion''': When the Start threshold is reached, the SIP stack will start refusing calls with congestion (503) error code.  
*'''Critical Congestion''': When the Start threshold is reached, the SIP stack will start dropping incoming calls silently. Default is [1], or 10%, for Start threshold and [3], or 30%, Stop threshold
+
*'''Critical Congestion''': When the Start threshold is reached, the SIP stack will start dropping incoming calls silently.  
 
+
Default Configuration:
 +
<pre>Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Increase SIP Stack Allowed RAM -&gt; Yes 
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; SIP Dynamic/Event/Signal memory size and SIP Signal Pool size -&gt; 0
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Reduced timer -&gt; Start threshold 4, Stop threshold 5
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Congestion -&gt; Start threshold 2,  Stop threshold 4
 +
Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; Critical Congestion -&gt; Start threshold 1, Stop threshold 3</pre> 
 
<br>  
 
<br>  
  
 
=== TDM Companding <br>  ===
 
=== TDM Companding <br>  ===
  
This selects the companding mode of operation of the VoIP and IVR DSP devices. ulaw to Alaw conversion will be automatically done if needed. Should be set to ulaw for countries like US and Canada.
+
This selects the TDM companding mode of operation of the VoIP and IVR DSP devices. uLaw to alaw conversion will be automatically done if needed.
 
+
Should be set to ulaw for countries like US and Canada:
<br>  
+
<pre>Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; TDM Companding -&gt; uLaw</pre>
 +
Other countries should use:
 +
<pre>Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; TDM Companding -&gt; aLaw</pre><br>  
  
 
=== VOIP Codec Mode<br>  ===
 
=== VOIP Codec Mode<br>  ===
  
 
VOIP codec '''Mixed mode''' (default) allows any vocoder to be used in any call. Changing to '''Fixed Mode '''allows more channels for some vocoders, but the count of each type of vocoder must be configured at startup. Please check the TBVoipWizard.html tool in the tb-doc.zip package to know how many channels you can get.<br>  
 
VOIP codec '''Mixed mode''' (default) allows any vocoder to be used in any call. Changing to '''Fixed Mode '''allows more channels for some vocoders, but the count of each type of vocoder must be configured at startup. Please check the TBVoipWizard.html tool in the tb-doc.zip package to know how many channels you can get.<br>  
 +
Default configuration:
 +
<pre>Hardware -&gt; TB00xxxx [Edit] -&gt; Advanced Parameters -&gt; VOIP Codec Mode -&gt; Mixed Mode</pre>
  
 
== <br><br> Call rate limiting feature  ==
 
== <br><br> Call rate limiting feature  ==

Latest revision as of 10:01, 16 April 2013

Contents

Advanced

Advanced hardware features allow to tune the system for particular applications or environments. To modify this, go to:

Hardware -> TB00xxxx [Edit] -> Advanced Parameters

NOTE: The options below require a restart of the main telecom module. Once all the changes have been done, go to:

Hardware -> Status -> TB00xxxx -> Reboot adapter [Yes] -> Apply States


Limit access to advanced interfaces

Enable HTTP or telnet access are set to allow the usage of the direct HTTP or telnet access to the main telecom module. Most of the time this is not needed, so they can be disabled. When using the TMP platform, the user needs to ssh to the TMG unit before accessing HTTP or telnet.

Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Enable HTTP access
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Enable Telnet access


V34 fax

Enable V34 FAX feature allows V.34 fax feature, in addition to V.17 fax. V.34 fax allows for faster fax transmission speeds. This should be selected only if there are V.34 faxes, since it reduces slightly the amount of channels available for fax. Please check the TBVoipWizard.html tool in the tb-doc.zip package. To enable V.34 fax:

Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Enable V34 FAX


CPU optimization

Depending on the application, it may be useful to optimize the CPU usage. Signaling stacks have the ability to run on either CPU of the main telecom module. It is possible to verify memory and cpu usage and optimize the load of these modules. The default configuration for these modules for maximum performance is like this:

Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> CAS R2 -> 60%  
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> ISDN   -> 60% 
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Load ISUP on secondary CPU -> Yes 
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Load M2PA on secondary CPU -> No  
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Load M2UA on secondary CPU -> No  
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Load M3UA on secondary CPU -> No 
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Load SIP  on secondary CPU -> Yes
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Load IUA  on secondary CPU -> No 
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Load LAPD on secondary CPU -> Yes


SIP stack optimization

To better control the SIP stack memory usage, new configuration parameters were added.

  • Increase SIP Stack Allowed RAM: this allocates more memory to the SIP module. This should always be selected on unit sold since 2008.
  • SIP Dynamic/Event/Signal memory size and SIP Signal Pool size: This is to control individual memory allocation on different modules of the SIP stack. A value of 0 lets the system select the memory allocation.
  • Reduced timer: Default timer for keeping call information from terminated SIP calls is 32 seconds. When the Start threshold is reached the timer will be reduced so that the memory is freed faster, until the Stop threshold is reached.
  • Congestion: When the Start threshold is reached, the SIP stack will start refusing calls with congestion (503) error code.
  • Critical Congestion: When the Start threshold is reached, the SIP stack will start dropping incoming calls silently.

Default Configuration:

Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Increase SIP Stack Allowed RAM -> Yes  
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> SIP Dynamic/Event/Signal memory size and SIP Signal Pool size -> 0 
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Reduced timer -> Start threshold 4,  Stop threshold 5
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Congestion -> Start threshold 2,  Stop threshold 4
Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> Critical Congestion -> Start threshold 1,  Stop threshold 3


TDM Companding

This selects the TDM companding mode of operation of the VoIP and IVR DSP devices. uLaw to alaw conversion will be automatically done if needed. Should be set to ulaw for countries like US and Canada:

Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> TDM Companding -> uLaw

Other countries should use:

Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> TDM Companding -> aLaw

VOIP Codec Mode

VOIP codec Mixed mode (default) allows any vocoder to be used in any call. Changing to Fixed Mode allows more channels for some vocoders, but the count of each type of vocoder must be configured at startup. Please check the TBVoipWizard.html tool in the tb-doc.zip package to know how many channels you can get.
Default configuration:

Hardware -> TB00xxxx [Edit] -> Advanced Parameters -> VOIP Codec Mode -> Mixed Mode



Call rate limiting feature

The goal of this feature is to continue processing ongoing calls normally in the event of call bursts from the network. Overloaded calls will be dropped with congestion. This will prevent overloading the system, continue normal call processing and keep the system stable. These call bursts are more likely from a SIP network, where calls can come from many different devices. Calls per second in the system are calculated every second. If the call rate specified in the configuration is lower than this value, the temporary call buffer will be used. To allow for temporary call bursts, temporary call buffers are created ("call buckets"). If this temporary call buffer is emptied, the calls will be instantly dropped with error code congestion (SS7/ISDN: 42, SIP: 503, CAS: back to Idle state). There are temporary call buffers for each signaling interface (SS7, ISDN, CAS and SIP), for overall calls in the system, and per Network Access Point (NAP). Once incoming calls are accepted (not rate limited), the system will always allow the outgoing call to be executed. Dropped calls due to congestion are showed in the CDRs, as well as traces in the logs (specify which).

Configuration:

1) Overall call rate limitations on SS7/ISDN/CAS/SIP stacks

Hardware -> TB00xxxx [Edit] -> Call Rate Limiting
  • Maximum calls per second: If the call rate is higher than this value on this signaling interface (or overall), the call burst buffer will be used.
  • Maximum call bursts: If this temporary call buffer is emptied, the calls will be instantly dropped with error code congestion (SS7/ISDN: 42, SIP: 503, CAS: back to Idle state).


2) Call rate limitation per NAP, SS7/ISDN/CAS/SIP

NAP -> NAP_xxxx [Edit] -> Calls Rate Limiting
  • Maximum calls per second
  • Maximum Call bursts
  • Maximum simultaneous incoming calls: Limits the total number of incoming calls on this NAP to this value
  • Maximum simultaneous outgoing calls: Limits the total number of outgoing calls from this NAP to this value
  • Maximum simultaneous total calls: Limits the total number of calls on this NAP (should be set only for SIP NAPs)


Personal tools