Upgrade

Before you Upgrade

When using SwiftMQ 13, it's essential to follow some best practices for optimal operation:

Use the Router Script: Always start SwiftMQ with the provided router script rather than custom scripts. The router script is integral to the system, regularly tested and updated with each release.
Managing routerconfig.xml: The routerconfig.xml file in SwiftMQ is dynamic and changes automatically with various system components. Instead of version controlling this file, use preconfig files for your specific configurations like queues, topics, JMS listeners, etc. Include these preconfig files in your version control system (VCS). When starting SwiftMQ with the router script, add your preconfig files as parameters. This approach ensures that routerconfig.xml is consistently updated with your configurations.

Upgrade Procedure from 12.0.0 Onwards

To upgrade a SwiftMQ Router follow these steps:

Install the new SwiftMQ Router (new release).
Stop the old SwiftMQ Router (old release).
Copy the complete data directory from the old to the new release.
Start the new SwiftMQ Router (new release).

During startup, the new SwiftMQ Router will automatically convert the routerconfig.xml and apply changes, if necessary. To accomplish this, it is important that you always use the router script of the new release!

SwiftMQ clients will transparently reconnect to the new SwiftMQ Router. If necessary, update them with the new swiftmq.jar when you have time.

Upgrade from older Releases

Please have a look here.