Cluster property
names begin with com.sybase.jaguar.cluster.
A cluster configures load balancing and failover support for an
application that is deployed to two or more host machines. In EAServer
Manager, configure cluster properties in the Cluster Properties
dialog box.
Chapter 6, “Clusters and Synchronization”
Specifies the bind password for cluster name servers.
password
Where password is the bind password.
When you create a cluster, a random bind password is automatically generated. In most cases, you do not need to edit the password. However, if a name server is used by two or more clusters, you must configure the clusters to use the same bind password.
In EAServer Manager, set this property using the Advanced tab in the Cluster Properties dialog box.
When using adaptive load balancing, specifies how often each server broadcasts its load metrics.
The broadcast interval, in minutes. The default is 5.
com.sybase.jaguar.cluster.DLBpolicy
When using adaptive load balancing, specifies how often the load collectors in the name servers calculate and generate a normalized load list (NLL) of all member servers.
The interval, in minutes. The default is 10.
com.sybase.jaguar.cluster.DLBpolicy
Enables configuration of the dynamic load balancing policies (weighted or adaptive).
true or false.
The default is false.
com.sybase.jaguar.cluster.DLBpolicy
The maximum weight, used in a weighted load balancing policy, of any server.
An integer value. The default is five. The maximum value is ten.
com.sybase.jaguar.cluster.DLBpolicy, com.sybase.jaguar.cluster.DLBweights
Specifies the algorithm to distribute component invocations between the servers in the cluster.
One of the following values:
Value |
To indicate |
|---|---|
Random (the default) |
Random load distribution. Clients are assigned to servers by picking the server at random. Load distribution should average to equal values over time. |
Round-Robin |
Round-robin load distribution. Clients are assigned to servers in sequence. |
Weighted |
Random load distribution, with server weights assigned by the com.sybase.jaguar.cluster.DLBweights property. Server loads should average to proportions of the assigned weights. |
Adaptive |
Adaptive load distribution, based on load metrics that are configured by these properties: |
You must set the com.sybase.jaguar.cluster.DLBenable property to true to use value Weighted or Adaptive.
com.sybase.jaguar.cluster.DLBenable, com.sybase.jaguar.cluster.DLBbroadcastInterval, com.sybase.jaguar.cluster.DLBcalculateInterval, com.sybase.jaguar.cluster.DLBmaxWeight, com.sybase.jaguar.cluster.DLBrefreshInterval, com.sybase.jaguar.cluster.DLBsampleInterval, com.sybase.jaguar.cluster.DLBweights
When using adaptive load balancing, specifies how often each name server obtains the NLL from its local load collector. All name servers have their own copies of the NLL.
The interval, in minutes. The default is 10. The refresh interval must be equal to or greater than the calculate interval specified by com.sybase.jaguar.cluster.DLBcalculateInterval.
com.sybase.jaguar.cluster.DLBpolicy, com.sybase.jaguar.cluster.DLBcalculateInterval
When using adaptive load balancing, specifies how often each server collects its load metrics.
The sampling interval, in seconds. The default is 5.
com.sybase.jaguar.cluster.DLBpolicy
When using the weighted load balancing policy, specifies the relative weights assigned to each server.
A comma separated list of server URLs and integer weight values, in the form:
url1|weight1,url2|weight2, ....
Where:
url1, url2, and so forth, are the IIOP URLs for the servers in the cluster.
weight1, weight2, and so forth, are the integer weights assigned to each server in the cluster. No value can exceed the value of com.sybase.jaguar.cluster.DLBmaxWeight.
com.sybase.jaguar.cluster.DLBenable, com.sybase.jaguar.cluster.DLBmaxWeight, com.sybase.jaguar.cluster.DLBpolicy
Specifies the initial naming context for the cluster naming services.
context
Where context is the initial naming context, for example, “/UK/BusinessComponents”.
In EAServer Manager, set this property using the Advanced tab in the Cluster Properties dialog box.
Specifies mirror groups used for in-memory component state replication.
Specify a comma-separated list of mirror pairs, each of the form:
url1|url2
Where ur1l and url2 are the IIOP listener URLs for the servers in the mirror pair, using host names. For example, this value specifies two mirror pairs:
iiop://mypc:9000|iiop://yourpc:9100,iiop://hispc:9500|iiop://herpc:9600
Each server in a mirror pair must be a member of the cluster, and one server cannot be a member of more than one mirror pair. Servers in a mirror pair should have the same set of stateful components installed.
In EAServer Manager, configure this property on the Mirror Pairs tab in the Cluster Properties dialog box.
com.sybase.jaguar.cluster.ipmirrorgroups
Specifies mirror groups used for in-memory component state replication.
Same as for com.sybase.jaguar.cluster.ipmirrorgroups, except that you must use IP addresses rather than host names.
com.sybase.jaguar.cluster.ipmirrorgroups
Specifies the cluster name.
name
Where name is the cluster name.
In EAServer Manager, this property is set when the cluster is created, and cannot be changed.
Specifies the cluster’s name servers as a list of IIOP URLs.
ns1, ns2, ...
Where ns1, ns2, and so forth are IIOP URLs of the form:
iiop://host:port
Where host is the host name and port is the IIOP port number. For example:
iiop://bigbox:9000
In EAServer Manager, set this property using the Name Servers tab in the Cluster Properties dialog box.
“Adding a name server to a cluster”, “Removing a server from a cluster”
Specifies the IIOP URL of the primary cluster, which is the source server of the last synchronize operation.
iiop://host:port
Where host is the host name and port is the IIOP port number.
This property is set automatically when you synchronize a cluster, and should be considered read-only.
In EAServer Manager, the primary server is displayed in the Primary Server field on the General tab in the Cluster Properties dialog box.
Specifies the servers in the cluster as a list of IIOP URLs.
url1, url2, ...
Where url1, url2, and so forth are IIOP URLs of the form:
iiop://host:port
Where host is the host name and port is the IIOP port number. For example:
iiop://bigbox:9000
In EAServer Manager, set this property using the Servers tab in the Cluster Properties dialog box.
“Configuring a server to enable synchronization”, “Adding a server to a cluster”, “Removing a server from a cluster”
Specifies what form of cluster version control member servers perform before joining a cluster.
startup_check
Where startup_check is one of:
check_primary (the
default) to specify that the server version must be equal to the
primary server’s version.
check_servers to
specify that the server version must be equal to a majority of servers
in the cluster.
disable_check to
disable cluster version checking (not recommended).
In EAServer Manager, set this property on the Advanced tab in the Cluster Properties dialog box.
com.sybase.jaguar.cluster.version “Cluster start-up options”
Contains audit information for previous synchronize operation.
audit_text
Where audit_text is text describing the last synchronize operation.
This property is set when you synchronize a cluster and should be considered read-only. In EAServer Manager, view the property using the Advanced tab in the Cluster Properties dialog box.
Specifies the version number of the cluster. The version number automatically increments each time you synchronize the cluster.
version
Where version is the version number. The default for a new server is 0.
This property is set when you synchronize a cluster and should be considered read-only. In EAServer Manager, view the property using the Advanced tab in the Cluster Properties dialog box.
“Synchronization”, “Cluster start-up options”, com.sybase.jaguar.cluster.startup
