SIP 伺服器:組態:一般
使用此頁面可設定 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。如果從容器取消建置登錄為預設 servlet-name 的已建置 Servlet,則也會使用 BlankServlet 名稱。
BlankServlet 的行為是使用 default-behavior 元素設定的。預設情況下,Servlet 會代理所有不相符的要求。不過,如果 default-behavior 元素設定為 "ua" 模式,BlankServlet 會負責對 CANCEL 和 BYE 要求傳回 481 回應,而在所有其他狀況下傳回 500/416 回應。BlankServlet 不會對 ACK 回應,而且會永遠讓應用程式階段作業無效。
MBean 屬性:
SipServerBean.DefaultServletNameT1 逾時間隔 SIP 通訊協定 T1 計時器的持續時間 (毫秒)。
計時器 T1 也會指定計時器 A、E 和 G 的初始值,這些值會控制透過 UDP 之 INVITE 要求和回應的重新傳輸間隔。計時器 T1 會影響計時器 F、H 和 J 的值,這些值會控制 INVITE 回應和要求的重新傳輸間隔;這些計時器設定為 64*T1 毫秒的值。有關 SIP 計時器的詳細資訊,請參閱 SIP 規格。另請參閱組態設定指南中的「設定 NTP 以取得正確的 SIP 計時器」。
如果未設定 T1 逾時值,WebLogic Communications Server 會使用 500 毫秒的 SIP 通訊協定預設值。
MBean 屬性:
SipServerBean.T1TimeoutIntervalT2 逾時間隔 SIP 通訊協定 T2 計時器的持續時間 (毫秒)。
計時器 T2 定義 INVITE 回應和非 INVITE 要求的重新傳輸間隔。有關 SIP 計時器的詳細資訊,請參閱 SIP 規格。另請參閱組態設定中的「設定 NTP 以取得正確的 SIP 計時器」。
如果未設定 T2 逾時值,WebLogic Communications Server 會使用 4 秒的 SIP 通訊協定預設值。
MBean 屬性:
SipServerBean.T2TimeoutIntervalT4 逾時間隔 SIP 通訊協定 T4 計時器的持續時間 (毫秒)。
計時器 T4 會指定訊息留在網路中的最長時間。計時器 T4 也指定計時器 I 和 K 的初始值,這些值會控制透過 UDP 重新傳輸 ACK 和回應的等待時間。有關 SIP 計時器的詳細資訊,請參閱 SIP 規格。另請參閱組態設定指南中的「設定 NTP 以取得正確的 SIP 計時器」。
如果未設定 T4 逾時值,WebLogic Communications Server 會使用 5 秒的 SIP 通訊協定預設值。
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 應用程式階段作業可存留的最長時間 (分鐘)。這個值必須大於或等於每個已建置應用程式的預設階段作業長度。
-1 (預設) 表示 SIP 階段作業存留時間沒有限制。
MBean 屬性:
SipServerBean.MaxApplicationSessionLifetime啟用本機分配 啟用伺服器最佳化,以避免傳送和轉寄訊息期間的不必要網路流量。
啟用時,如果伺服器執行處理需要傳送或轉寄訊息,而訊息目標是引擎層的叢集位址或本機伺服器位址,則訊息會從內部傳送到本機伺服器而非透過網路傳送。
MBean 屬性:
SipServerBean.EnableLocalDispatch預設 SIP 伺服器行為 如果伺服器無法比對內送 SIP 要求與建置的 SIP Servlet,或如果相符的 Servlet 已經失效或逾時,此時所要執行之 WebLogic Communications Server 執行處理的預設行為。
有效值有:
代理主機:作為無狀態代理伺服器。
ua:作為「使用者代理程式」。
如果沒有指定值,預設使用「代理主機」。
作為「使用者代理程式」(UA) 時,WebLogic Communication 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 查詢。
如果您將此屬性設定為 "true",伺服器就可以使用 DNS 執行下列項目:
在要求傳送到 SIP URI 時,尋找代理伺服器的傳輸、IP 位址和連接埠號碼。
根據「傳送者」欄位的內容,在傳送回應期間解析 IP 位址和/或連接埠號碼。
尋找代理主機時,WebLogic Communications Server 只會對每個 SIP 交易使用一次 DNS 解析,以決定傳輸、IP 和連接埠號碼資訊。所有重新傳輸、ACK 或 CANCEL 要求會使用相同的傳輸傳遞到相同的位址。有關 DNS 解析如何進行的詳細資訊,請參閱 RFC 3263:階段作業啟動通訊協定 (SIP):找出 SIP 伺服器。
當代理主機需要傳送回應訊息時,WebLogic Communications Server 會根據「傳送者」欄位和透過標頭提供的資訊,使用 DNS 查詢來決定目標的 IP 位址和/或連接埠號碼。
預設不使用 DNS 解析 ("false")。
注意:因為 DNS 解析在 SIP 訊息處理的相關資訊環境內執行,所以任何 DNS 效能問題都會增加效能延遲。Oracle 建議在生產環境中使用快取 DNS 伺服器,以減少潛在的效能問題。
MBean 屬性:
SipServerBean.EnableDnsSrvLookup啟用呼叫狀態快取 指定引擎是否在本機快取一部分的呼叫狀態資料。
MBean 屬性:
SipServerBean.EngineCallStateCacheEnabled啟用非可靠啟動設定 (1xx) 回應的 Contact 標頭 指定伺服器是否將 Contact 標頭放在有 To 標記的非可靠啟動設定 (1xx) 回應中。
不適用於 100,而可能的值為 true 和 false。
如果您將此屬性設定為 "true",伺服器就會放入 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 的聯絡人包含 "+sip.instance" Contact 標頭欄位參數。收到 GRUU 後,UA 在產生新的要求時,會使用 GRUU 作為 Contact 標頭欄位的 URI。
MBean 屬性:
SipServerBean.GloballyRoutableUri啟用計時器相關性 指定每個計時器是否在其設定所在的引擎上進行處理。
如果此屬性設定為 "true",計時器就會在其建立所在的引擎進行處理。在某些應用程式中這非常重要。如果是 "false",計時器就不會在任何引擎上進行處理。
MBean 屬性:
SipServerBean.EnableTimerAffinity稍後重試值 使用於 5xx 回應之 Retry-After 標頭中的秒數。此值也可以包含參數或原因,例如 "Retry-After: 18000;持續時間=3600" 或 "Retry-After: 120 (開會中)"。
如果未設定此值,WebLogic Communications Server 會使用 180 秒的預設值。
MBean 屬性:
SipServerBean.RetryAfterValue網域別名 伺服器所負責的網域名稱清單。
傳到此清單中網路的訊息會在本機處理而非轉寄。您可以在此清單包括完整網域名稱,或是使用以萬用字元開頭的網域名稱,例如 *.mycompany.com。
MBean 屬性:
SipServerBean.DomainAliasNames對稱回應路由 指定是否針對 WebLogic Communications Server 產生的要求,透過報表參數要求對稱回應路由。
啟用此選項時,如 RFC3581 中定義的對稱回應路由就會生效。
MBean 屬性:
SipServerBean.EnableRport診斷影像傾印層級 指定要記錄在診斷影像檔案中的詳細層級。
「基本」會記錄除了呼叫狀態資料以外的所有可能資料。
「完整」會記錄包括呼叫狀態資料的所有資料。
MBean 屬性:
SipServerBean.ImageDumpLevel過時階段作業處理 內送訊息包含錯誤階段作業 ID 時,所執行的動作。
WebLogic Communications Server 將階段作業和呼叫狀態 ID 編碼為外送 URL,以協助識別回傳訊息中正確的階段作業。下列值決定內送訊息包含錯誤的階段作業 ID 時要進行的動作:
錯誤:以 481 或 404 錯誤回應。
繼續:忽略編碼的 ID 並繼續處理訊息。
刪除:不提示即刪除訊息。
預設動作為「錯誤」。
MBean 屬性:
SipServerBean.StaleSessionHandling