12.2. Adding a Transport Connector to a Fabric Broker

Note

The management console makes configuring fabric brokers easier. For more information see Using the Management Console.

To add a transport connector definition:

Create a configuration template.
See Section 2.1, “Understanding the Red Hat JBoss A-MQ Configuration Model”.
Locate the transportConnectors element.
Add a transportConnector element as a child of the transportConnectors element.
Add a name attribute to the new transportConnector element.
The name attribute specifies a unique identifier for the transport connector. It is used in the connectors property to identify the transport to be activated.
Add a uri attribute to the new transportConnector element.
The uri attribute specifies the connection details used to instantiate the connector. Clients will use a similar URI to access the broker using this connector. For a complete list of the URIs see the Connection Reference.
Save the changes to the configuration template.
In the command console, use the fabric:import command to upload the your XML configuration template to the Fabric Ensemble.
```
JBossAMQ:karaf> fabric:import -t /fabric/configs/versions/version/profiles/mq-base/configFile configFile
```
version must match the version of the new profile.
Use the fabric:mq-create command to create a new profile.
```
JBossAMQ:karaf> fabric:mq-create --config configFile profileName
```
This will create a new broker profile that inherits from the mq-base profile, but uses your XML configuration template.

Note

The newly added transport connector is not available until the profile containing it is modified to activate the connector.

To activate a transport connector in a fabric broker:

Connect to the broker using a command console.
Verify the value of the connectors property for the desired profile using the fabric:profile-display command.
```
JBossAMQ:karaf> fabric:profile-display profileName
```
Change the value of the connectors property using the fabric:profile-edit command's -p option.
```
JBossAMQ:karaf> fabric:profile-edit -p org.fusesource.mq.fabric.server-profileName/connectors="connector1 connector2..." profileName
```
connector1 specifies the name of a transport to activate. The value corresponds the value of the transportConnector element's name attribute.
Deploy the new profile to one or more brokers in the fabric to test the changes.
```
JBossAMQ:karaf> fabric:container-add-profile broker profileName
```