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-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) |