附录 B httpbind.conf 中的 Instant Messaging XMPP/HTTP 网关配置参数
Instant Messaging 在 httpbind.conf 文件中存储 XMPP/HTTP 网关的配置设置。本附录中的以下各节说明配置参数和文件：
任何时候修改 httpbind.conf 文件，您都需要使用 Web 容器或应用服务器提供的工具来重新启动 XMPP/HTTP 网关。
httpbind.conf 文件位置
默认情况下，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 文件语法
httpbind.conf 文件是一个 ASCII 纯文本文件，每行定义一个网关参数及其值：
-
参数及其值用等号 (=) 分隔，等号前后允许有空格和制表符。
-
值可以用双引号 (" ") 括住。如果一个参数允许多个值，则整个值字符串必须用双引号括住。
-
注释行必须以感叹号 (!) 作为第一个字符。注释行是仅供参考的信息，会被服务器忽略。
-
如果某个参数多次出现，则所列最后一个参数的值将覆盖前一个值。
-
反斜杠 (\) 是接续符，表示该值超过一行。
-
每行都用行终止符（\n、 \r 或 \r\n）终止。
-
键由每行中从第一个非空格字符开始到第一个 ASCII 等号 (=) 或分号 (;) 止的所有字符。如果键以分号结束，则其后接有“lang-”和一个表示翻译此值所用语言的标记。语言标记后接等号 (=)。忽略等号前后的所有空白字符。该行的所有剩余字符都成为与值字符串相关的部分。
-
若值字符串含多个值，则用逗号 (,) 分隔。
-
如果值内存在特殊字符（例如：逗号、空格、换行符、制表符、双引号或反斜杠），则必须用双引号括住整个值。此外，值中的每个回车、换行符、制表符、反斜杠和双引号都必须用反斜杠 (\) 指定。
-
如果更改 httpbind.conf，则必须刷新网关的 Web 容器才能使新的配置设置生效。
注 –
httpbind.conf 文件通过 configure 实用程序进行初始化，并且只能如本指南中所述进行修改。
Instant Messaging XMPP/HTTP 网关配置参数
表 B–1 说明 httpbind.conf 中的配置参数。
表 B–1 httpbind.conf 中的 XMPP/HTTP 网关配置参数|
参数 |
默认值 |
说明 |
|---|---|---|
|
httpbind.pool.nodeId |
无 |
如果 httpbind.pool.support 设置为 true，则此参数指定服务器池中服务器节点的完整 URL。此 URL 不应指向负载平衡器，而应指向 Instant Messaging 服务器实例。 |
|
httpbind.pool.support |
false |
此参数定义网关是否位于服务器池部署中。如果没有指定 httpbind.pool.nodeId，则此参数的值设置为 false。 此参数的值可能为：
|
|
httpbind.config |
无 |
包含一个逗号分隔的 ID 键（或 gwdomain-id）列表，网关用它作为配置密钥来确定网关应使用哪些域、主机、主机密码和组件 JID。有关 ID 键的更多信息，参见表 B–2。 |
|
httpbind.content_type |
text/xml; charset=utf-8 |
网关发送响应回应客户机时使用的 content-type HTTP 头的默认值。 |
|
httpbind.hold |
无 |
根据 JEP 124 中的定义，指定客户机请求中的 hold 属性的最大允许值。如果客户机指定的值比请求中的网关高，则将使用网关的值。否则，将使用客户机请求中的值。 |
|
httpbind.inactivity |
180 |
客户机不活动的最长时间（秒），之后网关将终止与客户机的连接。 |
|
httpbind.log4j.config |
无 |
网关将用于日志记录的 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（秒） |
网关发送响应到客户机的默认时间间隔（秒）。如果客户机等待时间设置为高于网关等待时间，则使用网关的等待时间。 |
httpbind.config 的网关域 ID 键参数
表 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 |
用于连接到主机的密码。 |
- © 2010, Oracle Corporation and/or its affiliates