SIP Proxy 伺服器自訂內容

您可以將下列自訂內容新增至「階段作業起始通訊協定 (SIP)」Proxy 伺服器的配置設定中。

如果要指定特定 SIP Proxy 伺服器的自訂內容,請導覽至自訂內容頁面,然後指定自訂內容值。
重要: 在配置的主要方法中,支援這些自訂內容。因此,如果設定了某個自訂內容,然後在管理主控台中設定對應的設定,就會使用這個自訂內容值。
  1. 在管理主控台中,展開伺服器 > 伺服器類型 > Websphere Proxy 伺服器 > server_name 來開啟伺服器的配置標籤。
  2. Proxy 設定之下,展開 SIP Proxy 伺服器設定,然後按一下 SIP Proxy 設定
  3. 在從其他內容之下,選取自訂內容 > 新建
  4. 在配置頁面上的名稱欄位中,輸入您要配置的自訂內容,並在欄位中,輸入該自訂內容的值。
  5. 按一下套用確定
  6. 按一下主控台工作列中的儲存,以儲存配置變更。
  7. 重新啟動伺服器。
SIP Proxy 伺服器自訂內容
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 相符性檢查。

避免困難 避免困難: 如果您是在 z/OS WebSphere Application Server, Network Deployment 環境中執行 Proxy 伺服器,且您的 Proxy 伺服器不是叢集的一部分,您可以利用這個自訂內容來啟用或停用這個 SIP Proxy 伺服器的 SIP 相符性檢查。 不過,如果您執行獨立式應用程式伺服器,或您的 Proxy 伺服器是叢集的一部分,您必須利用 DisSipComplianceEnabledto 通用 JVM 引數來啟用或停用 SIP 相符性檢查。gotcha
資訊
資料類型 字串
預設值 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 伺服器沒有 TCP/TLS 用戶端連線時,它會檢查 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 進行性能檢查之方法的字串值。

格式是 OPTIONSINFO。 這個內容用來搭配 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

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjpx_sippxcustprops
檔名:rjpx_sippxcustprops.html