SIP 代理服务器定制属性

可将以下定制属性添加至会话启动协议 (SIP) 代理服务器的配置设置。

要指定特定 SIP 代理服务器的定制属性,请浏览到该定制属性页面,然后指定该定制属性的值。
重要信息: 支持将定制属性作为配置的主要方法。 因此,如果设置了定制属性然后您在管理控制台中设置了对应设置,那么会使用定制属性值。
  1. 在管理控制台中,展开服务器 > 服务器类型 > WebSphere 代理服务器 > server_name 以打开服务器的配置选项卡。
  2. 代理设置下,展开 SIP 代理服务器设置,然后单击 SIP 代理设置
  3. 其他属性下,选择 定制属性 > 新建
  4. 在配置页面上的名称字段中输入要配置的定制属性,并在字段中输入该定制属性的值。
  5. 单击 应用确定
  6. 单击控制台任务栏上的保存以保存配置更改。
  7. 重新启动服务器。
SIP 代理服务器定制属性
SIP 代理服务器超负荷保护定制属性
可以使用下列 SIP 代理定制属性来应用由代理管理的超负荷保护 (PMOP)。 PMOP 超负荷设置使得能够进行实时保护以避免容器超负荷。

有关超负荷控制的更多信息,请参阅有关 会话启动协议超负荷保护的文档。

burstResetFactor

指定给定时间段内的突发百分比。 此定制属性控制平均周期内发生的突发数。

信息
数据类型 整型
缺省值 100

deflatorRatio

指定静态比率。 仅当已指定转换期,才应在转换期期间使用此定制属性。

信息
数据类型 整型
缺省值 0

dropOverloadPackets

指定 SIP 容器处于超负荷状态时是否删除包。 如果此值设置为 False,那么超负荷时代理服务器会以 503 错误响应,否则会删除包。

信息
数据类型 字符串
缺省值

inDialogAveragingPeriod

指定计算对话内消息数的平均值的时间段(以秒计)。

信息
数据类型 整型
缺省值 180

lsnLookupFailureResponseCode

指定针对亲缘关系的 SIP 请求失败时的响应代码。 此定制属性允许您覆盖缺省 404 错误响应,亲缘关系失败时通常会显示此响应。

信息
数据类型 充当有效 SIP 响应代码的整数值
缺省值 404

lsnLookupFailureReasonPhrase

指定针对亲缘关系的 SIP 请求失败时要显示的响应文本。 此定制属性允许您覆盖缺省“找不到”错误文本,亲缘关系失败时通常会显示此文本。

信息
数据类型 字符串
缺省值 “找不到”

maddrParameterEnabled

指定是否希望 SIP 代理服务器使用 VIA 头中的 maddr 参数来确定将 SIP 响应路由至的位置。 如果将此属性设置为 true,那么 SIP 代理服务器将使用 maddr 参数来确定将响应路由至的位置。 如果没有为此属性指定值或如果将此属性设置为 false,那么 SIP 代理服务器不会使用 maddr 参数来确定将响应路由至的位置。

信息
数据类型 字符串
缺省值

maxBackupLogFiles

指定希望 SIP 代理服务器保留的历史 sipproxy.log 文件的数目。 缺省情况下,SIP 代理服务器仅保留一个历史 sipproxy.log 文件。

信息
数据类型 整型
缺省值 1

logCompleteMessages

指定在 SIP 代理服务器上启用了访问日志记录的情况下是否记录完整的 SIP 消息(为了安全起见而隐藏的任何头除外)。 缺省情况下,仅记录一部分 SIP 头。

信息
数据类型 字符串
缺省值

maxThroughputFactor

指定每平均周期集合的最大消息数百分比。 如果此值设置为 0,那么会禁用最大吞吐量功能。 此定制属性用于计算代理服务器开始拒绝新会话的请求之前,每秒允许的最大消息数。 对于每个代理服务器,此定制属性应设置为相同值。

信息
数据类型 整型
缺省值 0

numFailuresSipAdvisorRequests

指示要错过多少个 SIP 顾问程序请求,SIP 代理才会认识到它未在处理任何数据。 通过此定制属性,SIP 代理将会注意到接收负载均衡器顾问程序请求失败。

如果使用此定制属性,请考虑将其值设置为 3。

信息
数据类型 整型
缺省值 无缺省值 - 此属性未启用,除非您指定值。

outDialogAveragingPeriod

指定计算对话外消息数的平均值的时间段(以秒计)。

信息
数据类型 整型
缺省值 360

overloadResponseCode

指定在发生超负荷且拒绝来自容器的 SIP 请求时从代理返回的响应代码的值。 如果配置了代理进行超负荷保护,那么 SIP 代理可配置为检测超负荷状态。 该代理监视在代理中处理的流量并限制新的请求数。 如果容器处于超负荷状态,那么代理将拒绝请求并返回 503 响应代码。 如果要对超负荷保护使用其他响应代码,那么您可以将此定制属性配置为返回该响应代码。

信息
数据类型 整型
缺省值 503

overloadResponseReasonPhrase

指定发生超负荷且来自容器的 SIP 请求被拒绝时由代理服务器发出的响应原因短语。 如果配置了代理进行超负荷保护,那么 SIP 代理可配置为检测超负荷状态。 该代理监视在代理中处理的流量并限制新的请求数。 如果容器处于超负荷状态,那么代理会拒绝请求并返回服务不可用响应短语。 如果要使用另一响应短语,那么您可以将此定制属性配置为返回该响应短语。

信息
数据类型 字符串
缺省值 服务不可用

perSecondBurstFactor

指定允许的突发百分比。

信息
数据类型 整型
缺省值 150

proxyTransitionPeriod

指定容器关闭后要锁定 deflator 的时间段(以秒计)。

信息
数据类型 整型
缺省值 0

sipAdvisorRequestTimeout

指定 SIP 代理服务器等待 Load Balancer 返回 DNS 查询的时间量(以毫秒计)。

如果您没有为此定制属性指定值,那么 SIP 代理服务器将等待 2 秒。

指定值 0 可禁用 DNS 查询监视。

信息
数据类型 整型
缺省值 3000 毫秒

sipProxyStartupDelay

指定 SIP 代理服务器重新启动前的时间段(以秒计)以允许此代理在集群中变稳定和避免错误的超负荷状态。

信息
数据类型 整型
缺省值 0

trustedIPAddressList

指定一个以冒号定界的 IP 地址列表,带有 p 断言身份头的消息可以从这些 IP 地址中流经 WebSphere Application Server的 SIP 代理服务器。 如果某个消息中存在 P 断言身份头但此消息来自此 IP 地址列表以外的地址,那么此头会被移除。

此 IP 地址列表必须是具体的,例如,192.168.0.1。

从此 Service Release 开始,定制属性需要使用分号定界列表。 此外,还可以指定一系列 IP 地址,例如 192.168.0.* 而不是特定 IP 地址的列表。

信息
数据类型 数字 IP 地址列表
缺省值

contactRegistryEnabled

指定 SIP 代理服务器停止和关闭的等级。 将 contactRegistryEnabled 设置为 false 可允许 SIP 代理服务器在关闭时使用联系人注册表绕过。 如果将 contactRegistryEnabled 设置为 true(缺省值),那么 SIP 代理服务器将花费较长时间来更新其 TCP/TLS 路由表。 当 SIP 代理服务器停止并管理大量连接时,关闭过程可能要花费较长时间来完成。 将 contactRegistryEnabled 设置为 false 可让关闭的速度更快。

信息
数据类型 字符串
缺省值

defaultTCPChainName

指定未调用 setOutboundInterface 时要使用的缺省 TCP 链名称。 如果要在 multihome 环境中使用 Feature Pack for Communications Enabled Applications (CEA) 的 Web 协作功能部件,那么必须正确设置此变量以便 Web 协作组件在路由数据时可选择正确的接口使用。

信息
数据类型 字符串
缺省值

defaultTLSChainName

指定未调用 setOutboundInterface 时要使用的缺省 TLS 链名称。 如果要在 multihome 环境中使用 Feature Pack for Communications Enabled Applications (CEA) 的 Web 协作功能部件,那么必须正确设置此变量以便 Web 协作组件在路由数据时可选择正确的接口使用。

信息
数据类型 字符串
缺省值

defaultUDPChainName

指定未调用 setOutboundInterface 时要使用的缺省 UDP 链名称。 如果要在 multihome 环境中使用 Feature Pack for Communications Enabled Applications (CEA) 的 Web 协作功能部件,那么必须正确设置此变量以便 Web 协作组件在路由数据时可选择正确的接口使用。

信息
数据类型 字符串
缺省值

enableEnhancedLoadBalancing

指定是否在应用程序服务器上启用负载均衡。

使用 WebSphere Application Server SIP 代理程序时,用户可能会看到后端应用程序服务器上的负载不均衡。 当有 10 个以上的后端应用程序服务器时,此问题似乎更加严重。 通过将 enableEnhancedLoadBalancing 设置为 true,新的负载均衡算法将以更适当的方式处理不均衡的负载。

信息
数据类型 字符串
缺省值

enableMultiClusterRouting

指定是否允许将具有无效路由信息的包发送到后端 SIP 容器。 要确保将具有无效路由信息的包发送到后端 SIP 容器,请将此属性设置为 true

信息
数据类型 字符串
缺省值

identityAssertionHeaderRemovalEnabled

指定应移除与通过 SIP 代理传递至 SIP 容器的 SIP 请求中的所有与身份断言相关的头。 如果将此属性设置为 false,那么与身份断言相关的头应作为请求的一部分保留。

信息
数据类型 字符串
缺省值

ipForwardingLBEnabled

使用此属性并将其设置为 true,以便在 SIP 代理前置“IP 转发”Load Balancer 的情况下,SIP 代理会将该 Load Balancer 的 IP 地址发送至后端应用程序服务器。

信息
数据类型 字符串
缺省值

isSipComplianceEnabled

指定是否在 SIP 代理服务器上启用 SIP 合规性检查。 SIP 合规性检查确保 SIP 消息符合会话初始化协议标准。 此属性设置为 true 时,启用 SIP 合规性检查。

避免麻烦: 如果您正在 z/OS WebSphere Application Server Network Deployment 环境中运行代理服务器,并且您的代理服务器不是集群的一部分,那么可以使用此定制属性对该 SIP 代理服务器启用或禁用 SIP 合规性检查。 但是,如果您正在运行独立应用程序服务器或代理服务器在集群中,那么必须使用 DisSipComplianceEnabledto 通用 JVM 参数来启用或禁用 SIP 一致性检查。
信息
数据类型 字符串
缺省值

keepAliveFailures

指定在代理确定与 SIP 容器的连接已关闭前,必须达到的保持活动消息丢失数目。

代理在每个 keepAliveInterval 内向容器发送一条保持活动消息。 如果代理未接收到对消息的响应,那么将缺乏响应这一情况视为失败。 如果代理接收到的连续失败达到特定数目,那么视容器已关闭并开始将消息转发给其他 SIP 容器。

信息
数据类型 整型
缺省值 0

keepAliveInterval

指定将保持活动消息发送至 SIP 容器时所处的时间间隔(以毫秒计)。 保持活动消息将在指定时间间隔内发送。 如果从 SIP 容器接收到指定数目的 keepAliveFailures 消息,那么此代理会将容器视为关闭。 然后此代理会将数据路由至备份 SIP 容器直到代理与主容器之间的连接恢复。

第一条保持活动消息包含保持活动消息之间的时间间隔以及将容器视为已关闭前所需的失败数。 应根据高可用性 (HA) 脉动信号配置来指定起始值。

信息
数据类型 整型
缺省值 0

LBIPAddr

指定用于使 SIP 代理负载均衡的负载均衡器的 IP 地址,例如,192.101.1.5。 可配置多个负载均衡器地址,各个 IP 地址间使用分号 (;) 分隔。

当 SIP 代理从指定的 IP 地址接收到带有配置为 SIPAdvisorMethodName 的方法的 SIP 消息时,如果 SIP 代理可以将这些消息转发给 SIP 容器,那么 SIP 代理将返回成功消息。 如果无法将这些消息转发给 SIP 容器,那么 SIP 代理将返回失败消息。 负载均衡器随后将确定是否应将这些消息路由至 SIP 代理。

信息
数据类型 字符串
缺省值 空值

localOutboundTCPAddress

指定建立与备份 SIP 容器的连接时代理所绑定至的源接口。 当代理服务器具有多个地址,并且需要进行配置以使用特定接口向 SIP 容器发送 SIP 流量时,使用此属性。 此属性适用于传输控制协议 (TCP) 和传输层安全性 (TLS) 连接。

信息
数据类型 字符串
缺省值 *

maxForwardsHeaderRequired

指定所有 SIP 请求和响应中是否必须存在 Max-Forwards 头。 Max-Forwards 头用于限制可转发请求的代理或网关数。

SIP 代理要求所有 SIP 请求和响应中必须存在 Max-Forwards 头。 此属性设置为 true(缺省设置)并且请求中未包括 Max-Forwards 头时,SIP 代理会发出警告消息,此消息会向该 SIP 请求发送 400 错误响应。

如果将此定制属性设置为 false,那么不会强制 Max-Forwards 头需求。 即使此属性设置为 false,SIP 代理也会降低此头的值(如果请求中存在此头)。

信息
数据类型 字符串
缺省值

maxViaHeaderPortNumber

使用此属性来指定可用于建立 TCP/TLS 客户机连接的最大有效端口号。

通常,如果 SIP 代理服务器接收到来自应用程序服务器的 SIP 响应,并且该 SIP 代理服务器没有 TCP/TLS 客户机连接,那么该 SIP 代理服务器将使用 VIA 头中指定的端口来创建与客户机的连接。 如果 VIA 中列出的端口无效,那么连接将失败。

如果为此属性指定端口号值,那么当 SIP 代理服务器没有 TCP/TLS 客户机连接时,它将检查 VIA 头中包含的端口是否等于或小于为此属性指定的端口号。
  • 如果该端口号小于或等于为此属性指定的端口号,那么 SIP 代理服务器将使用 VIA 头中指定的端口号来建立 TCP/TLS 客户机连接。
  • 如果该端口号大于为此属性指定的端口号,那么 SIP 代理服务器将使用缺省 SIP 端口 5060 和 5061 来建立 TCP/TLS 客户机连接。
信息
数据类型 整型
缺省值

maxWriteQueueEntries

指定连接很慢或者不能建立连接时可排对等待的消息数。 该值越大,消耗的内存越多。 该值过小会导致端点进行清除时丢失包。

信息
数据类型 整型
缺省值 100000

receiveBufferSizeChannel

指定入局 UDP 包的最大大小的值,以字节计,它也是代理服务器端 UDP 连接中分配的接收缓冲区的大小。

信息
数据类型 整型
缺省值 65535

receiveBufferSizeSocket

指定较低级别数据报缓冲区的值,以字节计,它也是代理服务器端用户数据报协议 (UDP) 连接中 DatagramSocket 接收缓冲区 (SO_RCVBUF) 的大小。

使用此属性来将多个包缓存在 DatagramSocket 层中。 如果此属性的值过小,那么在服务器超负载时就会丢失一些包。 如果该值过大,那么一些包就会延迟。

信息
数据类型 整型
缺省值 1024000

retryAfterValue

指定客户机再次尝试将请求路由至代理服务器前的时间段(以秒计)。 如果 SIP 容器处于超负荷状态,或者如果 SIP 代理找不到路由请求的目标服务器,那么在错误响应中将此定制属性值返回给客户机。

信息
数据类型 整型
缺省值 5

sendBufferSizeSocket

指定较低级别数据报缓冲区的值,以字节计,它也是代理服务器端 UDP 连接中 DatagramSocket 发送缓冲区 (SO_SNDBUF) 的大小。

使用此属性来将多个包缓存在 DatagramSocket 层中。 如果此属性的值过小,那么在服务器超负载时就会丢失一些包。 如果该值过大,那么一些包就会延迟。

信息
数据类型 整型
缺省值 1024000

serverUDPInterface

指定当网络分段时,SIP 代理与 SIP 容器之间的所有通信所需的主机名或 IP 地址。 此接口是进入或退出 SIP 容器的所有 UDP 数据的特定网络接口。 必须将此属性与 serverUDPPort 属性配合使用。

信息
数据类型 字符串
缺省值 *

serverUDPPort

指定用于 SIP 容器通信的 UDP 端口。 当 SIP 代理与 SIP 容器之间存在防火墙时,如果需要特定接口与 SIP 容器通信,或者如果要求特定端口通过防火墙,那么可以设置此值。

信息
数据类型 字符串
缺省值 动态

SIPAdvisorMethodName

指定负载均衡器发送给 SIP 代理以进行运行状况检查的方法的字符串值。

格式为 OPTIONSINFO。 此属性与 LBIPAddr 属性配合使用。

信息
数据类型 字符串
缺省值 空值

sipClusterCellName

指定包含 SIP 容器的集群的实际单元的名称。

sipClusterCellName 定制属性设置为包含已配置 SIP 容器集群的单元的名称

信息
数据类型 字符串
缺省值 此代理所在的单元的名称

startupRetryInterval

这是 SIP 代理在向 SIP 容器重新发送启动消息之前将等待的时间(毫秒)。

startupRetryInterval 定制属性设置为包含已配置 SIP 容器集群的单元的名称

信息
缺省值 4000 毫秒

systemTimePollInterval

指定 SIP 代理进行轮询以读取系统时间的时间间隔(按毫秒计)。

信息
数据类型 整型
缺省值 10 毫秒

tcp.IPSprayer.host

对传输控制协议 (TCP) 包指定 IP Sprayer 的主机名。

信息
数据类型 字符串
缺省值

tcp.IPSprayer.port

对传输控制协议 (TCP) 包指定 IP Sprayer 的端口。

信息
数据类型 字符串
缺省值

tls.IPSprayer.host

对传输层安全性 (TLS) 包指定 IP Sprayer 的主机名。

信息
数据类型 字符串
缺省值

tls.IPSprayer.port

对传输层安全性 (TLS) 包指定 IP Sprayer 的端口。

信息
数据类型 字符串
缺省值

udp.IPSprayer.host

对用户数据报协议 (UDP) 包指定 IP Sprayer 的主机名。

信息
数据类型 字符串
缺省值

udp.IPSprayer.port

对用户数据报协议 (UDP) 包指定 IP Sprayer 的端口。

信息
数据类型 字符串
缺省值

udpLSNFailoverTimeout

指示在相应的应用程序服务器不起作用的情况下,SIP 代理服务器如何处理要发送至特定分区标识的 SIP UDP 请求。

当此属性设置为 true 时,SIP 代理服务器将废弃 UDP 请求长达一定时间。 如果分区标识在此时间段内未故障转移到另一个应用程序服务器,那么 SIP 代理服务器将生成错误响应。

如果未指定此属性,或者此属性设置为 false,那么在相应的应用程序服务器不起作用的情况下,在 SIP 代理服务器中会废弃发送至特定分区标识的 SIP UDP 请求,并且不会生成错误响应。

信息
数据类型 字符串
缺省值

updateStatisticsInterval

指定用于报告 PMI 统计信息的时间(按毫秒计)。

如果值为 0,那么表示在执行 PMI 回调期间报告统计信息。

信息
数据类型 整型
缺省值 0

useExistingOutboundConnection

指定在代理处理 SIP 响应时,如果与客户机的连接中断,那么 SIP 代理是复用现有连接还是可创建新的出站连接。

当此属性设置为 true 时,如果与客户机的连接中断,那么 SIP 代理将始终复用现有出站连接。

当未设置此属性或者设置为 false 时,如果与客户机的连接中断,那么 SIP 代理可以创建新的出站连接,也可以复用现有出站连接。 创建新的出站连接可能会与客户机建立不必要的连接,随着时间推移,这可能会导致“内存不足”错误。

信息
数据类型 字符串
缺省值