Serveur SIP : Configuration : Général
Utilisez cette page pour configurer les fonctionnalités et le comportement par défaut du conteneur de servlet SIP.
Options de configuration
Nom Description Nom de servlet par défaut Nom du servlet SIP par défaut à appeler si le serveur ne peut pas faire concorder une demande initiale entrante avec un servlet à l'aide des règles de mise en correspondance de servlet disponibles.
Le nom indiqué dans l'élément default-servlet-name doit correspondre à la valeur servlet-name d'un servlet SIP déployé. S'il ne correspond pas à un servlet déployé, ou si aucune valeur n'est indiquée (configuration par défaut), WebLogic Communications Server inscrit le nom com.bea.wcp.sip.engine.BlankServlet en tant que servlet par défaut. Le nom BlankServlet est également utilisé lorsqu'un servlet déployé inscrit sous le nom default-servlet-name voit son déploiement annulé sur le conteneur.
Le comportement de BlankServlet est configuré via l'élément default-behavior. Par défaut, le servlet établit un proxy avec toutes les demandes sans correspondance. Cependant, si l'élément default-behavior est défini sur le mode "ua", BlankServlet est responsable du renvoi des réponses 481 (pour les demandes CANCEL et BYE) et des réponses 500/416 (dans tous les autres cas). BlankServlet ne répond pas aux accusés de réception et invalide la session d'application.
Attribut de MBean :
SipServerBean.DefaultServletNameLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Intervalle de temporisation T1 Durée de l'horloge T1 du protocole SIP, en millisecondes.
L'horloge T1 indique également les valeurs initiales des horloges A, E et G, qui contrôlent l'intervalle de retransmission des demandes et des réponses INVITE sur UDP. L'horloge T1 affecte les valeurs des horloges F, H et J, qui contrôlent les intervalles de retransmission des réponses et demandes INVITE ; ces horloges sont définies sur une valeur égale à 64*T1 millisecondes. Pour plus d'informations sur les horloges SIP, reportez-vous à la spécification SIP. Reportez-vous également à "Configuring NTP for Accurate SIP Timers" dans le manuel de configuration.
Si la valeur de temporisation T1 n'est pas configurée, WebLogic Communications Server utilise la valeur par défaut du protocole SIP, soit 500 millisecondes.
Attribut de MBean :
SipServerBean.T1TimeoutIntervalLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Intervalle de temporisation T2 Durée de l'horloge T2 du protocole SIP, en millisecondes.
L'horloge T2 définit l'intervalle de retransmission pour les réponses INVITE et les demandes non INVITE. Pour plus d'informations sur les horloges SIP, reportez-vous à Spécification SIP. Reportez-vous également à "Configuring NTP for Accurate SIP Timers" dans la documentation sur la configuration.
Si la valeur de temporisation T2 n'est pas configurée, WebLogic Communications Server utilise la valeur par défaut du protocole SIP, soit 4 millisecondes.
Attribut de MBean :
SipServerBean.T2TimeoutIntervalLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Intervalle de temporisation T4 Durée de l'horloge T4 du protocole SIP, en millisecondes.
L'horloge T4 indique la durée maximale de conservation d'un message dans le réseau. Elle spécifie également les valeurs initiales des horloges I et K, qui contrôlent les temps d'attente pour la retransmission des accusés de réception et des réponses sur UDP. Pour plus d'informations sur les horloges SIP, reportez-vous à la spécification SIP. Reportez-vous également à "Configuring NTP for Accurate SIP Timers" dans le manuel de configuration.
Si la valeur de temporisation T4 n'est pas configurée, WebLogic Communications Server utilise la valeur par défaut du protocole SIP, soit 5 millisecondes.
Attribut de MBean :
SipServerBean.T4TimeoutIntervalLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Intervalle de temporisation de l'horloge B Durée de l'horloge B du protocole SIP, en millisecondes.
L'horloge B indique la durée pendant laquelle la transaction client tente de renvoyer une demande. Pour plus d'informations sur les horloges SIP, reportez-vous à la spécification SIP. Reportez-vous également à "Configuring NTP for Accurate SIP Timers".
Si la valeur de l'horloge B n'est pas configurée, le serveur dérive une valeur de l'horloge T1 (64*T1, ou 32 000 millisecondes par défaut).
Attribut de MBean :
SipServerBean.TimerBTimeoutIntervalLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Intervalle de temporisation de l'horloge F Durée de l'horloge F du protocole SIP, en millisecondes.
L'horloge F indique l'intervalle de temporisation pour la retransmission des demandes non-INVITE. Pour plus d'informations sur les horloges SIP, reportez-vous à la spécification SIP. Reportez-vous également à "Configuring NTP for Accurate SIP Timers" dans le manuel de configuration.
Si la valeur de l'horloge F n'est pas configurée, le serveur dérive une valeur de l'horloge T1 (64*T1, ou 32 000 millisecondes par défaut).
Attribut de MBean :
SipServerBean.TimerFTimeoutIntervalLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Durée de vie maximale d'une session d'application Durée maximale, en minutes, de conservation d'une session d'application SIP avant que WebLogic Communications Server n'invalide cette session. Cette valeur doit être supérieure ou égale à la longueur de session par défaut de chaque application déployée.
A -1 (valeur par défaut) indique que la session SIP n'est pas limitée dans le temps.
Attribut de MBean :
SipServerBean.MaxApplicationSessionLifetimeLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Activer la répartition locale Activez l'optimisation du serveur pour éviter un trafic réseau inutile lors de l'envoi et de la retransmission des messages.
Lorsque ce paramètre est activé, si une instance de serveur doit envoyer ou retransmettre un message et que la destination du message est l'adresse de cluster au niveau de moteur ou l'adresse du serveur local, le message est alors acheminé en interne vers le serveur local au lieu d'être envoyé via le réseau.
Attribut de MBean :
SipServerBean.EnableLocalDispatchLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Comportement du serveur SIP par défaut Comportement par défaut de l'instance WebLogic Communications Server si le serveur ne peut pas faire concorder une demande SIP entrante avec un servlet SIP déployé, ou si le servlet correspondant a été invalidé ou a expiré.
Les valeurs valides sont :
proxy : fait office de serveur proxy sans conservation de statut.
ua : fait office d'agent utilisateur.
La valeur "proxy" est utilisée par défaut si vous n'indiquez pas de valeur.
Lorsqu'il est utilisé comme agent utilisateur (UA), WebLogic Communications Server agit de la manière suivante en réponse aux demandes SIP :
les demandes d'accusé de réception sont rejetées sans préavis ;
les demandes CANCEL et BYE reçoivent le code de réponse 481 – la transaction n'existe pas ;
toutes les autres demandes reçoivent le code de réponse 500 - Erreur interne du serveur.
Dans le cas d'un comportement comme proxy sans conservation de statut, les demandes sont automatiquement retransmises vers un proxy sortant, s'il en existe un configuré. Si aucun proxy n'est défini, WebLogic Communications Server établit un proxy vers un URI de demande donné uniquement si l'URI de demande ne correspond pas à l'IP ni au numéro de port d'une adresse locale connue pour un conteneur de servlet SIP ou d'une adresse du programme d'équilibrage de charge configurée pour le serveur. Cette action garantit que la demande ne parcourt pas constamment en boucle les mêmes serveurs. Lorsque l'URI de demande correspond à une adresse de conteneur locale ou à une adresse du programme d'équilibrage de charge, WebLogic Communications Server agit alors en tant qu'UA.
Attribut de MBean :
SipServerBean.DefaultBehaviorLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Insertion d'en-tête de serveur Indique les conditions nécessaires à l'insertion d'un en-tête de serveur dans un message SIP.
Utilisez cet attribut pour limiter ou éliminer les en-têtes de serveur et ainsi réduire la taille des messages sur les réseaux mobiles ou augmenter la sécurité. Sélectionnez l'une des valeurs de chaîne suivantes pour configurer le comportement :
none (valeur par défaut) : n'insère aucun en-tête de serveur.
request : insère l'en-tête de serveur uniquement pour les demandes SIP générées par le serveur.
response : insère l'en-tête de serveur uniquement pour les réponses SIP générées par le serveur.
all : insère l'en-tête de serveur pour toutes les demandes et réponses SIP.
Par défaut, WebLogic Communications Server n'insère aucun en-tête de serveur dans les messages SIP.
Attribut de MBean :
SipServerBean.ServerHeaderValeur d'en-tête de serveur Valeur de l'en-tête de serveur insérée dans les messages SIP.
WebLogic Communications Server permet de déterminer le texte inséré dans l'en-tête de serveur des messages générés. Cela permet d'effectuer un contrôle supplémentaire sur la taille des messages SIP et également de masquer l'entité de serveur pour des raisons de sécurité. Pour configurer le contenu de l'en-tête, entrez une valeur de chaîne.
Par défaut, WebLogic Communications Server n'insère aucun en-tête de serveur dans les messages SIP générés. Si l'insertion d'un en-tête de serveur est activée mais qu'aucune n'est indiquée, WebLogic Communications Server insère le texte "WebLogic SIP Server".
Attribut de MBean :
SipServerBean.ServerHeaderValueFormat par défaut de l'insertion d'en-tête Indique la façon dont le serveur applique les règles pour compresser les en-têtes de messages SIP.
Cet élément configure le comportement par défaut au niveau du serveur lors de l'utilisation ou de la conservation des en-têtes compacts dans les messages SIP. Vous pouvez définir cet élément sur l'une des valeurs suivantes :
compact : WebLogic Communications Server utilise le format compact pour tous les en-têtes générés par le système. Toutefois, les en-têtes copiés à partir d'un message source (et non générés) conservent leur format d'origine.
force compact : WebLogic Communications Server utilise le format compact pour tous les en-têtes, convertissant alors les en-têtes longs des messages existants en en-têtes compacts si nécessaire.
long : WebLogic Communications Server utilise le format long pour tous les en-têtes générés par le système. Toutefois, les en-têtes copiés à partir d'un message source (et non générés) conservent leur format d'origine.
!force long : WebLogic Communications Server utilise le format long pour tous les en-têtes, convertissant alors les en-têtes compacts des messages existants en en-têtes longs si nécessaire.
Attribut de MBean :
SipServerBean.UseHeaderFormActiver la recherche de serveur DNS Indique si le serveur effectue une recherche DNS.
Si vous donnez à cet attribut la valeur True, le serveur peut alors utiliser DNS pour effectuer les opérations suivantes :
Repérer le transport, l'adresse IP et le numéro de port d'un serveur proxy lorsqu'une demande est envoyée à un URI SIP
Résoudre une adresse IP et/ou un numéro de port pendant le routage de la réponse, selon le contenu du champ de l'expéditeur.
Pour le repérage de proxy, WebLogic Communications Server n'utilise la résolution DNS qu'une seule fois par transaction SIP pour déterminer le transport, l'IP et le numéro de port. L'ensemble des retransmissions, des accusés de réception et des demandes CANCEL est distribué à la même adresse et au même port à l'aide du même transport. Pour plus d'informations sur le fonctionnement de la résolution DNS, reportez-vous au document RFC 3263: Session Initiation Protocol (SIP): Locating SIP Servers.
Lorsqu'un proxy doit envoyer un message de réponse, WebLogic Communications Server utilise la recherche DNS pour déterminer l'adresse IP et/ou le numéro de port de la destination, selon les informations fournies dans le champ de l'expéditeur et via l'en-tête.
Par défaut, la résolution DNS n'est pas utilisée (False).
Remarque : dans la mesure où la résolution DNS est effectuée dans le cadre du traitement des messages SIP, les éventuels problèmes de performances DNS se traduisent par une latence accrue. Oracle recommande d'utiliser un serveur DNS de mise en mémoire cache dans un environnement de production afin de réduire les éventuels problèmes de performances.
Attribut de MBean :
SipServerBean.EnableDnsSrvLookupActiver le cache d'état d'appel Indique si le moteur met en mémoire cache locale une partie des données d'état d'appel.
Attribut de MBean :
SipServerBean.EngineCallStateCacheEnabledLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Activer l'en-tête Contact pour la réponse provisionnelle (1xx) non fiable Indique si le serveur insère un en-tête Contact dans une réponse provisionnelle (1xx) non fiable possédant une balise de destinataire.
Ceci n'est pas applicable pour 100 ; les valeurs possibles sont True et False.
Si vous donnez à cet attribut la valeur True, le serveur insère l'en-tête Contact. Sinon, il l'ignore.
Attribut de MBean :
SipServerBean.EnableContactProvisionalResponseURI globalement routable URI d'agent utilisateur globalement routable (GRUU) que WebLogic Communications Server insère automatiquement dans les en-têtes Contact et Route-Set lors de la communication avec des éléments du réseau.
L'URI indiqué dans cet élément doit correspondre au GRUU pour la totalité du cluster WebLogic Communications Server. Dans un domaine ne possédant qu'un seul serveur, indiquez un GRUU pour le serveur.
Les agents utilisateur (UA) déployés sur le serveur WebLogic Communications Server obtiennent en général les GRUU via une demande d'inscription. Dans ce cas, le code d'application est à la fois responsable de la demande et de la gestion consécutive du GRUU. Pour demander un GRUU, l'UA doit inclure le paramètre "+sip.instance" dans le champ d'en-tête Contact pour chaque contact requérant un GRUU. A la réception du GRUU, l'UA doit utiliser le GRUU comme URI du champ d'en-tête Contact lors de la génération de nouvelles demandes.
Attribut de MBean :
SipServerBean.GloballyRoutableUriLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Activer l'affinité de l'horloge Indique si chaque horloge est traitée sur le moteur où elle a été définie.
Si vous donnez à cet attribut la valeur True, les horloges seront alors traitées sur le moteur où elles ont été définies. Ceci est important pour certaines applications. Si la valeur est False, les horloges pourront être traitées sur n'importe quel moteur.
Attribut de MBean :
SipServerBean.EnableTimerAffinityValeur Nouvelle tentative après Nombre de secondes utilisé dans l'en-tête Retry-After pour les réponses 5xx. Cette valeur peut également inclure un paramètre ou un motif, par exemple "Retry-After: 18000;duration=3600" ou "Retry-After: 120 (I'm in a meeting)".
Si cette valeur n'est pas configurée, WebLogic Communications Server utilise la valeur par défaut, soit 180 secondes.
Attribut de MBean :
SipServerBean.RetryAfterValueLes modifications sont prises en compte une fois le module redéployé ou le serveur relancé.
Alias de domaine Liste des noms de domaine à la charge du serveur.
Les messages destinés aux domaines de cette liste sont traités localement, et non retransmis. Vous pouvez inclure dans la liste des noms de domaine qualifiés complets ou des noms de domaine commençant par un caractère générique, par exemple *.mycompany.com.
Attribut de MBean :
SipServerBean.DomainAliasNamesRoutage de réponse symétrique Indique si un routage de réponse symétrique est demandé (via le paramètre rport) pour les demandes générées par WebLogic Communications Server.
Lorsque cette option est activée, le routage de réponse symétrique défini dans RFC3581 est effectif.
Attribut de MBean :
SipServerBean.EnableRportNiveau de dump d'image de diagnostic Indique le niveau de détails à enregistrer dans les fichiers image de diagnostic.
"basic " enregistre toutes les données possibles sauf celles d'état d'appel.
"full" enregistre toutes les données, y compris celles d'état d'appel
Attribut de MBean :
SipServerBean.ImageDumpLevelGestion de session obsolète Action à exécuter lorsqu'un message entrant contient des identificateurs de session erronés.
WebLogic Communications Server encode les ID de session et d'état d'appel sous la forme d'URL sortantes pour identifier la session appropriée dans les messages renvoyés. Les valeurs suivantes déterminent l'opération à effectuer lorsqu'un message entrant contient des identificateurs de session erronés.
error : répondre avec une erreur 481 ou 404.
continue : ignorer les identificateurs encodés et poursuivre le traitement du message.
drop : supprimer le message sans invite.
La valeur par défaut est "error".
Attribut de MBean :
SipServerBean.StaleSessionHandling