Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Create weighted distributed topics in a system module


The legacy weighted distributed topic feature is for users who prefer to manually create topic members to carry extra message load or have extra capacity. However, Oracle strongly recommends configuring uniform distributed topics to avoid possible administrative and application problems due to a weighted distributed topic not being deployed consistently across a cluster. For more information on creating a uniform distributed topic, see Create uniform distributed topics in a system module.

To create a weighted distributed topic:

  1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
  2. In the Administration Console, expand Services > Messaging and select JMS Modules.
  3. In the JMS Modules table, click the name of JMS module in which to configure the topic resource.
  4. On the module's Settings page, click the New button in the Summary of Resources table.
  5. On the Create a New JMS System Module Resource page, select Distributed Topic from the list of JMS resources.
  6. Click Next.
  7. On the Distributed Topic Properties page:
    1. In Name, enter a name for the weighted distributed topic.
    2. In JNDI Name, enter the JNDI name used to look up the weighted distributed topic within the JNDI namespace. Applications use the JNDI Name to look up the distributed topic.

      Note: A distributed topic that does not have a JNDI Name can be referenced by passing the Name of the distributed topic to javax.jms.TopicSession.createTopic().

    3. In Load Balancing Policy, specify a policy (Round Robin or Random) for how messages are distributed to the members of this weighted distributed topic.
    4. Clear the Allocate Members Uniformly check box to specify that you want manually allocate the members of this weighted distributed topic.

      Note: Once you create a weighted distributed topic, you cannot rename it. Instead, you must delete it and create another one that uses the new name.

  8. Click Next.
  9. On the member allocation page, select the existing topics that you want to add as members of this weighted distributed topic by moving them from the Available column into the Chosen column.
  10. Click Finish.

    The new weighted distributed topic is added to the module's Summary of Resources table.

  11. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.
    Not all changes take effect immediately—some require a restart (see Use the Change Center).

After you finish

To configure the load balance weighting of the member topics, see Weighted distributed topics - configure member weights.


Back to Top