Maintaining Event Broker Redundancy

:  Unless otherwise noted, the procedures provided in this section apply to both Solace PubSub+ appliances and software event brokers.

This section describes common practices related to maintaining high-availability (HA) event broker redundancy. It also provides topics on how to change the VRID of an active/standby HA appliances, and how to change the IP address used for the message backbone of HA appliances.

Starting/Stopping Event Broker Redundancy

  • To stop the redundancy facility on an event broker, enter the following commands:

    solace# configure
    solace(configure)# redundancy
    solace(configure/redundancy)# shutdown

  • To start the redundancy facility on an event broker, enter the following commands:

    solace# configure
    solace(configure)# redundancy
    solace(configure/redundancy)# no shutdown

Releasing Event Broker Activity

You can release activity on an event broker in an HA pair so that you can perform maintenance operations, such as running privileged admin CLI commands like reload, boot or power-down, on the event broker.

  • To make an event broker surrender its activity, enter the following command:

    solace1(configure/redundancy)# release-activity

    If the command is executed successfully, the configuration status of the event broker becomes “Released”.

  • To allow an event broker take activity back, enter the no version of this command:

    solace1(configure/redundancy)# no release-activity

    If the command is executed successfully, the configuration status of the event broker becomes the same as was before releasing activity.

Forcing Backups to Give Up Activity to Primaries

If a backup event broker has taken activity over from its primary mate (for example, if the primary mate went down, or you were performing maintenance on the primary), and then you want to switch activity to the primary after it is back up, you must do the following:

  1. On the recovered event broker, take activity back through the “no” version of the release-activity command (see Releasing Event Broker Activity above).
  2. On the backup event broker that took activity over, administratively force that event broker to give up activity to its recovered mate (the primary).

    To administratively force an event broker to give up service to its mate, enter the following commands:

    solace2# admin
    solace2(admin)# redundancy revert-activity

Setting Auto-Revert States

The auto-revert option controls what happens when the primary event broker comes back online after a failover has occurred.

When auto-revert is not enabled (the default and recommended state), the primary event broker stays as a standby after it comes back online, allowing the backup event broker to remain active. In this case, the primary event broker becomes active only if the backup event broker fails or gives up activity (see Forcing Backups to Give Up Activity to Primaries).

If auto-revert is enabled, as soon as the primary event broker comes back online, it becomes active and switches the backup event broker from active to standby.

It is recommended that you do not enable auto-revert on event brokers. For example, a manual switch over is recommended so that you can determine why the failure occurred and take action if required before the primary event broker takes activity again.

  • To enable the auto-revert, enter the following commands:

    solace1(configure)# redundancy
    solace1(configure/redundancy)# auto-revert

  • To disable the auto-revert, enter the following commands:

    solace1(configure)# redundancy
    solace1(configure/redundancy)# no auto-revert

:  It's recommended you set the same auto-revert state for both event brokers in an HA pair.

Configuring Mate SMF Ports

By default, the local and mate event brokers listen for SMF traffic on the same ports. If the local and mate event brokers listen on different SMF ports, you must configure each mate SMF port (the ports that the local router's HA mate is listening to for SMF traffic) to match the SMF listen-ports set on the mate event broker.

Configuring mate SMF ports is supported only on PubSub+ software event brokers. On appliances, the local and mate event brokers always listen on the same SMF ports.

To configure each mate SMF port, enter the following commands:

solace(configure)# redundancy

solace(configure/redundancy)# mate-smf-port <port> [compressed | ssl]

Where:

<port> is the SMF listen-port configured on the mate event broker. The default is 0, which means the local and mate event broker both use the same SMF listen-port. This setting is required only when each HA mate listens on a different port.

compressed specifies the compressed SMF listen-port configured on the mate event broker.

ssl specifies the TLS/SSL SMF listen-port configured on the mate event broker.

The no version of this command, no mate-smf-port, resets this value to the default.