Application client properties  Component properties

Appendix B: Repository Properties Reference

Cluster properties

Description

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.

See also

Chapter 6, “Clusters and Synchronization”




com.sybase.jaguar.cluster.bindpassword

Description

Specifies the bind password for cluster name servers.

Syntax

password

Where password is the bind password.

Usage

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.




com.sybase.jaguar.cluster.DLBbroadcastInterval

Description

When using adaptive load balancing, specifies how often each server broadcasts its load metrics.

Syntax

The broadcast interval, in minutes. The default is 5.

See also

com.sybase.jaguar.cluster.DLBpolicy




com.sybase.jaguar.cluster.DLBcalculateInterval

Description

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.

Syntax

The interval, in minutes. The default is 10.

See also

com.sybase.jaguar.cluster.DLBpolicy




com.sybase.jaguar.cluster.DLBenable

Description

Enables configuration of the dynamic load balancing policies (weighted or adaptive).

Syntax

true or false. The default is false.

See also

com.sybase.jaguar.cluster.DLBpolicy




com.sybase.jaguar.cluster.DLBmaxWeight

Description

The maximum weight, used in a weighted load balancing policy, of any server.

Syntax

An integer value. The default is five. The maximum value is ten.

See also

com.sybase.jaguar.cluster.DLBpolicy, com.sybase.jaguar.cluster.DLBweights




com.sybase.jaguar.cluster.DLBpolicy

Description

Specifies the algorithm to distribute component invocations between the servers in the cluster.

Syntax

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.

See also

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




com.sybase.jaguar.cluster.DLBrefreshInterval

Description

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.

Syntax

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.

See also

com.sybase.jaguar.cluster.DLBpolicy, com.sybase.jaguar.cluster.DLBcalculateInterval




com.sybase.jaguar.cluster.DLBsampleInterval

Description

When using adaptive load balancing, specifies how often each server collects its load metrics.

Syntax

The sampling interval, in seconds. The default is 5.

See also

com.sybase.jaguar.cluster.DLBpolicy




com.sybase.jaguar.cluster.DLBweights

Description

When using the weighted load balancing policy, specifies the relative weights assigned to each server.

Syntax

A comma separated list of server URLs and integer weight values, in the form:

url1|weight1,url2|weight2, ....

Where:

See also

com.sybase.jaguar.cluster.DLBenable, com.sybase.jaguar.cluster.DLBmaxWeight, com.sybase.jaguar.cluster.DLBpolicy




com.sybase.jaguar.cluster.initialcontext

Description

Specifies the initial naming context for the cluster naming services.

Syntax

context

Where context is the initial naming context, for example, “/UK/BusinessComponents”.

Usage

In EAServer Manager, set this property using the Advanced tab in the Cluster Properties dialog box.




com.sybase.jaguar.cluster.ipmirrorgroups

Description

Specifies mirror groups used for in-memory component state replication.

Syntax

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.

Usage

In EAServer Manager, configure this property on the Mirror Pairs tab in the Cluster Properties dialog box.

See also

com.sybase.jaguar.cluster.ipmirrorgroups




com.sybase.jaguar.cluster.mirrorgroups

Description

Specifies mirror groups used for in-memory component state replication.

Syntax

Same as for com.sybase.jaguar.cluster.ipmirrorgroups, except that you must use IP addresses rather than host names.

See also

com.sybase.jaguar.cluster.ipmirrorgroups




com.sybase.jaguar.cluster.name

Description

Specifies the cluster name.

Syntax

name

Where name is the cluster name.

Usage

In EAServer Manager, this property is set when the cluster is created, and cannot be changed.




com.sybase.jaguar.cluster.nameservers

Description

Specifies the cluster’s name servers as a list of IIOP URLs.

Syntax

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

Usage

In EAServer Manager, set this property using the Name Servers tab in the Cluster Properties dialog box.

See also

“Adding a name server to a cluster”, “Removing a server from a cluster”




com.sybase.jaguar.cluster.primary

Description

Specifies the IIOP URL of the primary cluster, which is the source server of the last synchronize operation.

Syntax

iiop://host:port

Where host is the host name and port is the IIOP port number.

Usage

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.

See also

“Synchronization”




com.sybase.jaguar.cluster.servers

Description

Specifies the servers in the cluster as a list of IIOP URLs.

Syntax

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

Usage

In EAServer Manager, set this property using the Servers tab in the Cluster Properties dialog box.

See also

“Configuring a server to enable synchronization”, “Adding a server to a cluster”, “Removing a server from a cluster”




com.sybase.jaguar.cluster.startup

Description

Specifies what form of cluster version control member servers perform before joining a cluster.

Syntax

startup_check

Where startup_check is one of:

Usage

In EAServer Manager, set this property on the Advanced tab in the Cluster Properties dialog box.

See also

com.sybase.jaguar.cluster.version “Cluster start-up options”




com.sybase.jaguar.cluster.updated

Description

Contains audit information for previous synchronize operation.

Syntax

audit_text

Where audit_text is text describing the last synchronize operation.

Usage

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.

See also

“Synchronization”




com.sybase.jaguar.cluster.version

Description

Specifies the version number of the cluster. The version number automatically increments each time you synchronize the cluster.

Syntax

version

Where version is the version number. The default for a new server is 0.

Usage

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.

See also

“Synchronization”, “Cluster start-up options”, com.sybase.jaguar.cluster.startup





Copyright © 2005. Sybase Inc. All rights reserved. Component properties