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

代理程式透過連線,連續嘗試偵測 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

用來建立偏好表格的 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

用來建立偏好狀態表格的 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

這個布林值指定是否啟動代理程式記錄檔的稽核記錄功能 (僅 Enterprise Edition)。

布林

false

imq.authentication.
basic.user_repository

(用於基本 64 程式碼) 這個字串指定用於認證的使用者儲存庫的類型,即基於檔案 (file) 或 LDAP (ldap)。

字串

file

imq.authentication.
client.response.timeout

系統等待用戶端回應來自代理程式的認證請求的間隔時間 (以秒為單位)。

整數

180

imq.authentication.type

這個字串指定密碼應以基本 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

這個字串指定密碼應以基本 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:porthost 可指定執行目錄伺服器之主機的完全合格的 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

此特性可不必設定。

字串

Message Queue 密鑰儲存的可配置特性如表 14-9 中所示。使用這些特性可以用於 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

這個字串指定主控台輸出寫入至 stdout (OUT),或寫入至 stderr (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_DAEMON 以及 LOG_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) 這個布林值指定是否同時記錄訊息與代理程式程序 ID (true/false)。

布林

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

叢集連線服務的連接埠號。

可以為叢集中的每個代理程式個別指定。

整數

0 (動態配置。)

imq.cluster.transport

叢集連線服務使用的網路傳輸通訊協定。為了在代理程式之間安全的傳送加密訊息,請將這個特性設定為 ssl

叢集中所有代理程式的此值必須相同。

字串

tcp

1這個特性可用於 imqcmd update bkr



上一頁      目錄      索引      下一頁     


文件號碼 819-2220。   Copyright 2005 Sun Microsystems, Inc. 版權所有。