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

12. Surveillance du Gatekeeper

12.1 Port d'état

Le port d'état est l'interface externe pour surveiller et contrôler le gatekeeper. Via cette interface, le gatekeeper enverra des messages à propos des appels en cours de tous les clients connectés et recevra des commandes.

L'accès au port d'état est restreint par les régles données dans GkStatus::Auth. Pour des raisons de sécurité, le réglage par défault est de pas autoriser l'accès jusqu'à ce que GkStatus::Auth ait été configuré.

Les messages envoyés par le gatekeeper au port d'état sont regroupés en trois niveaux de trace de sortie: (Ces niveaux de trace ne s'appliquement qu'aux données affichées par le port de sortie. Ne pas les confondre avec les niveaux de trace dans le fichier trace de GnuGK.)

  • Niveau 0
    Notifications de rechargement et réponses directes aux commandes saisies.
  • Niveau 1
    Notifications de rechargement, réponses directes aux commandes saisies, CDRs et Requêtes de Routage.
  • Niveau 2
    Trace tout (notification des rechargement, réponses directes aux commandes saisies, CDRs, Requêtes de Routage, RAS, ...). Il s'agit du niveau de trace par défaut.
Le client connecté au port d'état peut choisir le niveau de trace par lequel il est intéressé.

L'interface est un simple port TCP (par défaut: 7000), vous pouvez vous connecter avec telnet ou un autre client. Une exemple d'autre client est l'IHM Java, connue sous le nom de GnuGk ACD.

Domaines d'Application

Libre à vous de décider ce que vous voulez faire avec les pouvoirs de l'Interface d'Etat, mais voici quelques idées:

  • Surveillance d'Appel
  • Surveillande des terminaux enregistrés
  • Interface Utilisateur Graphique
    Voir GkGUI.
  • Routage d'Appel
    Voir GnuGk ACD.
  • Applications de Facturation
    Analyser les messages CDR et les transmettre à l'application de facturation.
  • Interfacer des extensions externes
    Si vous ne voulez pas publier le code source de ces fonctions supplémentaires, publiez juste le noyau de la fonction et interfacez vous avec au travers de l'interface d'état et conservez les parties externes privées.

Exemples

Supposons que vous êtes juste intéressés par les CDRs (enregistrement des détails des appels) et vous voulez les traiter en lot à intervalles réguliers.

Voici un script Perl simple (gnugk_cdr.pl) qui lance le gatekeeper et un client très simple pour l'Interface d'Etat et écrit juste les CDRs dans un fichier de log. Vous aurez besoin de le modifier un peu pour qu'il corresponde à vos besoins.

#!/usr/bin/perl
# example de programme montrant comment écrire les CDRs dans un fichier log
use strict;
use IO::Socket;
use IO::Handle;

my $logfile = "/home/jan/cdr.log";      # MODIFIER CETTE LIGNE
my $gk_host = "localhost";
my $gk_port = 7000;
my $gk_pid;

if ($gk_pid = fork()) {
        # le parent est à l'écoute du statut du gatekeeper
        sleep(1);       # attendre que gk démarre
        my $sock = IO::Socket::INET->new(PeerAddr => $gk_host, PeerPort => $gk_port, Proto => 'tcp');
        if (!defined $sock) {
                die "Impossible de se connecter au gatekeeper à $gk_host:$gk_port";
        }
        $SIG{HUP} = sub { kill 1, $gk_pid; };   # transmettre HUP au gatekeeper
        $SIG{INT} = sub { close (CDRFILE); kill 2, $gk_pid; };  # fermer le fichier à la fin

        open (CDRFILE, ">>$logfile");
        CDRFILE->autoflush(1);  # ne pas copier la sortie dans la mémoire tampon
        while (!$sock->eof()) {
                my $msg = $sock->getline();
                $msg = (split(/;/, $msg))[0];   # supprimer les données superflues à la fin de la ligne
                my $msgtype = (split(/\|/, $msg))[0];
                if ($msgtype eq "CDR") {
                        print CDRFILE "$msg\n";
                }
        }
        close (CDRFILE);
} else {
        # le fils démarre gatekeeper
        exec("gnugk");
}

Rappelez-vous qu'il ne s'agit que d'un exemple pour montrer l'utilisation du port d'état. Vous pouvez utiliser le module FileAcct pour tracer les CDRs dans un système de production.

Interface graphique Java pour Gatekeeper

Développée par Jan Willamowius.

Vous pouvez surveiller les enregistrements et les appels qui passent par le gatekeeper. Un clic droit sur un bouton vous donne un menu déroulant pour ce terminal.

Cette interface graphique fonctionne avec Java 1.0 présent dans la plupart des navigateurs web. Pour des raisons de sécurité l'interface graphique doit fonctionner comme une application autonome ou être mise à disposition par un serveur web sur le même numéro IP que le gatekeeper (vous ne pouvez pas le lancer en tant qu'applet depuis un fichier local).

Le programme est disponible sur GnuGk Java GUI

12.2 Commandes (Référence)

Cette section liste toutes les commandes que vous pouvez émettre sur le port d'état (manuellement ou avec une application externe). Les commandes ne tiennent pas compte de la casse (majuscules / minuscules). Mais certains paramètres peuvent en tenir compte.

La commande help ou h affichera la liste de toutes les commandes disponibles.

  • Reload

    Rafraichir la configuration.

    Rafraichir la configuration ne termine pas les appels existants, et tout changement des paramètres n'affectera que les nouveaux appels.

    Vous pouvez ajouter un paramètre facultatif pour ne rafraichir qu'une partie de votre configuration.

    • AcctConfig - ne rafraichir que la configuration accounting
    • AuthConfig - ne rafraichir que la configuration de l'authentification
    • CapConfig - ne rafraichir que les règles de controle de la capacitè
    • EpConfig - ne rafraichir que la configuration des terminaux (terminaux permanents, section de terminal, paramètres du tableau d'appels)

    Exemple:

    Reload
    Full Config reloaded.
    
    Reload Epconfig.
    EP Config reloaded.
    

  • Shutdown

    Met fin au gatekeeper. Peut être désactivé par Shutdown=forbid dans la secion [GkStatus::Auth].

  • Version, v

    Afficher la version et des informations sur l'OS du gatekeeper.

  • Statistics, s

    Affiche des informations statistiques du gatekeeper.

    Exemple:

    Statistics
    -- Endpoint Statistics --
    Total Endpoints: 307  Terminals: 278  Gateways: 29  NATed: 0
    Cached Endpoints: 0  Terminals: 0  Gateways: 0
    -- Call Statistics --
    Current Calls: 7 Active: 7 From Neighbor: 4 From Parent: 0 Proxied: 3
    Total Calls: 1151  Successful: 485  From Neighbor: 836  From Parent: 0  Proxied: 193  Peak:  17 at Tue, 26 Nov 2013 19:32:04 +04:00
    Startup: Tue, 26 Nov 2013 18:45:35 +04:00   Running: 0 days 02:34:15
    ;
    

  • ResetCallCounters

    Remet tous les compteurs du nombre totel d'appels, du nombre d'appels réussis, du nombre d'appels aux voisins et du nombre d'appels aux parents à zéro.

  • PrintAllRegistrations, r, ?

    Affiche tous les terminaux enregistrés.

    Format:

    AllRegistrations
    RCF|IP:Port|Aliases|Terminal_Type|EndpointID
    ...
    Number of Endpoints: n
    ;
    

    Exemple:

    AllRegistrations
    RCF|10.1.1.10:1720|800:dialedDigits=Wei:h323_ID|terminal|1289_endp
    RCF|10.0.1.43:1720|613:dialedDigits=Jacky Tsai:h323_ID|terminal|1328_endp
    RCF|10.0.1.55:1720|705:dialedDigits=Sherry Liu:h323_ID|terminal|1333_endp
    Number of Endpoints: 3
    ;
    

  • PrintAllRegistrationsVerbose, rv, ??

    Affiche des détails sur tous les terminaux enregistrés.

    Format:

    AllRegistrations
    RCF|IP:Port|Aliases|Terminal_Type|EndpointID
    Registration_Time C(Active_Call/Connected_Call/Total_Call) <r>
    [Prefixes: ##] (gateway only)
    ...
    Number of Endpoints: n
    ;
    

    Exemple:

    AllRegistrations
    RCF|10.0.1.8:1720|Accel-GW2:h323_ID|gateway|1322_endp
    Wed, 26 Jun 2002 16:40:03 +0800 C(1/5/33) <1>
    Prefixes: 09,002
    RCF|10.1.1.10:1720|800:dialedDigits=Wei:h323_ID|terminal|1289_endp
    Wed, 26 Jun 2002 16:40:55 +0800 C(0/32/39) <1>
    RCF|10.0.1.66:1720|716:dialedDigits=Vicky:h323_ID|terminal|1425_endp
    Wed, 26 Jun 2002 16:40:58 +0800 C(1/47/53) <1>
    Number of Endpoints: 2
    ;
    

  • PrintAllCached, rc

    Affiche la liste de tous les terminaux "cached out-of-zone"(mis en mémoire cache en dehors de la zone).

  • PrintCurrentCalls, c, !

    Affiche tous les appels en cours en utilisant la même syntaxe ACF que lors de l'établissement de l'appel.

    Format:

    CurrentCalls
    Call No. # | CallID | Call_Duration | Left_Time
    Dialed_Number
    ACF|Caller_IP:Port|Caller_EPID|CRV|DestinationInfo|SrcInfo|IsAnswered;
    ACF|Callee_IP:Port|Callee_EPID|CRV|DestinationInfo|SrcInfo|IsAnswered;
    ...
    Number of Calls: Current_Call Active: Active_Call From Neighbor: Call_From_Neighbor \
    From Parent: Call_From_Parent
    ;
    

    Exemple:

    CurrentCalls
    Call No. 29 | CallID bd c6 17 ff aa ea 18 10 85 95 44 45 53 54 77 77 | 109 | 491
    Dial 0953378875:dialedDigits
    ACF|10.0.1.49:1720|4048_CGK1|25263|frank:h323_ID|gunter:h323_ID|false;
    ACF|10.1.1.1:1720|4037_CGK1|25263|gunter:h323_ID|frank:h323_ID|true;
    Call No. 30 | CallID 70 0e dd c0 9a cf 11 5e 00 01 00 05 5d f9 28 4d | 37 | 563
    Dial 0938736860:dialedDigits
    ACF|10.0.1.48:1032|4041_CGK1|11896|sue:h323_ID|peter:h323_ID|false;
    ACF|10.1.1.1:1720|4037_CGK1|11896|peter:h323_ID|sue:h323_ID|true;
    Number of Calls: 2 Active: 2 From Neighbor: 0 From Parent: 0
    ;
    

  • PrintCurrentCallsVerbose, cv, !!

    Affiche des détails sur tous les appels en cours.

    Format:

    CurrentCalls
    Call No. # | CallID | Call_Duration | Left_Time
    Dialed_Number
    ACF|Caller_IP:Port|Caller_EPID|CRV|DestinationInfo|SrcInfo|IsAnswered;
    ACF|Callee_IP:Port|Callee_EPID|CRV|DestinationInfo|SrcInfo|IsAnswered;
    # Caller_Aliases|Callee_Aliases|Bandwidth|Connected_Time <r>
    ...
    Number of Calls: Current_Call Active: Active_Call From NB: Call_From_Neighbor
    ;
    

    Exemple:

    CurrentCalls
    Call No. 48 | CallID 7d 5a f1 0a ad ea 18 10 89 16 00 50 fc 3f 0c f5 | 30 | 570
    Dial 0225067272:dialedDigits
    ACF|10.0.1.200:1720|1448_endp|19618|frank:h323_ID|gunter:h323_ID|false;
    ACF|10.0.1.7:1720|1325_endp|19618|gunter:h323_ID|frank:h323_ID|true;
    # Sherry:h323_ID|Accel-GW1:h323_ID|200000|Wed, 26 Jun 2002 17:29:55 +0800 <2>
    Number of Calls: 1 Active: 1 From NB: 0
    ;
    

  • PrintPrefixCapacities, printpc

    Affiche les capacités des préfixes et la valeur actuelle des compteurs pour tous les terminaux ou pour l'alias spécifié.

    Format:

    PrintPrefixCapacities [Alias]
    PrefixCapacities
    -- Endpoint: Alias (1.2.3.4:1720) --
    Total calls = 0
    prefix/capacity/curr: 125/5/0
    -- Endpoint: Alias2 (1.2.3.5:1720) --
    Total calls = 0
    prefix/capacity/curr: 125/5/0
    ;
    

    Exemple:

    PrintPrefixCapacities OpenMCU
    PrefixCapacities
    -- Endpoint: OpenMCU (192.168.1.100:1720) --
    Total calls = 0
    prefix/capacity/curr: ^(123|124)/2/0
    prefix/capacity/curr: 125/5/0
    ;
    

  • printcc

    Affiche les compteurs pour toutes les règles de controle de la capacité.

  • Find, f

    Trouve un terminal enregistré par un alias ou un préfixe.

    Format:

    Find Alias
    RCF|IP:Port|Aliases|Terminal_Type|EndpointID
    ;
    

    Exemple:

    f 800
    RCF|10.1.1.10:1720|800:dialedDigits=Wei:h323_ID|terminal|1289_endp
    ;
    f 801
    SoftPBX: alias 801 not found!
    

  • FindVerbose, fv

    Trouve des détails d'un terminal enregistré par un alias ou un préfixe.

    Format:

    FindVerbose Alias
    RCF|IP:Port|Aliases|Terminal_Type|EndpointID
    Registration_Time C(Active_Call/Connected_Call/Total_Call) <r>
    [Prefixes: ##] (gateway only)
    ;
    

    Exemple:

    fv 02
    RCF|10.0.1.100:1720|TFN:h323_ID|gateway|4037_CGK1
    Wed, 26 Jun 2002 17:47:29 +0800 C(0/84/120) <1>
    Prefixes: 02,09
    ;
    

  • UnregisterIP

    Force l'annulation de l'enregistrement d'un terminal en fonction de son IP et appelle le port de signalisation.

    Format:

    UnregisterIP IP[:Port]
    

    Exemple:

    UnregisterIP 10.0.1.31:1720
    URQ|10.0.1.31:1032|1326_endp|maintenance;
    SoftPBX: Endpoint 10.0.1.31:1720 unregistered!
    

  • UnregisterAlias

    Force l'annulation de l'enregistrement d'un terminal en fonction d'un de ses alias.

    Format:

    UnregisterAlias Alias
    

    Exemple:

    UnregisterAlias 601
    URQ|10.0.1.31:1032|1326_endp|maintenance;
    SoftPBX: Endpoint 601 unregistered!
    

  • UnregisterAllEndpoints

    Force l'annulation de l'enregistrement de tous les terminaux enregistrés.

    Format:

    
    

    Exemple:

    UnregisterAllEndpoints
    URQ|10.0.1.7:1024|1325_endp|maintenance;
    URQ|10.0.1.8:1024|1322_endp|maintenance;
    URQ|10.0.1.32:1032|1324_endp|maintenance;
    URQ|10.0.1.36:1032|1323_endp|maintenance;
    URQ|10.0.1.42:1032|1318_endp|maintenance;
    Done
    ;
    

  • DisconnectCall

    Déconnecte un appel avec le numéro donné.

    Format:

    DisconnectCall Number
    

    Exemple:

    DisconnectCall 1533
    

  • DisconnectIP

    Déconnecte tous les appels d'un terminal en fonction de son IP et appelle le port de signalisation.

    Format:

    DisconnectIP IP[:Port]
    

    Exemple:

    DisconnectIP 10.0.1.31:1720
    

  • DisconnectAlias

    Déconnecte tous les appels d'un terminal en fonction d'un de ses alias.

    Format:

    DisconnectAlias Alias
    

    Exemple:

    DisconnectAlias 601
    

  • ClearCalls

    Déconnecte tous les appels sur le gatekeeper.

  • GK

    Affiche les informations sur le gatekeeper parent.

  • Trace

    Règle le niveau de trace de sortie de l'interface d'état. Il contrôle quels messages sont envoyés à ce client:

    • trace 0 ou trace min

      Seulement les réponses directes aux commandes et les notifications de rechargement

    • trace 1

      CDRs, réponses directes aux commandes et notifications de rechargement.

    • trace 2 ou trace max

      Affiche tout (RAS, CDRs, réponses directes aux commandes, notifications de rechargement, etc).

  • Debug

    Utilisé uniquement à de buts de debug. Options:

    • trc [+|-|n]

      Affiche/modifie le niveau de trace.

    • cfg SEC PAR

      Lit et imprime un paramètre de configuration dans une section.

    • set SEC PAR VAL

      Ecrit une valeur de paramètre de configuration dans une section.

    • remove SEC PAR

      Supprime une valeur de paramètre de configuration dans une section.

    • remove SEC

      Supprime une section.

    • printrm VERBOSE

      Imprime tous les enregistrements de terminaux supprimès.

    Exemple:

    debug trc 3
    debug set RoutedMode H245Routed 1
    

  • SetLog

    Envoie la trace de la sortie vers un autre fichier.

    Format:

    Setlog [filename]
    

    Exemple:

    Setlog /tmp/trace.log
    

  • RotateLog

    Fait tourner le fichier log.

  • Who

    Affiche toutes les personnes sur le port d'ètat. Le premier est l'identificateur de session, qui peut être utilisé pour déconnecter un utilisateur avec la commande DisconnectSession.

  • DisconnectSession

    Déconnecte un utilisateur du port d'état.

    Format:

    DisconnectSession [session id]
    

    Exemple:

    DisconnectSession 2
    

  • Yell, y

    Envoie un message à tous les statuts clients

    Format:

    Yell [message text]
    

    Exemple:

    Yell Config reload in 5 minutes.
    

  • RouteReject

    Termine cette appel sur une file virtuelle. Cette commande est utilisée comme réponse à un événement RouteRequest (voir ci-dessous).

    Format:

    RouteReject CallingEndpointID CallRef
    

    Exemple:

    RouteReject endp_4711 1234
    

  • RouteToAlias, rta

    Route cet appel sur une file virtuel vers un alias donné. Cette commande est utilisée en réponse à un événement RouteRequest (voir ci-dessous).

    Format:

    RouteToAlias Alias CallingEndpointID CallRef
    

    Exemple:

    RouteToAlias Suzi endp_4711 1234
    

  • RouteToGateway, rtg

    Route cet appel sur une file virtuelle vers l'alias donné et positionne le destinationSignallAddress. Cette commande est utilisée en réponse à un événement RouteRequest (voir ci-dessous). Vous pouvez utiliser cette commande pour router des appels vers des passerelles hors de la zone ou des MCUs non enregistrés auprès du gatekeeper. Assurez-vous que la politique 'vqueue' et 'explicit' est en cours pour ces appels.

    Format:

    RouteToGateway Alias IP:Port CallingEndpointID CallRef
    

    Exemple:

    RouteToGateway Suzi 192.168.0.50 endp_4711 1234
    

  • BindAndRouteToGateway

    Cette commande est semblable à RouteToGateway, mais elle permet de spécifier également, pour un serveur avec plusieurs addresses IP (multi-homed), l'addresse IP à utiliser pour un appel sortant.

    Format:

    BindAndRouteToGateway IP Alias IP:Port CallingEndpointID CallRef [CallID]
    

    Exemple:

    BindAndRouteToGateway 192.168.0.2 Suzi 192.168.0.50 endp_4711 1234
    

  • SendProceeding

    ATTENTION: Cette fonctionnalité est encore au stade d'expérimentation.

    Envoyer un message CallProceeding à l'appeleant Ceci n'a de sens qu'après un évènemenet RouteRequest pour un appel non enregistré. Otherwise a status port application won't know if a Setup message has been sent but that the call is not yet established.

    Format:

    SendProceeding CallID
    

    Exemple:

    SendProceeding 40-06-dd-98-22-37-52-40-8c-b0-92-0e-18-60-99-07
    

  • Exit, q

    Quitte le port d'ètat.

  • TransferCall

    Transfère un appel établi d'un alias A vers un alias B.

    Ceci ne fonctionne qu'avec les terminaux qui supportent correctement les messages du mécanisme Q.931 (ceci ne fonctionne donc pas avec Netmeeting).

    Format:

    TransferCall Source-Alias New-Destination-Alias
    

    Exemple:

    TransferCall Frank Peter
    

  • MakeCall

    Crée un nouvel appel depuis la source vers un alias destinataire. Il est aussi possible de spécifier une addresse IP en tant que destination. Ceci est effectué en établissant un appel depuis un pseudo terminal dans le gatekeeper vers l'alias ou le numéro de la source puis en transférant l'appel depuis le terminal du gatekeeper vers le destinataire.

    Ce transfert peut être fait soit en utilisant un transfert H.450.2 ou avec un "Facility message".

    Voir [GkStatus::Auth]<@@ref>ctimakecall[CTI::MakeCall] pour les options de configuration.

    Format:

    MakeCall Source-Alias Destination-Alias
    

    Exemple:

    MakeCall 1234 5678
    MakeCall joe 192.168.6.1
    

  • GetAuthInfo,gai

    Récolte des informations depuis un module d'authentification particulier (si celui-ci peut fournir ces informations) et les affichie sur le port d'état

    Format:

    GetAuthInfo ModuleName
    

    Exemple:

    GetAuthInfo RadAliasAuth
    

  • GetAcctInfo,gci

    Récolte des informations depuis un module accounting particulier (si celui-ci peut fournir ces informations) et les affichie sur le port d'état

    Format:

    GetAcctInfo ModuleName
    

    Exemple:

    GetAcctInfo SqlAcct
    

12.3 Messages (Référence)

Cette section décrit la sortie des messages sur l'interface d'état.

  • GCF|IP|Aliases|Endpoint_Type;

    Le gatekeeper reçoit un GatekeeperRequest (GRQ) et répond avec un GatekeeperConfirm (GCF).

  • GRJ|IP|Aliases|Endpoint_Type|RejectReason;

    Le gatekeeper reçoit un GatekeeperRequest (GRQ) et répond avec un GatekeeperReject (GRJ).

  • RCF|IP:Port|Aliases|Endpoint_Type|EndpointID;

    Le gatekeeper reçoit un RegistrationRequest (RRQ) et répond avec un RegistrationConfirm (RCF).

  • RRJ|IP|Aliases|Endpoint_Type|RejectReason;

    Le gatekeeper reçoit un RegistrationRequest (RRQ) et répond avec un RegistrationReject (RRJ).

  • ACF|Caller_IP:Port|Caller_EndpointID|CRV|DestinationInfo|SrcInfo|IsAnswered[|CallID];

    Le gatekeeper reçoit un AdmissionRequest (ARQ) et répond avec un AdmissionConfirm (ACF). Le CallID est envoyé seulement quand SignalCallId=1.

  • ARJ|Caller_IP:Port|DestinationInfo|SrcInfo|IsAnswered|RejectReason[|CallID];

    Le gatekeeper reçoit un AdmissionRequest (ARQ) et répond avec un AdmissionReject (ARJ). Le CallID est envoyé seulement quand SignalCallId=1.

  • DCF|IP|EndpointID|CRV|DisengageReason[|CallID];

    Le gatekeeper reçoit un DisengageRequest (DRQ) et répond avec un DisengageConfirm (DCF). Le CallID est envoyé seulement quand SignalCallId=1.

  • DRJ|IP|EndpointID|CRV|RejectReason[|CallID];

    Le gatekeeper reçoit un DisengageRequest (DRQ) et répond avec un DisengageReject (DRJ). Le CallID est envoyé seulement quand SignalCallId=1.

  • LCF|IP|EndpointID|DestinationInfo|SrcInfo;

    Le gatekeeper reçoit un LocationRequest (LRQ) et répond avec un LocationConfirm (LCF).

  • LRJ|IP|DestinationInfo|SrcInfo|RejectReason;

    Le gatekeeper reçoit un LocationRequest (LRQ) et répond avec un LocationReject (LRJ).

  • BCF|IP|EndpointID|Bandwidth;

    Le gatekeeper reçoit un BandwidthRequest (BRQ) et répond avec un BandwidthConfirm (BCF).

  • BRJ|IP|EndpointID|Bandwidth|RejectReason;

    Le gatekeeper reçoit un BandwidthRequest (BRQ) et répond avec un BandwidthReject (BRJ).

  • UCF|IP|EndpointID;

    Le gatekeeper reçoit un UnregistrationRequest (URQ) et répond avec un UnregistrationConfirm (UCF).

  • URJ|IP|EndpointID|RejectReason;

    Le gatekeeper reçoit un UnregistrationRequest (URQ) et répond avec un UnregistrationReject (URJ).

  • IRQ|IP:Port|EndpointID;

    Le gatekeeper envoie un InfoRequest (IRQ) à un terminal pour lui demander si il est toujours en vie. Le terminal doit répondre avec un InfoRequestResponse (IRR) immédiatement.

  • URQ|IP:Port|EndpointID|Reason;

    Le gatekeeper envoie un UnregistrationRequest (URQ) à un terminal pour annuler son enregistrement. Le terminal doit répondre avec un UnregistrationConfirm (UCF).

  • CDR|CallNo|CallId|Duration|Starttime|Endtime|CallerIP|CallerEndId| \
    CalledIP|CalledEndId|DestinationInfo|SrcInfo|GatekeeperID;

    Après un appel déconnecté, l'enregistrement du détail de l'appel est affiché (sur une ligne).

  • RouteRequest|CallerIP:Port|CallerEndpointId|CallRef|VirtualQueue|CallerAlias[|CallID];

    Demande à une application externe de router un appel arrivant sur une file virtuelle. Ceci peut être fait avec une commande RouteToAlias ou RouteReject. Le CallID est envoyé seulement quand SignalCallId=1.

12.4 Filtrage au niveau du port d'état

Le filtrage au niveau du port d'état facilite le control de la quantité et du type de messages de sortie montrés a l'utilisateur. Le fitrage est effectué à l'aide d'expressions régulières utilisées afin de déterminer si le message doit être inclus (include) ou exclus (exclude). Le controle du filtrage est effectué à l'aide des commandes suivantes:

  • addincludefilter REGEX
    Ajoute l'expression régulière à la liste include (inclure)
  • addexcludefilter REGEX
    Ajoute l'expression régulière à la liste exclude (exclure)
  • removeincludefilter INDEX
    Supprime le filtre à l'INDEX donné de la liste include
  • removeexcludefilter INDEX
    Supprime le filtre à l'INDEX donné de la liste exclude
  • filter 1|0
    Activer/Désactiver le filtrage des messages
  • printincludefilters
    Imprimer la liste des filtres de la liste include
  • printexcludefilters
    Imprimer la liste des filtres de la liste exclude

Afin de permettre l'utilisation de filtres prédéfinis, une nouvelle section nommiie [GkStatus::Filtering] a été créée. Vous pouvez spécifier quels filtres prédéfinis vous voulez activer lorsque le port d'état démarre.

Exemple:

[GkStatus::Filtering]
IncludeFilter=.+
ExcludeFilter=.RQ

Lorsque le filtrage est activé à l'aide de la commande filter 1, tous les message seront affichés à part les lignes comprenant ARQ, LRQ etc. Vous pouvez également taper la commande suivante dans le port d'état:

addincludefilter .+
addexcludefilter .RQ
filter 1

Notez qu'activer le filtrage lorsqu'il n'y a aucun filtre défini entrainera l'absence de tout message de sortie.


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