This is the manual for GNU Gatekeeper 4.5.
A manual for your version is in your GnuGk download archive.
A PDF version can be found in the download section.

Chapters: Contents · Introduction · Installation · Getting started · Basic Config · Routed Mode & Proxy · Routing · RAS Config · Authentication · Accounting · Neighbors · Per Endpoint Config · Advanced Config · Monitoring · Advanced Topics

Download GnuGk    Join the community    Get support

The GNU Gatekeeper Manual Chapter 11

11. Per-Endpoint Configuration

In addition to the standard configuration file options, per-endpoint configuration settings can be specified in the GnuGk config file.

11.1 Section [EP::...]

[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
    Default: -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
    Default: 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
    Default: 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 registers.

  • GatewayPriority=1
    Default: 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
    Default: 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
    Default: 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
    Default: 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
    Default: 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
    Default: 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
    Default: 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
    Default: 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
    Default: 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
    Default: 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
    Default: 0

    Disable H.460.17 for this endpoint.

  • DisableH46018=1
    Default: 0

    Disable H.460.18/.19 for this endpoint.

  • MaxBandwidth=81920
    Default: -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
    Default: 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
    Default: 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
    Default: 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
    Default: 0

    Tell GnuGk to add the number from calling party IE to the list of source addresses in the Setup message.

  • DisabledCodecs=h261VideoCapability
    Default: n/a

    Filter codecs for this particular endpoint. Similar to the global switch in the [CallTable] section.

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.


Next Previous Contents

Chapters: Contents · Introduction · Installation · Getting started · Basic Config · Routed Mode & Proxy · Routing · RAS Config · Authentication · Accounting · Neighbors · Per Endpoint Config · Advanced Config · Monitoring · Advanced Topics



Last updated: 20. Aug 2017
Page maintained by Jan Willamowius