In addition to the standard configuration file options, per-endpoint configuration settings can be specified in the GnuGk config file. The syntax is as follows:
[EP::ALIAS]
Key Name=Value String
ALIAS
should be replaced with the actual alias for the endpoint the settings
should apply to. If your endpoint has multiple aliases, you can pick one of them.
GnuGk will look through all aliases and use the first [EP:..] section it finds.
Currently, the following options are recognized:
Capacity=10
-1
Call capacity for an endpoint. No more than Capacity
concurrent
calls will be sent to this endpoint. In case of gateways, if more than one
gateway matches a dialed number, a call will be sent to the first available
gateway which has available capacity.
PrefixCapacities=^0049:=10,^(0044|0045):=20
N/A
Limit the capacity for certain prefixes. Regular expressions can be used to specify the prefix and specify a combined capacity for a group of prefixes. For a gateway to be considered available a.) the prefix must have capacity left and b.) the total gateway capacity (see above) must not be exceeded.
ForceGateway=1
0
If you endpoint doesn't register as a gateway or MCU, you can't assign gateway prefixes. Use this switch to treat an endpoint as a gateway regardless of how it regsiters.
GatewayPriority=1
1
Applicable only to gateways. Allows priority based routing when more
than one gateway matches a dialed number. Lower values indicate a higher gateway priority.
A call is routed to the first available gateway
(that has available capacity) with the highest priority (the lowest
GatewayPriority
values). In case the gateway priority contradicts prefix priority (see section
[RasSrv::GWPrefixes])
for details), prefix priority will take precedence.
GatewayPrefixes=0048,0049:=2,0044
N/A
Additional prefixes for this gateway. Applies only to gateways. Special
characters .
and !
can be used to match any digit or to disable
the prefix. You may use the := syntax to set a prefix priority in the same
manner as in
[RasSrv::GWPrefixes] section. If
no priority is explicitly configured for a prefix, then the gateway priority
is used.
AddNumbers=4212,5650-5630,6000
N/A
Add E.164 numbers to this endpoint. The new aliases can either be specified as a list of numbers or as number ranges.
CalledTypeOfNumber=1
N/A
Sets Called-Party-Number type of number to the specified value for calls sent to this endpoint (0 - UnknownType, 1 - InternationalType, 2 - NationalType, 3 - NetworkSpecificType, 4 - SubscriberType, 6 - AbbreviatedType, 7 - ReservedType).
CallingTypeOfNumber=1
N/A
Sets Calling-Party-Number type of number to the specified value for calls sent to this endpoint (0 - UnknownType, 1 - InternationalType, 2 - NationalType, 3 - NetworkSpecificType, 4 - SubscriberType, 6 - AbbreviatedType, 7 - ReservedType).
CalledPlanOfNumber=1
N/A
Sets Called-Numbering-Plan of number to the specified value for calls sent to this endpoint (0 - UnknownType, 1 - ISDN, 3 - X.121 numbering, 4 - Telex, 8 - National standard, 9 - private numbering).
CallingPlanOfNumber=1
N/A
Sets Calling-Numbering-Plan of number to the specified value for calls sent to this endpoint (0 - UnknownType, 1 - ISDN, 3 - X.121 numbering, 4 - Telex, 8 - National standard, 9 - private numbering).
Proxy=1
0
Enables/disables proxying calls sent to this endpoint (0 - do not change global proxy settings, 1 - force proxy mode, 2 - disable proxy mode).
TranslateReceivedQ931Cause=17:=34
N/A
Translate received cause codes in ReleaseComplete messages from this endpoint. In the above example code 17 (User busy) will be translated into cause code 34 (No circuit/channel available).
TranslateSentQ931Cause=21:=34,27:=34
N/A
Translate cause codes in ReleaseComplete messages sent out to this endpoint. In the above example code 21 and 27 will be translated into cause code 34, because this particular gateway might deal with error code 34 better than with others.
DisableH46017=1
0
Disable H.460.17 for this endpoint.
DisableH46018=1
0
Disable H.460.18/.19 for this endpoint.
MaxBandwidth=81920
-1
Maximum bandwidth this endpoint may use in units of 100 bits per second.
This includes inbound and outbound bandwidth, so for symmetrical calls this should be doubled.
Common bandwidth settings and their GnuGk equivalents:
384K = 7680
512K = 10240
768K = 15360
1024K = 20480
1920K = 38400
2048K = 40960
4096K = 81920
If you do not wish to restrict bandwidth, then use "-1".
AdditionalDestinationAlias=H323-TRUNK
n/a
Add an additional alias to all calls going to this endpoint, if its not already present. This can be used to add the trunk ID required by Swxy version 6 and up.
UseTLS=1
0
Use TLS (transport layer security) when calling this endpoint. See also [TLS] section. If the endpoint is able to signal it's capability to use TLS by H.460.22, then there is no need to explicitely configure this.
DisableCallCreditCapabilities
0
If you have an endpoint that signals call credit capabilities, but crashes when they are used, you can use this switch to disable the feature for this endpoint.
AddCallingPartyToSourceAddress=1
0
Tell GnuGk to add the number from calling party IE to the list of source addresses in the Setup message.
Example how to attach an [EP::..] section to an endpoint:
[RasSrv::PermanentEndpoints]
192.168.1.1=gw1;48
192.168.1.2=gw2;48,!4850,!4860,!4869,!4888
[EP::gw1]
Capacity=60
GatewayPriority=1
[EP::gw2]
Capacity=30
GatewayPriority=2
In this example, calls will be sent to the gateway gw1
until its
capacity is fully utilized (60 concurrent calls) and then to the gateway gw2
.