Broker 10.5 | webMethods Broker Documentation | Administering webMethods Broker | Managing Brokers | Creating a Broker
Creating a Broker
When you install Broker Server using the Software AG Installer, the Installer creates one Broker, called "default," on the Broker Server. You can use the following procedure to create additional Brokers on the Broker Server if necessary.
When you create Brokers, the JMS client groups (IS-JMS, JMSClient, and EventMembers) and Broker objects (JMS::Temporary::Queue, JMS::Temporary::Topic, Event::WebM::EventSubscriptionMgmt::SubscriptionChange, and Event::WebM::Deployment) are created by default.
By default, the "can-publish" and "can-subscribe" permissions for Broker objects:
*JMS::Temporary::Queue and JMS::Temporary::Topic are assigned to IS-JMS and JMSClient.
*Event::WebM::EventSubscriptionMgmt::SubscriptionChange is assigned to EventMembers.
You do not need to explicitly initialize the Brokers using the JMSAdmin command-line tool. However, you can use the initialize broker JMSAdmin tool to recreate the default JMS definitions on the currently connected Broker in the event the JMSClient client group, or the JMS::Temporary::Queue and JMS::Temporary::Topic Broker objects were deleted using My webMethods after Broker creation.
You can also use this procedure to add a Broker to a Broker Server that you have created using the server_config utility. Unlike the installation process, the server_config utility does not install a default Broker on a new Broker Server. You must explicitly create the Broker yourself.
Although you can create multiple Brokers on a Broker Server, this capability is provided mainly as a convenience for development organizations that need to develop and test against multiple Broker environments. Running multiple Brokers on a Broker Server is not necessary in a production environment.
*To create a Broker
1. In My webMethods: Messaging > Broker Server s.
2. In the Broker Server s List, click the Broker Server on which you want to create the Broker.
3. Select the Broker s tab and click Add Broker.
4. Complete the following fields.
In this field...
Broker Name
A name for the new Broker.
*The name must be unique among all Brokers on the Broker Server. If the Broker will eventually become a member of a territory or a cluster, its name must also be unique among the members of the territory or cluster.
*The name cannot contain the following characters:
@ / :
*The first character must not be #.
*The name cannot exceed 255 characters.
Optional. A description for the new Broker.
5. If you want this Broker to act as the default Broker, enable the Default Broker option. For additional information about the default Broker, see Configuring a Default Broker .
6. Click Add.