The following section describes how to set up Oracle Communications Services Gatekeeper geographically redundant site pairs and the maintenance attributes and operations for the geographic redundancy service once it is set up. It also provides a workflow for the configuration:
The geographic redundancy service replicates data between two geographically distant sites so that applications can switch from one site to another (for example, in case of the catastrophic failure of one) and still have all the configuration data (account information, system SLAs, and budgets) necessary for SLA enforcement available at the second, remote, site. For more information about geographic redundancy, see section Redundancy, Load Balancing, and High Availability chapter in Oracle Communications Services Gatekeeper Concepts and Architectural Overview.
The sites are set up in pairs. One member of the pair is designated the geomaster, the other the slave. Each geographic site has a name which is used for looking up data relevant to the site pair. The name of the remote site is defined in the local site.
There are two stages to configuring basic geographic redundancy. Both must be done at each site.
To use geographic redundancy, each site must be appropriately configured. This is accomplished using the GeoRedundantService. Using this service, you:
One site of the site pair must be designated the geomaster site. This is accomplished using the GeoStorageService. Using this service, you:
Managed object: Container ServicesGeoRedundantService
MBean Type: com.bea.wlcp.wlng.core.budget.management.configuration.GeoRedundantServiceMBean
Below is a list of attributes and operations for configuration and maintenance:
Defines the name of this geographic redundant site. Must be done at both sites. This name is used as key for all operations on the remote site - see Operation: setSiteAddress, Operation: getSiteAddress, Operation: removeSite.
Specifies the number of attempts made by a site to reach its peer site before raising an alarm. Must be done at both sites.
Whenever the peer sites fail to establish a connection the number of times defined in RemoteSiteReachabilityAlarmThreshold
, a connection lost alarm is raised.
getSiteAddress(Site name: String)
Displays the address of a given remote site.
listRemoteSites()
Displays a list of registered remote sites.
removeSite(Site name: String)
Removes a site definition for a remote site. If both sites are operational, must be done at both sites
setSiteAddress(Site name: String, Address: String)
Specifies the address of a remote site. Must be done at both sites
Managed object: Container ServicesGeoStorageService
MBean Type: com.bea.wlcp.wlng.geostorage.management.GeoStorageServiceMBean
Below is a list of attributes and operations for configuration and maintenance:
Defines the geomaster site. This value must be set at both sites and must be one of the two GeoSiteIds set up using the GeoRedundant service. The geomaster keeps the master copy of all geo-configurable data.
Note: | If a new site is added to replace a slave site that has failed, it must be added as a slave site. The site that is designated the geomaster site must remain the geomaster site for the lifetime of the site configuration. |
Note: | If a geomaster site fails permanently, this attribute should be set to empty (temporarily terminating georedundancy) and the failed site should be removed from the configuration using the GeoRedundantService. If a replacement site is added to the configuration, the currently operating site must be the geomaster and the replacement site must be added as the slave. |
syncFromGeoMaster()
Forces the slave to resync the account configuration data with the geomaster. Should only be invoked from the slave site. This is used if, for example, the configuration data of the two sites get out of sync, resulting in multiple out-of-sync alarms.
Note: | This operation potentially copies large amounts of data and therefore should not be used during peak traffic hours. |