How to Automate the Startup and Shutdown of Oracle 9i RAC Database Instances (Sun Cluster Data Service for Oracle RAC Guide for Solaris OS)

Sun Cluster Data Service for Oracle RAC Guide for Solaris OS

Previous: How to Enable Sun Cluster and Oracle 10g R2 CRS to Interoperate
Next: Verifying the Installation and Configuration of Sun Cluster Support for Oracle RAC

How to Automate the Startup and Shutdown of Oracle 9i RAC Database Instances

Before You Begin

Ensure that the following prerequisites are met:

The RAC framework resource group is created and is online.
Storage resources for Oracle files are configured.
The Oracle RAC software is installed.
Node-specific files and directories for a shared file system are created.
The installation of the Oracle RAC software is verified.
The Oracle database is 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 displays the list of prerequisites for performing 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:
  1. Type e and press Return.
    
    The clsetup utility prompts you for the Oracle home directory.
  2. 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.

Note –
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 clsetup utility displays the values of properties for the node of the Sun Cluster resources that the utility will create.
- If the SID is not listed, specify the SID explicitly.
  1. Type e and press Return.
    
    The clsetup utility prompts you for the SID.
  2. Type the SID and press Return.
    
    The clsetup utility displays the values of properties for the node of the Sun Cluster resources that the utility will create.

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.
1. 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.
2. 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.
3. 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:
  1. Type c and press Return.
    
    The clsetup utility prompts you for the logical hostname that the resource is to make available.
- 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.
1. 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.
2. 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.

Resource Configuration

The following table lists the default resource configuration that the clsetup utility creates when you complete this task.

Resource Type, Resource Name, and Resource Group	Dependencies	Description
Resource type: `SUNW.LogicalHostname` Resource name: `lh-name`, where `lh-name` is the logical hostname that you specified when you created the resource Resource group: `rac-lhN-rg`, where `N` is an integer in the range 1 to the number of nodes where Oracle RAC is to run. These integers are assigned in the order in which the resource groups are created.	None.	Logical hostname resource. One logical hostname resource is created for each node where Oracle RAC is to run.
Resource type: `SUNW.scalable_rac_listener` Resource name: `rac-listener-rs` Resource group: `ora-sid-rg`, where `ora-sid` is the SID on the primary node without any numbers in the SID	Strong dependency on each logical hostname resource.	Scalable RAC listener resource.
Resource type: `SUNW.scalable_rac_server` Resource name: `ora-sid-rs`, where `ora-sid` - is the SID on the primary node without any numbers in the SID Resource group: `ora-sid-rg`, where `ora-sid` is the SID on the primary node without any numbers in the SID	Strong dependency on the RAC framework resource. Weak dependency on the scalable RAC listener resource. Offline-restart dependencies on all scalable device-group resources for Oracle files, if any. Offline-restart dependencies on all scalable file-system mount-point resources for Oracle files. If you are not using a shared file system or a volume manager, this resource has no offline-restart dependencies on any other resources.	Scalable RAC server resource.

Resource Type, Resource Name, and Resource Group

Dependencies

Description

Resource type: SUNW.LogicalHostname

Resource name: lh-name, where lh-name is the logical hostname that you specified when you created the resource

Resource group: rac-lhN-rg, where N is an integer in the range 1 to the number of nodes where Oracle RAC is to run. These integers are assigned in the order in which the resource groups are created.

None.

Logical hostname resource. One logical hostname resource is created for each node where Oracle RAC is to run.

Resource type: SUNW.scalable_rac_listener

Resource name: rac-listener-rs

Resource group: ora-sid-rg, where ora-sid is the SID on the primary node without any numbers in the SID

Strong dependency on each logical hostname resource.

Scalable RAC listener resource.

Resource type: SUNW.scalable_rac_server

Resource name: ora-sid-rs, where ora-sid - is the SID on the primary node without any numbers in the SID

Resource group: ora-sid-rg, where ora-sid is the SID on the primary node without any numbers in the SID

Strong dependency on the RAC framework resource.

Weak dependency on the scalable RAC listener resource.

Offline-restart dependencies on all scalable device-group resources for Oracle files, if any.

Offline-restart dependencies on all scalable file-system mount-point resources for Oracle files.

If you are not using a shared file system or a volume manager, this resource has no offline-restart dependencies on any other resources.

Scalable RAC server resource.

Next Steps

Go to Verifying the Installation and Configuration of Sun Cluster Support for Oracle RAC.