Configuring object or servlet dynamic cache instances
WebSphere® Application Server allows you to configure multiple object or servlet dynamic cache instances in addition to the default instance. Use this procedure to configure additional object or servlet cache instances.
Before you begin
- To use the dynamic cache provider, WebSphere eXtreme Scale must be installed on top of the WebSphere Application Server node deployments, including the deployment manager node. See Installing WebSphere eXtreme Scale or WebSphere eXtreme Scale Client with WebSphere Application Server for more information.
- A WebSphere eXtreme Scale catalog service domain must be configured. See Configuring catalog servers and catalog service domains .
- A WebSphere eXtreme Scale grid environment, that consists of one or more catalog and container servers must be started. See Starting and stopping stand-alone servers.
- If the catalog servers within your catalog service domain have Secure Sockets Layer (SSL) enabled or you want to use SSL for a catalog service domain with SSL supported, then global security must be enabled in the WebSphere Application Server administrative console. You require SSL for a catalog server by setting the transportType attribute to SSL-Required in the Server properties file. For more information about configuring global security, see Global security settings.
About this task
cachespec.xml
configuration file. Any <cache-entry> elements that are
specified within a <cache-instance> element are created in that specific cache instance. Any
<cache-entry> elements that are specified outside of a <cache-instance> element are stored in
the default dynamic cache instance. See Cache instances for more information about object and servlet type cache
instances.- WebSphere eXtreme Scale Version 8.6 is not supported on versions of WebSphere Application Server prior to Version 7.0.
Procedure
What to do next
By default, each dynamic cache instance that is configured on WebSphere Application Server corresponds to a dynamic cache data grid that has the same name as the JNDI name of the cache instance. Also, by default, the data for that cache instance is stored in a dynamic map within that dynamic cache data grid, and the suffix for that dynamic map name also corresponds to the JNDI name of the cache instance. For example, if you were to configure a cache instance on WebSphere Application Server with a JNDI name of cache1, then a dynamic cache data grid is created with the name cache1. Inside data grid cache1, a dynamic map named IBM_DC_PARTIONED_cache1 is created to store the data.
In most cases, this configuration does not need to be changed. However, in some circumstances, you might want multiple cache instances, with different JNDI names, to map to different dynamic maps within the same data grid instance. In other circumstances, you might want multiple cache instances, with the same JNDI name, to map to different dynamic cache data grid instances or different dynamic map instances within the same dynamic cache data grid. For example, if you have an application that uses the default dynamic cache instance (baseCache), you might want to use the same data grid for both of your test level and production level environments, while you keep the cached data in separate data grids or separate dynamic maps within the same data grid.
- com.ibm.websphere.xs.dynacache.grid_name
- Use this custom property to specify the name of the dynamic cache data grid instance to which a dynamic cache instance corresponds.
- com.ibm.websphere.xs.dynacache.cache_name
- Use this custom property to specify the name to be used, in place of the JNDI name, for both the dynamic cache data grid name and the dynamic map inside that data grid. If the com.ibm.websphere.xs.dynacache.grid_name custom property is also set, then the value of this property applies only to the dynamic map name.