Serveur SIP : Configuration : AppRouter

Options de configuration     

Utilisez cette page pour configurer les fonctionnalités Application Router (AR) du conteneur de servlet SIP.

Afin de satisfaire la demande initiale, le conteneur de servlet SIP appelle d'abord l'instance Application Router (AR), qui fournit la logique utilisée pour sélectionner l'application de servlet SIP appropriée. Un routeur d'applications est obligatoire pour que le conteneur puisse fonctionner, mais l'instance AR est une entité logique séparée du conteneur. Elle est uniquement responsable de la sélection de l'application et ne doit pas implémenter de logique applicative. Par exemple, l'instance AR ne peut pas modifier une demande ni envoyer une réponse. Pour plus d'informations, reportez-vous à "Composing SIP Applications" dans le manuel de programmation.

Options de configuration

Nom Description
Données de configuration d'AR

Propriétés à transmettre à l'instance AR par défaut ou personnalisée dans la méthode d'initialisation.

Toutes les propriétés de configuration doivent correspondre au format des propriétés Java. Si vous saisissez des propriétés pour le routeur d'applications par défaut, les propriétés doivent également respecter le format de propriété détaillé décrit dans l'annexe C de la spécification de servlet SIP v1.1. Les implémentations AR personnalisées peuvent utiliser un format de propriété détaillé différent de celui décrit dans l'annexe C. Une instance AR personnalisée doit également valider les données de configuration.

Vous pouvez indiquer les propriétés d'initialisation de l'instance AR lors du démarrage de l'instance WebLogic Communications Server en incluant l'option Java -Djavax.servlet.sip.ar.dar.configuration. (Pour indiquer un fichier de propriétés plutôt qu'un URI, incluez le fichier de préfixe : "///") . Si vous indiquez l'option de démarrage Java, le conteneur ignore toute propriété définie dans les données de configuration de l'instance AR. Vous pouvez modifier les propriétés dans Données de configuration d'AR à tout moment, mais les propriétés ne sont transmises à l'instance AR qu'une fois le serveur redémarré en omettant l'option -Djavax.servlet.sip.ar.dar.configuration.

Attribut de MBean :
AppRouterBean.AppRouterConfigData

Les modifications sont prises en compte une fois le module redéployé ou le serveur relancé.

Utiliser l'instance AR personnalisée

Utilisez une instance Application Router personnalisée à la place de l'instance AR par défaut.

Attribut de MBean :
AppRouterBean.UseCustomAppRouter

Les modifications sont prises en compte une fois le module redéployé ou le serveur relancé.

Nom de fichier d'instance AR personnalisée

Nom du fichier JAR de l'instance AR personnalisée (doit être stocké dans le répertoire $DOMAIN_HOME/approuter).

Attribut de MBean :
AppRouterBean.CustomAppRouterJarFileName

Les modifications sont prises en compte une fois le module redéployé ou le serveur relancé.

Nom d'application par défaut

Nom de l'application par défaut que le conteneur doit appeler lorsque l'instance AR personnalisée ne trouve pas d'application pour traiter la demande initiale.

Si aucune application par défaut n'est indiquée et si l'instance AR ne parvient pas à en sélectionner une, le conteneur renvoie une erreur 500.

Remarque : vous devez d'abord déployer une application avant d'indiquer son nom en tant que valeur de nom d'application par défaut.

Attribut de MBean :
AppRouterBean.DefaultApplicationName