Resources for Oracle RAC database instances enable the database instances to be administered from Sun Cluster.
If you are using Oracle 10g Release 2 or 11g RAC, these resources also enable Sun Cluster and Oracle Cluster Ready Services (CRS) to interoperate.
The software architectures of Oracle 9i, Oracle 10g Release 1, and Oracle 10g Release 2 or 11g are different. As a result of these differences, the resources for Oracle RAC database instances that Sun Cluster requires depend on the version of Oracle that you are using.
If you are using Oracle 10g Release 1, omit this task. In Oracle 10g Release 1, Oracle CRS and Sun Cluster cannot interoperate. Instead, Oracle CRS start and shut down Oracle RAC database instances.
You can also use the Oracle 10g Release 2 RAC Plug-in for Sun N1 Service Provisioning System to deploy Oracle 10g Release 2 RAC software in a Sun Cluster configuration. Follow instructions in the documentation at http://wikis.sun.com/display/SunCluster/Oracle+RAC+10g+R2+Plug-in.
This section contains the following information about configuring resources for Oracle RAC database instances:
Tools for Registering and Configuring Resources for Oracle RAC Database Instances
How to Enable Sun Cluster and Oracle 10g Release 2 or 11g CRS to Interoperate
How to Automate the Startup and Shutdown of Oracle 9i RAC Database Instances
Sun Cluster provides the following tools for registering and configuring resources for Oracle RAC database instances:
The clsetup(1CL) utility. For more information, see the following sections:
Sun Cluster Manager. For more information, see the Sun Cluster Manager online help.
Sun Cluster maintenance commands. For more information, see the following sections:
The clsetup utility and Sun Cluster Manager each provide a wizard for configuring resources for Oracle RAC database instances. The wizards reduce the possibility of configuration errors that might result from command syntax errors or omissions. These wizards also ensure that all required resources are created and that all required dependencies between resources are set.
When you perform this task, the clsetup utility creates the following resources for interoperation with Oracle 10g Release 2 or 11g:
A Sun Cluster resource to act as a proxy for the Oracle RAC database
A Sun Cluster resource to represent the Oracle CRS framework
Oracle CRS resources to represent scalable device groups
Oracle CRS resources to represent scalable file-system mount points
Ensure that the following prerequisites are met:
The RAC framework resource group is created and is online.
Storage resources for Oracle files are configured.
Node-specific files and directories for a shared file system are created.
The Oracle database is running.
To determine whether the Oracle database is running, use the Oracle srvctl command as follows:
$ srvctl status database -d db-name |
db-name specifies the name of the Oracle database.
Ensure that you have the following information:
The full path to the Oracle CRS home directory
The name of the Oracle RAC database for which you are configuring resources
The full path to the Oracle home directory
The Oracle system identifier (SID) for each instance of the database for which you are configuring resources
The names of all Sun Cluster storage resources for Oracle files that you are using
On one node of the cluster, become superuser.
Start the clsetup utility.
# clsetup |
The clsetup main menu is displayed.
Type the number that corresponds to the option for data services and press Return.
The Data Services menu is displayed.
Type the number that corresponds to the option for configuring Sun Cluster Support for Oracle RAC and press Return.
The clsetup utility displays information about Sun Cluster Support for Oracle RAC.
Press Return to continue.
The clsetup utility prompts you to select whether you are performing the initial configuration of Sun Cluster Support for Oracle RAC or administering an existing configuration.
Type the number that corresponds to the option for performing the initial configuration of Sun Cluster Support for Oracle RAC and press Return.
The clsetup utility displays a list of components of Oracle RAC to configure.
Type the number that corresponds to the option for resources for Oracle RAC database instances and press Return.
The clsetup utility prompts you to select the Oracle RAC clusters location – global cluster or zone cluster.
Type the number that corresponds to the option for the location of the Oracle RAC clusters, and press Return.
Type the number that corresponds to the option for the required zone cluster, and press Return.
The clsetup utility displays the list of components of Oracle RAC to configure.
Type the number that corresponds to the option for the component of Oracle RAC, and press Return.
The clsetup utility displays the list of prerequisites for performing in this task.
Verify that the prerequisites are met, and press Return.
The clsetup utility displays a list of versions of Oracle that you can configure by using this utility.
Type the number that corresponds to the option for Oracle 10g Release 2 or 11g and press Return.
The clsetup utility displays a list of Oracle CRS home directories that exist on the cluster.
Specify the Oracle CRS home directory for your installation of the Oracle CRS software.
Specify the name of the Oracle RAC database that you are configuring.
Specify the Oracle home directory for your installation of the Oracle RAC software.
If the directory is listed, type the number that corresponds to the directory that you are selecting and press Return.
The clsetup utility displays a list of Oracle system identifiers that are configured on the cluster. The utility also prompts you to specify the system identifier for the first node in the list of nodes where Oracle RAC is to run.
If the directory is not listed, specify the directory explicitly:
Type e and press Return.
The clsetup utility prompts you for the Oracle home directory.
Type the full path to the Oracle home directory and press Return.
The clsetup utility displays a list of Oracle system identifiers that are configured on the cluster. The utility also prompts you to specify the system identifier for the first node in the list of nodes where Oracle RAC is to run.
Specify the Oracle SID of the Oracle RAC database instance for the node that you are configuring.
Perform this step for each node in the list of nodes where Oracle RAC is to run.
You must specify a unique Oracle SID for each node. If you specify a duplicate SID, the clsetup utility warns you that the SID is a duplicate and prompts you to specify the SID again.
If the SID is listed, type the number that corresponds to the SID that you are selecting and press Return.
The response of the clsetup utility depends on whether you have specified the Oracle SID for all nodes where Oracle RAC is to run.
If you have not specified the Oracle SID for all nodes, the clsetup utility prompts you for the SID of the next node in the node list.
If you have specified the Oracle SID for all nodes, the clsetup utility displays a list of Sun Cluster storage resources for Oracle files that are configured. For information about these resources, see Registering and Configuring Storage Resources for Oracle Files.
If the SID is not listed, specify the SID explicitly.
Type e and press Return.
The clsetup utility prompts you for the SID.
Type the SID and press Return.
The response of the clsetup utility depends on whether you have specified the Oracle SID for all nodes where Oracle RAC is to run.
If you have not specified the Oracle SID for all nodes, the clsetup utility prompts you for the SID of the next node in the node list.
If you have specified the Oracle SID for all nodes, the clsetup utility displays a list of Sun Cluster storage resources for Oracle files that are configured. For information about these resources, see Registering and Configuring Storage Resources for Oracle Files.
Type a comma-separated or space-separated list of the numbers that correspond to the storage resources that you are using, and press Return.
The clsetup utility displays the names of the Sun Cluster objects that the utility will create.
If you require a different name for any Sun Cluster objects, change each name as follows.
Type the number that corresponds to the name that you are changing and press Return.
The clsetup utility displays a screen where you can specify the new name.
At the New Value prompt, type the new name and press Return.
The clsetup utility returns you to the list of the names of the Sun Cluster objects that the utility will create.
To confirm your selection of Sun Cluster object names, press Return.
The clsetup utility displays information about the Sun Cluster configuration that the utility will create.
To create the configuration, type c and Press Return.
The clsetup utility displays a progress message to indicate that the utility is running commands to create the configuration. When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
Press Return to continue.
The clsetup utility returns you to the list of options for configuring Sun Cluster Support for Oracle RAC.
(Optional) Type q and press Return repeatedly until you quit the clsetup utility.
The following table lists the default configuration of Sun Cluster resources that the clsetup utility creates when you complete this task.
For detailed information for the resource configuration for zone clusters, see the figures in Appendix A, Sample Configurations of This Data Service.
The clsetup utility also creates an Oracle CRS resource for each Sun Cluster resource for scalable device groups and scalable file-system mount points on which Oracle components depend.
The name of each Oracle CRS resource that the clsetup utility creates is as follows:
sun.node.sc-rs
The replaceable items in this name are as follows:
node specifies the name of the node where the Oracle CRS resource is to run.
sc-rs specifies the name of the Sun Cluster resource that the Oracle CRS resource represents. This resource is created when the task in Registering and Configuring Storage Resources for Oracle Files is performed.
The Oracle CRS resource for the database instance on node depends on the Oracle CRS resource that the clsetup utility creates for that node. Oracle CRS resources for database instances are created during the installation and configuration of the Oracle RAC
The name of the Oracle CRS resource for the database instance on a node is as follows:
ora.dbname.sid.inst
The replaceable items in this name are as follows:
dbname specifies the database name of the database instance that the Oracle CRS resource represents.
sid specifies the Oracle SID of the database instance that the Oracle CRS resource represents.
Go to Verifying the Installation and Configuration of Sun Cluster Support for Oracle RAC.
Ensure that the following prerequisites are met:
The RAC framework resource group is created and is online.
Storage resources for Oracle files are configured.
Node-specific files and directories for a shared file system are created.
Ensure that you have the following information:
The full path to the Oracle home directory
The Oracle system identifier (SID) for each instance of the database for which you are configuring resources
The names of all Sun Cluster storage resources for Oracle files that you are using
The logical hostnames, or the names of the logical hostname resources, that you are using for Oracle listeners
On one node of the cluster, become superuser.
Start the clsetup utility.
# clsetup |
The clsetup main menu is displayed.
Type the number that corresponds to the option for data services and press Return.
The Data Services menu is displayed.
Type the number that corresponds to the option for configuring Sun Cluster Support for Oracle RAC and press Return.
The clsetup utility displays information about Sun Cluster Support for Oracle RAC.
Press Return to continue.
The clsetup utility prompts you to select whether you are performing the initial configuration of Sun Cluster Support for Oracle RAC or administering an existing configuration.
Type the number that corresponds to the option for performing the initial configuration of Sun Cluster Support for Oracle RAC and press Return.
The clsetup utility displays a list of components of Oracle RAC to configure.
Type the number that corresponds to the option for resources for Oracle RAC database instances and press Return.
The clsetup utility prompts you to select the Oracle RAC clusters location – global cluster or zone cluster.
Type the number that corresponds to the option for the location of the Oracle RAC clusters, and press Return.
Type the number that corresponds to the option for the required zone cluster, and press Return.
The clsetup utility displays the list of components of Oracle RAC to configure.
Type the number that corresponds to the option for the component of Oracle RAC, and press Return.
The clsetup utility displays the list of prerequisites for performing in this task.
Verify that the prerequisites are met, and press Return.
The clsetup utility displays a list of versions of Oracle that you can configure by using this utility.
Type the number that corresponds to the option for Oracle 9i and press Return.
Type the number that corresponds to the option to configure both the listener and the server.
The clsetup utility displays a list of Oracle home directories that exist on the cluster.
Specify the Oracle home directory for your installation of the Oracle RAC software.
If the directory is listed, type the number that corresponds to the directory that you are selecting and press Return.
The clsetup utility displays a list of Oracle system identifiers that are configured on the cluster. The utility also prompts you to specify the system identifier for the first node in the list of nodes where Oracle RAC is to run.
If the directory is not listed, specify the directory explicitly:
Type e and press Return.
The clsetup utility prompts you for the Oracle home directory.
Type the full path to the Oracle home directory and press Return.
The clsetup utility displays a list of Oracle system identifiers that are configured on the cluster. The utility also prompts you to specify the system identifier for the first node in the list of nodes where Oracle RAC is to run.
Specify the Oracle SID of the Oracle RAC database instance for the node that you are configuring.
The wizard prompts you to perform this step for each node in the list of nodes where Oracle RAC is to run.
You must specify a unique Oracle SID for each node. If you specify a duplicate SID, the clsetup utility warns you that the SID is a duplicate and prompts you to specify the SID again.
If you require a different value for any Sun Cluster resource properties, change each property as follows.
The wizard prompts you to perform this step for each node in the list of nodes where Oracle RAC is to run.
Type the number that corresponds to the property that you are changing and press Return.
The clsetup utility displays a screen where you can specify the new value.
At the New Value prompt, type the new value and press Return.
The clsetup utility returns you to the values of properties for the node.
To confirm your selection of Sun Cluster resource properties, press Return.
The response of the clsetup utility depends on whether you have specified the Sun Cluster resource properties for all nodes where Oracle RAC is to run.
If you have not specified Sun Cluster resource properties for all nodes, the clsetup utility prompts you to specify the system identifier for the next node in the list of nodes.
If you have specified the Sun Cluster resource properties for all nodes, the clsetup utility displays a list of logical hostname resources that are configured.
Configure a logical hostname resource for each node where Oracle RAC is to run.
The Oracle listener uses the logical hostname resource for a node to connect to the Oracle RAC database instance on the node.
The wizard prompts you to perform this step for each node in the list of nodes where Oracle RAC is to run.
If the logical hostname resource is listed, type the number that corresponds to the resource that you are selecting and press Return.
The response of the clsetup utility depends on whether you have configured a logical hostname resource for all nodes where Oracle RAC is to run.
If you have not configured a resource for all nodes, the clsetup utility prompts you to configure a resource for the next node.
If you have configured a resource for all nodes, the clsetup utility displays a list of Sun Cluster storage resources for Oracle files that are configured. For information about these resources, see Registering and Configuring Storage Resources for Oracle Files.
If the logical hostname resource is not listed, create the resource as follows:
Type the logical hostname and press Return.
The clsetup utility returns you to the list of logical hostname resources. An entry for the logical hostname resource that the wizard will create is added to the list.
Type the number that corresponds to the resource that you are creating and press Return.
The response of the clsetup utility depends on whether you have configured a logical hostname resource for all nodes where Oracle RAC is to run.
If you have not configured a resource for all nodes, the clsetup utility prompts you to configure a resource for the next node.
If you have configured a resource for all nodes, the clsetup utility displays a list of Sun Cluster storage resources for Oracle files that are configured. For information about these resources, see Registering and Configuring Storage Resources for Oracle Files.
Type a comma-separated or space-separated list of the numbers that correspond to the storage resources that you are using, and press Return.
The clsetup utility displays the names of the Sun Cluster objects that the utility will create.
If you require a different name for any Sun Cluster objects, change each name as follows.
Type the number that corresponds to the name that you are changing and press Return.
The clsetup utility displays a screen where you can specify the new name.
At the New Value prompt, type the new name and press Return.
The clsetup utility returns you to the list of the names of the Sun Cluster objects that the utility will create.
To confirm your selection of Sun Cluster object names, press Return.
The clsetup utility displays information about the Sun Cluster configuration that the utility will create.
To create the configuration, type c and Press Return.
The clsetup utility displays a progress message to indicate that the utility is running commands to create the configuration. When configuration is complete, the clsetup utility displays the commands that the utility ran to create the configuration.
Press Return to continue.
The clsetup utility returns you to the list of options for configuring Sun Cluster Support for Oracle RAC.
(Optional) Type q and press Return repeatedly until you quit the clsetup utility.
The following table lists the default resource configuration that the clsetup utility creates when you complete this task.
For detailed information for the resource configuration for zone clusters, see the figures in Appendix A, Sample Configurations of This Data Service.
Go to Verifying the Installation and Configuration of Sun Cluster Support for Oracle RAC.