Changing Resource Type, Resource Group, and Resource Properties

Sun Cluster defines standard properties for configuring resource types, resource groups, and resources. These standard properties are described in the following sections:

• Resource Type Properties

• Resource Properties

• Resource Group Properties

Resources also have extension properties, which are predefined for the data service that represents the resource. For a description of the extension properties of a data service, see the documentation for the data service.

To determine whether you can change a property, see the Tunable entry for the property in the description of the property.

The following procedures describe how to change properties for configuring resource types, resource groups, and resources.

How to Change Resource Type Properties

Perform this procedure from any cluster node.

Before You Begin

Ensure that you have the following information.

• The name of the resource type to change.

• The name of the resource type property to change. For resource types, you can change only certain properties. To determine whether you can change a property, see the Tunable entry for the property in Resource Type Properties.

  ---

  Note –

  You cannot change the Installed_nodes property explicitly. To change this property, specify the -h installed-node-list option of the scrgadm command.

  ---

Steps

1. Become superuser on a cluster member.

2. Run the scrgadm command to determine the name of the resource type that you need for this procedure.

   # scrgadm -pv

3. Change the resource type property.

   For resource types, you can change only certain properties. To determine whether you can change a property, see the Tunable entry for the property in Resource Type Properties.

   # scrgadm -c -t resource-type \ [-h installed-node-list] \ [-y property=new-value]

   -c

   Changes the specified resource type property.

   -t resource-type

   Specifies the name of the resource type.

   -h installed-node-list

   Specifies the names of nodes on which this resource type is installed.

   -y property=new-value

   Specifies the name of the standard property to change and the new value of the property.

   You cannot change the Installed_nodes property explicitly. To change this property, specify the -h installed-node-list option of the scrgadm command.

4. Verify that the resource type property has been changed.

   # scrgadm -pv -t resource-type

Example 2–19 Changing a Resource Type Property

This example shows how to change the SUNW.apache property to define that this resource type is installed on two nodes (phys-schost-1 and phys-schost-2).

# scrgadm -c -t SUNW.apache -h phys-schost-1,phys-schost-2
# scrgadm -pv -t SUNW.apache
Res Type name:                               SUNW.apache
  (SUNW.apache) Res Type description:        Apache Resource Type
  (SUNW.apache) Res Type base directory:     /opt/SUNWscapc/bin
  (SUNW.apache) Res Type single instance:    False
  (SUNW.apache) Res Type init nodes:         All potential masters
  (SUNW.apache) Res Type failover:           False
  (SUNW.apache) Res Type version:            1.0
  (SUNW.apache) Res Type API version:        2
  (SUNW.apache) Res Type installed on nodes: phys-schost1 phys-schost-2
  (SUNW.apache) Res Type packages:           SUNWscapc

How to Change Resource Group Properties

This procedure explains how to change resource group properties. For a description of resource group properties, see Resource Group Properties.

Perform this procedure from any cluster node.

Before You Begin

Ensure that you have the following information.

• The name of the resource group to change

• The name of the resource group property to change and its new value

Steps

1. Become superuser on a cluster member.

2. Change the resource group property.

   # scrgadm -c -g resource-group -y property=new-value

   -c

   Changes the specified property.

   -g resource-group

   Specifies the name of the resource group.

   -y property

   Specifies the name of the property to change.

3. Verify that the resource group property has been changed.

   # scrgadm -pv -g resource-group

Example 2–20 Changing a Resource Group Property

This example shows how to change the Failback property for the resource group (resource-group-1).

# scrgadm -c -g resource-group-1 -y Failback=True
# scrgadm -pv -g resource-group-1

How to Change Resource Properties

This procedure explains how to change extension properties and standard properties of a resource.

• For a description of standard resource properties, see Resource Properties.

• For a description of the extension properties of a resource, see the documentation for the resource's resource type.

Perform this procedure from any cluster node.

Before You Begin

Ensure that you have the following information.

• The name of the resource with the property to change

• The name of the property to change

Steps

1. Become superuser on a cluster member.

2. View the current resource property settings.

   # scrgadm -pvv -j resource

3. Change the resource property.

   # scrgadm -c -j resource -y standard-property=new-value | -x extension-property=new-value

   -c

   Changes the specified property

   -j resource

   Specifies the name of the resource

   -y standard-property=new-value

   Specifies the name of the standard property to change

   -x extension-property=new-value

   Specifies the name of the extension property to change

4. Verify that the resource property has been changed.

   # scrgadm pvv -j resource

Example 2–21 Changing a Standard Resource Property

This example shows how to change the system-defined Start_timeout property for the resource (resource-1).

# scrgadm -c -j resource-1 -y start_timeout=30
# scrgadm -pvv -j resource-1

Example 2–22 Changing an Extension Resource Property

This example shows how to change an extension property (Log_level) for the resource (resource-1).

# scrgadm -c -j resource-1 -x Log_level=3
# scrgadm -pvv -j resource-1

How to Modify a Logical Hostname Resource or a Shared Address Resource

By default, logical hostname resources and shared address resources use name services for name resolution. You might configure a cluster to use a name service that is running on the same cluster. During the failover of a logical hostname resource or a shared address resource, a name service that is running on the cluster might also be failing over. If the logical hostname resource or the shared address resource uses the name service that is failing over, the resource fails to fail over.

Configuring a cluster to use a name server that is running on the same cluster might impair the availability of other services on the cluster.

To prevent such a failure to fail over, modify the logical hostname resource or the shared address resource to bypass name services. To modify the resource to bypass name services, set the CheckNameService extension property of the resource to false. You can modify the CheckNameService property at any time.

If your version of the resource type is earlier than 2, you must upgrade the resource type before you attempt to modify the resource. For more information, see Upgrading a Preregistered Resource Type.

Steps

1. Become superuser on a cluster member.

2. Change the resource property.

   # scrgadm -c -j resource -x CheckNameService=false

   -j resource

   Specifies the name of the logical hostname resource or shared address resource that you are modifying

   -y CheckNameService=false

   Sets the CheckNameService extension property of the resource to false