ZCS Administrator's Guide Open Source Edition 6.0, Rev 1

Flushing LDAP Cache

Themes and Locales

Accounts, COS, Domains, and Servers

Global Configuration

The Zimbra LDAP server caches the following types of entries

•	Themes (skins)

•

Locales

•

Account

•

COS

•

Domains

•	Global configuration

•

Server

•	Zimlet configuration

Themes and Locales

When you add or change skin (themes) properties files and local resource files for ZCS on a server, you flush the cache to reload the new content. Until you do this, the new skins and locales are not available in the COS or Account.

•	To flush skins, type zmprov flushCache skin

•	To flush locales, type: zmprov flushCache locale

Note: Flushing the skin/locale cache only makes the server aware of the resource changes. It does not automatically modify any COS or account’s LDAP zimbraAvailableSkin and zimbraAvailableLocal settings. The LDAP attributes must be modified separately either from the administration console or with the zmprov ma command.

Accounts, COS, Domains, and Servers

When you modify Account, COS, Domain, and Server attributes, the change is effective immediately on the server to which the modification is done. On the other servers, the LDAP entries are automatically updated after a period of time if the attributes are cached. Use zmprov flushCache to make the changes available immediately on a server.

Note: The default ZCS setting for updating the server is 15 minutes.

•	To flush accounts, COS, domain, and server caches, type zmprov flushCache [account|cos|domain|server] [name|id]

If you do not specify a name or ID along with the type, all entries in cache for that type are flushed and the cache is reloaded.

Note: Some server attributes are not effective until after a server restart, even after the cache is flushed. For example, settings like bind port or number of processing threads.

Global Configuration

When you modify global config attributes, the changes are effective immediately on the server to which the modification is done. On other mailbox servers, you must flush the cache to make the changes available or restart the server. LDAP entries for global config attributes do not expire.

Note: Some global config attributes are computed into internal representations only once per server restart. For efficiency reasons, changes to those attributes are not effective until after a server restart, even after the cache is flushed. Also, some global configuration settings and server settings that are inherited from global config are only read once at server startup, for example port or number of processing threads. Modifying these types of attributes requires a server restart.

To make a global config change effective on all servers do the following:

1.	Modify the setting using zmprov mcf. For example, type zmprov mcf zimbraImapClearTextLoginEnabled.

Note: The change is only effective on the server zimbra_zmprov_default_soap_server, port zimbra_admin-service_port.

2.	Flush the global config cache on all other servers, zmprov flushCache must be issued on all servers, one at a time. For example:

zmprov –s server-1 flushCache config

zmprov –s server-2 flushcache config

zmprov –s server-3 flushcache config

ZCS Administrator's Guide Open Source Edition 6.0, Rev 1