Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The WSO2 MB management console provides capability to create/delete topics and subtopics and to subscribe to topics through a simplified UI. Users can view all the topics available in the server in a tree view and perform various management operations with point-and-click simplicity.

Follow the instructions in the sections below to view and manage topics and subscriptions.:

Table of Contents
maxLevel3
minLevel3

Adding

...

topics

1. Log in to the management console and click Topics -> Add in the Main tab.Image Removed

2.

Anchor
step2
step2
In the Add Topic window that appears, provide the required details and click Add Topic.Image Removed

  • Topic: Name of the topic
  • Permissions: This section lists out all user roles in the server from which required roles can be granted permissions. For information on adding user roles to the server, see Adding and Deleting User Roles.
    • Publish: The role has permission to add topics to the server.
    • Subscribe: The role has permission to subscribe to a published topic.

...

Topics created by external client applications are listed the same way in a tree view when you are in the default "Super Tenant" mode. When a topic is created from a tenant other than the super tenant, the topic appears inside the tenant domain name in the tree view. For example, if the tenant domain is "a.com" and the topic name is "myTopic", the topic is displayed as follows:

The following operations are available for a particular topic:

Table of Contents
maxLevel4
minLevel4

Adding Subtopics 

...

Info

When creating a JMS subscription in tenant mode, the username and topic name should be set in the following manner:

username =username!tenantdomain 
Example: username =rohana!rohana.com; 

topicName = tenantdomain/topicName; 
Example: topicName = rohana.com/Kumara;

Adding subtopics

You can add a subtopic under an existing topic by clicking Add Subtopic in the Topic Browser window. The information that should be provided when adding a subtopic is the same as when adding a main topic, as described in step 2.

6. Once a subtopic is added, it will be displayed in the Topic Browser window under the main topic.

...

To add a topic directly to the root, refer to step 2.                                                                                                                                        

Subscribing to a

...

topic

7. User You can subscribe to a topic by clicking Subscribe in the Topic Browser window.

8. The Subscribe window appears, through which all subscriptions for a particular topic can be done.

...

ParameterDescription
TopicDoes not need to be specified again as it is automatically set.
Subscription Mode

Specify whether to subscribe to this topic only or to hierarchical topics.

    • The default mode is Topic Only where users create the subscription only to the topic and subscribers only receive events which are published only to the topic.
    • Second mode is Topic and Immediate child. In this mode, subscribers of the topic receive events published - not only to the specified topic but also to its immediate children.
    • Last mode of subscription is Topic and Children. In this mode, subscribers of the specified topic receive events published to the specified topic and all its children.
Event Sink URLURL which the subscriber should provide to receive events published. When events are published to the topic, they are sent to the URL specified here.
Expiration TimeUser can specify the expiration time of the subscription. This is not a mandatory parameter, and if user leaves it blank, the subscription will be active indefinitely.

Viewing

...

details

9. User You can view the details of a topic by clicking Details in the Topic Browser window.10. The  The Topic Details  window opensappears.

viewing topic detail

The following table shows descriptions of the parameters on this page:

DetailDescription
Permission DetailsPermissions related to the topic can be viewed here. Permissions can be changed by clearing or selecting the provided check boxes and clicking Update Permissions once done.
WS Subscription Details

All the WS subscriptions for the topic and its children are listed here. The following links are associated with each WS subscription.

    • Unsubscribe - To unsubscribe from the topic, simply click the Unsubscribe link.
    • Renew -
JMS Subscription DetailsAll the durable and non durable JMS subscriptions are listed here.
PublishPublish a sample XML message to a topic. When there is a subscription for the topic, the event sink URL receives the XML message specified here. Click the Publish button after placing the XML message in the provided space.

Deleting a

...

topic

Deletes the topic from the server. To delete a topic, the subscription count for that topic and its children should be zero. If not, an error message appears specifying that there are subscriptions for the topic or its children.