The installation takes place via 'hot deployment'. See the documentation of the Deploy Swiftlet for further information.
The Swiftlet uses the client classes of the foreign JMS server(s). These classes need to be deployed into the same directory where you put the classes of this Swiftlet for hot deployment. During hot deployment, these classes are detected and available. Don't put these classes into the classpath of the router!
The configuration of the JMS Bridge Extension Swiftlet is defined within the element
<swiftlet name="xt$bridge" .../>
of the router's configuration file. One can use the SwiftMQ Exlorer or CLI for configuration as well. They both save into that file.
Attributes of Element "swiftlet"
Definition
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| collect-interval | java.lang.Long | No | Collect Interval (ms) for the Usage Section |
Values
| Attribute | Values |
|---|---|
| collect-interval | Default: 10000 |
Element List "servers", Parent Element: "swiftlet"
Server Definitions. This element list contains zero or more "server" elements with this template definition:
Definition
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| name | java.lang.String | Yes | Name of this Server |
| enabled | java.lang.Boolean | No | Enables/Disables this Server |
| clientid | java.lang.String | No | Client Id for durable Subscribers |
| username | java.lang.String | No | Username |
| password | java.lang.String | No | Password |
| retryinterval | java.lang.Long | No | Retry Interval (ms) for Re-Connect |
Values
| Attribute | Values |
|---|---|
| enabled | Default: false |
| clientid | |
| username | |
| password | |
| retryinterval | Default: 60000 |
Element "objectfactory", Parent Element: "server"
Object Factory Definition.
Definition
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| class | java.lang.String | Yes | Object Factory Class |
Values
| Attribute | Values |
|---|---|
| class | Default: com.swiftmq.extension.bridge.JNDIObjectFactory |
Element List "properties", Parent Element: "objectfactory"
Object Factory Properties. This element list contains zero or more "property" elements with this template definition:
Definition
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| name | java.lang.String | Yes | Name of this Object Factory Property |
| value | java.lang.String | Yes | Property Value |
Values
| Attribute | Values |
|---|---|
| value |
Element List "bridgings", Parent Element: "server"
JMS Bridging Definitions. This element list contains zero or more "bridging" elements with this template definition:
Definition
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| name | java.lang.String | Yes | Name of this JMS Bridging |
| direction | java.lang.String | Yes | Bridging Direction |
| localname | java.lang.String | Yes | Name of the local Destination |
| localtype | java.lang.String | Yes | Type of the local Destination |
| remotefactoryname | java.lang.String | Yes | Name of the remote Queue/TopicConnectionFactory |
| remotename | java.lang.String | Yes | Name of the remote Destination |
| remotetype | java.lang.String | Yes | Type of the remote Destination |
| durablename | java.lang.String | No | Name of the durable Subscriber |
| transferpersistence | java.lang.String | Yes | Persistence Mode for Message Transfer |
Values
| Attribute | Values |
|---|---|
| direction | Choice: local_to_remote remote_to_local Default: local_to_remote |
| localname | |
| localtype | Choice: queue topic Default: queue |
| remotefactoryname | |
| remotename | |
| remotetype | Choice: queue topic |
| durablename | |
| transferpersistence | Choice: persistent nonpersistent as_source Default: as_source |
CLI Commands During Deployment
This Swiftlet performs the following CLI commands during deployment:
cc /sys$threadpool/pools
new bridge.server
cc /sys$threadpool/pools/bridge.server/threads
new extension.xt$bridge.server.mgr
cc /sys$threadpool/pools
new bridge.source
cc /sys$threadpool/pools/bridge.source/threads
new extension.xt$bridge.source.queue
new extension.xt$bridge.source.topic
CLI Commands During Undeployment
This Swiftlet performs the following CLI commands during undeployment:
cc /sys$threadpool/pools
delete bridge.server
delete bridge.source