Configuring PubSub+ Cache on the Designated Router
This section describes how to configure and manage PubSub+ Cache on a PubSub+ event broker that is acting as the Designated Router for the PubSub+ Cache facility.
Operating Limits
The global operating limits for PubSub+ Cache are listed in the table below.
Performance limits such as maximum cache request rates and maximum message rates depend on several factors:
- the messaging patterns and sizes used
- the number of PubSub+ Cache Instances used for load balancing
- the server hardware where PubSub+ Cache Instances have been deployed.
For guidance on the expected performance of PubSub+ Cache in your application environment, contact Solace.
Feature | Global Limit | 100-tier Limit |
---|---|---|
Maximum number of PubSub+ Cache Instances on an event broker |
1024 |
256 |
Maximum number of cached messages per cached topic |
unlimited |
unlimited |
Maximum number of PubSub+ Cache Instances per Cache Cluster |
16 |
16 |
Maximum number of Cache Clusters per Distributed Cache |
64 |
32 |
Maximum number of PubSub+ Cache Instances supported by the Designated Router across all Message VPNs |
1024 |
256 |
Maximum number of Cache Clusters per Designated Router |
256 |
32 |
Maximum number of Distributed Caches per Designated Router |
256 |
32 |
Maximum number of configured topics per Cache Cluster |
1000 |
100 |
Maximum number of cached topics per Cache Instance |
unlimited |
unlimited |
High-Level Steps for Configuring PubSub+ Cache
The following steps show how to configure the main PubSub+ Cache components on the PubSub+ Cache Designated Router through the Solace CLI. The exact steps required vary depending on your network conditions and preferred configuration.
If you want to use the Global Caching feature, so that client applications can request messages that are cached on remote Distributed Caches, you must provide additional configuration information when you configure Cache Clusters or modify PubSub+ Cache Instance configuration files. For more information, see Global Caching.
- Unlock the PubSub+ Cache feature on the Designated Router.
- Configure a new or an existing Message VPN.
- Configure a Distributed Cache in the Message VPN.
- Configure one or more Cache Clusters within the Distributed Cache.
- Add subscriptions for the topics that the Cache Clusters will listen for.
- Configure one or more PubSub+ Cache Instances within the Cache Clusters.
- Modify a copy of the PubSub+ Cache configuration file (included with the installation package) for each PubSub+ Cache Instance to add the appropriate configuration parameters for communicating with the event broker host. Save each modified configuration file to the Linux system or event broker that the PubSub+ Cache Instance will run on.
This file provides the PubSub+ Cache Instance with configuration information when the PubSub+ Cache service is invoked in the following step. For more information, see Customizing PubSub+ Cache Configuration Files.
If you intend to use the Global Caching feature, review and modify, as necessary, the Global cache request delay and Global cache request time-out parameters. For more information, see Global Caching.
- Follow the steps described within the
README
file (included with the PubSub+ Cache installation package), to install and run the PubSub+ Cache service script on the Linux system or event broker with the modified configuration file. - Enable the created PubSub+ Cache Instances.
- Enable the created Cache Clusters.
- Enable the created Distributed Cache.
- If the Auto Start Mode was not enabled for the PubSub+ Cache Instances you created, run the start Admin EXEC command at the Distributed Cache level to put all the PubSub+ Cache Instances under the Designated Cache into service. See Performing PubSub+ Cache Administrative Tasks.