SIP Proxy 伺服器自訂內容
您可以將下列自訂內容新增至「階段作業起始通訊協定 (SIP)」Proxy 伺服器的配置設定中。
- 在管理主控台中,展開 server_name 來開啟伺服器的配置標籤。
- 在 Proxy 設定之下,展開 SIP Proxy 伺服器設定,然後按一下 SIP Proxy 設定。
- 在從其他內容之下,選取 。
- 在配置頁面上的名稱欄位中,輸入您要配置的自訂內容,並在值欄位中,輸入該自訂內容的值。
- 按一下套用或確定。
- 按一下主控台工作列中的儲存,以儲存配置變更。
- 重新啟動伺服器。
- SIP Proxy 伺服器自訂內容
- 您可以定義產品隨附的下列 SIP Proxy 自訂內容。 Proxy 伺服器的設定頁面不會顯示這些內容。
- contactRegistryEnabled
- defaultTCPChainName
- defaultTLSChainName
- defaultUDPChainName
- enableEnhancedLoadBalancing
- enableMultiClusterRouting
- identityAssertionHeaderRemovalEnabled
- ipForwardingLBEnabled
- lsnLookupFailureResponseCode
- lsnLookupFailureReasonPhrase
- isSipComplianceEnabled
- keepAliveFailures
- keepAliveInterval
- LBIPAddr
- localOutboundTCPAddress
- logCompleteMessages
- maddrParameterEnabled
- maxBackupLogFiles
- maxForwardsHeaderRequired
- maxViaHeaderPortNumber
- maxWriteQueueEntries
- numFailuresSipAdvisorRequests
- receiveBufferSizeChannel
- receiveBufferSizeSocket
- retryAfterValue
- sendBufferSizeSocket
- serverUDPInterface
- serverUDPPort
- SIPAdvisorMethodName
- sipAdvisorRequestTimeout
- sipClusterCellName
- startupRetryInterval
- systemTimePollInterval
- tcp.IPSprayer.host
- tcp.IPSprayer.port
- tls.IPSprayer.host
- tls.IPSprayer.port
- trustedIPAddressList
- udp.IPSprayer.host
- udp.IPSprayer.port
- udpLSNFailoverTimeout
- updateStatisticsInterval
- useExistingOutboundConnection
- SIP Proxy 伺服器超載保護的自訂內容
- 您可以使用下列 SIP Proxy 自訂內容,來套用 Proxy 管理的超載保護 (PMOP)。PMOP 超載設定能夠即時防範儲存器超載。
如需超載控制的相關資訊,請參閱階段作業起始通訊協定超載保護說明文件。
burstResetFactor
指定在給定時間段內,激增的百分比。 這個自訂內容控制平均期間內所發生的激增量。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 100 |
deflatorRatio
指定靜態比例。 只有在指定了轉移期間時,才會在轉移期間使用這個自訂內容。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 0 |
dropOverloadPackets
指定當 SIP 儲存器處於超載狀態時,是否捨棄封包。 當這個值設為 False 時,倘若超載,Proxy 伺服器會回應 503 錯誤,否則,會除去封包。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | False |
inDialogAveragingPeriod
指定內部對話訊息進行平均的時段(秒)。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 180 |
lsnLookupFailureResponseCode
指定 SIP 親緣性要求失敗時的回應碼。 這個自訂內容可讓您置換在親緣性失敗之時,通常預設顯示的 404 錯誤回應。
資訊 | 值 |
---|---|
資料類型 | 整數值是有效的 SIP 回應碼 |
預設值 | 404 |
lsnLookupFailureReasonPhrase
指定 SIP 親緣性要求失敗時要顯示的回應文字。 這個自訂內容可讓您置換在親緣性失敗之時,通常預設顯示的「找不到」錯誤文字。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | 「找不到」 |
maddrParameterEnabled
指定您是否要 SIP Proxy 伺服器使用 VIA 標頭中的 maddr 參數來決定要在何處遞送 SIP 回應。如果這個內容設為 true,SIP Proxy 伺服器會使用 maddr 參數來決定要在何處遞送回應。如果未指定這個內容的值,或是這個內容設為 false,SIP Proxy 伺服器不會使用 maddr 參數來決定要在何處遞送回應。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | false |
maxBackupLogFiles
指定您要 SIP Proxy 伺服器保留的歷程 sipproxy.log 檔數目。依預設,SIP Proxy 伺服器只保留一個歷程 sipproxy.log 檔。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 1 |
logCompleteMessages
指定當在 SIP Proxy 伺服器上啟用存取記載時,是否記載完整 SIP 訊息,但不記載基於安全原因而隱藏的任何標頭。 依預設,只會記載一部分的 SIP 標頭。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | False |
maxThroughputFactor
指定所設定的每一平均期間的訊息數目上限百分比。 如果這個值設為 0,就會停用傳輸量上限功能。 這個自訂內容用來計算在 Proxy 伺服器開始拒絕對於新階段作業的要求之前,每秒所接受的訊息數目上限。 每個 Proxy 伺服器的這個自訂內容都應該設為相同的值。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 0 |
numFailuresSipAdvisorRequests
指出遺漏多少 SIP 顧問要求之後,SIP Proxy 就認為它沒有在處理任何資料。 當使用這個自訂內容時,SIP Proxy 會注意到接收負載平衡器顧問要求失敗。
如果您使用這個自訂內容,請考慮將它的值設為 3。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 無預設值 - 除非您指定了某個值,否則,不會啟用這個內容。 |
outDialogAveragingPeriod
指定外部對話訊息進行平均的時段(秒)。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 360 |
overloadResponseCode
指定發生超載而拒絕儲存器所發出的 SIP 要求時,Proxy 傳回的回應碼值。 當 Proxy 配置了超載保護時,可以配置 SIP Proxy 來偵測超載狀態。 Proxy 會監視在 Proxy 處理的傳輸量,且會限制新要求的數目。 如果儲存器超載,Proxy 會拒絕要求,並傳回 503 回應碼。 如果偏好在超載保護上使用另一個回應碼,您可以配置這個自訂內容來傳回另一個回應碼。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 503 |
overloadResponseReasonPhrase
指定發生超載而拒絕儲存器所發出的 SIP 要求時,Proxy 伺服器所發出的回應原因詞組。 當 Proxy 配置了超載保護時,可以配置 SIP Proxy 來偵測超載狀態。 Proxy 會監視在 Proxy 處理的傳輸量,且會限制新要求的數目。 如果儲存器超載,Proxy 會拒絕要求,並傳回「無法提供服務」這個回應詞組。 如果偏好使用另一個回應詞組,您可以配置這個自訂內容來傳回另一個回應詞組。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | 無法提供服務 |
perSecondBurstFactor
指定定期允許的激增百分比 (BTF)。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 150 |
proxyTransitionPeriod
指定在儲存器關閉之後,鎖定 deflator 的時段(秒)。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 0 |
sipAdvisorRequestTimeout
指定 SIP Proxy 伺服器等待 Load Balancer 傳回 DNS 查閱的時間量(毫秒)。
如果沒有指定這個自訂內容的值,SIP Proxy 伺服器會等待 2 秒。
指定 0 值時,會停用 DNS 查閱的監視作業。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 3000 毫秒 |
sipProxyStartupDelay
指定 Proxy 伺服器重新啟動之前的時段(秒),以便 Proxy 在叢集內能夠穩定,且避免出現錯誤的超載狀態。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 0 |
trustedIPAddressList
指定冒號定界的 IP 位址清單,以便能夠從其中傳送含有 p-asserted 身分標頭的訊息來通過 WebSphere Application Server 的 SIP Proxy 伺服器。 如果訊息含有 p-asserted 身分標頭,但來源 IP 位址不是這份 IP 位址清單,就會移除這個標頭。
這必須是一份特定 IP 位址的清單,例如 192.168.0.1。
從這個服務版本開始,自訂內容需要分號定界的清單。 另外,您也可以指定一個 IP 位址範圍,例如 192.168.0.*,而不是含有特定 IP 位址的清單。
資訊 | 值 |
---|---|
資料類型 | IP 位址數值清單 |
預設值 | 無 |
contactRegistryEnabled
指定 SIP Proxy 伺服器的停止與關閉程度。將 contactRegistryEnabled 設為 false,可讓 SIP Proxy 伺服器在關閉時略過使用聯絡登錄。如果 contactRegistryEnabled 設為 true(預設值),SIP Proxy 伺服器將耗費長時間來更新其 TCP/TLS 遞送表。當 SIP Proxy 伺服器停止時,如果它正在管理大量連線,則關閉程序可能需要好一陣子才能完成。將 contactRegistryEnabled 設為 false,可加快關閉。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | True |
defaultTCPChainName
指定未呼叫 setOutboundInterface 之時,所用的預設 TCP 鏈接名稱。 如果您在多網路環境中,使用「具備通訊功能的應用程式 (CEA) 特性套件」中的 Web 協同作業特性,您必須適當設定這個變數,以便在遞送資料時,Web 協同作業元件能夠挑選適當的介面。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | 無 |
defaultTLSChainName
指定未呼叫 setOutboundInterface 之時,所用的預設 TLS 鏈接名稱。 如果您在多網路環境中,使用「具備通訊功能的應用程式 (CEA) 特性套件」中的 Web 協同作業特性,您必須適當設定這個變數,以便在遞送資料時,Web 協同作業元件能夠挑選適當的介面。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | True |
defaultUDPChainName
指定未呼叫 setOutboundInterface 之時,所用的預設 UDP 鏈接名稱。 如果您在多網路環境中,使用「具備通訊功能的應用程式 (CEA) 特性套件」中的 Web 協同作業特性,您必須適當設定這個變數,以便在遞送資料時,Web 協同作業元件能夠挑選適當的介面。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | 無 |
enableEnhancedLoadBalancing
指定是否啟用應用程式伺服器的負載平衡。
當使用 WebSphere Application Server SIP Proxy 時,使用者可能發現後端應用程式伺服器的負載不平衡。如果後端應用程式伺服器超過 10 部,問題似乎會更糟。將 enableEnhancedLoadBalancing 設為 true 時,新的負載平衡演算法會以更適當的方式來處理不平衡的負載。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | False |
enableMultiClusterRouting
指定是否要容許將含有無效路由資訊的封包灑向後端 SIP 儲存器。 如果要確保含有無效路由資訊的封包會灑向後端 SIP 儲存器,請將這個內容設為 true。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | false |
identityAssertionHeaderRemovalEnabled
指定在從 SIP Proxy 到 SIP 儲存器的 SIP 要求中,所有與身分主張相關的標頭都應該移除。 如果您將這個內容設為 false,要求之中會保留與身分主張相關的標頭。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | true |
ipForwardingLBEnabled
請使用這個內容,並將它設為 true,當 SIP Proxy 前面有「IP 轉遞」Load Balancer 時,SIP Proxy 會將 Load Balancer 的 IP 位址傳送給後端應用程式伺服器。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | false |
isSipComplianceEnabled
指定是否在 SIP Proxy 伺服器中啟用 SIP 相符性檢查。 SIP 相符性檢查可確保 SIP 訊息會符合「階段作業起始通訊協定」標準。 當這個內容設為 true 時,會啟用 SIP 相符性檢查。

資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | true |
keepAliveFailures
指定遺漏多少保持作用中的訊息之後,Proxy 就判定含有 SIP 儲存器的連線已經當掉。
在每個 keepAliveInterval 之時,Proxy 都會向儲存器傳送一則保持作用中訊息。 如果 Proxy 沒有收到訊息回應,它會將沒有回應視為失敗。 如果 Proxy 收到特定數量的連續失敗,它會認為儲存器已當掉,並開始將訊息轉遞到不同的 SIP 儲存器。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 0 |
keepAliveInterval
指定向 SIP 儲存器傳送保持作用中訊息的間隔(毫秒)。 保持作用中訊息會按照指定的間隔來傳送。 如果收到 SIP 儲存器的指定數量的 keepAliveFailures 訊息,Proxy 會將儲存器視為已經當掉。 之後,Proxy 會將資料遞送到備份的 SIP 儲存器,直到 Proxy 和主要儲存器之間的連線還原。
第一個保持作用中訊息包含各保持作用中訊息之間的時間間隔,以及將儲存器視為已當掉所需經歷的失敗次數。 起始值應該根據高可用性 (HA) 活動訊號配置來指定。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 0 |
LBIPAddr
指定用來進行 SIP Proxy 負載平衡之負載平衡器的 IP 位址,如 192.101.1.5。 您可以用分號 (;) 來區隔每個 IP 位址,以配置多重負載平衡器位址。
當 SIP Proxy 從指定的 IP 位址收到方法配置為 SIPAdvisorMethodName 的 SIP 訊息時,如果 SIP Proxy 能夠將訊息轉遞到 SIP 儲存器,SIP Proxy 會回應一則成功訊息。 如果訊息無法轉遞到 SIP 儲存器,SIP Proxy 會回應一則失敗訊息。 之後,負載平衡器會判斷是否應該將訊息遞送到 SIP Proxy。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | 空值 |
localOutboundTCPAddress
指定建立連線來通往後端 SIP 儲存器時,Proxy 所連結的來源介面。 當您的 Proxy 伺服器為多網卡環境,且需要配置成利用特定介面來傳送 SIP 資料流量到 SIP 儲存器時,便使用這個內容。 這個內容適用於「傳輸控制通訊協定 (TCP)」和「傳輸層安全 (TLS)」連線。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | * |
maxForwardsHeaderRequired
指定 Max-Forwards 標頭是否必須出現在所有 SIP 要求和回應中。 Max-Forwards 標頭用來限制能夠轉遞要求的 Proxy 或閘道的數目。
SIP Proxy 需要所有 SIP 要求和回應都含有 Max-Forwards 標頭。 當這個內容設為預設值 true,而要求未包含 Max-Forwards 標頭時,SIP Proxy 會發出一則警告訊息來傳送這個 SIP 要求的 400 錯誤回應。
如果您將這個自訂內容設為 false,就不會強制 Max-Forwards 標頭需求。 即使這個內容設為 false,如果要求含有這個標頭,SIP Proxy 也會將這個標頭值降低。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | true |
maxViaHeaderPortNumber
請利用這個內容來指定可用來建立 TCP/TLS 用戶端連線的最高有效埠號。
一般而言,如果 SIP Proxy 伺服器接收來自應用程式伺服器的 SIP 回應,但是 SIP Proxy 伺服器沒有 TCP/TLS 用戶端連線,則 SIP Proxy 伺服器會使用 VIA 標頭中所指定的埠來建立連線至用戶端。如果 VIA 中列出的埠無效,連線即失敗。
- 如果埠號等於或小於指定給這個內容的埠號,SIP Proxy 伺服器即使用 VIA 標頭中所指定的埠號來建立 TCP/TLS 用戶端連線。
- 如果埠號大於指定給這個內容的埠號,SIP Proxy 伺服器會使用預設 SIP 埠 5060 和 5061 來建立 TCP/TLS 用戶端連線。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 無 |
maxWriteQueueEntries
指定連線太慢或無法建立連線時,能夠放在佇列中的訊息數目。 如果這個值的數目很大,耗用的記憶體也就越多。 如果數目很小,當端點清除時,會造成封包遺失。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 100000 |
receiveBufferSizeChannel
指定送入 UDP 封包的大小上限值(位元組),也就是 Proxy 伺服器端 UDP 連線所配置的接收緩衝區的大小。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 65535 |
receiveBufferSizeSocket
指定較低層資料包緩衝區的值(位元組),這是在 Proxy 伺服器端「使用者資料封包通訊協定 (UDP)」連線中 DatagramSocket 接收緩衝區 (SO_RCVBUF) 的大小。
請利用這個內容來緩衝 DatagramSocket 層內的多重封包。 如果內容值太小,在伺服器超載時,會遺失封包。 如果值太大,封包可能會延遲。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 1024000 |
retryAfterValue
指定過了多久(秒)之後,用戶端就重新嘗試將要求遞送到 Proxy 伺服器。 如果 SIP 儲存器超載,或 SIP Proxy 找不到要求所要送往的伺服器,就會在錯誤回應中,將這個自訂內容值傳回給用戶端。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 5 |
sendBufferSizeSocket
指定較低層資料包緩衝區的值(位元組),這是在 Proxy 伺服器端 UDP 連線中 DatagramSocket 傳送緩衝區 (SO_SNDBUF) 的大小。
請利用這個內容來緩衝 DatagramSocket 層內的多重封包。 如果內容值太小,在伺服器超載時,會遺失封包。 如果值太大,封包可能會延遲。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 1024000 |
serverUDPInterface
指定在網路分段時,SIP Proxy 和 SIP 儲存器之間的所有通訊所用的主機名稱或 IP 位址。 這個介面是進入或離開 SIP 儲存器時,所有 UDP 資料的特定網路介面。 您必須搭配 serverUDPPort 內容來使用這個內容。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | * |
serverUDPPort
指定 SIP 儲存器通訊所用的 UDP 埠。 當防火牆是在 SIP Proxy 和 SIP 儲存器之間,如果需要特定介面來與 SIP 儲存器通訊,或需要特定埠來通過防火牆,您可以設定這個值。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | 動態 |
SIPAdvisorMethodName
指定負載平衡器傳給 SIP Proxy 進行性能檢查之方法的字串值。
格式是 OPTIONS 或 INFO。 這個內容用來搭配 LBIPAddr 內容。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | 空值 |
sipClusterCellName
指定包含 SIP 儲存器叢集的實際 Cell 名稱。
將 sipClusterCellName 自訂內容設為配置的 SIP 儲存器叢集所在的 Cell 名稱。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | Proxy 所在的 Cell 名稱 |
startupRetryInterval
這是 SIP Proxy 在重送啟動訊息給「SIP 儲存器」之前,要等待的時間量(毫秒)。
將 startupRetryInterval 自訂內容設為含有所配置的 SIP 儲存器叢集的 Cell 名稱。
資訊 | 值 |
---|---|
預設值 | 4000 毫秒 |
systemTimePollInterval
針對 SIP Proxy 輪詢讀取系統時間的頻率,指定時間間隔(毫秒)。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 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 Proxy 伺服器如何處理要傳送至特定分割區 ID 的 SIP UDP 要求。
當這個內容設為 true 時,SIP Proxy 伺服器會捨棄 UDP 要求長達一段時間。如果分割區 ID 在這段期間沒有交由另一個應用程式伺服器失效接手,SIP Proxy 伺服器會產生錯誤回應。
如果沒有指定這個內容,或者這個內容設為 false,當對應的應用程式伺服器無法運作時,SIP Proxy 伺服器中會捨棄傳送至特定分割區 ID 的 SIP UDP 要求,且不會產生錯誤回應。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | false |
updateStatisticsInterval
指定用來報告 PMI 統計資料的時間量(毫秒)。
0 值表示在 PMI 回呼期間報告統計資料。
資訊 | 值 |
---|---|
資料類型 | 整數 |
預設值 | 0 |
useExistingOutboundConnection
指定在 Proxy 處理 SIP 回應期間,如果用戶端連線中斷,則 SIP Proxy 要重複使用現有的連線,或是要建立新的出埠連線。
當這個內容設為 true 時,如果與用戶端的連線中斷,SIP Proxy 一律會重複使用現有的出埠連線。
如果未設定這個內容,或者設為 false,當用戶端連線中斷時,SIP Proxy 可以建立新的出埠連線,也可以重複使用現有的出埠連線。一旦建立新的出埠連線,不必要的用戶端連線可能維持開啟,隨著時間推移可能會導致「記憶體不足」錯誤。
資訊 | 值 |
---|---|
資料類型 | 字串 |
預設值 | false |