Instant Messaging 將 XMPP/HTTP 閘道的配置設定儲存在 httpbind.conf 檔案中。此附錄的以下章節描述配置參數和檔案:
只要您修改 httpbind.conf 檔案,您必須使用您的 Web 容器或應用程伺服器提供的工具重新啟動 XMPP/HTTP 閘道。
根據預設,configure 公用程式會在預設伺服器例項的「配置目錄」(im-cfg-base) 內建立 httpbind.conf 檔案,例如:
Solaris:
/etc/opt/SUNWiim/default/config/httpbind.conf
Linux:
/etc/opt/sun/im/default/config/httpbind.conf
如果您已建立多個 Instant Messaging 的實例,/default 目錄的名稱會隨著實例改變。如需詳細資訊,請參閱從單次 Instant Messaging 安裝中建立多個實例。configure 公用程式只會在預設實例的 im-cfg-base 目錄中建立此檔案。
httpbind.conf 檔案是 ASCII 純文字檔案,其中的每一行定義了閘道參數及其值:
參數及其值是由等號 (=) 分隔,等號之前或之後可以允許包含空格與標籤。
數值可以用雙引號 (" ") 括起。如果參數允許多值,則必須將整個值字串以雙引號括起。
註釋行必須要以驚嘆號 (!) 作為一行的第一個字元。註釋行是作為提供資訊之用,而且會被伺服器所忽略。
如果參數出現不只一次,則列出的最後參數值將會覆蓋先前的值。
反斜線 (\) 是用於接續後面內容,並指出值的內容超過一行。
每行會終止於行終止符號 (\n、\r 或 \r\\n)。
鍵值包含行中開頭為第一個非空格字元到第一個 ASCII 等號 (=) 或分號 (;) 的所有字元。 如果該鍵值以分號結束,則鍵值之後會是「lang-」和指定解譯此值所使用語言的標記。語言標記後面會接著等號 (=)。所有等號之前或之後的空白字元將會被忽略。行中所有剩餘的字元將會變為相關值字串的一部份。
值字串中的多重值會使用逗號 (,) 分隔。
如果值內有任何特殊字元,如逗號、空格、新行、定位字元、雙引號或反斜線,那麼整個值必須前後加上雙引號。此外,每個值中的換行鍵、返回字元、定位字元、反斜線和雙引號必須以反斜線 (\) 指定。
如果您變更 httpbind.conf,則必須重新整理閘道的 Web 容器,讓新的配置設定生效。
httpbind.conf 檔案是由 configure 公用程式初始化,並僅應根據本指南所述修改。
表 B–1 描述 httpbind.conf 中的配置參數。
表 B–1 httpbind.conf 中的 XMPP/HTTP 閘道配置參數
參數 |
預設值 |
說明 |
---|---|---|
httpbind.pool.nodeId |
N/A |
如果 httpbind.pool.support 設為 true,此參數為伺服器池中的伺服器節點指定完整的 URL。此 URL 不應指向負載平衡器,而應指向 Instant Messaging 伺服器實例。 |
httpbind.pool.support |
false |
此參數定義閘道是否在伺服器池部署中。如果未指定 httpbind.pool.nodeId,則此參數值會設為 false。 此參數的值可以是:
|
httpbind.config |
N/A |
包含閘道可做為配置鍵值的 ID 鍵值清單 (以逗號分隔),或 gwdomain-id,以決定閘道應使用哪一些網域、主機、主機密碼和元件 JID。如需 ID 鍵值的詳細資訊,請參閱表 B–2。 |
httpbind.content_type |
text/xml; charset=utf-8 |
content-type HTTP 標頭的預設值,當閘道將回應傳回用戶端時會使用此預設值。 |
httpbind.hold |
N/A |
根據 JEP 124 中的定義,指定用戶端請求中 hold 屬性的最大允許值。 如果用戶端指定的值高於請求中的閘道,將使用閘道值。否則,將使用用戶端請求中的值。 |
httpbind.inactivity |
180 |
用戶端非使用中的最長時間 (以秒為單位),閘道在這段時間之後會終止用戶端連線。 |
httpbind.log4j.config |
N/A |
閘道將用於記錄的 log4j 配置檔的位置。如果您將此值保留為空白,則會關閉閘道的記錄。記錄程式的名稱為「httpbind」(log4j.logger.httpbind)。 |
httpbind.polling |
1 (秒) |
用戶端在傳送另一個請求前必須等待的最小時間 (以秒為單位)。 |
httpbind.requests |
2 |
用戶端可向閘道同步運作請求的數目。如果此參數的值小於用戶端請求中 JEP 124 hold 屬性的值,此參數值將設為 hold+1。不要將此值設定為 1,因為如此會使效能嚴重降低。如需詳細資訊,請參? httpbind.hold。 |
httpbind.round_trip_delay |
1 (秒) |
往返的逾時之外所允許視為網路延遲的額外時間長度 (以秒為單位)。此值設定過高會使效能降低。 |
httpbind.wait_time |
120 (秒) |
預設的時間秒數,閘道會在這段時間內將回應傳送到用戶端。如果用戶端等待時間設定的值高於閘道等待時間,則使用閘道的等待時間。 |
表 B–2 描述用於定義 httpbind.config 參數中每個 ID 的鍵值。表 gwdomain-id 中所述的每個鍵值為 httpbind.config 中指定的網域識別碼。
表 B–2 httpbind.config ID 鍵值
鍵值 |
說明 |
---|---|
gwdomain-id.domains |
此 ID 的網域清單,以逗號分隔。 |
gwdomain-id.hosts |
此 ID 的主機清單,以空格分隔。每個主機均必須能夠服務 gwdomain-id .domains 中所列的網域。此清單協助在網域之間提供容錯移轉。如果請求中未提及明確的路由主機,則此鍵值中所列的其中一個主機將用於服務該請求。 |
gwdomain-id.componentjid |
用於連線主機的元件 JID。 |
gwdomain-id.password |
用於連線主機的密碼。 |