test

Sun Cluster 3.1 Data Service for Oracle Parallel Server/Real Application Clusters Guide

Chapter 2 Administering Sun Cluster Support for Oracle Parallel Server/Real Application Clusters

This chapter describes the steps to administer Sun Cluster Support for Oracle Parallel Server/Real Application Clusters on your Sun Cluster nodes. This chapter contains the following procedures.

Overview of Administration Tasks for Sun Cluster Support for Oracle Parallel Server/Real Application Clusters

The following table summarizes the administration tasks and provides cross-references to detailed instructions for performing the tasks.

Table 2–1 Task Map: Administering Sun Cluster Support for Oracle Parallel Server/Real Application Clusters

Task 

Cross-Reference 

Register and configure Sun Cluster Support for Oracle Parallel Server/Real Application Clusters 

Registering and Configuring Sun Cluster Support for Oracle Parallel Server/Real Application Clusters

Install the Oracle relational database management system (RDBMS) software and create your Oracle database

Oracle Parallel Server/Real Application Clusters installation documentation 

Tune Sun Cluster Support for Oracle Parallel Server/Real Application Clusters extension properties 

Tuning Sun Cluster Support for Oracle Parallel Server/Real Application Clusters

Upgrade Sun Cluster Support for Oracle Parallel Server/Real Application Clusters to upgrade your cluster to use a new version of Sun Cluster

“Upgrading Sun Cluster Software” in Sun Cluster 3.1 10/03 Software Installation Guide

How to Register and Configure Sun Cluster Support for Oracle Parallel Server/Real Application Clusters for a Cluster

Troubleshoot Sun Cluster Support for Oracle Parallel Server/Real Application Clusters 

Chapter 3, Troubleshooting Sun Cluster Support for Oracle Parallel Server/Real Application Clusters

Registering and Configuring Sun Cluster Support for Oracle Parallel Server/Real Application Clusters

Registering and configuring Sun Cluster Support for Oracle Parallel Server/Real Application Clusters enables this support to be managed by using Sun Cluster commands.

You can register and configure Sun Cluster Support for Oracle Parallel Server/Real Application Clusters for the following entities:

Overview of the RAC Framework Resource Group

The Real Application Clusters (RAC) framework resource group enables Oracle Parallel Server/Real Application Clusters to be managed by using Sun Cluster commands. This resource group contains an instance of the following single-instance resource types:

In addition, the RAC framework resource group contains an instance of a single-instance resource type that represents the storage management scheme that you are using.

Note –

The resource types that are defined for the RAC framework resource group do not enable the Resource Group Manager (RGM) to manage instances of Oracle Parallel Server/Real Application Clusters.

Determining Whether to Use scsetup or scrgadm

The procedures that follow explain how to configure resources for Sun Cluster Support for Oracle Parallel Server/Real Application Clusters by using the scsetup(1M) utility. The scsetup utility enables you to configure resources for Sun Cluster Support for Oracle Parallel Server/Real Application Clusters interactively, thereby reducing the possibility for configuration errors that might result from command syntax errors or omissions. The scsetup utility ensures that all required resources are created on the basis of the software that is installed on your cluster nodes.

Note –

For instructions about how to configure resources for Sun Cluster Support for Oracle Parallel Server/Real Application Clusters by using the scrgadm(1M) utility, see Creating, Modifying, and Removing the RAC Framework Resource Group by Using the scrgadm Utility.

How to Register and Configure Sun Cluster Support for Oracle Parallel Server/Real Application Clusters for a Cluster

When you register and configure Sun Cluster Support for Oracle Parallel Server/Real Application Clusters for a cluster, the RAC framework resource group is created.

Before you perform this procedure, ensure that the required Sun Cluster Support for Oracle Parallel Server/Real Application Clusters software packages are installed on each node. The packages that are required depend on the storage management scheme that you are using. For more information, see Installing Sun Cluster Support for Oracle Parallel Server/Real Application Clusters Packages.

  1. Become superuser.

  2. From one node only, create the RAC framework resource group.

    Note –

    The following instructions explain how to perform this operation by using the scsetup utility. For information about how to perform this operation by using the scrgadm utility, see How to Create the RAC Framework Resource Group by Using the scrgadm Utility.

    1. Start the scsetup utility.


      # scsetup

      The scsetup main menu is displayed.

    2. Type the number that corresponds to the option for data services.

      The Data Services menu is displayed.

    3. Type the number that corresponds to the option for configuring Sun Cluster Support for Oracle Parallel Server/Real Application Clusters.

      The Sun Cluster Support for Oracle RAC menu is displayed.

    4. Type the number that corresponds to the option for creating the RAC framework resource group.

      The scsetup utility displays a list of the cluster nodes on which the Sun Cluster Support for Oracle Parallel Server/Real Application Clusters packages are installed. The scsetup utility also asks you to confirm that the RAC framework resource group should be created on these nodes.

    5. To confirm that the scsetup utility should create the RAC framework resource group on the listed nodes, type y.

      The scsetup utility creates the RAC framework resource group and the resources that this resource group contains on the listed nodes.

      Note –

      If the value of a resource property is changed from its default value, the scsetup utility sets the property to the changed value for the resource that the scsetup utility creates.

  3. Determine if the RAC framework resource group and its resources are online.

    Use the scstat(1M) utility for this purpose. The resource group to verify is named rac-framework-rg. The scsetup utility automatically assigns this name when you create the resource group.


    # scstat -g

    • If the RAC framework resource group and its resources are online, no further action is required.

    • If the RAC framework resource group and its resources are not online, bring them online.


      # scswitch -Z -g rac-framework-rg
      -Z

      Enables the resource and monitor, moves the resource group to the MANAGED state, and brings the resource group online

      -g rac-framework-rg

      Specifies that the resource group to be moved to the MANAGED state and brought online is rac-framework-rg

Where to Go From Here

See your Oracle Parallel Server/Real Application Clusters installation documentation for information about how to install the Oracle RDBMS software and create your Oracle database.

How to Register and Configure Sun Cluster Support for Oracle Parallel Server/Real Application Clusters for Selected Nodes

When you register and configure Sun Cluster Support for Oracle Parallel Server/Real Application Clusters for selected nodes, the nodes are added to the RAC framework resource group.

Perform this procedure in the following situations:

Before you perform this procedure, ensure that the required Sun Cluster Support for Oracle Parallel Server/Real Application Clusters software packages are installed on each node. The packages that are required depend on the storage management scheme that you are using. For more information, see Installing Sun Cluster Support for Oracle Parallel Server/Real Application Clusters Packages.

  1. Become superuser.

  2. Add the nodes to the RAC framework resource group.

    Note –

    The following instructions explain how to perform this operation by using the scsetup utility. For information about how to perform this operation by using the scrgadm utility, see How to Add Nodes to the RAC Framework Resource Group by Using the scrgadm Utility.

    1. Start the scsetup utility.


      # scsetup

    2. Type the number that corresponds to the option for data services.

      The Data Services menu is displayed.

    3. Type the number that corresponds to the option for configuring Sun Cluster Support for Oracle Parallel Server/Real Application Clusters.

      The Sun Cluster Support for Oracle RAC menu is displayed.

    4. Type the number that corresponds to the option for adding a node to the RAC framework resource group.

      The scsetup utility responds as follows:

      • The list of nodes that you can add to the RAC framework resource group is displayed. This list contains the cluster nodes on which the Sun Cluster Support for Oracle Parallel Server/Real Application Clusters packages are installed, but on which the RAC framework resource group does not exist.

      • The scsetup utility prompts you for the list of nodes that you are adding.

    5. Type a comma-separated list of the nodes that you are adding to the RAC framework resource group.

  3. Bring the RAC framework resource group and its resources online.


    # scswitch -Z -g rac-framework-rg
    -Z

    Enables the resource and monitor, moves the resource group to the MANAGED state, and brings the resource group online

    -g rac-framework-rg

    Specifies that the resource group to be moved to the MANAGED state and brought online is rac-framework-rg

Where to Go From Here

See your Oracle Parallel Server/Real Application Clusters installation documentation for information about how to install the Oracle RDBMS software and create your Oracle database.

Removing Sun Cluster Support for Oracle Parallel Server/Real Application Clusters

Removing Sun Cluster Support for Oracle Parallel Server/Real Application Clusters removes the RAC framework resource group or removes nodes from this resource group.

How to Remove Sun Cluster Support for Oracle Parallel Server/Real Application Clusters From a Cluster

The cluster node from which you run the scsetup utility or scrgadm utility to perform this task must be booted in cluster mode.

  1. On one node of the cluster, become superuser.

  2. Remove the RAC framework resource group.

    Note –

    The following instructions explain how to perform this operation by using the scsetup utility. For information about how to perform this operation by using the scrgadm utility, see How to Remove the RAC Framework Resource Group by Using the scrgadm Utility.

    1. Start the scsetup utility.


      # scsetup

      The scsetup main menu is displayed.

    2. Type the number that corresponds to the option for data services.

      The Data Services menu is displayed.

    3. Type the number that corresponds to the option for configuring Sun Cluster Support for Oracle Parallel Server/Real Application Clusters.

      The Sun Cluster Support for Oracle RAC menu is displayed.

    4. Type the number that corresponds to the option for removing the RAC framework resource group.

      The scsetup utility displays a list of the cluster nodes on which the RAC framework resource group exists. The scsetup utility also asks you to confirm that the RAC framework resource group should be removed from these nodes.

    5. To confirm that the scsetup utility should remove the RAC framework resource group from the listed nodes, type y.

      The scsetup utility removes the RAC framework resource group and the resources that this resource group contains from the listed nodes.

  3. Boot each node in the cluster in noncluster mode.

  4. From each node in the cluster, uninstall the Sun Cluster Support for Oracle Parallel Server/Real Application Clusters software packages for the storage management scheme that you are using.

    • If you are using VxVM with the cluster feature, type the following command:


      # pkgrm SUNWscucm SUNWudlm SUNWudlmr SUNWcvmr SUNWcvm

    • If you are using hardware RAID support, type the following command:


      # pkgrm SUNWscucm SUNWudlm SUNWudlmr SUNWschwr

    • If you are using the cluster file system, type the following command:


      # pkgrm SUNWscucm SUNWudlm SUNWudlmr
    Note –

    To prevent the userland cluster membership monitor (UCMM) daemon ucmmd from being started when the cluster is rebooted, you must uninstall the Sun Cluster Support for Oracle Parallel Server/Real Application Clusters software packages.

How to Remove Sun Cluster Support for Oracle Parallel Server/Real Application Clusters From Selected Nodes

  1. Become superuser.

  2. Boot in noncluster mode the nodes from which you are removing Sun Cluster Support for Oracle Parallel Server/Real Application Clusters.

  3. Remove the nodes from the RAC framework resource group.

    Note –

    The following instructions explain how to perform this operation by using the scsetup utility. For information about how to perform this operation by using the scrgadm utility, see How to Remove Nodes From the RAC Framework Resource Group by Using the scrgadm Utility.

    1. Start the scsetup utility.


      # scsetup

    2. Type the number that corresponds to the option for data services.

      The Data Services menu is displayed.

    3. Type the number that corresponds to the option for configuring Sun Cluster Support for Oracle Parallel Server/Real Application Clusters.

      The Sun Cluster Support for Oracle RAC menu is displayed.

    4. Type the number that corresponds to the option for removing a node from the RAC framework resource group.

      The scsetup utility responds as follows:

      • The list of nodes in the RAC framework resource group is displayed.

      • The scsetup utility prompts you for the list of nodes that you are removing.

    5. Type a comma-separated list of the nodes that you removing from the RAC framework resource group.

  4. (Optional) From each node that you removed, uninstall the Sun Cluster Support for Oracle Parallel Server/Real Application Clusters software packages for the storage management scheme that you are using.

    • If you are using VxVM with the cluster feature, type the following command:


      # pkgrm SUNWscucm SUNWudlm SUNWudlmr SUNWcvmr SUNWcvm

    • If you are using hardware RAID support, type the following command:


      # pkgrm SUNWscucm SUNWudlm SUNWudlmr SUNWschwr

    • If you are using the cluster file system, type the following command:


      # pkgrm SUNWscucm SUNWudlm SUNWudlmr

Creating, Modifying, and Removing the RAC Framework Resource Group by Using the scrgadm Utility

The scrgadm utility enables you to automate the creation, modification, and removal of the RAC framework resource group by using scripts. Automating this process reduces the time for propagating the same configuration information to many nodes in a cluster.

Note –

For procedures that explain how to create, modify, or remove the RAC framework resource by using the scsetup utility, see Registering and Configuring Sun Cluster Support for Oracle Parallel Server/Real Application Clusters and Removing Sun Cluster Support for Oracle Parallel Server/Real Application Clusters. Using the scsetup utility reduces the possibility for configuration errors that might result from command syntax errors or omissions.

How to Create the RAC Framework Resource Group by Using the scrgadm Utility

  1. On one node of the cluster, become superuser.

  2. Create a scalable resource group.


    # scrgadm -a -g resource-group \
  -y nodelist=nodelist \
  -y maximum_primaries=num-in-list \
  -y desired_primaries=num-in-list \
  -y RG_mode=Scalable
    -g resource-group

    Specifies the name that you are assigning to the resource group.

    -y nodelist=nodelist

    Specifies a comma-separated list of cluster nodes on which Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is to be enabled. The Sun Cluster Support for Oracle Parallel Server/Real Application Clusters software packages must be installed on each node in this list.

    -y maximum_primaries=num-in-list

    Specifies the number of nodes on which Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is to be enabled. This number must equal the number of nodes in nodelist.

    -y desired_primaries=num-in-list

    Specifies the number of nodes on which Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is to be enabled. This number must equal the number of nodes in nodelist.

    -y RG_mode=Scalable

    Specifies that the resource group is scalable.

  3. Register the SUNW.rac_framework resource type.


    # scrgadm -a -t SUNW.rac_framework

  4. Add an instance of the SUNW.rac_framework resource type to the resource group that you created in Step 2.


    # scrgadm -a -j fmwk-resource \
  -g resource-group \
  -t SUNW.rac_framework
    -j fmwk-resource

    Specifies the name that you are assigning to the SUNW.rac_framework resource.

    -g resource-group

    Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created in Step 2.

  5. Register the SUNW.rac_udlm resource type.


    # scrgadm -a -t SUNW.rac_udlm

  6. Add an instance of the SUNW.rac_udlm resource type to the resource group that you created in Step 2.

    Ensure that this instance depends on the SUNW.rac_framework resource that you created in Step 4.


    # scrgadm -a -j udlm-resource \
  -g resource-group \
  -t SUNW.rac_udlm \
  -y resource_dependencies=fmwk-resource
    -j udlm-resource

    Specifies the name that you are assigning to the SUNW.rac_udlm resource.

    -g resource-group

    Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created in Step 2.

    -y resource_dependencies=fmwk-resource

    Specifies that this instance depends on the SUNW.rac_framework resource that you created in Step 4.

  7. Register and add instances of the resource types that are required for the storage management scheme that you are using.

    • If you are using VxVM with the cluster feature, register and add an instance of the SUNW.rac_cvm resource type to the resource group that you created in Step 2.

      Ensure that this instance depends on the rac_framework resource that you created in Step 4.


      # scrgadm -a -t SUNW.rac_cvm


      # scrgadm -a -j cvm-resource \
  -g resource-group \
  -t SUNW.rac_cvm \
  -y resource_dependencies=fmwk-resource
      -j cvm-resource

      Specifies the name that you are assigning to the SUNW.rac_cvm resource.

      -g resource-group

      Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created in Step 2.

      -y resource_dependencies=fmwk-resource

      Specifies that this instance depends on the SUNW.rac_framework resource that you created in Step 4.

    • If you are using hardware RAID support, register and add an instance of the SUNW.rac_hwraid resource type to the resource group that you created in Step 2.

      Ensure that this instance depends on the rac_framework resource that you created in Step 4.


      # scrgadm -a -t SUNW.rac_hwraid


      # scrgadm -a -j raid-resource \
  -g resource-group \
  -t SUNW.rac_hwraid \
  -y resource_dependencies=fmwk-resource
      -j raid-resource

      Specifies the name that you are assigning to the SUNW.rac_hwraid resource.

      -g resource-group

      Specifies the resource group to which you are adding the resource. This resource group must be the resource group that you created in Step 2.

      -y resource_dependencies=fmwk-resource

      Specifies that this instance depends on the SUNW.rac_framework resource that you created in Step 4.

    • If you are using the cluster file system, no resource instance that represents this storage management scheme is required.

  8. Bring the RAC framework resource group and its resources online.


    # scswitch -Z -g resource-group
    -Z

    Enables the resource and monitor, moves the resource group to the MANAGED state, and brings the resource group online

    -g resource-group

    Specifies that the resource group that you created in Step 2 is to be moved to the MANAGED state and brought online

How to Add Nodes to the RAC Framework Resource Group by Using the scrgadm Utility

This procedure assumes that a RAC framework resource group has already been created for the cluster.

  1. On one node of the cluster, become superuser.

  2. For the RAC framework resource group, specify a node list that contains the following nodes:

    • The nodes on which Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is already enabled.

    • The nodes that you are adding to the RAC framework resource group.


    # scrgadm -c -g resource-group \
  -y nodelist=nodelist \
  -y maximum_primaries=num-in-list \
  -y desired_primaries=num-in-list
    -g resource-group

    Specifies the name of the RAC framework resource group to which you are adding nodes. If this resource group was created by using the scsetup utility, the name of the resource group is rac-framework-rg.

    -y nodelist=nodelist

    Specifies a comma-separated list of cluster nodes on which Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is already enabled and the nodes that you are adding to the RAC framework resource group. The Sun Cluster Support for Oracle Parallel Server/Real Application Clusters software packages must be installed on each node in this list.

    -y maximum_primaries=num-in-list

    Specifies the number of nodes on which Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is to be enabled. This number must equal the number of nodes in nodelist.

    -y desired_primaries=num-in-list

    Specifies the number of nodes on which Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is to be enabled. This number must equal the number of nodes in nodelist.

  3. Bring the RAC framework resource group and its resources online.


    # scswitch -Z -g resource-group
    -Z

    Enables the resource and monitor, moves the resource group to the MANAGED state, and brings the resource group online.

    -g resource-group

    Specifies the name of the RAC framework resource group that is to be moved to the MANAGED state and brought online. If this resource group was created by using the scsetup utility, the name of the resource group is rac-framework-rg.

How to Remove the RAC Framework Resource Group by Using the scrgadm Utility

The resources that the RAC framework resource group contains are described in Overview of the RAC Framework Resource Group. If the RAC framework resource group is created by using the scsetup utility, scsetup assigns names to the resources as listed in the following table.

Table 2–2 Names Assigned to RAC Framework Resources by scsetup

Resource Type 

Resource Name 

SUNW.rac_cvm

rac_cvm

SUNW.rac_hwraid

rac_hwraid

SUNW.rac_udlm

rac_udlm

SUNW.rac_framework

rac_framework

  1. On one node of the cluster, become superuser.

  2. Disable each resource that the RAC framework resource group contains.

    Disable the instance of the SUNW.rac_framework resource only after you have disabled all other resources that the RAC framework resource group contains. The other resources in the RAC framework resource group depend on SUNW.rac_framework.


    # scswitch -n -j resource
    -j resource

    Specifies the name of the resource that you are disabling. If this resource was created by using the scsetup utility, the name depends on the resource type as shown in Table 2–2.

  3. Remove each resource that you disabled in Step 2.

    Remove the instance of the SUNW.rac_framework resource only after you have removed all other resources that the RAC framework resource group contains. The other resources in the RAC framework resource group depend on SUNW.rac_framework.


    # scrgadm -r -j resource
    -j resource

    Specifies the name of the resource that you are removing. If this resource was created by using the scsetup utility, the name depends on the resource type as shown in Table 2–2.

  4. Unregister the resource type of each resource that you removed in Step 3.


    # scrgadm -r -t resource-type
    -t resource-type

    Specifies the name of the resource type that you are unregistering. This resource type was registered for the RAC framework resource group when the resource group was created. The resources that the RAC framework resource group contains are described in Overview of the RAC Framework Resource Group.

  5. Remove the RAC framework resource group.


    # scrgadm -r -g resource-group
    -g resource-group

    Specifies the name of the RAC framework resource group that you are removing. If this resource group was created by using the scsetup utility, the name of the resource group is rac-framework-rg.

Example 2–1 Removing the RAC Framework Resource Group by Using the scrgadm Utility


# scswitch -n -j rac_cvm
# scswitch -n -j rac_udlm
# scswitch -n -j rac_framework
# scrgadm -r -j rac_cvm
# scrgadm -r -j rac_udlm
# scrgadm -r -j rac_framework
# scrgadm -r -t SUNW.rac_cvm
# scrgadm -r -t SUNW.rac_udlm
# scrgadm -r -t SUNW.rac_framework
# scrgadm -r -g rac-framework-rg

This example shows the commands that are required to remove a RAC framework resource group that was created by using the scsetup utility. The cluster from which this resource group is removed uses the VxVM volume manager.

Note –

After you have removed the RAC framework resource group, you must boot each cluster node in noncluster mode and uninstall the Sun Cluster Support for Oracle Parallel Server/Real Application Clusters software packages. For more information, see How to Remove Sun Cluster Support for Oracle Parallel Server/Real Application Clusters From a Cluster.

How to Remove Nodes From the RAC Framework Resource Group by Using the scrgadm Utility

  1. On one node of the cluster, become superuser.

  2. Boot in noncluster mode the nodes from which you are removing Sun Cluster Support for Oracle Parallel Server/Real Application Clusters.

  3. For the RAC framework resource group, specify a node list that contains only the nodes that are to remain in the RAC framework resource group.

    This node list must not include the nodes that you are removing.


    # scrgadm -c -g resource-group \
  -y nodelist=nodelist \
  -y maximum_primaries=num-in-list \
  -y desired_primaries=num-in-list
    -g resource-group

    Specifies the name of the RAC framework resource group from which you are removing nodes. If this resource group was created by using the scsetup utility, the name of the resource group is rac-framework-rg.

    -y nodelist=nodelist

    Specifies a comma-separated list of cluster nodes that are to remain in the RAC framework resource group. This node list must not include the nodes that you are removing.

    -y maximum_primaries=num-in-list

    Specifies the number of nodes on which Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is to be enabled. This number must equal the number of nodes in nodelist.

    -y desired_primaries=num-in-list

    Specifies the number of nodes on which Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is to be enabled. This number must equal the number of nodes in nodelist.

Note –

After you have removed nodes from the RAC framework resource group, you can optionally uninstall the Sun Cluster Support for Oracle Parallel Server/Real Application Clusters software packages from the nodes that you removed. For more information, see How to Remove Sun Cluster Support for Oracle Parallel Server/Real Application Clusters From Selected Nodes.

Tuning Sun Cluster Support for Oracle Parallel Server/Real Application Clusters

To tune Sun Cluster Support for Oracle Parallel Server/Real Application Clusters, you modify the extension properties of the resources in the RAC framework resource group. For details about these extension properties, see Appendix A, Sun Cluster Support for Oracle Parallel Server/Real Application Clusters Extension Properties. Typically, you use the command line scrgadm -x parameter=value to set extension properties when you create the Sun Cluster Support for Oracle Parallel Server/Real Application Clusters resources. You can also use the procedures in “Administering Data Service Resources” in Sun Cluster 3.1 Data Service Planning and Administration Guide to configure the resources later.

Guidelines for Setting Timeouts

Many of the extension properties for Sun Cluster Support for Oracle Parallel Server/Real Application Clusters specify timeouts for steps in reconfiguration processes. The optimum values for most of these timeouts are independent of your cluster configuration. Therefore, you should not need to change the timeouts from their default values.

Timeouts that depend on your cluster configuration are described in the subsections that follow. If timeouts occur during reconfiguration processes, increase the values of these time-out properties to accommodate your cluster configuration.

VxVM Component Reconfiguration Step 4 Timeout

The time that is required for step 4 of a reconfiguration of the VxVM component of Sun Cluster Support for Oracle Parallel Server/Real Application Clusters is affected by the size and complexity of your VERITAS shared-disk group configuration. If your VERITAS shared-disk group configuration is large or complex and the reconfiguration of the VxVM component times out, increase the timeout for step 4 of a reconfiguration of the VxVM component.

To increase the timeout for step 4 of a reconfiguration of the VxVM component, increase the value of the Cvm_step4_timeout extension property of the SUNW.rac_cvm resource.

For details of the extension properties of the SUNW.rac_cvm resource type, see Table A–2.

Example 2–2 Setting the VxVM Component Reconfiguration Step 4 Timeout


# scrgadm -c -j rac_cvm -x cvm_step4_timeout=1200

This example sets the timeout for step 4 of a reconfiguration of the VxVM component to 1200 seconds. This example assumes that the VxVM component is represented by an instance of the SUNW.rac_cvm resource type that is named rac_cvm.

Reservation Step Timeout

The time that is required for reservation commands to run is affected by the following factors:

If the number of shared physical disks in the cluster is large, or if your cluster is heavily loaded, the reconfiguration of Sun Cluster Support for Oracle Parallel Server/Real Application Clusters might time out. If such a timeout occurs, increase the reservation step timeout.

To increase the reservation step timeout, increase the Reservation_timeout extension property of the appropriate resource for your storage management scheme.

Storage Management Scheme 

Resource 

VxVM with the cluster feature 

SUNW.rac_cvm

Hardware RAID support 

SUNW.rac_hwraid

Note –

If you are using the cluster file system, the reservation step timeout is not applicable.

Details of the extension properties of these resource types are available as follows:

Example 2–3 Setting the Reservation Step Timeout


# scrgadm -c -j rac_hwraid -x reservation_timeout=350

This example sets the timeout for the reservation step of a reconfiguration of Sun Cluster Support for Oracle Parallel Server/Real Application Clusters to 350 seconds. In this example, the cluster uses hardware RAID support. This example assumes that the hardware RAID component is represented by an instance of the SUNW.rac_hwraid resource type that is named rac_hwraid.

Guidelines for Setting the Communications Port Range for the Oracle UDLM

An application other than the Oracle UDLM on a cluster node might use a range of communications ports that conflicts with the range for the Oracle UDLM. If such a conflict occurs, modify the range of communications ports that the Oracle UDLM uses.

The range of communications ports that the Oracle UDLM uses is determined by the values of the following extension properties of the SUNW.rac_udlm resource type:

For details of the extension properties of the SUNW.rac_udlm resource type, see Table A–1.

Example 2–4 Setting the Communications Port Number for the Oracle UDLM


# scrgadm -c -j rac_udlm -x port=7000

This example sets the communications port number that the Oracle UDLM uses to 7000. The following assumptions apply to this example:

How to Modify an Extension Property That Is Tunable Only When a Resource Is Disabled

Restrictions apply to the circumstances in which you can modify an extension property that is tunable only when a resource is disabled. Those circumstances depend on the resource type as follows:

  1. Disable each resource that the RAC framework resource group contains and bring the RAC framework resource group into the UNMANAGED state.

    Disable the instance of the SUNW.rac_framework resource only after you have disabled all other resources that the RAC framework resource group contains. The other resources in the RAC framework resource group depend on the SUNW.rac_framework resource.

    For detailed instructions, see “Disabling Resources and Moving Their Resource Group Into the UNMANAGED State” in Sun Cluster 3.1 Data Service Planning and Administration Guide.

  2. Reboot all the nodes that are in the node list of the RAC framework resource group.

  3. Use the scrgadm utility to set the property to its new value.


    # scrgadm -c -j resource -x property=value

    -j resource

    Specifies the name of the resource for which you are modifying an extension property. If this resource was created by using the scsetup utility, the name depends on the resource type as shown in Table 2–2.

    property

    Specifies the name of the extension property that you are changing.

    value

    The new value of the extension property.

  4. Bring the RAC framework resource group and its resources online.


    # scswitch -Z -g resource-group
    -Z

    Enables the resource and monitor, moves the resource group to the MANAGED state, and brings the resource group online.

    -g resource-group

    Specifies the name of the RAC framework resource group that is to be moved to the MANAGED state and brought online. If this resource group was created by using the scsetup utility, the name of the resource group is rac-framework-rg.