By default OpenAM has caching enabled both for configuration data and
also for user data. This setting is governed by the server property
com.iplanet.am.sdk.caching.enabled, which by default is
true. When you set this advanced property to
false, then you can enable caching independently for
configuration data and for user data.
Procedure 18.1. To Turn Off Global User Data Caching
Disabling caching can have a severe negative impact on performance. This is because, when caching is disabled, OpenAM must query a data store each time it needs data.
If, however, you have at least one user data store that does not support LDAP persistent search, such as a relational database or an LDAP directory server that does not support persistent search, then you must disable the global cache for user data. Otherwise user data caches cannot stay in sync with changes to user data entries.
-
In the OpenAM console, browse to Configuration > Servers and Sites >
Server Name> Advanced. -
Set
com.iplanet.am.sdk.caching.enabledtofalseto disable caching overall. -
Set
com.sun.identity.sm.cache.enabledtotrueto enable configuration data caching.All supported configuration data stores support LDAP persistent search, so it is safe to enable configuration data caching.
You must explicitly set this property to
true, because settingcom.iplanet.am.sdk.caching.enabledtofalsein the previous step disables both user and configuration data caching. -
Save your work.
Procedure 18.2. To Change the Maximum Size of Global User Data Cache
With a large user data store and active user base, the number of user entries in cache can grow large.
-
In the OpenAM console, browse to Configuration > Servers and Sites > Default Server Settings > SDK.
-
Change the value of SDK Caching Max. Size, and then Save your work.
There is no corresponding setting for configuration data, as the number of configuration entries in a large deployment is not likely to grow nearly as large as the number of user entries.
