SUNW.scalable_rac_listener

, scalable_rac_listener

- resource type implementation for the Oracle 9i Real Application Clusters (RAC) listener managed by Oracle Solaris Cluster

Description

The SUNW.scalable_rac_listener resource type represents the Oracle 9i RAC listener in an Oracle Solaris Cluster configuration.

The SUNW.scalable_rac_listener resource type is a multiple-master resource type. A single resource of this type can run on multiple nodes concurrently, but does not use network load balancing.

Each SUNW.scalable_rac_listener resource represents all Oracle RAC listener instances that serve a database. Each instance of the RAC listener is uniquely identified by the value of the listener_name extension property on the node where the instance is running. The listener_name extension property is a per-node property. A single resource of this type can take a different value of this property for each node.

.

To register this resource type and create instances of this resource type, use one of the following means:

• The clsetup(1CL) utility, specifying the option for configuring Oracle Solaris Cluster Support for Oracle Real Application Clusters

• The following sequence of Oracle Solaris Cluster maintenance commands:

  1. To register this resource type, use the clresourcetype(1CL) command.

  2. To create instances of this resource type, use the clresource(1CL) command.

Standard Properties

For a description of all standard resource properties, see the r_properties(5) man page.

Standard resource properties are overridden for this resource type as follows:

Boot_timeout

Minimum

5

Default

30

Failover_mode

Default

None

Tunable

Any time

Fini_timeout

Minimum

5

Default

30

Init_timeout

Minimum

5

Default

30

Monitor_start_timeout

Minimum

5

Default

180

Monitor_stop_timeout

Minimum

5

Default

120

Retry_count

Minimum

-1

Default

-1

Tunable

Any time

Retry_interval

Minimum

-1

Maximum

2592000

Default

600

Tunable

Any time

Start_timeout

Minimum

5

Default

300

Stop_timeout

Minimum

5

Default

300

Thorough_probe_interval

Minimum

1

Maximum

2592000

Default

30

Tunable

Any time

Update_timeout

Minimum

5

Default

300

Validate_timeout

Minimum

5

Default

120

Extension Properties

The extension properties of the SUNW.scalable_rac_listener resource type are as follows.

debug_level

This property indicates the level to which debug messages from the Oracle RAC listener component are logged. When the debug level is increased, more debug messages are written to the log files. These messages are logged to the file /var/opt/SUNWscor/scalable_rac_listener/message_log.rs, where rs is the name of the resource that represents the Oracle RAC listener component.

You can specify a different value of the debug_level extension property for each node that can master the resource.

Data Type

Integer

Range

0–100

Default

1, which logs syslog messages

Tunable

Any time

listener_name

This property specifies the name of the Oracle listener instance that is to be started on the node where the instance is running. This name must match the corresponding entry in the listener.ora configuration file.

You can specify a different value of the listener_name extension property for each node that can master the resource.

Data Type

String

Range

Not applicable

Default

LISTENER

Tunable

When disabled

oracle_home

This property specifies the full path to the Oracle home directory. The Oracle home directory contains the binary files, log files, and parameter files for the Oracle software.

Data Type

String

Range

Not applicable

Default

No default defined

Tunable

When disabled

probe_timeout

This property specifies the timeout value, in seconds, that the fault monitor uses when checking the status of an Oracle RAC listener.

Data Type

Integer

Range

1–99999

Default

180

Tunable

Any time

user_env

This property specifies the name of the file that contains the environment variables that are to be set before the listener starts up or shuts down. You must define all environment variables whose values differ from Oracle defaults in this file.

For example, a user's listener.ora file might not be located under the /var/opt/oracle directory or the oracle-home/network/admin directory. In this situation, the TNS_ADMIN environment variable must be defined.

The definition of each environment variable that is defined must follow the format variable-name=value. Each definition must start on a new line in the environment file.

You can specify a different value of the user_env extension property for each node that can master the resource.

Data Type

String

Range

Not applicable

Default

No default defined

Tunable

Any time

Examples

Example 1 Creating a scalable_rac_listener Resource

This example shows the commands for performing the following operations to create a scalable_rac_listener resource on a two-node cluster:

1. Registering the SUNW.scalable_rac_server resource type

2. Adding the scalable_rac_server-rs resource to the rac-db-rg resource group

A different value of the listener_name extension property is set for each node that can master the resource.

The example makes the following assumptions:

• The C shell is used.

• A RAC framework resource group that is named rac-framework-rg exists.

• Logical hostname resources that are named lh1-rs and lh2-rs exist.

phys-schost-1# clresourcetype register \ SUNW.scalable_rac_listener
phys-schost-1# clresource create -g rac-db-rg \ -t SUNW.scalable_rac_listener \ -p resource_dependencies_weak=lh1-rs,lh2-rs \ -p oracle_home=/home/oracle/product/9.2.0 \ -p listener_name\{1\}=ORALISTNR1 \ -p listener_name\{2\}=ORALISTNR2 \ scalable_rac_listener-rs
...Creation of RAC server resource

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

clresource(1CL), clresourcetype(1CL), clsetup(1CL), attributes(5), r_properties(5), SUNW.rac_framework(5), SUNW.scalable_rac_server(5), SUNW.scalable_rac_server_proxy(5)

Oracle Solaris Cluster Data Services Planning and Administration Guide