6 Configuring Coherence

This chapter describes how to configure the Oracle Coherence storage provider in Oracle Communications Services Gatekeeper.

About Configuring Coherence

Coherence is used for clustering in Services Gatekeeper. The storage service uses Coherence for cluster-wide storage.

In a basic domain configuration, a default Coherence configuration is created when you create the domain. In a clustered environment you need to create a Coherence configuration.

You can declare the Coherence cluster-related attributes like multicast address and port, unicast address and port overrides using the administration console. WebLogic stores the attributes in the WebLogic configuration repository and makes them available to the Coherence cluster service.

Coherence supports two different types of addressing:

• Multicast, where all messages are broadcast to all servers in the network.

• Unicast, where the servers in the network tier are aware of the IP-addresses, or host-names, of all servers in the tier and only send messages to this well-known set of addresses.

For details about Coherence configuration, see section “Operational Configuration Elements” in Oracle Communications Services Gatekeeper Coherence Developer's Guide.

Configuring Coherence

To configure Coherence:

1. Log in to the administration console.

2. Expand the Services section in the Domain Structure pane.

3. Click on Coherence Clusters.

4. Click New.

   The Create Coherence Cluster Configuration screen is displayed.

5. Enter Coherence-OCSG in the Name field. This is a fixed value and must be entered exactly as stated.

6. Make sure that Use a custom Cluster Configuration File is not selected.

7. Click Next.

   The Coherence Cluster Addressing page is displayed.

8. If you are using unicast addressing:

   1. Enter the IP address for the cluster unicast listener in the Unicast Listen Address field.

   2. Enter the port for the cluster unicast listener in the Unicast Listen Port field.

   3. Check Unicast Port Auto Adjust if the unicast port number should be automatically incremented if the port cannot be bound because it is already in use.

9. If you are using multicast addressing:

   1. Enter the IP address for the cluster multicast listener in the Multicast Listen Address field.

   2. Enter the port for the cluster multicast listener in the Multicast Listen Port field.

10. Click Next.

    The Coherence Cluster Targets page is displayed.

11. Select all Network Tier servers as Coherence Cluster targets by selecting the check-box in front of Network_Tier_Cluster_Name, where Network_Tier_Cluster_Name is the name of your network tier cluster.

12. Click the All servers in the cluster radio-button in the Network_Tier_Cluster_Name group.

13. Click Finish.

    The Summary of Coherence Clusters page is displayed.

14. Click Coherence-OCSG.

    The Settings for Coherence-OCSG page is displayed.

15. Click the Well Known Addresses tab.

    The Well Known Addresses page is displayed.

16. For each Network Tier server:

    1. Click New.

       The Coherence Cluster configuration Properties page is displayed.

    2. Enter the name of the Coherence cluster configuration in the Name field.

    3. Enter the IP address to listen to in the Listen Address field.

    4. Enter the port to listen to in the Listen Port field.

    5. Click OK.