JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Data Services Reference Manual     Oracle Solaris Cluster
search filter icon
search icon

Document Information

Preface

OSC33DS 4

OSC33DS 5

apache(5)

asm_diskgroup(5)

dns(5)

hadb(5)

hadb_ma(5)

iws(5)

jsas(5)

jsas-na(5)

krb5(5)

ldom(5)

nfs(5)

obiee_cluster_controller(5)

obiee_presentation_service(5)

obiee_scheduler(5)

obiee_server(5)

oracle_listener(5)

oracle_rac_server(5)

oracle_server(5)

ORCL.obiee_cluster_controller(5)

ORCL.obiee_presentation_service(5)

ORCL.obiee_scheduler(5)

ORCL.obiee_server(5)

s1as(5)

s1mq(5)

sap_as(5)

sap_as_v2(5)

sap_ci(5)

sap_ci_v2(5)

sapdb(5)

sapenq(5)

sap_livecache(5)

saprepl(5)

sapscs(5)

sapwebas(5)

sap_xserver(5)

sblgtwy(5)

sblsrvr(5)

scalable_asm_diskgroup_proxy(5)

scalable_asm_instance(5)

scalable_asm_instance_proxy(5)

scalable_rac_listener(5)

scalable_rac_server(5)

scalable_rac_server_proxy(5)

SUNW.apache(5)

SUNW.asm_diskgroup(5)

SUNW.dns(5)

SUNW.hadb(5)

SUNW.hadb_ma(5)

SUNW.iws(5)

SUNW.jsas(5)

SUNW.jsas-na(5)

SUNW.krb5(5)

SUNW.ldom(5)

SUNW.nfs(5)

SUNW.oracle_listener(5)

SUNW.oracle_rac_server(5)

SUNW.oracle_server(5)

SUNW.s1as(5)

SUNW.s1mq(5)

SUNW.sap_as(5)

SUNW.sap_as_v2(5)

SUNW.sap_ci(5)

SUNW.sap_ci_v2(5)

SUNW.sapdb(5)

SUNW.sapenq(5)

SUNW.sap_livecache(5)

SUNW.saprepl(5)

SUNW.sapscs(5)

SUNW.sapwebas(5)

SUNW.sap_xserver(5)

SUNW.sblgtwy(5)

SUNW.sblsrvr(5)

SUNW.scalable_asm_diskgroup_proxy(5)

SUNW.scalable_asm_instance(5)

SUNW.scalable_asm_instance_proxy(5)

SUNW.scalable_rac_listener(5)

SUNW.scalable_rac_server(5)

SUNW.scalable_rac_server_proxy(5)

SUNW.sybase(5)

SUNW.wls(5)

sybase(5)

wls(5)

Index

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.


Note - Use the SUNW.scalable_rac_listener resource type only if you are using Oracle 9i RAC. If you are using Oracle 10g R2, use the SUNW.scalable_rac_server_proxy(5) resource type.


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.

For information about how to configure RAC listener resources, see Configuring Resources for Oracle RAC Database Instances in Oracle Solaris Cluster Data Service for Oracle Real Application Clusters Guide.

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

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:

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:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
SUNWscor

See Also

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

Oracle Solaris Cluster Data Service for Oracle Real Application Clusters Guide, Oracle Solaris Cluster Data Services Planning and Administration Guide