This section describes key standard properties that control the behavior of the implementation. You use scrgadm(1M) to set these properties on a SUNW.Event resource. r_properties(5) describes these resource properties in more detail.

Network_resources_used (string array)

A comma-separated list of logical host name or shared address network resources that are used by the resource. r_properties(5) describes Network_resources_used in more detail.

Category

Conditional/Required

Default

No default

Tunable

When disabled

Port_list (string array)

A comma-separated list of port numbers on which the server is listening. r_properties(5) describes Port_list in more detail.

Category

Conditional/Required

Default

9444/tcp

Tunable

When disabled

Retry_count (integer)

The number of times that a monitor attempts to restart a resource if it fails. r_properties(5) describes Retry_count in more detail.

Category

Conditional

Default

2

Tunable

Any time

Retry_interval (integer)

The number of seconds over which to count attempts to restart a failed resource. r_properties(5) describes Retry_interval in more detail.

Category

Conditional

Default

300

Tunable

Any time

Thorough_probe_interval (integer)

The number of seconds between invocations of a high overhead fault probe of the resource. r_properties(5) describes Thorough_probe_interval in more detail.

Category

Conditional

Default

60

Tunable

Any time

This section describes key extension properties that control the behavior of the implementation.

Allow_hosts (StringArray)

This property controls the set of clients that are allowed to register with the implementation to recieve cluster reconfiguration events. The general form of this property is ipaddress/masklength, which defines a subnet from which the clients are allowed to register. For example, the setting 129.99.77.0/24 allows clients on the subnet 129.99.77 to register for events. As another example, 192.9.84.231/32 allows only the client 192.9.84.231 to register for events.

In addition, the following special keywords are recognized. LOCAL refers to all clients that are located in directly connected subnets of the cluster. ALL allows all clients to register. Note that if a client matches an entry in both the Allow_hosts and the Deny_hosts property, that client is prevented from registering with the implementation.

Category

Optional

Default

LOCAL

Tunable

Any time

Client_retry_count (integer)

This property controls the number of attempts made by the implementation while communicating with external clients. If a client fails to respond within Client_retry_count attempts, the client times out. The client is subsequently removed from the list of registered clients that are eligible to recieve cluster reconfiguration events. The client must re-register in order to start recieving events again. The section about the Client_retry_interval property describes how often these retries are made by the implementation.

Category

Optional

Default

3

Tunable

Any time

Client_retry_interval (integer)

This property defines the time period (in seconds) used by the implementation while communicating with unresponsive external clients. Up to Client_retry_count attempts are made during this interval to contact the client.

The value for this property can be modified at any time.

Category

Optional

Default

1800

Tunable

Any time

Client_timeout (integer)

This property is the time out value (in seconds) that is used by the implementation while communicating with external clients. However, the implementation continues to attempt to contact the client for a tunable number of times. The sections about the Client_retry_count and Client_retry_interval properties describe the means of tuning this property.

Category

Optional

Default

60

Tunable

Any time

Deny_hosts (StringArray)

This property controls the set of clients that are prevented from registering to recieve cluster reconfiguration events. To determine access, the settings on this property take precedence over those in the Allow_hosts list. The format of this property is the same as the format that is defined in the Allow_hosts.

Category

Optional

Default

NULL

Tunable

Any time

Max_clients (integer)

This property controls the maximum number of clients that can register with the implementation to recieve notification of cluster events. Attempts by additional clients to register for events are rejected by the implementation. Since each client registration uses resources on the cluster, tuning this property allows users to control resource usage on the cluster by external clients.

Category

Optional

Default

1000

Tunable

Any time

This example shows how to create a failover SUNW.Event resource that is named CRNP in an existing resource group that is named events-rg. events-rg contains a LogicalHostname or SharedAddress resource, which identifies the failover host name that is associated with the resource group.

# scrgadm -a -t SUNW.Event
# scrgadm -a -j CRNP -t SUNW.Event -g events-rg 

In this example, the SUNW.Event resource that is created is named CRNP. This resource listens on port 9444 and allows all clients on directly connected subnets to register for events.

This example shows how to create a SUNW.Event resource that is named CRNP in a resource group that is named events-rg. The CRNP resource is configured to listen on port 7000, and a specific network resource foo-1 (already configured in the events-rg). This CRNP resource allows clients on subnet 192.9.77.0 and clients on directly connected subnets to register, but disallows the client 192.9.77.98 from using the implementation.

# scrgadm -a -g events-rg -j CRNP -t SUNW.Event -y \
Port_list=7000/tcp -y Network_resources_used=foo-1 -x \
Allow_hosts=LOCAL,192.9.77.0/24 -x Deny_hosts=192.9.77.98/32