Administration guide > Configure the deployment environment > Configuring cache integration


Configure the dynamic cache provider for WebSphere eXtreme Scale

Overview

To use the dynamic cache provider, WXS must be installed on top of WAS node deployments, including the deployment manager node.

If catalog servers within the catalog service domain have SSL enabled, global security must be enabled using the WAS administrative console. To require SSL for a catalog server set transportType attribute to SSL-Required in the Server properties file.

See also:

  1. Enable the dynamic cache service and servlet caching
  2. Enable WebSphere Commerce data cache

If you are not specifically directing the caching to a defined Object Cache or Servlet Cache instance, then it is likely that the Dynamic Cache API calls are being serviced by the baseCache.

To use the WXS dynamic cache provider for JSP, Web services or command caching, then set the baseCache instance to use the WXS dynamic cache provider.

The same configuration properties are used to configure the baseCache instance. Remember that these configuration properties need to be set as JVM custom properties.

This caveat applies to any cache configuration property discussed in this section except for servlet caching.

To use WXS with the dynamic cache provider for servlet caching, be sure to configure enablement in system properties rather than custom properties.


  1. Enable the WXS dynamic cache provider
  2. Optional: If you are using replicated cache instances
  3. If you are using replicated cache instances, configure the replication setting for the cache.

    With the WXS dynamic cache provider, you can have local cache instances or replicated cache instances.

    If you are only using local cache instances, you can skip this step.

    Use one of the following methods to configure the replicated cache:


  4. Optional: If you are using WXS as a JSP fragment cache
  5. If you are using WXS as a JSP fragment cache, set the custom property...

    com.ibm.ws.cache.CacheConfig.disableTemplateInvalidation

    ...to true to disable template-based invalidations during JSP reloads.


  6. Configure the topology for the dynamic cache service
  7. The only required configuration parameter for the WXS dynamic cache provider is the cache topology. Set the custom property on the dynamic cache service. Enter the name of the custom property as:

    com.ibm.websphere.xs.dynacache.topology

    The three possible values for this property follow. Use one of the allowed values:

    If you are using embedded or embedded partitioned topologies, consider setting the custom property...

    com.ibm.ws.cache.CacheConfig.ignoreValueInInvalidationEvent

    ...to true to save some serialization costs. Set this custom property on the cache instance or the JVM if you are using the baseCache instance.


  8. If you are using an embedded partitioned topology
  9. If you are using an embedded partitioned topology, configure the number of initial containers for the dynamic cache service.

    You can maximize the performance of caches that are using the embedded partitioned topology by configuring the number of initial containers. Set the variable as a system property on the WAS JVM.

    Enter the name of the property as: com.ibm.websphere.xs.dynacache.num_initial_containers.

    The recommended value of this configuration property is an integer that is equal to or slightly less than the total number of WAS instances that are accessing this distributed cache instance. For example, if a dynamic cache service is shared between data grid members, then the value should be set to the number of data grid members.

    For embedded or embedded_partitioned topologies, be using Version 7.0 of WAS. Set the following custom property on the JVM process to ensure that the initial containers are available right away.

    com.ibm.ws.cache.CacheConfig.createCacheAtServerStartup=true


  10. Configure the WXS catalog service grid
  11. When you are using WXS as the dynamic cache provider for a distributed cache instance, configure an WXS catalog service domain.

    A single catalog service domain can service multiple dynamic cache service providers backed by WXS.

    [v7.1 and later] A catalog service can run inside or outside of WAS processes. Starting with WXS V7.1, when you use the administrative console to configure catalog service domains, the dynamic cache uses these settings. It is not necessary to take additional steps to set up a catalog service.

  12. Configure custom key objects.
  13. When you are using custom objects as keys the objects must implement the Serializable or Externalizable interface. When you are using the embedded or embedded partitioned topologies, place objects on the WebSphere shared library path, just like if they were being used with the default dynamic cache provider. See: Use the DistributedMap and DistributedObjectCache interfaces for the dynamic cache.

    If you are using the remote topology, place the custom key objects on the CLASSPATH for the standalone WXS containers. See Start container processes for more information.


  14. Optional: If you are using a remote topology
  15. If you are using a remote topology, configure the WXS container servers...


  16. Enable the sizing agent to improve memory consumption estimates
  17. For distributed or embedded topologies, enable the sizing agent to improve memory consumption estimates.

    The sizing agent estimates memory consumption (usedBytes statistic). The agent requires a Java 5 or higher JVM.

    Load the agent by adding the following argument to the JVM command line:

    -javaagent:WXS lib directory/wxssizeagent.jar

    For an embedded topology, add the argument to the command line of the WAS process.

    For a distributed topology, add the argument to command line of the WXS processes (containers) and the WAS process.


Parent topic:

Configure cache integration


Related concepts

Dynamic cache provider
Dynamic cache capacity planning


Related tasks

Configure JPA loaders
Configure a JPA time-based data updater
Configure HTTP session managers

Related reference

JPA cache configuration properties