Servidor SIP: Configuración: General
Utilice esta página para configurar las funciones y el comportamiento por defecto del contenedor SIP Servlet.
Opciones de Configuración
Nombre Descripción Nombre del Servlet por Defecto El nombre de un Servlet SIP por defecto al que hay que llamar en caso de que el servidor no pueda asignar una solicitud inicial entrante a un Servlet con las reglas de correspondencia del Servlet disponibles.
El nombre especificado en el elemento nombre-servlet-por defecto debe coincidir con el valor nombre-servlet de un Servlet SIP desplegado. En caso de que el nombre definido en nombre-servlet-por defecto no coincida con el Servlet desplegado o de que no se proporcione ningún valor (la configuración por defecto), el servidor de conexiones WebLogic registra el nombre com.bea.wcp.sip.engine.BlankServlet como el Servlet por defecto. El nombre BlankServlet también se utiliza si un Servlet desplegado que esté registrado como el nombre-servlet-por defecto no se despliegue desde el contenedor.
El comportamiento de BlankServlet se configura con el elemento comportamiento-por defecto. Por defecto, el Servlet evalúa todas las solicitudes sin correspondencia. Sin embargo, si el elemento comportamiento-por defecto esta definido en el modo "ua", BlankServlet es responsable de devolver 481 respuestas para las solicitudes CANCELAR y ADIÓS, y 500 o 416 respuestas en los demás casos. BlankServlet no responde a ACK y siempre invalida la sesión de la aplicación.
Atributo de MBean:
SipServerBean.DefaultServletNameLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Intervalo de Timeout T1 La duración, en milisegundos, del temporizador T1 del protocolo SIP.
El temporizador T1 también especifica los valores iniciales de los temporizadores A, E y G, que controlan el intervalo de retransmisión para las solicitudes y respuestas de invitación a través de UDP. El temporizador T1 afecta a los valores de los temporizadores F, H y J, que controlan los intervalos de retransmisión para las solicitudes y respuestas de invitación; estos temporizadores están definidos en un valor de 64*T1 milisegundos. Consulte la especificación SIP para obtener más información sobre los temporizadores SIP. Consulte también la sección sobre la configuración de NTP para temporizadores SIP precisos en la guía de configuración.
Si el valor de timeout de T1 no está configurado, el servidor de comunicaciones WebLogic utiliza el valor por defecto del protocolo SIP de 500 milisegundos.
Atributo de MBean:
SipServerBean.T1TimeoutIntervalLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Intervalo de Timeout T2 La duración, en milisegundos, del temporizador T2 del protocolo SIP.
El temporizador T2 define el intervalo de retransmisión para las respuestas de invitación y las solicitudes de no invitación. Consulte la especificación SIP para obtener más información sobre los temporizadores SIP. Consulte también la sección sobre la configuración de NTP para temporizadores SIP precisos en la guía de configuración.
Si el valor de timeout de T2 no está configurado, el servidor de comunicaciones WebLogic utiliza el valor por defecto del protocolo SIP de 4 segundos.
Atributo de MBean:
SipServerBean.T2TimeoutIntervalLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Intervalo de Timeout T4 La duración, en milisegundos, del temporizador T4 del protocolo SIP.
El temporizador T4 especifica el tiempo máximo durante el cual un mensaje permanece en la red. Este temporizador también especifica los valores iniciales de los temporizadores I y K, que controlan los tiempos de espera para retransmitir confirmaciones y respuestas a través de UDP. Consulte la especificación SIP para obtener más información sobre los temporizadores SIP. Consulte también la sección sobre la configuración de NTP para temporizadores SIP precisos en la guía de configuración.
Si el valor de timeout de T4 no está configurado, el servidor de comunicaciones WebLogic utiliza el valor por defecto del protocolo SIP de 5 segundos.
Atributo de MBean:
SipServerBean.T4TimeoutIntervalLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Intervalo de Timeout del Temporizador B La duración, en milisegundos, del temporizador B del protocolo SIP.
El temporizador B especifica el tiempo durante el cual una transacción cliente intenta volver a enviar una solicitud. Consulte la especificación SIP para obtener más información sobre los temporizadores SIP. Consulte también la sección sobre la configuración de NTP para temporizadores SIP precisos.
Si el valor del temporizador B no está configurado, el servidor deriva un valor desde el temporizador T1 (64*T1 o 32.000 milisegundos por defecto).
Atributo de MBean:
SipServerBean.TimerBTimeoutIntervalLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Intervalo de Timeout del Temporizador F La duración, en milisegundos, del temporizador F del protocolo SIP.
El temporizador F especifica el intervalo de timeout para retransmitir solicitudes de no invitación. Consulte la especificación SIP para obtener más información sobre los temporizadores SIP. Consulte también la sección sobre la configuración de NTP para temporizadores SIP precisos en la guía de configuración.
Si el valor del temporizador F no está configurado, el servidor deriva un valor desde el temporizador T1 (64*T1 o 32.000 milisegundos por defecto).
Atributo de MBean:
SipServerBean.TimerFTimeoutIntervalLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Duración Máxima de la Sesión de la Aplicación Tiempo máximo, en minutos, que puede durar la sesión de una aplicación SIP antes de que WebLogic Communications Server invalide la sesión. Este valor debe ser igual o mayor que la duración de la sesión por defecto de cada aplicación desplegada.
A -1 (el valor por defecto) indica que no hay límite para la duración de la sesión de SIP.
Atributo de MBean:
SipServerBean.MaxApplicationSessionLifetimeLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Activar Distribución Local Active una optimización del servidor que ayude a impedir el tráfico de red innecesarios cuando se envíen y reenvíen mensajes.
Cuando esta opción está activada, si una instancia de servidor necesita enviar o reenviar un mensaje y el destino de dicho mensaje la dirección del cluster de la capa del motor o la dirección del servidor local, el mensaje se direcciona internamente al servidor local en lugar de enviarse a través de la red.
Atributo de MBean:
SipServerBean.EnableLocalDispatchLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Comportamiento por Defecto del Servidor SIP El comportamiento por defecto de la instancia del servidor de comunicaciones WebLogic si el servidor no puede hacer coincidir una solicitud SIP entrante con un Servlet SIP, o si el Servlet que coincide se ha invalidado o ha sobrepasado el tiempo de espera.
Los valores válidos son los siguientes:
proxy: Actuar como un servidor proxy sin estado.
ua: Actuar como un Agente de Usuario.
"proxy" se utiliza como valor por defecto en caso de que no especifique ningún valor.
Cuando actúa como un agente de usuario, el servidor de comunicaciones WebLogic actúa de la siguiente forma en respuesta a las solicitudes SIP:
Las solicitudes de ACK se desechan sin previo aviso.
Las solicitudes CANCELAR o ADIÓS reciben el código de respuesta 481 (no existen transacciones).
Todas las demás solicitudes reciben el código de respuesta 500 (error interno del servidor).
Cuando actúa como un intermediario sin estado, las solicitudes se reenvían automáticamente a un intermediario saliente en caso de que haya uno configurado. Si por el contrario, no se ha definido ningún intermediario, WebLogic Communications Server establece un intermediario a un URI de solicitud concreto sólo si el URI de solicitud no coincide con la IP o el número de puerto de una dirección local conocida para un contenedor de servlet SIP, o una dirección de equilibrador de carga configurada para el servidor. De esta forma se garantiza que la solicitud no forme bucles constantemente en los mismos servidores. Por el contrario, si el URI de solicitud coincide con la dirección del contenedor local o la dirección del equilibrador de carga, WebLogic Communications Server actúa como un agente de usuario.
Atributo de MBean:
SipServerBean.DefaultBehaviorLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Inserción de la Cabecera del Servidor Especifica las condiciones de inserción de la cabecera del servidor en mensajes SIP.
Utilice este atributo para limitar o eliminar cabeceras del servidor a fin de reducir el tamaño del mensaje para las redes móviles o para aumentar la seguridad. Seleccione uno de los siguientes valores de cadena para configurar el comportamiento:
none (el valor por defecto): No inserta ninguna cabecera del servidor.
request: Inserta la cabecera del servidor sólo para las solicitudes SIP generadas por el servidor.
response: inserta la cabecera del servidor sólo para respuestas SIP generadas por el servidor.
all: Inserta la cabecera del servidor para todas las solicitudes y respuestas SIP.
Por defecto, el servidor de comunicaciones WebLogic no inserta ninguna cabecera del servidor en los mensajes SIP.
Atributo de MBean:
SipServerBean.ServerHeaderValor de la Cabecera del Servidor El valor de la cabecera del servidor introducida en los mensajes SIP.
El servidor de comunicaciones WebLogic le permite controlar el texto que se inserta en la cabecera del servidor de los mensajes generados. Esto también le permite ejercer un mayor control del tamaño de los mensajes SIP y enmascarar el servidor a efectos de seguridad. Para configurar el contenido de la cabecera, introduzca un valor de cadena.
Por defecto, el servidor de comunicaciones WebLogic no inserta ninguna cabecera del servidor en los mensajes SIP generados. Si la opción Inserción de la Cabecera del Servidor está activada pero no se especifica ningún valor para la cabecera, el servidor de comunicaciones WebLogic inserta el valor "Servidor SIP WebLogic".
Atributo de MBean:
SipServerBean.ServerHeaderValueForma por Defecto para la Inserción de la Cabecera Especifica cómo el servidor aplica reglas para compactar las cabeceras de los mensajes SIP.
Este elemento configura el comportamiento por defecto de todo el servidor para utilizar o conservar cabeceras compactas en los mensajes SIP. Puede definir este elemento en uno de los siguientes valores:
compactar: El servidor de comunicaciones WebLogic utiliza la forma compacta para todos las cabeceras generadas por el sistema. Sin embargo, cualquier cabecera copiada de un mensaje originado (en lugar de generado) utiliza su forma original.
forzar compactación: El servidor de comunicaciones WebLogic utiliza la forma compacta para todas las cabeceras, convirtiendo las cabeceras largas de los mensajes existentes en cabeceras compactas, según proceda.
larga: El servidor de comunicaciones WebLogic utiliza la forma larga para todas las cabeceras generadas por el sistema. Sin embargo, cualquier cabecera copiada de un mensaje originado (en lugar de generado) utiliza su forma original.
forzar forma larga: El servidor de comunicaciones WebLogic utiliza la forma larga para todas las cabeceras, convirtiendo las cabeceras compactas de los mensajes existentes en cabeceras largas, según proceda.
Atributo de MBean:
SipServerBean.UseHeaderFormActivar la Búsqueda del Servidor DNS Especifica si el servidor realiza búsquedas DNS.
Si define este atributo en "true", el servidor podrá utilizar DNS para:
Descubra el transporte, la dirección IP y el número de puerto de un servidor proxy cuando se envíe una solicitud a una URI de SIP.
Resuelva una dirección IP y/o un número de puerto durante el direccionamiento de la respuesta, en función del contenido del campo Enviado por.
Para la detección del proxy, el servidor de comunicaciones WebLogic utiliza la resolución DNS sólo una vez por transacción SIP para determinar la información sobre el transporte, la IP y el número de puerto. Todas las solicitudes de retransmisiones, ACK o CANCELAR se entregan en la misma dirección y el mismo puerto utilizando el mismo transporte. Para obtener información detallada sobre cómo se lleva a cabo la resolución DNS, consulte RFC 3263: Protocolo de Inicio de Sesiones (SIP): Ubicación de Servidores SIP.
Cuando un proxy necesita enviar un mensaje de respuesta, el servidor de comunicaciones WebLogic utiliza la búsqueda DNS para determinar la dirección IP y/o el número de puerto del destino, en función de la información facilitada en el campo Enviado por y a través de la cabecera.
Por defecto, no se utiliza la resolución DNS ("false").
Nota: la resolución DNS se realiza en el contexto del procesamiento de mensajes SIP y, en consecuencia, cualquier problema de rendimiento de DNS deriva en un aumento del rendimiento de latencia. Oracle recomienda utilizar un servidor DNS de almacenamiento en caché en un entorno de producción para minimizar los posibles problemas de rendimiento.
Atributo de MBean:
SipServerBean.EnableDnsSrvLookupActivar la Caché de Estado de Llamada Especifica si los motores almacenan en caché una parte de los datos del estado de la llamada a nivel local.
Atributo de MBean:
SipServerBean.EngineCallStateCacheEnabledLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Activar la Cabecera de Contacto para la Respuesta Provisional(1xx) no Fiable Especifica si el servidor coloca la cabecera de contacto en una respuesta provisional(1xx) no fiable con la etiqueta Para.
Esto no se aplica a 100 y los valores posibles son true y false.
Si define este atributo en "true", el servidor coloca la cabecera de contacto; de lo contrario, la omite.
Atributo de MBean:
SipServerBean.EnableContactProvisionalResponseURI Direccionable Globalmente URI de agentes de usuario direccionable globalmente (GRUU) que el servidor de comunicaciones Server inserta automáticamente en las cabeceras de contacto y de definición de enrutado al comunicarse con los elementos de la red.
La URI especificada en este elemento debe ser del tipo GRUU para todo el cluster del servidor de comunicaciones WebLogic. En un dominio de un único servidor, especifique una GRUU para el servidor en sí.
Tenga en cuenta que los agentes de usuario (UA) desplegados en el servidor de comunicaciones WebLogic suele obtener las GRUU a través de una solicitud de registro. En este caso, el código de la aplicación es responsable de solicitar y de gestionar posteriormente la GRUU. Para solicitar una GRUU, el agente de usuario debería incluir el parámetro del campo de cabecera de contacto "+sip.instance" en cada contacto para el que se requiere la GRUU. Tras recibir una GRUU, el agente de usuario debería utilizarla como la URI para el campo cabecera de contacto cuando se generen nuevas solicitudes.
Atributo de MBean:
SipServerBean.GloballyRoutableUriLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Activar Afinidad del Temporizador Especifica si cada temporizador se procesa en el motor en el que se ha definido.
Si este atributo se define en "true", los temporizadores se procesarán en el motor en el que se crearon. Esto es importante en algunas aplicaciones. Por el contrario, si se define en "false", los temporizadores pueden procesarse en cualquier motor.
Atributo de MBean:
SipServerBean.EnableTimerAffinityValor de Reintentar Después de El número de segundos utilizados en la cabecera Volver a intentarlo después de para 5xx respuestas. Este valor también incluye un parámetro o un motivo, como "Volver a intentarlo después de: 18.000;duración=3.600" o "Volver a intentarlo después de: 120 (Estoy en una reunión)."
Si este valor no está configurado, WebLogic Communications Server utiliza el valor por defecto de 180 segundos.
Atributo de MBean:
SipServerBean.RetryAfterValueLos cambios se aplicarán después de volver a desplegar el módulo o reiniciar el servidor.
Alias de Dominio La lista de los nombres de dominios de los que es responsable el servidor.
Los mensajes enviados a los dominios de esta lista se procesan a nivel local, en lugar de reenviarse. Puede incluir en la lista nombres de dominios totalmente cualificados o nombres de dominios que empiecen un carácter comodín, como *.micompañía.com.
Atributo de MBean:
SipServerBean.DomainAliasNamesEnrutamiento de Respuesta Simétrica Especifica si se solicita el enrutamiento de respuesta simétrica (a través del parámetro rport) para solicitudes generadas por el servidor de comunicaciones WebLogic.
Cuando esta opción está activada, significa que el enrutamiento de respuesta simétrica se encuentra activo según lo definido en RFC3581.
Atributo de MBean:
SipServerBean.EnableRportNivel de Volcado de Imágenes de Diagnósticos Especifica el nivel de detalle que hay que registrar en los archivos de imágenes de diagnóstico.
"básico" registra todos los datos posibles, excepto los datos de estado de la llamada.
"completo" registra todos los datos, incluidos los datos de estado de la llamada.
Atributo de MBean:
SipServerBean.ImageDumpLevelTratamiento de Sesiones Anticuadas La acción que hay que realizar cuando un mensaje entrante contiene identificadores de sesión erróneos.
El servidor de comunicaciones WebLogic codifica los ID de sesión y de estado de la llamada en las URL salientes para facilitar la identificación de la sesión correcta en mensajes de devolución. Los siguientes valores determinan una acción que es necesario emprender si un mensaje entrante contiene identificadores de sesión erróneos.
error: Responder con un error 481 o 404.
continuar: Ignorar los identificadores codificados y continuar procesando el mensaje.
borrar: Borrar el mensaje de forma silenciosa.
La acción por defecto es "error".
Atributo de MBean:
SipServerBean.StaleSessionHandling