KB Article #176708

Distributed caches with spaces or special characters in the name cause errors during deploy

Problem

-- Distributed caches with spaces in the name cause the CacheManager to shut down on deploy with an error like:


ERROR 2015/01/05 15:33:23.598 Failed to configure module: store+com.vordel.store.util.env.EnvExpandEntityStore@78cb7d Entitity={ OAuth2StoresGroup ESPK = DEFAULT_EXTCONNS_VordelGateway_7.3.1:8 with parent pk as DEFAULT_PRIMARY_VordelGateway_7.3.1:0 and fields as {name=[name{OAuth2 Stores}]} }:
java.lang.IllegalStateException: The CacheManager has been shut down. It can no longer be used.
at net.sf.ehcache.CacheManager.checkStatus(CacheManager.java:1254)
[snip]
at javax.servlet.http.HttpServlet.service(HttpServlet.java:853)


Resolution

* Rename the cache to contain only characters that are legal in a URL. This occurs because the gateway tries to create an access URL for the cache that contains the cache's name. If the cache name contains illegal characters, that will fail and take down the cache manager. Note that while the cache manager is down, both local and distributed caches will be unavailable, even if the faulty distributed cache is not being used.