Programmatically starting a cluster?

Question

All,
I've been using Coherence for many years and am now experimenting with Extend in the new 12.1.3 release.  I'm trying to run my storage nodes as a simple webapp in Tomcat.  My idea for starting to cache node was to use a ServletContextListener.  I would start the cache in contextInitialized() and stop it in contextDestroyed().
I can't get the startup to work correctly, however.  I need to use a method that doesn't block, so simply calling DefaultCacheServer.main() won't do.
The documentation at 8 Starting and Stopping Cluster Members (12c Release 2 (12.1.2)) is just plain wrong.  For example, there is no constructor to ExtensibleConfigurableCacheFactory that takes a single String as input.
Browsing the API, I see I'm supposed to do something like this:
ConfigurableCacheFactory cacheFactory =
CacheFactory.getCacheFactoryBuilder().getConfigurableCacheFactory(
"coherence-server-config.xml",
Thread.currentThread().getContextClassLoader());
DefaultCacheServer dcs = new DefaultCacheServer(cacheFactory);
dcs.startDaemon(5000);
At first this appears to work.  I get to "Started DefaultCacheServer..." and the output shows that it used the config file I told it to.
My config file has 1 cache scheme and 1 proxy scheme.  Both have autostart=true.
However when I try put() to the cache from an Extend client, I get "An exception occurred while processing a EnsureCacheRequest for Service=Proxy:ExtendTcpProxyService:TcpAcceptor: java.lang.IllegalStateException: Service "DistributedCache" has been started by a different configurable cache factory."  I guess that is telling me that those 2 services were started by different configs.  I didn't expect that.  Do I need to do something else to start start the services in addition to the cache service?
FWIW, these are all of the "loaded" lines in my output:
2014-09-08 09:12:09.295/0.615 Oracle Coherence 12.1.3.0.0 <Info> (thread=main, member=n/a): Loaded operational configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/tangosol-coherence.xml"
2014-09-08 09:12:09.406/0.726 Oracle Coherence 12.1.3.0.0 <Info> (thread=main, member=n/a): Loaded operational overrides from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/tangosol-coherence-override-dev.xml"
2014-09-08 09:12:09.802/1.122 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=main, member=n/a): Loaded cache configuration from "file:/C:/projects/jgregg/coherence-extend-server/target/classes/META-INF/coherence-server-config.xml"
2014-09-08 09:12:14.819/6.139 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=Cluster, member=1): Loaded POF configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/pof-config.xml"
2014-09-08 09:12:14.858/6.178 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=Cluster, member=1): Loaded included POF configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/coherence-pof-config.xml"
2014-09-08 09:12:14.975/6.295 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=main, member=1): Loaded Reporter configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/reports/report-group.xml"
2014-09-08 09:23:58.297/709.617 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=Proxy:ExtendTcpProxyService:TcpAcceptorWorker:0, member=1): Loaded cache configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/coherence-cache-config.xml"
2014-09-08 09:23:58.361/709.681 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=Proxy:ExtendTcpProxyService:TcpAcceptorWorker:0, member=1): Loaded cache configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/internal-txn-cache-config.xml"
As you can see, lines 3 and 7 are for different config files (and different threads.)  Line 7 and 8 only occur after an Extend client tries to do something.
Finally, my config works fine as long as I start the server from the command line.
How am I supposed to do this?
thanks
John

Answer 1

All,
I've been using Coherence for many years and am now experimenting with Extend in the new 12.1.3 release.  I'm trying to run my storage nodes as a simple webapp in Tomcat.  My idea for starting to cache node was to use a ServletContextListener.  I would start the cache in contextInitialized() and stop it in contextDestroyed().
I can't get the startup to work correctly, however.  I need to use a method that doesn't block, so simply calling DefaultCacheServer.main() won't do.
The documentation at 8 Starting and Stopping Cluster Members (12c Release 2 (12.1.2)) is just plain wrong.  For example, there is no constructor to ExtensibleConfigurableCacheFactory that takes a single String as input.
Browsing the API, I see I'm supposed to do something like this:
ConfigurableCacheFactory cacheFactory =
CacheFactory.getCacheFactoryBuilder().getConfigurableCacheFactory(
"coherence-server-config.xml",
Thread.currentThread().getContextClassLoader());
DefaultCacheServer dcs = new DefaultCacheServer(cacheFactory);
dcs.startDaemon(5000);
At first this appears to work.  I get to "Started DefaultCacheServer..." and the output shows that it used the config file I told it to.
My config file has 1 cache scheme and 1 proxy scheme.  Both have autostart=true.
However when I try put() to the cache from an Extend client, I get "An exception occurred while processing a EnsureCacheRequest for Service=Proxy:ExtendTcpProxyService:TcpAcceptor: java.lang.IllegalStateException: Service "DistributedCache" has been started by a different configurable cache factory."  I guess that is telling me that those 2 services were started by different configs.  I didn't expect that.  Do I need to do something else to start start the services in addition to the cache service?
FWIW, these are all of the "loaded" lines in my output:
2014-09-08 09:12:09.295/0.615 Oracle Coherence 12.1.3.0.0 <Info> (thread=main, member=n/a): Loaded operational configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/tangosol-coherence.xml"
2014-09-08 09:12:09.406/0.726 Oracle Coherence 12.1.3.0.0 <Info> (thread=main, member=n/a): Loaded operational overrides from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/tangosol-coherence-override-dev.xml"
2014-09-08 09:12:09.802/1.122 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=main, member=n/a): Loaded cache configuration from "file:/C:/projects/jgregg/coherence-extend-server/target/classes/META-INF/coherence-server-config.xml"
2014-09-08 09:12:14.819/6.139 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=Cluster, member=1): Loaded POF configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/pof-config.xml"
2014-09-08 09:12:14.858/6.178 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=Cluster, member=1): Loaded included POF configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/coherence-pof-config.xml"
2014-09-08 09:12:14.975/6.295 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=main, member=1): Loaded Reporter configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/reports/report-group.xml"
2014-09-08 09:23:58.297/709.617 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=Proxy:ExtendTcpProxyService:TcpAcceptorWorker:0, member=1): Loaded cache configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/coherence-cache-config.xml"
2014-09-08 09:23:58.361/709.681 Oracle Coherence GE 12.1.3.0.0 <Info> (thread=Proxy:ExtendTcpProxyService:TcpAcceptorWorker:0, member=1): Loaded cache configuration from "jar:file:/C:/Users/John.E.Gregg/.m2/repository/com/oracle/coherence/coherence/12.1.3-0-0/coherence-12.1.3-0-0.jar!/internal-txn-cache-config.xml"
As you can see, lines 3 and 7 are for different config files (and different threads.)  Line 7 and 8 only occur after an Extend client tries to do something.
Finally, my config works fine as long as I start the server from the command line.
How am I supposed to do this?
thanks
John