Merge pull request #2365 from stianst/KEYCLOAK-2612
KEYCLOAK-2612 Set default eviction strategy for users cache
This commit is contained in:
commit
8f2c5af7d1
2 changed files with 23 additions and 8 deletions
|
@ -22,12 +22,22 @@
|
|||
(realm, application, client, roles, etc...) and one for users. These caches greatly improves the performance of the server.
|
||||
</para>
|
||||
|
||||
<section>
|
||||
<title>Eviction and Expiration</title>
|
||||
|
||||
<para>
|
||||
By default the user cache contains a maximum of 10000 entries. This is not 10000 users, but 10000 entries in the cache. You can change the maximum
|
||||
number of entries by editing the server configuration <literal>standalone.xml</literal> or <literal>standalone-ha.xml</literal>.
|
||||
Locate the element <literal>cache-container name="keycloak"</literal> and change the eviction policy for the <literal>users</literal> cache. For
|
||||
more information see <ulink url="https://docs.jboss.org/author/display/WFLY10/Infinispan+Subsystem">Infinispan Subsystem documentation</ulink>.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<title>Disabling Caches</title>
|
||||
<para>
|
||||
The realm and user caches can be cleared through the management console. To
|
||||
disable the realm or user cache, you must edit the <literal>keycloak-server.json</literal> file
|
||||
in your distribution. Here's what the config looks like initially.
|
||||
To disable the realm or user cache, you must edit the <literal>keycloak-server.json</literal> file
|
||||
in your distribution. Here's what the config looks like initially.
|
||||
</para>
|
||||
<para>
|
||||
<programlisting><![CDATA[
|
||||
|
@ -44,7 +54,7 @@
|
|||
},
|
||||
]]></programlisting>
|
||||
</para>
|
||||
<para>You must then change it to:
|
||||
<para>To disable the cache set the enabled field to false for the cache you want to disable:
|
||||
<programlisting><![CDATA[
|
||||
"userCache": {
|
||||
"infinispan" : {
|
||||
|
@ -60,11 +70,12 @@
|
|||
]]></programlisting>
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<title>Clear Caches</title>
|
||||
<para>
|
||||
To clear the realm or user cache, go to the Keycloak admin console Realm Settings->Cache Config page. Disable the cache
|
||||
you want. This will cause the cache to be cleared.
|
||||
To clear the realm or user cache, go to the Keycloak admin console Realm Settings->Cache Config page. On this page you can clear the realm cache
|
||||
or the user cache. This will clear the caches for all realms and not only the selected realm.
|
||||
</para>
|
||||
</section>
|
||||
</chapter>
|
||||
|
|
|
@ -26,7 +26,9 @@
|
|||
<replacement placeholder="CACHE-CONTAINERS">
|
||||
<cache-container name="keycloak" jndi-name="infinispan/Keycloak">
|
||||
<local-cache name="realms"/>
|
||||
<local-cache name="users"/>
|
||||
<local-cache name="users">
|
||||
<eviction max-entries="10000" strategy="LRU"/>
|
||||
</local-cache>
|
||||
<local-cache name="sessions"/>
|
||||
<local-cache name="offlineSessions"/>
|
||||
<local-cache name="loginFailures"/>
|
||||
|
@ -87,7 +89,9 @@
|
|||
<cache-container name="keycloak" jndi-name="infinispan/Keycloak">
|
||||
<transport lock-timeout="60000"/>
|
||||
<invalidation-cache name="realms" mode="SYNC"/>
|
||||
<invalidation-cache name="users" mode="SYNC"/>
|
||||
<invalidation-cache name="users" mode="SYNC">
|
||||
<eviction max-entries="10000" strategy="LRU"/>
|
||||
</invalidation-cache>
|
||||
<distributed-cache name="sessions" mode="SYNC" owners="1"/>
|
||||
<distributed-cache name="offlineSessions" mode="SYNC" owners="1"/>
|
||||
<distributed-cache name="loginFailures" mode="SYNC" owners="1"/>
|
||||
|
|
Loading…
Reference in a new issue