Skip Headers

# Configuring cache-synchronization Properties

Previous

Next

When you select TopLink as the persistence manager (see `name` in Table: orion-ejb-jar.xml File persistence-manager Entries), use the `pm-properties` subentry for `cache-synchronization` (see Table: orion-ejb-jar.xml File pm-properties Subentries for cache-synchronization) to configure TopLink cache coordination features of the session that the TopLink run time uses internally for CMP projects. For more information about TopLink cache coordination, see "Understanding Cache Coordination".

When this subentry is present, you must use a customization class (see `customization-class` in Table: orion-ejb-jar.xml File persistence-manager Subentries for pm-properties) to complete cache coordination configuration. For more information about TopLink cache coordination configuration, see Configuring a Coordinated Cache.

orion-ejb-jar.xml File pm-properties Subentries for cache-synchronization

Entry | Description
--- | ---

`mode`

An indicator of whether or not cache coordination updates should be propagated to other servers synchronously or asynchronously. Valid values are as follows:

- `asynchronous` (default)

- `synchronous`

`server-url`

For a JMS coordinated cache: assuming that you are using the Oracle Application Server Containers for J2EE (OC4J) JNDI naming service and that all the hosts in your coordinated cache can communicate using OC4J proprietary RMI protocol ORMI, use a URL like:

    ormi://<JMS-host-IP>:<JMS-host-port>

where `JMS-host-IP` is the IP address of the host on which the JMS service provider is running and `JMS-host-port` is the port on which the JMS service provider is listening for JMS requests.

For an RMI or CORBA coordinated cache: assuming that you are using the OC4J JNDI naming service and that all the hosts in your coordinated cache can communicate using OC4J proprietary RMI protocol ORMI on OC4J default port 23791, use a URL like:

    ormi://<session-host-IP>:23791

where `session-host-IP` is the IP address of the host on which this session is deployed.

`server-user` | Optional username required to log in to the JNDI naming service.