This section describes how to configure and manage SolCache on a Solace router that is acting as the Designated Router for the SolCache facility.
The global operating limits for SolCache are listed in the table below.
Note: Performance limits such as maximum cache request rates and maximum message rates depend on the messaging patterns and sizes being used, the number of SolCache Instances being used for load balancing, and the server hardware on which SolCache Instances have been deployed. For further guidance on the expected performance of SolCache in your application environment, contact Solace support.
|Maximum number of cached messages per cached topic||100,000,000|
|Maximum number of SolCache Instances per Cache Cluster||16|
|Maximum number of Cache Clusters per Distributed Cache||64|
|Maximum number of SolCache Instances supported by the Designated Router across all Message VPNs||1024|
|Maximum number of Cache Clusters per Designated Router||256|
|Maximum number of configured topics per Cache Cluster||1000|
|Maximum number of cached topics per SolCache Instance||4,000,000|
|Maximum number of Distributed Caches per Designated Router||256|
The following steps show how to configure the main SolCache components on the SolCache Designated Router through the Solace CLI. The exact steps required will vary depending on your network conditions and preferred configuration.
Note: If you want to use the Global Caching feature, so that client applications can request messages that are cached on remote Distributed Caches, additional configuration information must be provided when configuring Cache Clusters and when modifying SolCache Instance configuration files. For more information on the Global Caching feature, see Using Global Caching.
- Unlock the SolCache 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 be responsible for listening for.
- Configure one or more SolCache Instances within the Cache Clusters.
- Modify a copy of the provided configuration file (included with the SolCache Instance installation package) for each SolCache Instance so that it has the appropriate configuration parameters for communicating with a Solace router host. Each modified configuration file must be saved to the Linux system or Solace router that the SolCache Instance will run on.
This file provides a SolCache Instance with configuration information when SolCache service is invoked in the following step. For additional information, see Customizing SolCache Instance Configuration Files.
Note: If you are going to use the Global Caching feature be sure to review, and modify, as necessary, the Global cache request delay and Global cache request time-out parameters. For more information on Global Caching, see Using Global Caching.
- Following the steps described within the
READMEfile (included with the SolCache Instance installation package), to install and run the SolCache service script on Linux system or Solace router with the modified configuration file.
- Enable the created SolCache Instances.
- Enable the created Cache Clusters.
- Enable the created Distributed Cache.
- If the Auto Start Mode was not enabled for the SolCache Instances that were created, run the start Admin EXEC command at the Distributed Cache level to put all the SolCache Instances under the Designated Cache into service. See Starting SolCache Instances.