scalable_rac_listener(5)
NAME | DESCRIPTION | EXAMPLES | ATTRIBUTES | SEE ALSO
NAME
- SUNW.scalable_rac_listener, scalable_rac_listener– resource type implementation for the Oracle 9i Real Application Clusters (RAC) listener managed by Sun Cluster
DESCRIPTION
-
Sun Cluster Manager
-
The clsetup(1CL) utility, specifying the option for configuring Sun Cluster Support for Oracle Real Application Clusters
-
The following sequence of Sun Cluster maintenance commands:
-
To register this resource type, use the clresourcetype(1CL) command.
-
To create instances of this resource type, use the clresource(1CL) command.
-
- 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
- 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
-
300
- 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
The SUNW.scalable_rac_listener resource type represents the Oracle 9i RAC listener in a Sun 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 Sun Cluster Data Service for Oracle RAC Guide for Solaris OS.
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:
Extension Properties
The extension properties of the SUNW.scalable_rac_listener resource type are as follows.
EXAMPLES
-
Registering the SUNW.scalable_rac_server resource type
-
Adding the scalable_rac_server-rs resource to the rac-db-rg resource group
-
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.
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:
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)
Sun Cluster Data Service for Oracle RAC Guide for Solaris OS, Sun Cluster Data Services Planning and Administration Guide for Solaris OS
NAME | DESCRIPTION | EXAMPLES | ATTRIBUTES | SEE ALSO
- © 2010, Oracle Corporation and/or its affiliates