System Properties
Overview
SwiftMQ uses Java system properties (passed via -D flags or set in startup scripts) to control various runtime behaviors. These are set in the router/client startup scripts or passed on the JVM command line.
Router Properties
JMS Behavior
| Property |
Default |
Description |
swiftmq.jms.keepalive.missing.threshold |
5 |
Number of missed keepalive messages before considering a connection lost. |
Scheduler
| Property |
Default |
Description |
swiftmq.swiftlet.scheduler.respectdst |
true |
Whether the scheduler swiftlet should respect daylight saving time. |
Store/Persistence
| Property |
Default |
Description |
swiftmq.store.analyze |
false |
Controls store analysis/repair on startup. |
swiftmq.store.txlog.precreate |
true |
Pre-creates transaction log files for the store. |
Client Properties
AMQP Client
| Property |
Default |
Description |
swiftmq.amqp.open.hostname |
— |
Hostname to use in the AMQP open frame. |
CLI
| Property |
Default |
Description |
cli.username |
— |
Username for CLI authentication. |
cli.password |
— |
Password for CLI authentication. |
Connection & Protocol
| Property |
Default |
Description |
swiftmq.mgmt.protocol.version |
750 |
Management protocol version used by the client. |
swiftmq.smqp.version |
750 |
SMQP protocol version used by the client. |
swiftmq.filetransfer.protocol.version |
941 |
File transfer protocol version used by the client. |
swiftmq.request.timeout |
60000 |
Timeout in milliseconds for client request/response operations. |
Debugging/Logging
| Property |
Default |
Description |
swiftmq.client.debugtofile.enabled |
false |
Enable debug logging to file for the client. |
swiftmq.client.debugtofile.filename |
swiftmqclient |
Filename for client debug log output. |
swiftmq.client.debugtofile.generations |
10 |
Number of debug log file generations to keep. |
swiftmq.client.debugtofile.rolloversizekb |
1024 |
Rollover size in KB for client debug log files. |
swiftmq.springsupport.debug |
false |
Enable debug logging for Spring support classes. |
swiftmq.reconnect.debug |
false |
Enable debug logging for reconnection logic. |
General
| Property |
Default |
Description |
swiftmq.directory.autocreate |
— |
Automatically create required directories if they do not exist. |
swiftmq.paths.absolute |
— |
Use absolute paths for file and directory references. |
swiftmq.version.properties |
../version.properties |
Path to the version properties file. |
JMS Behavior
| Property |
Default |
Description |
swiftmq.cc.ss.delay |
100 |
Delay in milliseconds for ConnectionConsumer's server session polling. |
swiftmq.jms.keepalive.missing.threshold |
5 |
Number of missed keepalive messages before considering a connection lost. |
swiftmq.jms.persistent.asyncsend |
false |
Enable asynchronous sending for persistent JMS messages. |
Network/TLS
| Property |
Default |
Description |
swiftmq.tcp.no.delay |
true |
Enable TCP_NODELAY for client connections. |
Reconnection
| Property |
Default |
Description |
swiftmq.reconnect.max.internal.retry.count |
10 |
Maximum number of internal reconnect retries. |
Security
| Property |
Default |
Description |
swiftmq.security.objectmessage.trusted.pkg |
* |
Trusted package(s) for deserialization of ObjectMessages. |