20.10.2. qpid-java JVM Arguments
Table 20.5. Configuration Options For Connection Behavior
| Property Name | Type | Default Value | Description |
|---|---|---|---|
qpid.amqp.version | string | 0-10 | Sets the AMQP version to be used - currently supports 0-8, 0-9, 0-91, and 0-10. The client will begin negotiation at the specified version and only negotiate downwards if the broker does not support the specified version. |
qpid.heartbeat | int | 120 (seconds) | The heartbeat interval in seconds. Two consecutive missed heartbeats result in the connection timing out. This can also be set per connection. |
ignore_setclientID | boolean | false | If a client ID is specified in the connection URL then it is used, otherwise an ID is generated. If an ID is specified after it has been generated Qpid will throw an exception. Setting this property to 'true' disables that check and allows you to set a client ID at any time. |
Table 20.6. Configuration Options For Session Behavior
| Property Name | Type | Default Value | Description |
|---|---|---|---|
qpid.session.command_limit | int | 65536 | Limits the number of unacknowledged commands. |
qpid.session.byte_limit | int | 1048576 | Limits the number of unacknowledged commands in bytes. |
qpid.use_legacy_map_message | boolean | false | Uses the old map message encoding. By default the map messages are encoded using the 0-10 map encoding. This can also be set per connection as well. |
qpid.jms.daemon.dispatcher | boolean | false | Controls whether the Session dispatcher thread is a daemon thread or not. If this system property is set to true then the Session dispatcher threads will be created as daemon threads. This setting is introduced in version 0.16. |
Table 20.7. Configuration Options For Consumer Behavior
| Property Name | Type | Default Value | Description |
|---|---|---|---|
max_prefetch | int | 500 | Maximum number of messages to credits. Can also be set per connection or per destination. |
qpid.session.max_ack_delay | long | 1000 (ms) | Timer interval to flush message acks in buffer when using AUTO_ACK and DUPS_OK. |
sync_ack | boolean | false | If set, each message will be acknowledged synchronously. When using AUTO_ACK mode, set this to "true". Can also be set per connection. |
Table 20.8. Configuration Options For Producer Behavior
| Property Name | Type | Default Value | Description |
|---|---|---|---|
sync_publish | string | - | Sends messages synchronously. Valid values are persistent, transient, all. Can also be set per connection. |
Table 20.9. Configuration Options For Threading
| Property Name | Type | Default Value | Description |
|---|---|---|---|
qpid.thread_factory | string | org.apache.qpid.thread.DefaultThreadFactory | Specifies the thread factory to use. If using a real time JVM, set to org.apache.qpid.thread.RealtimeThreadFactory. |
qpid.rt_thread_priority | int | 20 | Specifies the priority (1-99) for realtime threads created by the realtime thread factory. |
Table 20.10. Configuration Options For I/O
| Property Name | Type | Default Value | Description |
|---|---|---|---|
qpid.transport | string | org.apache.qpid.transport.network.io.IoNetworkTransport | The transport implementation to be used. You can also specify the org.apache.qpid.transport.network.NetworkTransport transport mechanism. |
qpid.sync_op_timeout | long | 60000 (milliseconds) | The length of time to wait for a synchronous operation to complete. For compatibility with older clients, use amqj.default_syncwrite_timeout. |
qpid.tcp_nodelay | boolean | true |
Sets the TCP_NODELAY property of the underlying socket.
This can also be set per connection using the Connection URL options.
For compatibility with older clients, the synonym
amqj.tcp_nodelay is supported.
|
qpid.send_buffer_size | integer | 65535 |
Sets the SO_SNDBUF property of the underlying socket.
For compatibility with older clients, the synonym
amqj.sendBufferSize is supported.
|
qpid.receive_buffer_size | integer | 65535 |
Sets the SO_RCVBUF property of the underlying socket.
For compatibility with older clients, the synonym
amqj.receiveBufferSize is supported.
|
qpid.failover_method_timeout | long | 60000 |
During failover, this is the timeout for each attempt to try to re-establish the connection. If a reconnection attempt exceeds the timeout, the entire failover process is aborted.
It is only applicable for AMQP 0-8/0-9/0-9-1 clients.
|
Table 20.11. Configuration Options For Security
| Property Name | Type | Default Value | Description |
|---|---|---|---|
qpid.sasl_mechs | string | PLAIN | The SASL mechanism used. More than one can be specified using a comma separated list. Supported values are PLAIN, GSSAPI, and EXTERNAL. |
qpid.sasl_protocol | string | AMQP | When using GSSAPI as the SASL mechanism, sasl_protocol must be set to the principal for the qpidd broker. |
qpid.sasl_server_name | string | localhost | When using GSSAPI as the SASL mechanism, sasl_server must be set to the host for the SASL server. |
Table 20.12. JVM properties for GSSAPI as the SASL mechanism
| Property Name | Type | Default Value | Description |
|---|---|---|---|
javax.security.auth.useSubjectCredsOnly | boolean | true | If set to 'false', forces the SASL GASSPI client to obtain kerberos credentials explicitly. |
java.security.auth.login.config | string | - | Specifies the JASS configuration file. |
Table 20.13. Configuration options for SSL connections
| Property Name | Type | Default Value | Description |
|---|---|---|---|
qpid.ssl_timeout | long | 60000 | Timeout value used by the Java SSL engine when waiting on operations. |
qpid.ssl.KeyManagerFactory.algorithm | string | - |
The key manager factory algorithm name. If not set, defaults to the value returned from the Java runtime call KeyManagerFactory.getDefaultAlgorithm().
For compatibility with older clients, the synonym qpid.ssl.keyStoreCertType is supported.
|
qpid.ssl.TrustManagerFactory.algorithm | string | - |
The trust manager factory algorithm name. If not set, defaults to the value returned from the Java runtime call TrustManagerFactory.getDefaultAlgorithm()
For compatibility with older clients, the synonym qpid.ssl.trustStoreCertType is supported.
|
Table 20.14. JVM Properties for SSL connections
| Property Name | Type | Default Value | Description |
|---|---|---|---|
javax.net.ssl.keyStore | string | jvm default | Specifies the key store path. |
javax.net.ssl.keyStorePassword | string | jvm default | Specifies the key store password. |
javax.net.ssl.trustStore | string | jvm default | Specifies the trust store path. |
javax.net.ssl.trustStorePassword | string | jvm default | Specifies the trust store password. |
