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

4. Configuration Basique du Gatekeeper

Le comportement du gatekeeper est complètement déterminé par les options de la ligne de commande et le fichier de configuration. Certaines options de la ligne de commande peuvent annuler certains paramètres du fichier de configuration. Par exemple, l'option -l annule le paramètre TimeToLive dans le fichier de configuration.

4.1 Options de la Ligne de Commande

Presque chaque option a un format court et un format long, i.e., -c est comme --config.

Basique

-h --help

Liste toutes les options disponibles et quitte le programme.

-c --config filename

Indique le fichier de configuration à utiliser.

-s --section section

Indique quelle section principale utiliser dans le fichier de configuration. Par défaut, c'est [Gatekeeper::Main].

-i --interface IP

Indique l'interface (numéro IP) sur laquelle écoute le gatekeeper. Vous devriez omettre cette option pour laisser le gatekeeper déterminer automatiquement l'IP sur laquelle il écoute, à moins que vous ne vouliez que le gatekeeper s'attache à une IP précise.

-l --timetolive n

Indique la minuterie (en secondes) du temps-à-vivre pour l'enregistrement de terminal. Il annule le paramètre TimeToLive du fichier de configuration. Voir ici pour des explications détaillées.

-b --bandwidth n

Indique la bande passante totale disponible pour le gatekeeper. En ne précisant pas cette option, la gestion de la bande passante est désactivée par défaut.

--pid filename

Indique le fichier pid, valable uniquement pour les versions Unix.

-u --user name

Exécute le processus gatekeeper avec cet utilisateur. Valable uniquement pour les version Unix.

--core n

(Unix seulement) Permet l'écriture de fichiers core dump quand l'application plante. Un fichier core dump ne dépassera pas la taille de n octets. Une constante spéciale "unlimited" peut être utilisée pour ne pas imposer de limite.

Mode du Gatekeeper

Les options de cette sous-section annulent les paramètres de la section [RoutedMode] du fichier de configuration.

-d --direct

Utilise le signal d'appel direct de terminal.

-r --routed

Utilise le signal d'appel routé du gatekeeper.

-rr --h245routed

Utilise le signal d'appel routé du gatekeeper et le canal de contrôle H.245.

Information de Debug

-o --output filename

Ecrit les traces dans le fichier indiqué.

-t --trace

Règle le niveau de trace. Plus vous ajoutez de -t, plus les traces sont complètes. Par exemple, utiliser -ttttt pour régler le niveau de trace à 5.

4.2 Fichier de Configuration

Le fichier de configuration est un fichier texte normal. Le format de base est:

[Section String]
Key Name=Value String

Les commentaires sont marqués avec un dièse (#) ou un point virgule (;) au début de la ligne.

Le fichier complete.ini contient toutes les sections disponibles pour GnuGk. Dans la plupart des cas, il n'est pas nécessaire de tous les utiliser. Ce fichier est juste une collection d'exemples pour beaucoup de réglages.

Le fichier de configuration peut être modifié pendant l'exécution. Une fois que le fichier de configuration est modifié, vous pouvez envoyer une command reload par le port d'état, ou envoyer un signal HUP au processus du gatekeeper sous Unix. Par exemple,

kill -HUP `cat /var/run/gnugk.pid`

Section [Gatekeeper::Main]

La plupart des utilisateurs n'auront jamais besoin de modifier une des valeurs suivantes. Ils sont principalement utilisés pour les tests ou pour des applications trè sophistiquées.

Section [GkStatus::Auth]

Définit un nombre de règles pour indiquer qui est autorisé à se connecter au port d'état. Chacun ayant accès au port d'état a le contrôle total sur votre gatekeeper. Assurez vous de le définir correctement.

Section [LogFile]

Cette section définit les paramètres liés aux fichiers de log. Actuellement, ceci permet aux utilisateurs de préciser les options de rotation des fichiers de log.

Section [RoutedMode]

Call signalling messages may be passwd in two ways. The first method is Direct Endpoint Call Signalling, in which case the call signalling messages are passed directly between the endpoints. The second method is Gatekeeper Routed Call Signalling. In this method, the call signalling messages are routed through the gatekeeper between the endpoints. The choice of which methods is used is made by the gatekeeper.

When Gatekeeper Routed call signalling is used, the gatekeeper may choose whether to route the H.245 control channel and logical channels.

Case I.

The gatekeeper doesn't route them. The H.245 control channel and logical channels are established directly between the endpoints.

Case II.

The H.245 control channel is routed between the endpoints through the gatekeeper, while the logical channels are established directly between the endpoints.

Case III.

The gatekeeper routes the H.245 control channel, as well as all logical channels, including RTP/RTCP for audio and video, and T.120 channel for data. In this case, no traffic is passed directly between the endpoints. This is usually called an H.323 Proxy, which can be regarded as an H.323-H.323 gateway.

This section defines the gatekeeper routed mode options (case I & II). The proxy feature is defined in the next section. All settings in this section are affected by reloading.

Section [Proxy]

The section defines the H.323 proxy features. It means the gatekeeper will route all the traffic between the calling and called endpoints, so there is no traffic between the two endpoints directly. Thus it is very useful if you have some endpoints using private IP behind an NAT box and some endpoints using public IP outside the box.

The gatekeeper can do proxy for logical channels of RTP/RTCP (audio and video) and T.120 (data). Logical channels opened by fast-connect procedures or H.245 tunnelling are also supported.

Note to make proxy work, the gatekeeper must have direct connection to both networks of the caller and callee.


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