Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Uniform distributed topics - pause message operations on server restart


In the event that you need to troubleshoot a uniform distributed topic, you can temporarily pause all message production, insertion (in-flight messages), and consumption operations on each topic member. By temporarily pausing message production and insertion to a distributed topic, you can effectively drain all the existing messages for troubleshooting purposes, and then resume message production and insertions once the issue has been resolved.

To configure message pausing on the members of a 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, navigate to the uniform distributed topic resource that you want to configure:
  3. On theConfiguration: General page, click the Advanced button to define the message pausing options:
    1. Select the Pause Message Insertion At Startup check box to indicate whether the insertion of "in-flight" messages is paused on this distributed topic when the host server is restarted. When a distributed topic is paused for message insertion, then in addition to pausing the new message production operations, all messages that are result of the in-flight work completion are also prevented from appearing on the distributed topic. To resume the insertion of in-flight messages to destinations targeted to the distributed topic, clear this check box and restart the host server.
    2. Select the Pause Message Production At Startup check box to indicate whether production of new messages is paused on this distributed topic when the host server is restarted. When a distributed topic is paused for message production, it prevents any new message production operations from both new and existing producers attached to the distributed topic. To resume message production to this distributed topic, clear this check box and restart the host server.
    3. Select the Pause Message Consumption At Startup check box to indicate whether message consumption is paused on this distributed topic when the host server is restarted. When a distributed topic is paused for message consumption, it prevents any further message consumption operations from the distributed topic. To resume the consumption of messages on this distributed topic, clear this check box and restart the host server.

    For more information about these fields, see Advanced Configuration Options.

  4. Save your changes:
  5. 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

If you modify message pausing options on a distributed topic, you must restart the Administration Server.


Back to Top