17 SIP Coherence Configuration Reference (coherence.xml)

This chapter describes the Coherence configuration file, coherence.xml, for Oracle Communications WebRTC Session Controller.

Overview of coherence.xml

The coherence.xml configuration file identifies servers that manage the concurrent call state for SIP applications, and specifies distributed cache settings. See "Configuring Coherence" for information on configuring Coherence.

The coherence.xml file resides in the domain_home/config/custom subdirectory where domain_home is the root directory of WebRTC Session Controller domain.

Editing coherence.xml

You can edit coherence.xml using either the Administration Console or a text editor. Changes to the configuration cannot be applied to servers dynamically; you must restart servers to change the SIP server configuration.

XML Schema

The schema file is bundled within the wlss-descriptor-binding.jar library, installed in the Middleware_Home/wlserver/sip/server/lib directory where Middleware_Home is the path to the directory where WebLogic Server is installed.

Example coherence.xml File

Example 17-1 shows the default coherence.xml file.

Example 17-1 Default coherence.xml File

<?xml version='1.0' encoding='UTF-8'?>
<coherence-storage>
  <cache-config>
    <thread-count>20</thread-count>
    <partition-count>257</partition-count>
  </cache-config>
</coherence-storage>

XML Element Description

Table 17-1 describes the elements in the coherence.xml file that govern the Coherence distributed cache service.

Table 17-1 coherence.xml File Elements

Element	Description
thread-count	Specifies the number of threads used in the call-state Coherence cache service used by the SIP server. Oracle recommends that this value be a positive integer but you can specify 0 or -1 to obtain specific behaviors. See the `thread-count` element description in "Cache Configuration Elements" in Developing Applications with Oracle Coherence for more information.
partition-count	Specifies the number of partitions used in the call-state Coherence cache service used by the SIP server. You must specify a positive integer and should specify a prime number. See the `partition-count` element description in "Cache Configuration Elements" in Developing Applications with Oracle Coherence for more information.