Managing SolCache

This section describes how to configure and manage SolCache on a Solace router that is acting as the Designated Router for the SolCache facility.

Operating Limits

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.

Global Operating Limits for SolCache

Feature

Limit

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
Cache memory per Solace appliance 8 GB
Maximum number of Distributed Caches per Designated Router 256

Steps to Configure SolCache

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, refer to Using Global Caching.

  1. Unlock the SolCache feature on the Designated Router.

    Refer to Product Key Feature Locking.

  2. Configure a new or an existing Message VPN.

    Refer to Configuring Message VPNs for Caching.

  3. Configure a Distributed Cache in the Message VPN.

    Refer to Configuring Distributed Caches.

  4. Configure one or more Cache Clusters within the Distributed Cache.

    Refer to Configuring Cache Clusters.

  5. Add subscriptions for the topics that the Cache Clusters will be responsible for listening for.

    Refer to Assigning Topics to Cache Clusters.

  6. Configure one or more SolCache Instances within the Cache Clusters.

    Refer to Configuring SolCache Instances.

  7. 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, refer to 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, refer to Using Global Caching.

  8. Following the steps described within the README file (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.
  9. Enable the created SolCache Instances.

    Refer to Configuring SolCache Instances.

  10. Enable the created Cache Clusters.

    Refer to Enabling Cache Clusters.

  11. Enable the created Distributed Cache.

    Refer to Enabling Distributed Caches.

  12. 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. Refer to Starting SolCache Instances.