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, define the uniform distributed topic's basic properties:
    1. In Name, enter a name for the uniform distributed topic.

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

    2. In JNDI Name, enter the JNDI name used to look up the uniform distributed topic within the JNDI namespace. Applications use the JNDI Name to look up the distributed topic.

      If you do not specify a JNDI name for the distributed topic, it will not be available for JNDI lookup even after it has been targeted to a server resource. Therefore, you will only be able to access the distributed topic using the javax.jms.topicSession.createtopic() API or in an application-scoped context.

    3. In Destination Type, specify Weighted.
  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