Config-Sync Overview

A Solace PubSub+ event broker maintains two separate types of configuration information:

  • System-level configuration information
  • Configuration information for each Message VPN

If you are deploying event brokers in high-availability (HA) redundant pairs, or in replicated data centers, the use of Config-Sync will automatically propagate changes in both types of configurations between two event brokers so that they remain in sync.

In both kinds of deployments, Config‑Sync relies on Guaranteed Messaging, which must be configured and enabled on each event broker involved.

Automatic propagation of durable endpoint information

For redundant appliances that are handling Guaranteed Messaging, durable endpoint information, such as queue and topic endpoints, topic-to-queue mappings, and queue options, is automatically propagated whether or not Config-Sync is enabled.

Config-Sync doesn't automatically synchronize all configuration properties

Some configuration parameters that are considered unique to an event broker, or related to licensing or security, are not automatically propagated between mates when Config-Sync is enabled. Therefore, they must be manually configured for each event broker. For more information, see Properties That Are Not Synchronized.

Synchronizing High Availability Deployments

When HA redundancy is used, the configurations of both event brokers in an HA pair must be the same and remain in-sync while the event brokers are running. Config-Sync automatically synchronizes configuration of such pairs .In other words, the ownership model, in this case, is master-master.

When the configuration of the HA pair is out-of-sync (for example, due to initial deployment or connectivity loss between the HA pair), Config-Sync must be instructed which paired message brokers has the correct configuration for both the system-level configuration and for each Message VPN-level configuration. This is done by asserting the master configuration over its mate. For each HA pair, the system-level configuration must be asserted, and each Message VPN-level configuration must also be asserted.

Synchronizing Replication Deployments

Config-Sync must be used in replication deployments to synchronize Message VPN-level configuration parameters between replication mates.

When replication is enabled on an event broker, a replication Config-Sync bridge is automatically created to link a replicated event broker with its mate, and Message VPNs are automatically synchronized.

For replication deployments, the master Message VPN is always the one configured as “Replication Active.” Any configuration changes made to the master Message VPN is automatically pushed to its slave, the corresponding Message VPN configured as “Replication Standby.” Configuration changes are not allowed on the Message VPN configured as“Replication Standby.” The ownership model, in this case, is master-slave.

Notice that if the Message VPN is also in an HA redundant configuration, its changes are also pushed to the redundant mate event brokers.

System Resources Used by Config-Sync

Config-Sync consumes additional system resources on an event broker; more specifically, it creates and uses:

  • one Message VPN
  • four clients for itself, and two more for each synchronized Message VPN
  • nine topic subscriptions for itself, and six more for each synchronized Message VPN
  • three queues for itself, and two more for each synchronized Message VPN

It's important to count in the resources listed above as they are limited by system-level limits. See Guaranteed Message Queuing Limits.

All resources created and used by Config-Sync are all named as #config-sync, except for its clients, which are named #config-sync/<router-name>. Any of the resources created and used by Config-Sync cannot be deleted or directly edited.