Howto:Config size Limitations: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
(New page: '''FAQ''' How many "alias" (E.164 number and H.323 id) can I configure under a GW interface? If I try to register a GW interface on a Gatekeeper the registration is OK only if I configur...)
 
No edit summary
 
(55 intermediate revisions by 7 users not shown)
Line 1: Line 1:
'''FAQ'''
<!-- 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 -->


How many "alias" (E.164 number and H.323 id) can I configure under a GW interface?
=Limitations=


If I try to register a GW interface on a Gatekeeper the registration is OK only if I configure up to 31 alias. If I try with 32 the registration fail.
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]


'''Answer'''
==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


Hm, difficult to answer to be honest.
==Gateway layer==
* the total size of "config change" commands must not exceed 29kB


There are various restrictions when configuring the relay:
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.


* the total size of the config fiile (all that starts with "config change") must not exceed 64k
==Interfaces==
* the total line length of a config file line must not exceed 2048 bytes
* No more than 32 alias entries are allowed on one Gatekeeper/Registrar interface.
* the number of words on a config line is limited


==VARS==
* Amount of 64kB flash segments to store [[Concept_Flash_Directory|VARS]] in the configuration.
** 2 segments on Gateways
** 10 segments on IPVA


So if there is a problem, you can try to use shorter aliases, leave out the e164 (redundant anyway) or split it into 2 GWx entries. Nevertheless, it is ugly.
==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


However, 31 sounds strange. I may well be that the problem actually is in the gatekeeper in the far end.
== 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)


<!-- Keywords: config line size lenght configline alias maximum number -->


== Related Articles ==
== Related Articles ==


<!--*[[Main_Page|wiki-innovaphone]]-->
[[Concept Flash Directory]]
 
[[Category:Faq|{{PAGENAME}}]]

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