SwiftMQ AMQP Router

The SwiftMQ AMQP Router is a light weight message broker that supports AMQP 1.0 and AMQP 0.9.1. It is offered free of charge.

Functionality (Swiftlets)

SwiftMQ AMQP Router contains the following Swiftlets (click on the links to view the online documentation):

Distribution Content

Directory Content
config Router configuration file
doc Documentation
jars jar Files
kernel Kernel Swiftlets
log Log files
scripts Start scripts in Unix and Windows format
store Persistent message store
trace Trace directory

Starting SwiftMQ AMQP Router

Go to the "scripts" directory and switch to the subfolder that matches your platform. Then run the Router startup script as follows:

    ./router

The router is now up, running and ready to serve AMQP connections on port 5671 (SSL) and 5672.

Administration with SwiftMQ Explorer

SwiftMQ Explorer is SwiftMQ's graphical administration tool to manage a Router. SwiftMQ AMQP Router contains a version of SwiftMQ Explorer that connects via AMQP 1.0.

To start SwiftMQ Explorer, perform a

      ./exploreramqp

from the platform subfolder of the "scripts" directory. As username/password press the return key (anonymous) or use "admin", password "secret".

The AMQP-URL has the following format:

      amqp[s]://<host>:<port>[/?<param>[&<param>...]]

      Where

      amqp      ::= AMQP protocol over plain sockets.
      amqps     ::= AMQP protocol over SSL sockets.
      <host>    ::= Hostname.
      <port>    ::= Port. 5672 is for plain, 5661 for SSL.
      <param>   ::= Parameter in form <name>=<value>.

           Possible parameters are:

              maxframesize   Sets the AMQP max frame size. Value is in bytes. Default unlimited.
              idletimeout    Closes the connection after no data has been sent for this amount of time.
                             Value is in milliseconds. Default no timeout.
              mechanism      SASL authentication mechanism like CRAM-MD5.

The SwiftMQ Explorer documentation can be found online HERE.

Administration with CLI

CLI is SwiftMQ's command line interface to manage a Router. SwiftMQ AMQP Router contains a version of CLI that connects via AMQP 1.0.

To start CLI, perform a

      ./cliamqp

from the platform subfolder of the "scripts" directory. As username/password press the return key (anonymous) or use "admin", password "secret".

For the AMQP-URL see section above.

The CLI documentation can be found online HERE.

Administration by Changing the Configuration File

The configuration file of the SwiftMQ AMQP Router is stored under the config directory. A watchdog automatically detects changes and applies it to the running Router. It is not necessary to restart it.

AMQP 1.0 Clients

The following AMQP 1.0 clients have been tested and can be used with SwiftMQ AMQP Router:

SwiftMQ AMQP 1.0 Java Client

The documentation of the SwiftMQ AMQP 1.0 Java Client can be found online HERE. It also available free of charge as a separate distribution from SwiftMQ's web site HERE.

Apache Qpid Proton AMQP 1.0 Library

Qpid Proton provides a protocol engine for AMQP 1.0 with an easy to use Messenger interface on top of it. Supported languages are C, Perl, PHP, Python, Ruby and Java. It is available from HERE.

Microsoft ServiceBus .Net Client

Microsoft's ServiceBus .Net Client can be used to access SwiftMQ over AMQP 1.0 but without SASL. Look HERE.

SwiftMQ AMQP Router License, Version 2.0

This license ("License") contains rights and restrictions associated with the use of the accompanying SwiftMQ AMQP Router software and documentation ("Software") of IIT Software GmbH, M√ľnsterstr. 111, 48145 M√ľnster, Germany ("IIT"). Read the License carefully before using the Software. By using the Software you declare your explicit acceptance of the following licensing conditions. If you do not accept these licensing conditions, you may not use the Software.

1. LICENSE GRANT

1.1. IIT grants you a perpetual, non-exclusive and non-transferable license free of charge for the purely internal use of the Software.

1.2. You may not bundle the Software with your product. End-users have to acquire the Software from IIT separately.

1.3. You must not rent or lease the Software including the documentation and other accompanying materials to third parties.

1.4. Copyright notices, serial numbers and all other elements designed to identify the Software may not, in any circumstances, be removed or altered.

1.5. IIT reserves the right to audit usage of the Software at any time without prior notice. You agree to allow IIT unrestricted access to all installations of the Software for audit purposes.

1.6. You agree not to disclose any benchmark results relating to its use of the Software without the prior written consent of IIT.

2. LICENSE TERMS

The License is granted for the duration of the statutory term of copyright protection. The License automatically becomes invalid, without the need for termination notice, if you culpably infringe any of the provisions of this agreement. In the case of the contract is coming to an end, the Software and all copies of the Software must be destroyed.

3. OTHER

This License is governed by the law of the Federal Republic of Germany with the explicit exclusion of UN purchasing law. Should any provision of this agreement be or become invalid or unenforceable, the remaining terms of this agreement shall be unaffected thereby. The invalid or unenforceable provision shall be replaced by such a provision that comes closest to fulfilling the purpose of the invalid provision. Side agreements were not made. Alterations and amendments to this licensing agreement require the written form. This also applies to the cancellation of this written form provision.