Ceci est le manuel Français pour GNU Gatekeeper 2.2.1 (partially updated for 2.3.2).
Une version plus récente (Anglais) du manuel se trouve dans l'archive téléchargée de GnuGk.

Chapitres: Contenu · Introduction · Installation · Pour commencer · Config basique · Routage · Config RAS · Authentification · Accounting · Voisins · Config par terminal · Config avancée · Surveillance

6. Configuration RAS

6.1 Section [RasSrv::GWPrefixes]

Cette section liste quels numéros E.164 sont routés vers une passerelle spécifique.

Format:

gw-alias=prefix[,prefix,...]

Il faut noter que vous devez indiquer l'alias de la passerelle. Si une passerelle est enregistrée pour cet alias, tous les numéros commençant par les préfixes sont routés vers cette passerelle. Les caractères spéciaux . et ! peuvent être utilisés ici pour correspondre à n'importe quel chiffre et désactiver le préfixe.

A priority can be given to each prefix for each gateway (using := syntax), so that if several gateways match the dialed number, the one with the highest prefix priority will be selected to route the call (when the ActivateFailover switch is ON, the call will be routed to all selected gateways in order of the prefix priority). A smaller value corresponds to a higher priority. Default value is 1. If the prefix priority and overlaps the GatewayPriority (see section [EP::...]), the prefix priority will be preferred.

In the following example, the gateway "test-gw" will be responsible for prefixes "02" and "03" with a priority of 3, and for "04" with a priority of 1.

Exemple:

test-gw=02,03:=3,04:=1

6.2 Section [RasSrv::PermanentEndpoints]

Dans cette section vous pouvez mettre des terminaux qui n'ont pas le support RAS ou que vous ne souhaitez pas voir expirer. Les enregistrements seront toujours conservés dans le table d'enregistrements du gatekeeper. Cependant, vous pouvez toujours le désenregistrer par le port d'état. Les caractères spéciaux . et ! peuvent être utilisés avec les préfixes ici pour correspondre à n'importe quel chiffre et désactiver le préfixe. Vous pouvez utiliser la syntaxe := pour fixer la priorité d'un préfixe de la même manière que dans la section <@@ref>gwprefixes[RasSrv::GWPrefixes].

Format:

IP[:port]=alias[,alias,...;prefix[:=priority][,prefix[:=priority]]...]

Exemple:

Pour une passerelle,

10.0.1.5=MyGW;009,008:=2,0.7:=3
Pour un terminal,
10.0.1.10:1720=700

6.3 Section [RasSrv::RRQFeatures]

  • AcceptEndpointIdentifier=1
    Défault: 1

    Indique si on accepte endpointIdentifier indiqué dans un RRQ complet.

  • AcceptGatewayPrefixes=1
    Défault: 1

    Une passerelle peut enregistrer ses préfixes avec le gatekeeper en contenant supportedPrefixes dans le champ terminalType du RRQ. Cette option indique si on accepte les préfixes de cette passerelle.

  • AcceptMCUPrefixes=1
    Défaut: 1

    Un MCU peut enregistrer ses préfixes avec le gatekeeper en envoyant supportedPrefixes dans le champ terminalType du RRQ. Cette option définit s'il faut accepter ou non les préfixes spécifiés par un MCU.

  • OverwriteEPOnSameAddress=1
    Défaut: 0

    Dans certains réseaux l'adresse IP d'un terminal peut changer de façon inattendue. Ceci peut se produire quand un terminal utilise une connexion PPP (e.g. modem ou ADSL). Cette option indique comment gérer un demande d'enregistrement (RRQ) d'une adresse IP qui ne correspond pas à ce que nous avons stocké. L'action par défaut est de rejeter la requête. Avec cette option activée la requête contradictoire entraînera une requête non-enregistré (URQ) à être envoyée pour l'adresse IP existante et l'entrée est supprimée pour permettre le terminal de s'enregistrer avec la nouvelle adresse.

  • IRQPollCount=0
    Défault: 1

    Quand le gatekeeper ne reçoit pas un RRQ garder-en-vie d'un terminal pendant une période de temps TimeToLive, il envoie un message IRQ pour "sonder" le terminal et vérifier si il est en vie. Après que IRQPollCount messages aient été envoyés sans qu'aucune réponse n'ait été reçue, le terminal est désenregistré. Pour désactiver cette fonction (et désenregistrer les terminaux juste aprés TimeToLive), régler cette variable à 0. L'intervalle de sondage IRQ est de 60 secondes.

  • SupportDynamicIP=1
    Default: 0

    When the IP address of an endpoint changes, the gatekeeper can maintain registration. This will force the EP to fully re-register if its IP address changes.

  • AccHTTPLink=https://billing.mysite.com?account=%a&password=%p
    Default: N/A

    You can assign a URL for clients to access to view billing information. If using PacPhone you can also add wildcards for the client to use so the clients H323ID and password can be used to directly access their account information. %a - H323ID %p - password

  • AliasTypeFilter=terminal;h323id,dialeddigits
    Default: N/A

    Use this setting where endpoints send multiple H225_AliasAddress and some Aliases are shared across multiple registrations. You can filter out the shared alias types for any given endpoint type. The registrations will keep all alias types listed in the filter setting and remove all others. You must have separate AliasTypeFilter entries for each endpoint type. Valid endpoint types are: gatekeeper, gateway, mcu and terminal. Valid filters are: h323id, dialeddigits, url, transport, email and partynumber. NOTE: If no alias is found that match the filter then all aliases are registered.

6.4 Section [RasSrv::ARQFeatures]

  • ArjReasonRouteCallToGatekeeper=1
    Défaut: 1

    Si cette option est activée, le gatekeeper rejette un ARQ répondu sans un CallRec préexistant dans la CallTable avec la raison routeCallToGatekeeper en mode routé. Le terminal doit libérer l'appel immédiatement et renvoyer l'appel Setup au gatekeeper.

  • RemoveTrailingChar=#
    Défault: N/A

    Indique le caractère de fin à supprimer de destinationInfo. Par exemple, si votre terminal contient de manière erronée le caractère de fin tel que `#' dans destinationInfo, vous pouvez le supprimer avec cette option.

  • RoundRobinGateways=0
    Défault: 1

    Active/désactive la sélection round-robin(?) de passerelle, si plus d'une passerelle correspond à un numéro composé. Si désactivé, la première passerelle disponible sera sélectionnée. Autrement, les appels suivants seront envoyés à chaque passerelle à son tour.

6.5 Section [RasSrv::AssignedAlias]

This allows the assigning of aliases to endpoints as they register, allowing them to set their fully qualified E.164 or URI addresses.

Example:

[RasSrv::AssignedAlias]
1234=3323465777,me@mysite.com 

6.6 Section [AssignedAliases::SQL]

This section configures GnuGk to read the assigned aliases from a database. You can use the same database parameters as defined in [SQLPasswordAuth].

  • Query=SELECT ...
    Default: N/A

    Defines the SQL query used to retrieve the assigned aliases from the database.

    One parameter is defined:

    • %u - endpoint alias

    Sample query string:

    SELECT assignedalias FROM users WHERE alias = '%u' AND active
    

6.7 Section [RasSrv::AssignedGatekeeper]

This allows the assigning of a gatekeeper based upon the H323ID or the apparent source IP address of the registering endpoint. The received H323ID in the GRQ is checked to see if it has a prefix for an assigned gatekeeper or the IP is in a range of an assigned gatekeeper. The endpoint is then advised in the GCF to register with that gatekeeper. You may have multiple gatekeepers for a specific prefix. The first is assigned as the primary and others are then the alternates. (requires H.323v6)

Examples:

[RasSrv::AssignedGKs]
;; For Endpoint with H323ID starting with 01234
01234=x.x.x.x:1719
;; For Endpoints in the range of 195.71.129.0/24 or 195.71.131.0/24
^195\.71\.(129|131)\.[0-9]+$=x.x.x.x:1719

6.8 Section [AssignedGatekeepers::SQL]

This section allows GnuGk to read the assigned gatekeepers from a database. You can use the same database parameters as defined in [SQLPasswordAuth].

  • Query=SELECT ...
    Default: N/A

    Defines the SQL query used to retrieve the assigned gatekeepers from the database.

    Two parameters are defined:

    • %u - endpoint alias
    • %i - endpoint IP

    Sample query string:

    SELECT assignedgatekeeper FROM users WHERE alias = '%u' AND active
    

6.9 Section [NATedEndpoints]

Le gatekeeper peut détecter automatiquement si un terminal est derrière un routeur. Cependant, si la détection échoue, vous pouvez l'indiquer manuellement dans cette section.

Format:

alias=true,yes,1,...

Exemple:

Indique qu'un terminal avec l'alias 601 est derrière un routeur.

601=true


Page suivante Page précédente Table des matières

Chapitres: Contenu · Introduction · Installation · Pour commencer · Config basique · Routage · Config RAS · Authentification · Accounting · Voisins · Config par terminal · Config avancée · Surveillance



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