Howto:Config size Limitations: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
m (Reverted edits by Slu (Talk); changed back to last version by Sga)
No edit summary
 
(23 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<!-- Keywords: config line size lenght length configline alias maximum number max config conf line relay maximum characters maps routes how many routes maximum routes maximum maps limitations restrictions -->
<!-- Keywords: config line size lenght length configline alias maximum number max config conf line relay maximum characters maps routes how many routes maximum routes maximum maps limitations restrictions -->
=Limitations=
=Limitations=


There are various global restrictions in the config size:
Sometimes, in large scenarios, there are configurations that can exceed some limits. This is to be considered in a concept planning.<br />
In most cases, problems with the limitations are simple conceptual errors and can be resolved by a different configuration.
 
If you have any problems with the concept development, or problems with understanding, please feel free to contact [mailto:presales-at-innovaphone-dot-com our presales team]
 
==Whole Configuration File==
* the total length of each line must not exceed the following size:
:* 32kB in V13r1 and higher
:* 20kB in V12r1, V12r2
:* &nbsp;&nbsp;8kB in v11r2 and lower
* the number of whitespace separated strings (words) on each config line must not exceed 1024


==Gateway layer==
* the total size of "config change" commands must not exceed 29kB
* the total size of "config change" commands must not exceed 29kB
* the total line length must not exceed 20kB (for v11r2 and earlier versions the limit is 8kB)
* the number of whitespace separated strings (words) on a config line must not exceed 1024


There are some special restrictions in the config size:
note 1: only lines with additional configuration parameters are counted. This means a line like "config change IP0 ETH1" without any additional parameters will not be counted.
note 2: from duplicate configuration (with additional configuration - see note 1) lines, only the last one is counted.
 
==Interfaces==
* No more than 32 alias entries are allowed on one Gatekeeper/Registrar interface.
* No more than 32 alias entries are allowed on one Gatekeeper/Registrar interface.
* No more than 6 Hardware IDs on a PBX Object are possible.


So if there is a problem, you can try to use shorter aliases, leave out redundant informations. Nevertheless, it is ugly.
==VARS==
* Amount of 64kB flash segments to store [[Concept_Flash_Directory|VARS]] in the configuration.
** 2 segments on Gateways
** 10 segments on IPVA
 
==PBX Object==
* Maximum Hardware IDs on a PBX Object:
:* 10 in V13r1 and higher
:* &nbsp;&nbsp;6 in V12r2 and lower
* No more than 32 conditions (only/only not) in a single CFx are possible
:If more conditions are needed, we recommend moving the logic to an external XML script that interprets the CGPN and forwards the call if necessary. See [http://wiki.innovaphone.com/index.php?title=Category:Sample sample scripts]
* Maximum size of a single xml attribute:
:* 32kB in V13r1 and higher
:* &nbsp;&nbsp;4kB in V12r2 and lower
* User specific myApps homescreen configuration: 8KB
 
== PBX Groups ==
* Maximum limitation is 2048 Objects in a group
* Maximum limitation for the ''primary group'' in a Waiting Queue Object is 30 bytes for the groupname
 
== Reverse Proxy ==
* As of version 13r2 sr15, you can configure 128 maps per hostname entry. Previously, only 32 maps were allowed.
 
=Weak Scenarios and better Solutions=
 
==Many Routes and Number Mappings in the routing engine==
It is not recommended to create very large configurations in the routing engine.
Instead, we recommend an assessment of the necessary concept and a sustainable solution.
 
Examples:
*[[Course12:Advanced_-_E164_PBX_Setups|E164 Setup]] - use global structured numbering plan
*[[Howto:Create_an_ACD_Routepoint_with_external_Call_Distribution_Logic|Howto: external ACD Routepoint logic]] - use external call-distribution logic via Vociemail Object
*[[Howto:Central_SIP_trunk_with_multiple_subscriber_numbers]] - use an additional PBX and GW-interfaces to map subscriber numbers to internal extensions
*separate Node with CFU's - use an additional Node for CFU's with Trunk Object and activated ''Discard received diverting No''
 
=Tools=
*Online Calculator of bytes on String - https://mothereff.in/byte-counter
** please consider: A single character can use 1 to 4 bytes. It depends on the character. (Eg. the most chars use 1 byte, german umlauts use 2 bytes)


Online Calculator of bytes on String - https://mothereff.in/byte-counter


=Weak Scenarios and alternative Solutions=
== Related Articles ==


==Many number mappings in the routing engine==
[[Concept Flash Directory]]
Use PBX Features instead:
*[[Course12:Advanced_-_E164_PBX_Setups|E164 Setup]]
*[[Howto:Create_an_ACD_Routepoint_with_external_Call_Distribution_Logic|Howto: external ACD Routepoint logic]]
*separate Node with CFx's
* [[Howto:Central_SIP_trunk_with_multiple_subscriber_numbers]] - uses an additional PBX and GW-interfaces to map subscriber numbers to internal extensions

Latest revision as of 14:18, 4 April 2023


Limitations

Sometimes, in large scenarios, there are configurations that can exceed some limits. This is to be considered in a concept planning.
In most cases, problems with the limitations are simple conceptual errors and can be resolved by a different configuration.

If you have any problems with the concept development, or problems with understanding, please feel free to contact our presales team

Whole Configuration File

  • the total length of each line must not exceed the following size:
  • 32kB in V13r1 and higher
  • 20kB in V12r1, V12r2
  •   8kB in v11r2 and lower
  • the number of whitespace separated strings (words) on each config line must not exceed 1024

Gateway layer

  • the total size of "config change" commands must not exceed 29kB
note 1: only lines with additional configuration parameters are counted. This means a line like "config change IP0 ETH1" without any additional parameters will not be counted.
note 2: from duplicate configuration (with additional configuration - see note 1) lines, only the last one is counted.

Interfaces

  • No more than 32 alias entries are allowed on one Gatekeeper/Registrar interface.

VARS

  • Amount of 64kB flash segments to store VARS in the configuration.
    • 2 segments on Gateways
    • 10 segments on IPVA

PBX Object

  • Maximum Hardware IDs on a PBX Object:
  • 10 in V13r1 and higher
  •   6 in V12r2 and lower
  • No more than 32 conditions (only/only not) in a single CFx are possible
If more conditions are needed, we recommend moving the logic to an external XML script that interprets the CGPN and forwards the call if necessary. See sample scripts
  • Maximum size of a single xml attribute:
  • 32kB in V13r1 and higher
  •   4kB in V12r2 and lower
  • User specific myApps homescreen configuration: 8KB

PBX Groups

  • Maximum limitation is 2048 Objects in a group
  • Maximum limitation for the primary group in a Waiting Queue Object is 30 bytes for the groupname

Reverse Proxy

  • As of version 13r2 sr15, you can configure 128 maps per hostname entry. Previously, only 32 maps were allowed.

Weak Scenarios and better Solutions

Many Routes and Number Mappings in the routing engine

It is not recommended to create very large configurations in the routing engine. Instead, we recommend an assessment of the necessary concept and a sustainable solution.

Examples:

Tools

  • Online Calculator of bytes on String - https://mothereff.in/byte-counter
    • please consider: A single character can use 1 to 4 bytes. It depends on the character. (Eg. the most chars use 1 byte, german umlauts use 2 bytes)


Related Articles

Concept Flash Directory

Retrieved from "https://wiki.innovaphone.com/index.php?title=Howto:Config_size_Limitations&oldid=66905"