SIP Server:配置:一般信息

配置选项     

使用此页可以配置 SIP Servlet 容器功能和默认行为。

配置选项

名称 说明
默认 Servlet 名称

当服务器无法使用可用 Servlet 映射规则将传入初始请求映射到 Servlet 时要调用的默认 SIP Servlet 的名称。

在 default-servlet-name 元素中指定的名称必须与已部署 SIP Servlet 的 servlet-name 值匹配。如果在 default-servlet-name 中定义的名称与部署的 Servlet 不匹配,或未提供任何值 (默认配置),WebLogic Communications Server 会将名称 com.bea.wcp.sip.engine.BlankServlet 注册为默认 Servlet。如果从容器中取消部署已注册为 default-servlet-name 的已部署 Servlet,也会使用 BlankServlet 名称。

BlankServlet 的行为使用 default-behavior 元素进行配置。默认情况下,Servlet 将代理所有不匹配的请求。但是,如果 default-behavior 元素设置为“ua”模式,BlankServlet 将负责对 CANCEL 和 BYE 请求返回 481 响应,在所有其他情况下返回 500/416 响应。BlankServlet 不会对 ACK 做出响应,它总是使应用程序会话失效。

MBean 属性:
SipServerBean.DefaultServletName

更改将在重新部署模块或重新启动服务器后生效。

T1 超时间隔

SIP 协议 T1 计时器的持续时间 (毫秒)。

计时器 T1 还指定计时器 A、E 和 G 的初始值,这些计时器控制通过 UDP 传输的 INVITE 请求和响应的重新传输间隔。计时器 T1 会影响计时器 F、H 和 J 的值,这些计时器控制 INVITE 响应和请求的重新传输间隔;这些计时器的值设置为 64*T1 毫秒。有关 SIP 计时器的详细信息,请参阅 SIP 规范。另请参阅配置指南中的“配置 NTP 以获得精确 SIP 计时器”。

如果未配置 T1 超时值,WebLogic Communications Server 将使用 SIP 协议默认值 500 毫秒。

MBean 属性:
SipServerBean.T1TimeoutInterval

更改将在重新部署模块或重新启动服务器后生效。

T2 超时间隔

SIP 协议 T2 计时器的持续时间 (毫秒)。

计时器 T2 定义 INVITE 响应和非 INVITE 请求的重新传输间隔。有关 SIP 计时器的详细信息,请参阅 SIP 规范。另请参阅配置指南中的“配置 NTP 以获得精确 SIP 计时器”。

如果未配置 T2 超时值,WebLogic Communications Server 将使用 SIP 协议默认值 4 秒。

MBean 属性:
SipServerBean.T2TimeoutInterval

更改将在重新部署模块或重新启动服务器后生效。

T4 超时间隔

SIP 协议 T4 计时器的持续时间 (毫秒)。

计时器 T4 指定消息保留在网络中的最长时间。计时器 T4 还指定计时器 I 和 K 的初始值,这两个计时器控制通过 UDP 重新传输 ACK 和响应的等待时间。有关 SIP 计时器的详细信息,请参阅 SIP 规范。另请参阅配置指南中的“配置 NTP 以获得精确 SIP 计时器”。

如果未配置 T4 超时值,WebLogic Communications Server 将使用 SIP 协议默认值 5 秒。

MBean 属性:
SipServerBean.T4TimeoutInterval

更改将在重新部署模块或重新启动服务器后生效。

计时器 B 超时间隔

SIP 协议计时器 B 的持续时间 (毫秒)。

计时器 B 指定客户机事务处理尝试重试发送请求的时间长度。有关 SIP 计时器的详细信息,请参阅 SIP 规范。另请参阅“配置 NTP 以获得精确 SIP 计时器”。

如果未配置计时器 B 值,服务器将从计时器 T1 派生值 (64*T1 或默认值 32000 毫秒)。

MBean 属性:
SipServerBean.TimerBTimeoutInterval

更改将在重新部署模块或重新启动服务器后生效。

计时器 F 超时间隔

SIP 协议计时器 F 的持续时间 (毫秒)。

计时器 F 指定用于重新传输非 INVITE 请求的超时间隔。有关 SIP 计时器的详细信息,请参阅 SIP 规范。另请参阅配置指南中的“配置 NTP 以获得精确 SIP 计时器”。

如果未配置计时器 F 值,服务器将从计时器 T1 派生值 (64*T1 或默认值 32000 毫秒)。

MBean 属性:
SipServerBean.TimerFTimeoutInterval

更改将在重新部署模块或重新启动服务器后生效。

最长应用程序会话生命周期

在 WebLogic Communications Server 使会话失效前,SIP 应用程序会话可以存在的最长时间 (分钟)。此值必须大于等于每个部署的应用程序的默认会话长度。

A -1 (默认值) 表示 SIP 会话生命周期没有限制。

MBean 属性:
SipServerBean.MaxApplicationSessionLifetime

更改将在重新部署模块或重新启动服务器后生效。

启用本地分派

启用在发送和转发消息时可帮助避免不必要的网络通信量的服务器优化功能。

启用后,如果服务器实例需要发送或转发消息并且消息目标为引擎层的集群地址或本地服务器地址,系统会在内部将消息路由到本地服务器而不是通过网络发送消息。

MBean 属性:
SipServerBean.EnableLocalDispatch

更改将在重新部署模块或重新启动服务器后生效。

默认 SIP Server 行为

在服务器无法将传入 SIP 请求匹配到部署的 SIP Servlet,或匹配的 Servlet 已失效或超时的情况下,WebLogic Communications Server 实例的默认行为。

有效值是:

  • 代理:充当无状态代理服务器。

  • ua:充当用户代理。

如果不指定值,则使用“代理”作为默认值。

充当用户代理 (UA) 时,WebLogic Communications Server 在响应 SIP 请求时按下列方式执行操作:

  • 将在不进行通知的情况下丢弃 ACK 请求。

  • CANCEL 或 BYE 请求收到响应代码 481 - 事务处理不存在。

  • 所有其他请求收到响应代码 500 - 内部服务器错误。

充当无状态代理时,会将请求自动转发到出站代理 (如果已配置)。如果未定义代理,则仅当请求 URI 与 SIP Servlet 容器的已知本地地址或为服务器配置的负载平衡器地址的 IP 和端口号不匹配时,WebLogic Communications Server 才会代理到指定的请求 URI。这将确保请求不会经常循环到相同的服务器。当请求 URI 与本地容器地址或负载平衡器地址匹配时,WebLogic Communications Server 将改为充当 UA。

MBean 属性:
SipServerBean.DefaultBehavior

更改将在重新部署模块或重新启动服务器后生效。

服务器标头插入

指定将服务器标头插入 SIP 消息的条件。

使用此属性可以限制或删除服务器标头以减小用于移动网络的消息大小或增加安全性。选择下列字符串值之一来配置行为:

  • 无 (默认值):不插入服务器标头。

  • 请求:仅为由服务器生成的 SIP 请求插入服务器标头。

  • 响应:仅为由服务器生成的 SIP 响应插入服务器标头。

  • 全部:为所有 SIP 请求和响应插入服务器标头。

默认情况下,WebLogic Communications Server 不向 SIP 消息中插入服务器标头。

MBean 属性:
SipServerBean.ServerHeader

服务器标头值

插入到 SIP 消息中的服务器标头的值。

通过 WebLogic Communications Server 可以控制插入生成的消息的服务器标头中的文本。这样可对 SIP 消息大小进行更多控制,并可以出于安全目的标记服务器实体。要配置标头内容,请输入字符串值。

默认情况下,WebLogic Communications Server 不向生成的 SIP 消息中插入服务器标头。如果已启用服务器标头插入,但未指定服务器标头值,WebLogic Communications Server 将插入值“WebLogic SIP Server”。

MBean 属性:
SipServerBean.ServerHeaderValue

标头插入的默认形式

指定服务器如何应用用于压缩 SIP 消息标头的规则。

此元素配置在 SIP 消息中使用或保留简洁标头的服务器端默认行为。可以将此元素设置为下列值之一:

  • 简洁:WebLogic Communications Server 对所有系统生成的标头使用简洁形式。但是,从始发消息复制的任何标头 (而不是生成的) 都使用其原始形式。

  • 强制简洁:WebLogic Communications Server 对所有标头使用简洁形式,根据需要将现有消息中的详细标头转换为简洁标头。

  • 详细:WebLogic Communications Server 对所有系统生成的标头使用详细形式。但是,从始发消息复制的任何标头 (而不是生成的) 都使用其原始形式。

  • 强制详细:WebLogic Communications Server 对所有标头使用详细形式,根据需要将现有消息中的简洁标头转换为详细标头。

MBean 属性:
SipServerBean.UseHeaderForm

启用 DNS 服务器查找

指定服务器是否执行 DNS 查找。

如果将此属性设置为“真”,则服务器可以使用 DNS 执行以下操作:

  • 在将请求发送到 SIP URI 时发现代理服务器的传输方式、IP 地址和端口号。

  • 在响应路由期间根据“发送方”字段的内容解析 IP 地址和/或端口号。

对于代理发现,WebLogic Communications Server 只对每个 SIP 事务处理使用一次 DNS 解析以确定传输方式、IP 和端口号信息。所有重新传输、ACK 或 CANCEL 请求都使用同一传输方式传送到同一地址和端口。有关如何进行 DNS 解析的详细信息,请参阅 RFC 3263:会话初始协议 (SIP):定位 SIP Server

当代理需要发送响应消息时,WebLogic Communications Server 使用 DNS 查找根据“发送方”字段中提供的信息并通过标头确定目标的 IP 地址和/或端口号。

默认情况下,不使用 DNS 解析 (“假”)。

注:由于 DNS 解析是在 SIP 消息处理上下文中执行的,因此任何 DNS 性能问题都会导致延迟增加。Oracle 建议在生产环境中使用高速缓存 DNS 服务器以最大限度地减少可能的性能问题。

MBean 属性:
SipServerBean.EnableDnsSrvLookup

启用调用状态高速缓存

指定引擎是否在本地高速缓存调用状态数据的一部分。

MBean 属性:
SipServerBean.EngineCallStateCacheEnabled

更改将在重新部署模块或重新启动服务器后生效。

对不可靠预配的 (1xx) 响应启用 Contact 标头

指定服务器是否在具有 To 标记的不可靠预配的 (1xx) 响应中放置 Contact 标头。

这不适用于 100,可能的值包括“真”和“假”。

如果将此属性设置为“真”,则服务器放置 Contact 标头,否则跳过它。

MBean 属性:
SipServerBean.EnableContactProvisionalResponse

全局可路由 URI

WebLogic Communications Server 在与网络元素通信时自动插入到 Contact 和 Route-Set 标头中的全局可路由用户代理 URI (GRUU)。

在此元素中指定的 URI 应为整个 WebLogic Communications Server 集群的 GRUU。在单服务器域中,请为服务器自身指定 GRUU。

请注意,在 WebLogic Communications Server 中部署的用户代理 (UA) 通常通过注册请求获取 GRUU。在这种情况下,应用程序代码同时负责对 GRUU 进行请求和后续处理。要请求 GRUU,UA 应在需要 GRUU 的每个 Contact 中包括“+sip.instance”Contact 标头字段参数。收到 GRUU 后,在生成新请求时,UA 将使用 GRUU 作为联系人标头字段的 URI。

MBean 属性:
SipServerBean.GloballyRoutableUri

更改将在重新部署模块或重新启动服务器后生效。

启用计时器关系

指定是否在设置计时器的引擎上处理每个计时器。

如果此属性设置为“真”,将在创建计时器的引擎上处理计时器。这在某些应用程序中非常重要。如果设置为“假”,则可以在任何引擎上处理计时器。

MBean 属性:
SipServerBean.EnableTimerAffinity

“重试前等待时间”值

对于 5xx 响应,在 Retry-After 标头中使用的秒数。该值还可以包括参数或原因,如“Retry-After: 18000;duration=3600”或“Retry-After: 120 (I'm in a meeting)”。

如果未配置此值,WebLogic Communications Server 将使用默认值 180 秒

MBean 属性:
SipServerBean.RetryAfterValue

更改将在重新部署模块或重新启动服务器后生效。

域别名

服务器负责的域名的列表。

将在本地处理而不是转发发往此列表中的域的消息。您可以在列表中包括全限定的域名或以通配符开头的域名,如 *.mycompany.com。

MBean 属性:
SipServerBean.DomainAliasNames

对称响应路由

指定是否为由 WebLogic Communications Server 生成的请求请求对称响应路由 (通过 rport 参数)。

启用此选项时,RFC3581 中定义的对称响应路由生效。

MBean 属性:
SipServerBean.EnableRport

诊断图像转储级别

指定要在诊断图像文件中记录的信息的详细级别。

  • “基本”将记录除调用状态数据以外的所有可能数据。

  • “完整”将记录包括调用状态数据在内的所有数据。

MBean 属性:
SipServerBean.ImageDumpLevel

过期会话处理

当传入消息中包含错误会话标识符时要执行的操作。

WebLogic Communications Server 将会话和调用状态 ID 编码到传出 URL 中以帮助在返回消息中标识正确的会话。下列值确定在传入消息中包含错误会话标识符的情况下要执行的操作:

  • 错误:响应 481 或 404 错误。

  • 继续:忽略已编码的标识符并继续处理消息。

  • 丢弃:无提示地丢弃消息。

默认操作为“错误”。

MBean 属性:
SipServerBean.StaleSessionHandling