Sun Java logo     上一页      目录      索引      下一页     

Sun logo
Sun Java System Message Queue 3 2005Q1 管理指南 

第 14 章
代理属性参考

本章列出并说明了代理配置属性。第一节是按字母顺序列出的所有代理属性的列表以及包含完整说明的小节参考。所有其他小节均按功能对代理属性进行分组,并提供这些属性的完整说明。

本章包含以下小节:

在说明表格中,将可以使用 imqcmd update bkr 命令进行设置的属性做了标记。


按字母顺序排列的属性列表

表 14-1 是一个按字母顺序排列的代理实例属性列表。可以使用它确定任何属性的类别,然后使用类别说明来查找位于本章其他地方的完整属性说明。

在本表格中,左侧列按字母顺序列出了各个属性。右侧列显示了该属性所属的类别,并提供了到相应小节的交叉参考。

表 14-1 代理实例配置属性 

属性名称

参考

imq.accesscontrol.enabled

安全性管理器属性

imq.accesscontrol.file.filename

安全性管理器属性

imq.audit.enabled

安全性管理器属性

imq.authentication.basic.user_repository

安全性管理器属性

imq.authentication.client.response.timeout

安全性管理器属性

imq.authentication.type

安全性管理器属性

imq.autocreate.destination.isLocalOnly

自动创建配置属性

imq.autocreate.destination.limitBehavior

自动创建配置属性

imq.autocreate.destination.maxBytesPerMsg

自动创建配置属性

imq.autocreate.destination.maxNumMsgs

自动创建配置属性

imq.autocreate.destination.maxNumProducers

自动创建配置属性

imq.autocreate.destination.maxTotalMsgBytes

自动创建配置属性

imq.autocreate.destination.useDMQ

自动创建配置属性

imq.autocreate.queue

自动创建配置属性

imq.autocreate.queue.consumerFlowLimit

自动创建配置属性

imq.autocreate.queue.localDeliveryPreferred

自动创建配置属性

imq.autocreate.queue.maxNumActiveConsumers

自动创建配置属性

imq.autocreate.queue.maxNumBackupConsumers

自动创建配置属性

imq.autocreate.topic

自动创建配置属性

imq.autocreate.topic.consumerFlowLimit

自动创建配置属性

imq.cluster.property_name

群集配置属性

imq.destination.DMQ.truncateBody

消息路由器属性

imq.destination.logDeadMsgs

监视和日志记录属性

imq.hostname

连接服务属性

imq.httpjms.http.property_name

表 C-3

imq.httpsjms.https.property_name

表 C-3

imq.imqcmd.password

安全性管理器属性

imq.keystore.property_name

安全性管理器属性

imq.log.console.output

监视服务属性

imq.log.console.stream

监视服务属性

imq.log.file.dirpath

监视服务属性

imq.log.file.filename

监视服务属性

imq.log.file.output

监视服务属性

imq.log.file.rolloverbytes

监视服务属性

imq.log.file.rolloversecs

监视服务属性

imq.log.level

监视服务属性

imq.log.syslog.facility

监视服务属性

imq.log.syslog.identity

监视服务属性

imq.log.syslog.logconsole

监视服务属性

imq.log.syslog.logpid

监视服务属性

imq.log.syslog.output

监视服务属性

imq.log.timezone

监视服务属性

imq.message.expiration.interval

消息路由器属性

imq.message.max_size

消息路由器属性

imq.metrics.enabled

消息路由器属性

imq.metrics.interval

消息路由器属性

imq.metrics.topic.enabled

消息路由器属性

imq.metrics.topic.interval

消息路由器属性

imq.metrics.topic.persist

消息路由器属性

imq.metrics.topic.timetolive

监视服务属性

imq.passfile.dirpath

安全性管理器属性

imq.passfile.enabled

安全性管理器属性

imq.passfile.name

安全性管理器属性

imq.persist.file.destination.message.
filepool.limit

基于文件的持久性的属性

imq.persist.file.message.cleanup

消息路由器属性

imq.persist.file.message.filepool.cleanratio

消息路由器属性

imq.persist.file.message.max_record_size

消息路由器属性

imq.persist.file.sync.enabled

基于文件的持久性的属性

imq.persist.jdbc.property_name

持久性管理器属性

imq.persist.store

消息路由器属性

imq.ping.interval

连接服务属性

imq.portmapper.backlog

连接服务属性

imq.portmapper.hostname

连接服务属性

imq.portmapper.port

连接服务属性

imq.resource_state.count

消息路由器属性

imq.resource_state.threshold

消息路由器属性

imq.service.activelist

连接服务属性

imq.service_name.accesscontrol.enabled

安全性管理器属性

imq.service_name.accesscontrol.file.filename

安全性管理器属性

imq.service_name.authentication.type

安全性管理器属性

imq.service_name.max_threads

连接服务属性

imq.service_name.min_threads

连接服务属性

imq.service_name.protocol_type.hostname

连接服务属性

imq.service_name.protocol_type.port

连接服务属性

imq.service_name.threadpool_model

连接服务属性

imq.shared.connectionMonitor_limit

连接服务属性

imq.system.max_count

消息路由器属性

imq.system.max_size

消息路由器属性

imq.transaction.autorollback

消息路由器属性

imq.user_repository.ldap.property_name

安全性管理器属性


连接服务属性

表 14-2 列出了连接服务属性。第一列列出了属性名称。对于每个属性名称,第二列对该属性进行了说明;第三列指定了其类型;而第四列则给出了其默认值。

表 14-2 连接服务属性

属性名称

说明

类型

默认值

imq.service.activelist

按名称列出的启动代理时将变为活动状态的连接服务列表,服务之间以逗号分隔。支持的服务包括:jmsssljmshttpjmshttpsjmsadminssladmin

列表

jms、admin

imq.ping.interval

代理通过连接连续尝试 ping Message Queue 客户机运行时的时间周期(以秒为单位)。

整数

120

imq.hostname

当有多个主机可用(例如,一台计算机中安装了多个网络接口卡)时所有连接服务将绑定到的主机(主机名或 IP 地址)。

字符串

全部可用 IP 地址

imq.portmapper.port1

代理的主端口,即端口映射器所在的端口。如果主机上运行多个代理实例,则必须为每个实例分配唯一的端口映射器端口。

整数

7676

imq.portmapper.hostname

当有多个主机可用(例如,一台计算机中安装了多个网络接口卡)时端口映射器将绑定到的主机(主机名或 IP 地址)。

字符串


imq.hostname 继承

imq.portmapper.backlog

端口映射器在拒绝请求之前可处理的并发请求的最大数量。该属性设置了可存储在操作系统待办事项中等待端口映射器处理的请求的数量。

整数

50

imq.service_name.
protocol_type2.port

仅适用于 jms、ssljms、admin 和 ssladmin 服务,命名的连接服务的端口号。

要配置 httpjms 和 httpsjms 连接服务,请参见附录 C“HTTP/HTTPS 支持”

整数

0(零)

端口是由端口映射器动态分配的。

imq.service_name.
protocol_type2.hostname

仅适用于 jms、ssljms、admin 和 ssladmin 服务,当有多个主机可用(例如,一台计算机中安装了多个网络接口卡)时命名的连接服务将绑定到的主机(主机名或 IP 地址)。

字符串


imq.hostname 继承

imq.service_name.
min_threads

线程数量,达到该数量后,线程池中将维护此数量的线程供命名的连接服务使用。

默认值随连接服务的不同而有所变化。

整数

10 (jms)

10 (ssljms)

10 (httpjms)

10 (httpsjms)

4 (admin)

4 (ssladmin)

imq.service_name.
max_threads

线程数量,达到该数量后,新的线程将不会被添加到线程池中供命名的连接服务使用。该数量必须大于零,并且必须大于 min_threads 的值。

默认值随连接服务的不同而有所变化。

整数

1000 (jms)

500 (ssljms)

500 (httpjms)

500 (httpsjms)

10 (admin)

10 (ssladmin)

imq.service_name.
threadpool_model

一个字符串,指定线程是专用于特定的连接 (dedicated),还是根据命名的连接服务的需要由多个连接共享 (shared)。共享模型(线程池管理)将增加代理支持的连接数量,但只能用于 jmsadmin 连接服务。

默认值随连接服务的不同而有所变化。

字符串

dedicated (jms)

dedicated (ssljms)

dedicated (httpjms)

dedicated (httpsjms)

dedicated (admin)

dedicated (ssladmin)

imq.shared.
connectionMonitor_limit

仅适用于共享线程池模型,分配器线程可监视的连接的最大数量。(系统会分配足够多的分配器线程来监视所有连接。)此值越小,系统向线程分配活动连接的速度就越快。值 -1 表示没有限制。

默认值随操作系统的不同而有所变化。

整数

512(Solaris 和 Linux)

64 (Windows)

1此属性可用于 imqcmd update bkr 命令。

2protocol_type表 4-2 中指定的协议类型。


消息路由器属性

表 14-3 列出了消息路由器属性。第一列列出了属性名称。对于每个属性名称,第二列对该属性进行了说明;第三列指定了其类型;而第四列则给出了其默认值。

表 14-4 中列出了用来配置消息服务器自动创建目标功能的自动创建属性。

表 14-3 消息路由器属性

属性名称

说明

类型

默认值

imq.destination.
DMQ.truncateBody1

一个布尔值,指定在将消息存储到停用消息队列中之前代理是否删除消息主体。当值为 true 时,代理只保存消息标题和属性数据。当值为 false 时,代理保存标题和主体。

布尔值

false

imq.message.
expiration.interval

发生过期消息回收的时间间隔(以秒为单位)。

整数

60

imq.system.max_count1

代理保留的消息的最大数量。附加消息将被拒绝。值 -1 表示没有限制。

整数

-1

imq.system.max_size1

代理保留的消息总大小的最大值(以字节、千字节或兆字节为单位)。附加消息将被拒绝。值 -1 表示没有限制。

字节字符串2

-1

imq.message.max_size1

允许的消息主体大小的最大值(以字节、千字节或兆字节为单位)。任何大于此值的消息将被拒绝。值 -1 表示没有限制。

字节字符串2

70m

imq.resource_state.
threshold

将触发各个内存资源状态的内存占用百分比。资源状态的值可以是 greenyelloworangered

整数
(百分比)

0 (green)

80 (yellow)

90(orange)

98 (red)

imq.resource_state.count

在检查系统内存查看是否达到新的内存阈值之前,允许同时处理的一批外来消息的最大数量。当系统内存愈加不足时,此限制可限制消息的生产方。

整数
(百分比)

5000 (green)

500 (yellow)

50(orange)

0 (red)

imq.transaction.
autorollback

一个布尔值,指定当启动代理时,是否自动回滚处于 PREPARED 状态的分布式事务。如果为 false,则必须使用 imqcmd 手动提交或回滚事务(请参见管理事务)。

布尔值

false

1此属性可用于 imqcmd update bkr 命令。

2能够以字节、千字节和兆字节的形式来表示作为字节字符串键入的值:例如:1000 表示 1000 字节;7500b 表示 7500 字节;77k 表示 77 千字节(77 x 1024 = 78848 字节);17m 表示 17 兆字节(17 x 1024 x 1024 = 17825792 字节)

表 14-4 列出了自动创建目标时代理使用的属性。

表 14-4 自动创建配置属性

属性名称

说明

类型

默认值

imq.autocreate.destination.
isLocalOnly

(仅适用于代理群集。)一个布尔值,指定目标不能在其他代理上复制,因而将消息传送限制为本地使用方(连接到创建目标的代理的使用方)。在创建目标之后此属性无法更新。

布尔值

false

imq.autocreate.destination.
limitBehavior

一个字符串,指定当达到内存限制的阈值时代理响应的方式。允许的值为:

  • FLOW_CONTROL——减慢生产方。
  • REMOVE_OLDEST——丢弃最旧的消息。
  • REMOVE_LOW_PRIORITY——根据消息的生存期丢弃优先级最低的消息。
  • REJECT_NEWEST——拒绝最新的消息。生产方客户机仅收到拒绝持久性消息的异常。要将此限制行为用于非持久性消息,请设置 imqAckOnProduce 连接工厂属性。

如果将此属性设置为 REMOVE_OLDESTREMOVE_LOW_PRIORITY,并将 imq.autocreate.destination.useDMQ 设置为 true,代理将把超出限制的消息移动到停用消息队列中。

字符串

REJECT
NEWEST

imq.autocreate.destination.
maxBytesPerMsg

自动创建的目标中允许的任何单个消息大小的最大值(以字节为单位)。值 -1 表示消息大小是无限的。

字节字符串1

10k

imq.autocreate.destination.
maxNumMsgs

自动创建的目标中允许的未使用消息的最大数量。值 -1 表示数量是无限的。

整数

100,000

imq.autocreate.destination.
maxNumProducers

目标允许的生产方的最大数量。当达到此限制时,将无法创建新的生产方。值 -1 表示生产方数量是无限的。

整数

100

imq.autocreate.destination.
maxTotalMsgBytes

目标中允许未使用消息占用的内存的最大总量(以字节为单位)。值 -1 表示内存是无限的。

字节字符串2

10m

imq.autocreate.destination.
useDMQ

一个布尔值,指定代理是否将自动创建目标的停用消息移动到停用消息队列中。

布尔值

true

imq.autocreate.queue2

一个布尔值,指定是否允许代理自动创建队列目标。

布尔值

true

imq.autocreate.queue.
consumerFlowLimit

将要在一批中传送给使用方的消息的最大数量。在负荷平衡队列传送中,为负荷平衡开始之前路由至活动使用方的队列消息的初始数量。可以使用为相应连接中的目标使用方设置的较小值来覆盖此限制。值为 -1 表示不限制数量。

整数

1000

imq.autocreate.queue.
localDeliveryPreferred

(仅应用于代理群集中的负荷平衡队列传送。)一个布尔值,指定仅当在本地代理中没有使用方时才将消息传送到远程的使用方。要求未将自动创建的目标限制为仅本地传送 (isLocalOnly = false)。

布尔值

false

imq.autocreate.queue.
maxNumActiveConsumers

在从自动创建的队列目标的负荷平衡传送中可以处于活动状态的最大使用方数。值为 -1 表示不限制数量。

整数

1

imq.autocreate.queue.
maxNumBackupConsumers

在从自动创建的队列目标的负荷平衡传送期间出现任何错误时,可以代替这些活动使用方的最大备份使用方的数量。值为 -1 表示不限制数量。

整数

0(零)

imq.autocreate.topic

一个布尔值,指定是否允许代理自动创建主题目标。

布尔值

true

imq.autocreate.topic.
consumerFlowLimit

将要在一批中传送给使用方的消息的最大数量。值为 -1 表示不限制数量。

整数

1000

1能够以字节、千字节和兆字节的形式来表示作为字节字符串键入的值:例如:1000 表示 1000 字节;7500b 表示 7500 字节;77k 表示 77 千字节(77 x 1024 = 78848 字节);17m 表示 17 兆字节(17 x 1024 x 1024 = 17825792 字节)

2此属性可用于 imqcmd update bkr


持久性管理器属性

要配置代理的持久性功能,您必须指定 imq.persist.store 的值或接受默认值。

表 14-5 必需的持久性管理器属性

属性名称

说明

类型

默认值

imq.persist.store

一个字符串,指定代理是使用内置的、基于文件的持久性,还是使用插入的、JDBC 兼容的持久性。

该值必须是 filejdbc

字符串

file

在下面的小节中,介绍了支持基于文件的持久性和基于 JDBC 的持久性的属性。

基于文件的持久性

表 14-6 列出了支持基于文件的持久性的属性。第一列列出了属性名称。对于每个属性名称,第二列对该属性进行了说明;第三列指定了其类型;而第四列则给出了其默认值。

表 14-6 基于文件的持久性的属性 

属性名称

说明

类型

默认值

imq.persist.file.sync.
enabled

一个布尔值,指定持久性操作是否使内存中状态与物理存储设备同步。如果将此属性设置为 true,则可以避免由于系统崩溃而导致的数据丢失,但持久性操作的性能会有所降低。

如果您正在对 Message Queue 运行 Sun Cluster 和 Sun Cluster Data Service,则请将所有群集节点上的代理的该属性设置为 true

布尔值

false

imq.persist.file.message.
max_record_size

适用于内置的、基于文件的持久性,将添加到消息存储文件中的消息(而不是存储在单独文件中的消息)大小的最大值。

字节字符串1

1m

imq.persist.file.
destination.message.
filepool.limit

适用于内置的、基于文件的持久性,目标文件池中可供重复使用的空闲文件的最大数量。该数量越大,代理处理持久性数据的速度越快。超过该值的空闲文件将被删除。代理将根据需要创建文件或删除超过此限制的文件。

整数

100

imq.persist.file.message.
filepool.cleanratio

适用于内置的、基于文件的持久性,保持清除状态(清空)的目标文件池中空闲文件的百分比。该值越大,在操作中清除文件所需的开销越大,但文件池所需的磁盘空间越小。

整数

0(零)

imq.persist.file.
message.cleanup

适用于内置的、基于文件的持久性,一个指定代理在关闭时是否清除目标文件池中的空闲文件的布尔值。如果值为 false,则关闭代理的速度会加快,但文件存储需要的磁盘空间会更多。

布尔值

false

1能够以字节、千字节和兆字节的形式来表示作为字节字符串键入的值。示例:1000 表示 1000 字节;7500b 表示 7500 字节;77k 表示 77 千字节(77 x 1024 = 78848 字节);17m 表示 17 兆字节(17 x 1024 x 1024 = 17825792 字节)

基于 JDBC 的持久性

表 14-7 包含支持基于 JDBC 的持久性的属性。该表列出了各个属性,对其进行了说明,然后给出如何进行配置以用于 PointBase 产品的示例。

表 14-7 基于 JDBC 的持久性的属性

属性名称

说明

示例

imq.persist.store

一个字符串,指定基于文件或基于 JDBC 的数据存储库。

jdbc

imq.persist.jdbc.brokerid

(可选)附加到数据库表名称中的代理实例标识符。当多个代理实例使用同一个数据库作为持久性数据存储库时,标识符可使代理实例保持唯一。

嵌入式数据库只存储一个代理实例的数据,因此通常不需要此属性。

标识符必须是字母数字字符串,其长度不能超过数据库所允许的最大表名长度减去 12 后的长度。

(PointBase 嵌入式版本不需要)

imq.persist.jdbc.driver

连接到数据库的 JDBC 驱动程序的 Java 类名。

com.pointbase.jdbc.
   jdbcUniversalDriver

imq.persist.jdbc.opendburl

打开现有数据库连接的数据库 URL。

jdbc:pointbase:embedded:
   dbName;database.home= …/instances/instanceName/
  dbstore

imq.persist.jdbc.createdburl

(可选)打开创建数据库连接的数据库 URL。

仅当使用 imqdbmgr 创建数据库时才指定此属性。

jdbc:pointbase:
   embedded
:dbName;new,
   database.home=    
/instances/instanceName/
   dbstore

imq.persist.jdbc.closedburl

(可选)当代理关闭时关闭当前数据库连接的数据库 URL。

PointBase 不需要

imq.persist.jdbc.user

(可选)用于打开数据库连接的用户名(如果需要)。出于安全性考虑,可以指定值,而不使用命令行选项:
imqbrokerd -dbuser
和 imqdbmgr -u

imq.persist.jdbc.needpassword

(可选)一个布尔值,指定数据库是否要求输入代理访问的密码。值 true 表示密码是必需的。

如果设置此选项,imqbrokerd imqdbmgr 命令将提示输入密码,除非使用 -passfile 选项指定包含该密码的文件。

imq.persist.jdbc.password

(可选)用于打开数据库连接的密码(如果需要)。

仅在密码文件中指定此属性。

imq.persist.jdbc.table.IMQSV35

用于创建版本表的 SQL 命令。

CREATE TABLE ${name}    (STOREVERSION INTEGER NOT    NULL, BROKERID    VARCHAR(100))

imq.persist.jdbc.table.
IMQCCREC35

用于创建配置更改记录表的 SQL 命令。

CREATE TABLE ${name}    (RECORDTIME BIGINT NOT    NULL, RECORD BLOB(10k))

imq.persist.jdbc.table.
IMQDEST35

用于创建目标表的 SQL 命令。

CREATE TABLE ${name} (DID    VARCHAR(100) NOT NULL,    DEST BLOB(10k), primary    key(DID))

imq.persist.jdbc.table.IMQINT35

用于创建 Interest 表的 SQL 命令。

CREATE TABLE ${name} (CUID    BIGINT NOT NULL, INTEREST    BLOB(10k), primary    key(CUID))

imq.persist.jdbc.table.IMQMSG35

用于创建消息表的 SQL 命令。

MSG 列的默认最大长度为 1 Megabyte (1m)。如果希望消息超过该长度,请对长度进行相应的设置。如果已经创建了这些表,则需要重新创建它们以进行更改。

CREATE TABLE ${name} (MID    VARCHAR(100) NOT NULL,    DID VARCHAR(100), MSGSIZE    BIGINT, MSG BLOB(1m),    primary key(MID))

imq.persist.jdbc.table.
IMQPROPS35

用于创建属性表的 SQL 命令。

CREATE TABLE ${name}    (PROPNAME VARCHAR(100)    NOT NULL, PROPVALUE    BLOB(10k), primary    key(PROPNAME))

imq.persist.jdbc.table.
IMQILIST35

用于创建 Interest 状态表的 SQL 命令。

CREATE TABLE ${name} (MID    VARCHAR(100) NOT NULL,    CUID BIGINT, DID    VARCHAR(100), STATE    INTEGER, primary key(MID,    CUID))

imq.persist.jdbc.table.IMQTXN35

用于创建事务表的 SQL 命令。

CREATE TABLE ${name} (TUID    BIGINT NOT NULL, STATE    INTEGER, TSTATEOBJ    BLOB(10K), primary    key(TUID))

imq.persist.jdbc.table.
IMQTACK35

用于创建事务确认表的 SQL 命令。

CREATE TABLE ${name} (TUID    BIGINT NOT NULL, TXNACK    BLOB(10k))


安全性管理器属性

表 14-8 列出了安全性管理器属性。第一列列出了属性名称。对于每个属性名称,第二列对该属性进行了说明;第三列指定了其类型;而第四列则给出了其默认值。

如果您正在使用 SSL,请参考在下面的表 14-9 中列出的密钥库配置属性。

表 14-8 安全性管理器属性

属性名称

说明

类型

默认值

imq.accesscontrol.
enabled

一个布尔值,指定是否为代理支持的所有连接服务设置访问控制。表明系统是否要检查已验证的用户是否如访问控制属性文件所指定,拥有使用连接服务或执行与特定目标有关的特定 Message Queue 操作的权限。

布尔值

true

imq.accesscontrol.file.
filename

代理实例支持的所有连接服务的访问控制属性文件的名称。文件名称指定访问控制目录的相对文件路径(请参见附录 A“Message Queue 数据在特定操作系统中的位置”)。

字符串

accesscontrol.
properties

imq.audit.enabled

一个布尔值,指定是否启动代理日志文件的审计日志(仅限企业版)。

布尔值

false

imq.authentication.
basic.user_repository

对于 Base 64 编码,一个指定用于验证的用户系统信息库类型的字符串:基于文件 (file) 或 LDAP (ldap)。

字符串

file

imq.authentication.
client.response.timeout

系统等待客户机响应来自代理的验证请求的时间间隔(以秒为单位)。

整数

180

imq.authentication.type

一个字符串,指定传送密码时应使用 Base 64 编码 (basic) 还是 MD5 摘要 (digest)。设置代理支持的所有连接服务的编码。

字符串

digest

imq.imqcmd.password

管理用户的密码。在用户使用某个命令执行操作前,imqcmd 命令实用程序使用此密码对其进行验证。

字符串

imq.keystore.property_name

一个字符串,指定与 SSL 密钥库相关的安全性属性(适用于基于 SSL 的服务)。请参见表 14-9

字符串

imq.passfile.dirpath

包含密码文件的目录的路径(取决于操作系统)。

字符串

请参见附录 A

imq.passfile.enabled

一个布尔值,指定是否在密码文件中指定用于安全性通信的用户密码(适用于 SSL、LDAP 和 JDBC™)

布尔值

false

imq.passfile.name

密码文件的名称。

字符串

密码文件

imq.service_name.
accesscontrol.enabled

一个布尔值,指定是否为命名连接服务设置访问控制以覆盖代理范围的设置。表明系统是否要检查已验证的用户是否如访问控制属性文件所指定,拥有使用连接服务或执行与特定目标有关的特定 Message Queue 操作的权限。

布尔值

从系统范围的属性 imq.accesscontrol.enabled 继承。

imq.service_name.
accesscontrol.file.
filename

代理实例的命名连接服务的访问控制属性文件的名称。文件名称指定访问控制目录的相对文件路径(请参见附录 A“Message Queue 数据在特定操作系统中的位置”)。

默认值是从系统范围的属性 imq.accesscontrol.file.filename 继承的。

字符串

请参见说明

imq.service_name.
authentication.type

一个字符串,指定传送密码时应使用 Base 64 编码 (basic) 还是 MD5 摘要 (digest)。设置命名的连接服务的编码,此设置将覆盖任意代理范围的设置。

默认值是从系统范围的属性 imq.authentication.type 继承的。

字符串

请参见说明

imq.user_repository.
ldap.base

用户条目的目录库。

字符串

imq.user_repository.
ldap.gidattr

提供商特定的属性标识符,其值为组名。

字符串

imq.user_repository.
ldap.grpbase

组条目的目录库。

字符串

imq.user_repository.
ldap.grpfiltler

JNDI 搜索过滤器(以逻辑表达式的形式表示搜索查询)。通过为组指定搜索过滤器,代理可以缩小搜索范围,从而使搜索更有效。有关详细信息,请参见位于以下位置的 JNDI 教程:

http://java.sun.com/products/jndi/tutorial

此属性并不是必须设置的。

字符串

imq.user_repository.
ldap.grpsearch

一个布尔值,指定是否启用组搜索。请参见 LDAP 提供商提供的文档,决定您是否可以将用户与组相关联。

请注意,Message Queue 不支持嵌套组。

布尔值

false

imq.user_repository.
ldap.memattr

组条目中的属性标识符,其值是组成员的独特名称。

字符串

imq.user_repository.
ldap.password

与代理使用的独特名称关联的密码。

仅在密码文件中指定此属性。

如果目录服务器允许匿名搜索,则无需输入密码。

字符串

imq.user_repository.
ldap.principal

代理用来绑定到目录服务器以进行搜索时使用的独特名称。如果目录服务器允许匿名搜索,则无需为此属性指定值。

字符串

imq.user_repository.
ldap.property_name

待提供

待提供

待提供

imq.user_repository.
ldap.server

LDAP 服务器的 host:port,其中 host 指定运行目录服务器的主机的全限定 DNS 名称,port 指定目录服务器用于通信的端口号。

要指定故障转移服务器的列表,请使用以下语法:

host1:port1 ldap://host2:port2 ldap://host3:port3

列表中的条目以空格分隔。请注意,每个故障转移服务器地址均以 ldap:// 开头。

即使您使用 SSL 并将属性 imq.user_repository.ldap.ssl.enabled 设置为 true,也请使用此格式。您无需在地址中指定“ldaps”。

字符串

imq.user_repository.
ldap.ssl.enabled

一个布尔值,指定代理在与 LDAP 服务器通信时是否应使用 SSL 协议。

布尔值

false

imq.user_repository.
ldap.timeout

用于搜索的时间限制(以秒为单位)。

整数

280

imq.user_repository.
ldap.uidattr

提供商特定的属性标识符,其值用于唯一标识一个用户。例如:uidcn 等。

字符串

imq.user_repository.
ldap.usrfilter

JNDI 搜索过滤器(以逻辑表达式的形式表示搜索查询)。通过为用户指定搜索过滤器,代理可以缩小搜索范围,从而使搜索更有效。有关详细信息,请参见位于以下位置的 JNDI 教程:http://java.sun.com/products/jndi/tutorial

此属性并不是必须设置的。

字符串

表 14-9 列出了 Message Queue 密钥库的可配置属性。请在 SSL 中使用这些属性。

表 14-9 密钥库属性

属性名称

说明

类型

默认值

imq.keystore.file.dirpath

适用于基于 SSL 的服务,包含密钥库文件的目录的路径。默认值:请参见附录 A“Message Queue 数据在特定操作系统中的位置”

字符串

imq.keystore.file.name

适用于基于 SSL 的服务:密钥库文件的名称。

字符串

密钥库

imq.keystore.password

适用于基于 SSL 的服务:密钥库密码。

仅在密码文件中指定此属性。

字符串


监视和日志记录属性

表 14-10 列出了与监视和日志记录相关的属性。第一列列出了属性名称。对于每个属性名称,第二列对该属性进行了说明;第三列指定了其类型;而第四列则给出了其默认值。

表 14-10 监视服务属性

属性名称

说明

类型

默认值

imq.destination.logDeadMsgs1

一个布尔值,指定代理是否记录下列类型的事件:

  • 目标已满,已达到其容量的最大值或最大消息数。
  • 代理由于管理命令或传送确认之外的原因废弃消息。
  • 代理将消息移动到停用消息队列中。

布尔值

false

imq.log.console.output

一个字符串,指定要写入到控制台的日志记录信息类别。可以是下列值之一:

  • ALL
  • NONE
  • 以下的一个或多个值,以竖线 (|) 分隔:ERROR、WARNING 和 INFO。分别指定每种日志消息类别;所有消息类别均不包括其他类别。

字符串

ERROR|WARNING

imq.log.console.stream

一个字符串,指定是否将控制台输出写入到标准输出 (OUT) 或标准错误 (ERR)

字符串

ERR

imq.log.file.dirpath

包含日志文件的目录的路径(取决于操作系统)。

字符串

请参见附录 A

imq.log.file.filename

日志文件的名称。

字符串

log.txt

imq.log.file.output

要写入到控制台的日志记录信息的类别。可以是下列值之一:

  • ALL
  • NONE
  • 以下的一个或多个值,以竖线 (|) 分隔:ERROR、WARNING 和 INFO。分别指定每种日志消息类别;所有消息类别均不包括其他类别。

字符串

ALL

imq.log.file.rolloverbytes1

日志文件的大小(以字节为单位),达到该值后输出将转移到新的日志文件。值 -1 将禁用基于文件大小的转移。

整数

-1

imq.log.file.rolloversecs1

日志文件的生存期(以秒为单位),达到该值后输出将转移到新的日志文件。值 -1 将禁用基于文件生存期的转移。

整数

604800
(一周)

imq.log.level1

一个指定记录程序级别的字符串:可以写入到输出通道的输出的种类。包括指定的种类以及所有更高级别的种类。值分别为(由高至低):ERRORWARNINGINFO

字符串

INFO

imq.log.syslog.facility

(仅对于 Solaris)一个字符串,指定 Message Queue 代理应将 syslog 记录为哪种系统日志工具。属性值镜像 syslog(3C) 手册页中列出的值。适用于 Message Queue 的值包括:LOG_USERLOG_DAEMONLOG_LOCAL0LOG_LOCAL7

字符串

LOG_DAEMON

imq.log.syslog.identity

(仅对于 Solaris)应添加到每条记录到 syslog 中的消息前面的标识字符串。

默认值是 imqbrokerd_${imq.instanceName}

字符串

请参见说明

imq.log.syslog.logconsole

(仅对于 Solaris)一个布尔值,指定如果无法将消息发送到 syslog,是否将其写入到系统控制台。

布尔值

false

imq.log.syslog.logpid

(仅对于 Solaris)一个布尔值 (true/false),指定是否将代理进程 ID 与消息一起记录。

布尔值

true

imq.log.syslog.output

(仅对于 Solaris)一个字符串,指定写入到 syslogd(1M) 的日志记录信息类别。可以是下列值之一:

  • ALL
  • NONE
  • 以下的一个或多个值,以竖线 (|) 分隔:ERROR、WARNING 和 INFO。分别指定每种日志消息类别;所有消息类别均不包括其他类别。

字符串

ERROR

imq.log.timezone

一个表示日志时间戳时区的字符串。标识符与 java.util.TimeZone.getTimeZone() 使用的一致。例如:GMTAmerica/LosAngelesEurope/RomeAsia/Tokyo

字符串

当地时区

imq.metrics.enabled

一个布尔值,指定是否要将度量信息写入记录程序。不影响度量消息的生成(请参见 imq.metrics.topic.enabled)。

布尔值

true

imq.metrics.interval

如果启用了度量日志记录 (imq.metrics.enabled=true),将度量信息写入记录程序的时间间隔(以秒为单位)。不影响度量消息的生成时间间隔(请参见 imq.metrics.topic.interval)。

值 -1 表示从不。

整数

-1

imq.metrics.topic.enabled

一个布尔值,指定是否启用度量消息生成。如果为 false,则试图订阅度量主题目标时会引发客户端异常。

布尔值

true

imq.metrics.topic.interval

生成度量消息(发送到度量主题目标)的时间间隔(以秒为单位)。

整数

60

imq.metrics.topic.persist

一个布尔值,指定度量消息是否为持久性消息。

布尔值

false

imq.metrics.topic.timetolive

度量消息(发送到度量主题目标)的生命周期(以秒为单位)。

整数

300

1此属性可用于 imqcmd update bkr


群集配置属性

表 14-11 概述了与代理群集相关的配置属性。

表 14-11 群集配置属性

属性名称

说明

类型

默认值

imq.cluster.brokerlist

以逗号分隔的 host:port 条目列表,它用来标识群集中的所有代理,其中 host 是代理的主机名,port 是其端口映射器端口号。

示例:

host1:3000,host2:8000,ctrlhost

群集中的所有代理必须具有相同的值。

字符串

imq.cluster.masterbroker

群集的主代理(如果有)的主机名和端口号。

该值的形式为 host:port,其中 host 是主代理的主机名,port 是其端口映射器端口号。

示例:

ctrlhost:7676

群集中的所有代理必须具有相同的值。

字符串

imq.cluster.url1

群集配置文件(如果有)的 URL。

示例:

http://webserver/imq/cluster.properties

(对于 Web 服务器上的文件)

file:/net/mfsserver/imq/cluster.properties

(对于共享驱动器上的文件)

群集中的所有代理必须具有相同的值。

字符串

imq.cluster.hostname

当有多个可用主机时,cluster 连接服务所绑定的主机名或 IP 地址(用于群集中代理之间的内部通信):例如,如果一台计算机中安装了多个网络接口卡。

可以单独地为群集中的每个代理指定。

字符串

imq.hostname 值继承(请参见表 14-2

imq.cluster.port

cluster 连接服务的端口号。

可以单独地为群集中的每个代理指定。

整数

0(动态分配。)

imq.cluster.transport

cluster 连接服务使用的网络传输协议。为了在代理之间传送安全、加密的消息,请将此属性设置为 ssl

群集中的所有代理必须具有相同的值。

字符串

tcp

1此属性可用于 imqcmd update bkr



上一页      目录      索引      下一页     


文件号码 819-2219。   版权所有 2005 Sun Microsystems, Inc. 保留所有权利。