This section is a quick index for looking up configuration. Click on the element name to go to the specific chapter.
This is the main core server configuration file.
Table 45.1. Server Configuration
Element Name | Element Type | Description | Default |
---|---|---|---|
backup | Boolean | true means that this server is a backup to another node in the cluster | false |
backup-connector-ref | String | the name of the remoting connector to connect to the backup node | |
bindings-directory | String | the directory to store the persisted bindings to | data/bindings |
clustered | Boolean | true means that the server is clustered | false |
connection-ttl-override | Long | if set, this will override how long (in ms) to keep a connection alive without receiving a ping. | -1 |
create-bindings-dir | Boolean | true means that the server will create the bindings directory on start up | true |
create-journal-dir | Boolean | true means that the journal directory will be created | true |
file-deployment-enabled | Boolean | true means that the server will load configuration from the configuration files | true |
global-page-size | Long | the standard size (in bytes) of a page-file. JBoss Messaging will only read messages when there is enough space to read at least one page file, determined by this value. | 10 * 1024 * 1024 |
id-cache-size | Integer | the size of the cache for pre creating message id's | 2000 |
journal-aio-buffer-size | Long | The size of the internal buffer on AIO. | 128 KiB |
journal-aio-buffer-timeout | Long | The timeout (in nanoseconds) used to flush internal buffers. | 20000 |
journal-aio-flush-on-sync | Boolean | If true, transactions will ignore timeouts and be persisted immediately | False |
journal-compact-min-files | Integer | The minimal number of data files before we can start compacting | 10 |
journal-compact-percentage | Integer | The percentage of live data on which we consider compacting the journal | 30 |
journal-directory | String | the directory to store the journal files in | data/journal |
journal-file-size | Long | the size (in bytes) of each journal file | 128 * 1024 |
journal-max-aio | Integer | the maximum number of write requests that can be in the AIO queue at any one time | 500 |
journal-min-files | Integer | how many journal files to pre-create | 2 |
journal-sync-transactional | Boolean | if true wait for transaction data to be synchronized to the journal before returning response to client | true |
journal-sync-non-transactional | Boolean | if true wait for non transaction data to be synced to the journal before returning response to client. | false |
journal-type | ASYNCIO|NIO | the type of journal to use | ASYNCIO |
jmx-management-enabled | Boolean | true means that the management API is available via JMX | true |
large-messages-directory | String | the directory to store large messages | data/largemessages |
management-address | String | the name of the management address to send management messages to | jbm.management |
management-cluster-user | String | the user used to for replicating management operations between clustered nodes | JBM.MANAGEMENT.ADMIN.USER |
management-cluster-password | String | the password used to for replicating management operations between clustered nodes | CHANGE ME!! |
management-notification-address | String | the name of the address that consumers bind to receive management notifications | jbm.notifications |
management-request-timeout | Long | how long (in ms) to wait for a reply to a management request | 5000 |
message-counter-enabled | Boolean | true means that message counters are enabled | false |
message-counter-max-day-history | Integer | how many days to keep message counter history | 10 |
message-counter-sample-period | Long | the sample period (in ms) to use for message counters | 10000 |
message-expiry-scan-period | Long | how often (in ms) to scan for expired messages | 30000 |
message-expiry-thread-priority | Integer | the priority of the thread expiring messages | 3 |
paging-directory | String | the directory to store paged messages in | data/paging |
paging-max-global-size-bytes | Long | JBoss Messaging enters into global page mode as soon as the total memory consumed by messages hits this value (in bytes) | -1 |
persist-delivery-count-before-delivery | Boolean | true means that the delivery count is persisted before delivery. False means that this only happens after a message has been cancelled. | false |
persistence-enabled | Boolean | true means that the server will use the file based journal for persistence. | true |
persist-id-cache | Boolean | true means that id's are persisted to the journal | true |
queue-activation-timeout | Long | after failover occurs, this timeout specifies how long (in ms) to wait for consumers to re-attach before starting delivery | 30000 |
scheduled-thread-pool-max-size | Integer | the number of threads that the main scheduled thread pool has. | 5 |
security-enabled | Boolean | true means that security is enabled | true |
security-invalidation-interval | Long | how long (in ms) to wait before invalidating the security cache | 10000 |
thread-pool-max-size | Integer | the number of threads that the main thread pool has. -1 means no limit | -1 |
transaction-timeout | Long | how long (in ms) before a transaction can be removed from the resource manager after create time | 60000 |
transaction-timeout-scan-period | Long | how often (in ms) to scan for timeout transactions | 1000 |
wild-card-routing-enabled | Boolean | true means that the server supports wild card routing | true |
acceptors | Acceptor | a list of remoting acceptors to create | |
broadcast-groups | BroadcastGroup | a list of broadcast groups to create | |
connectors | Connector | a list of remoting connectors configurations to create | |
discovery-groups | DiscoveryGroup | a list of discovery groups to create | |
diverts | Divert | a list of diverts to use | |
divert.name (attribute) | String | a unique name for the divert - mandatory | |
divert.routing-name | String | the routing name for the divert - mandatory | |
divert.address | String | the address this divert will divert from - mandatory | |
divert.forwarding-address | String | the forwarding address for the divert - mandatory | |
divert.exclusive | Boolean | is this divert exclusive? | false |
divert.filter | String | an optional core filter expression | null |
divert.transformer-class-name | String | an optional class name of a transformer | |
queues | Queue | a list of pre configured queues to create | |
queues.name (attribute) | String | unique name of this queue | |
queues.address | String | address for this queue - mandatory | |
queues.filter | String | optional core filter expression for this queue | null |
queues.durable | Boolean | is this queue durable? | true |
bridges | Bridge | a list of bridges to create | |
bridges.name (attribute) | String | unique name for this bridge | |
bridges.queue-name | String | name of queue that this bridge consumes from - mandatory | |
bridges.forwarding-address | String | address to forward to. If omitted original destination is used | null |
bridges.filter | String | optional core filter expression | null |
bridges.transformer-class-name | String | optional name of transformer class | null |
bridges.retry-interval | Long | period (in ms) between successive retries | 2000 ms |
bridges.retry-interval-multiplier | Double | multiplier to apply to successive retry intervals | 1.0 |
bridges.reconnect-attempts | Integer | maximum number of retry attempts, -1 signifies infinite | -1 |
bridges.failover-on-server-shutdown | Boolean | should failover be prompted if target server is cleanly shutdown? | false |
bridges.use-duplicate-detection | Boolean | should duplicate detection headers be inserted in forwarded messages? | true |
bridges.discovery-group-ref | String | name of discovery group used by this bridge | null |
bridges.connector-ref.connector-name (attribute) | String | name of connector to use for live connection | |
bridges.connector-ref.backup-connector-name (attribute) | String | optional name of connector to use for backup connection | null |
cluster-connections | ClusterConnection | a list of cluster connections | |
cluster-connections.name (attribute) | String | unique name for this cluster connection | |
cluster-connections.address | String | name of address this cluster connection applies to | |
cluster-connections.forward-when-no-consumers | Boolean | should messages be load balanced if there are no matching consumers on target? | false |
cluster-connections.max-hops | Integer | maximum number of hops cluster topology is propagated | 1 |
cluster-connections.retry-interval | Long | period (in ms) between successive retries | 2000 |
cluster-connections.use-duplicate-detection | Boolean | should duplicate detection headers be inserted in forwarded messages? | true |
cluster-connections.discovery-group-ref | String | name of discovery group used by this bridge | null |
cluster-connections.connector-ref.connector-name (attribute) | String | name of connector to use for live connection | |
cluster-connections.connector-ref.backup-connector-name (attribute) | String | optional name of connector to use for backup connection | null |
security-settings | SecuritySetting | a list of security settings | |
security-settings.match (attribute) | String | the string to use for matching security against an address | |
security-settings.permission | Security Permission | a permision to add to the address | |
security-settings.permission.type (attribute) | Permission Type | the type of permission | |
security-settings.permission.roles (attribute) | Roles | a comma-separated list of roles to apply the permission to | |
address-settings | AddressSetting | a list of address settings | |
address-settings.dead-letter-address | String | the address to send dead messages too | |
address-settings.max-delivery-attempts | Integer | how many times to attempt to deliver a message before sending to dead letter address | 10 |
address-settings.expiry-address | String | the address to send expired messages too | |
address-settings.redelivery-delay | Long | the time (in ms) to wait before redelivering a cancelled message. | 0 |
address-settings.last-value-queue | boolean | whether to treat the queue as a last value queue | false |
address-settings.distribution-policy-class | String | the class to use for distributing messages to a consumer | RoundRobinDistributor |
address-settings.page-size-bytes | Long | the page size (in bytes) to use for an address | 10 * 1024 * 1024 |
address-settings.max-size-bytes | Long | the maximum size (in bytes) to use in paging for an address | -1 |
address-settings.redistribution-delay | Long | how long (in ms) to wait after the last consumer is closed on a queue before redistributing messages. | -1 |
This is the configuration file used by the server side JMS service to load JMS Queues, Topics and Connection Factories.
Table 45.2. JMS Server Configuration
Element Name | Element Type | Description | Default |
---|---|---|---|
connection-factory | ConnectionFactory | a list of connection factories to create and add to JNDI | |
connection-factory.auto-group | Boolean | whether or not message grouping is automatically used | false |
connection-factory.block-on-acknowledge | Boolean | whether or not messages are acknowledged synchronously | false |
connection-factory.block-on-non-persistent-send | Boolean | whether or not non persistent messages are sent synchronously | false |
connection-factory.block-on-persistent-send | Boolean | whether or not persistent messages are sent synchronously | false |
connection-factory.call-timeout | Long | the timeout (in ms) for remote calls | 30000 |
connection-factory.client-failure-check-period | Long | the period (in ms) after which the client will consider the connection failed after not receiving packets from the server | 5000 |
connection-factory.client-id | String | the pre-configured client ID for the connection factory | null |
connection-factory.connection-load-balancing-policy-class-name | String | the name of the load balancing class | org.jboss.messaging.core.client.impl.RoundRobinConnectionLoadBalancingPolicy |
connection-factory.connection-ttl | Long | the time to live (in ms) for connections | 5 * 60000 |
connection-factory.consumer-max-rate | Integer | the fastest rate a consumer may consume messages per second | -1 |
connection-factory.consumer-window-size | Integer | the window size (in bytes) for consumer flow control | 1024 * 1024 |
connection-factory.discovery-initial-wait-timeout | Long | the initial time to wait (in ms) for discovery groups to wait for broadcasts | 2000 |
connection-factory.dups-ok-batch-size | Integer | the batch size (in bytes) between acknowledgements when using DUPS_OK_ACKNOWLEDGE mode | 1024 * 1024 |
connection-factory.failover-on-server-shutdown | Boolean | whether or not to failover on server shutdown | false |
connection-factory.max-connections | Integer | the maximum number of connections per factory | 8 |
connection-factory.min-large-message-size | Integer | the size (in bytes) before a message is treated as large | 100 * 1024 |
connection-factory.pre-acknowledge | Boolean | whether messages are pre acknowledged by the server before sending | false |
connection-factory.producer-max-rate | Integer | the maximum rate of messages per second that can be sent | -1 |
connection-factory.producer-window-size | Integer | the window size (in bytes) for sending messages | 1024 * 1024 |
connection-factory.reconnect-attempts | Integer | maximum number of retry attempts, -1 signifies infinite | 0 |
connection-factory.retry-interval | Long | the time (in ms) to retry a connection after failing | 2000 |
connection-factory.retry-interval-multiplier | Double | multiplier to apply to successive retry intervals | 1d |
connection-factory.scheduled-thread-pool-max-size | Integer | the size of the scheduled thread pool | 2 |
connection-factory.thread-pool-max-size | Integer | the size of the thread pool | -1 |
connection-factory.transaction-batch-size | Integer | the batch size (in bytes) between acknowledgements when using a transactional session | 1024 * 1024 |
connection-factory.use-global-pools | Boolean | whether or not to use a global thread pool for threads | true |
queue | Queue | a queue to create and add to JNDI | |
queue.name (attribute) | String | unique name of the queue | |
queue.entry | String | context where the queue will be bound in JNDI (there can be many) | |
queue.durable | Boolean | is the queue durable? | true |
queue.filter | String | optional filter expression for the queue | |
topic | Topic | a topic to create and add to JNDI | |
topic.name (attribute) | String | unique name of the topic | |
topic.entry | String | context where the topic will be bound in JNDI (there can be many) |