Managing Topics and Subscriptions
- Former user (Deleted)
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 below to view and manage topics and subscriptions.
1. Log in to the management console and select "Topics -> Add" menu from the "Main" menu.
2. The "Add Topic" window opens. Provide the required details and click "Add Topic" button.
- 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.
3. If the topic is added successfully, a message appears. Click "Ok" to view the "Topic Browser" where the newly-added topic is listed in a tree view.
4. Initially this tree view does not display any of the operations available for the topic. Clicks on the topic to view all the operations available for it.
The following operations are available for a particular topic.
Add Subtopic
5. User can add a subtopic under an existing topic by clicking the "Add Subtopic" link 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.                                                                    Â
Subscribe
7. User can subscribe to a topic by clicking the "Subscribe" link in the "Topic Browser" window.
8. The "Subscribe" window opens, through which all subscriptions for a particular topic can be done.
The following table shows descriptions of the parameters on this window.
| Parameter | Description |
|---|---|
| Topic | Does 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.
|
| Event Sink URL | URL 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 Time | User 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. |
Details
9. User can view details of a topic by clicking the "Details" link in the "Topic Browser" window.
10. The "Topic Details" window opens.
Following table shows descriptions of the parameters on this page.
| Detail | Description |
|---|---|
| Permission Details | Permissions related to the topic can be viewed here. Permissions can be changed by un-checking and checking the provided check boxes and clicking the "Update Permissions" button 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.
|
| JMS Subscription Details | All the durable and non durable JMS subscriptions are listed here. |
| Publish | Publish 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. |
Delete
Deletes the topic from the server. To delete a topic, the subscription count for that topic and its children should be zero. Else, it prompts an error message specifying that there are subscriptions for the topic or its children.