Resource Groups

View
Resource Group Status
Resource Group Topology
Resource Group Configuration

Actions
Bringing a Resource Group Online and Switching Primaries
Taking a Resource Group Offline
Restarting a Resource Group
Managing a Resource Group
Unmanaging a Resource Group
Creating a New Resource Group
Deleting a Resource Group
Modifying Resource Group Properties
Resource Tasks

Viewing Resource Group Status

To display the status of your resource groups and their current primary nodes (primaries), from the navigation frame in SunPlex^TM Manager, choose Resource Groups.

Return to top

Viewing Resource Group Topology

To display a graphical representation of your resource groups and their primaries, complete the following steps:

From the navigation frame in SunPlex Manager, choose Resource Groups.
From the Action Menu, choose Resource Group Topology.

This topology displays every cluster node and the status of each resource group on the node.

Note: If your cluster has more than four nodes or more than four resource groups, the resource group topology is not displayed as an option on the View menu.

Return to top

Viewing Resource Group Configuration

To display the resources in a resource group and the resource group's properties, choose the resource group name from either the:

Resource Group section in the navigation frame in SunPlex Manager
Resource Group Status table

See the Resource Group Properties table for a complete description of each resource group property.

Return to top

Bringing a Resource Group Online and Switching Primaries

Performing this task brings a resource group online on the node or on the nodes that are specified. This action can bring a resource group online for the first time or switch the node or nodes on which the resource group is running.

When you complete this task, SunPlex Manager also automatically manages the resource group. You need to enable the resources in the resource group.

Bring a resource group online to allow resources to begin providing failover or scalable services.

Switch primaries for the following reasons:

To perform maintenance on a node
To change the cluster's configuration

To bring a resource group online or switch primaries, complete the following steps:

From the Resource Group section in the navigation frame in SunPlex Manager, choose Resource Groups or [resource group name].
The Resource Groups window appears.
From the Action Menu, choose Bring Group Online/Switch Primaries.
A task window appears. This window prompts you to provide additional information.
Choose the resource group to bring online.
Choose the primary node or nodes on which the resource group is to run.
If the resource group is Failover, choose one new primary.
If the resource group is Scalable, you can choose more than one new primary.
Click Bring Online/Set Primaries.
SunPlex Manager displays a confirmation message, including the command that is used to complete the task. Write down or copy this command for future use in scripts and other automated tasks.

Return to top

Taking a Resource Group Offline

You need to take a resource group offline for the following reasons:

To change the cluster's configuration
To change the function of the cluster

Performing this task puts the selected resource group into an unmanaged state on all nodes. After you take a resource group offline, the resource group cannot restart until you bring the resource group online.

To take a resource group offline, complete the following steps:

From the Resource Group section in the navigation frame in SunPlex Manager, choose Resource Groups or [resource group name].
The Resource Groups window appears.
From the Action Menu, choose Take Group Offline.
A task window appears. This window prompts you to provide additional information.
Choose the resource group to take offline.
Click Take Resource Group Offline.
SunPlex Manager displays a confirmation message, including the command that is used to complete the task. Write down or copy this command for future use in scripts and other automated tasks.

Note: If the application that the resource is controlling fails to stop, SunPlex Manager places a STOP_FAILED flag on the associated resource and resource group.

You need to manually check the resource application to see if the application is running, stop the application on the node on which the application is running, and clear the STOP_FAILED flag.

Return to top

Restarting a Resource Group

If dependencies exist between a resource that needs to be restarted and other resources in the same resource group, you can restart the resource group to prevent the resources from coming online in the wrong order.

Restarting a resource group takes the selected resource group and all of its resources offline and then online on the resource group's primary nodes.

To restart a resource group, complete the following steps:

From the Resource Group section in the navigation frame in SunPlex Manager, choose Resource Groups or [resource group name].
The Resource Groups window appears.
Ensure that the resource group is online.
If the resource group is offline, to bring the resource group online, choose Bring Online/Switch Primaries from the Action Menu. SunPlex Manager cannot restart a resource group that is offline.
From the Action Menu, choose Restart Group.
A task window appears. This window prompts you to provide additional information.
Choose the resource group to be restarted.
Click Restart Resource Group
SunPlex Manager displays a confirmation message, including the command that is used to complete the task. Write down or copy this command for future use in scripts and other automated tasks.

Return to top

Managing a Resource Group

You need to manage a resource group to make the cluster aware of it. When the resource group is managed, the cluster can make resource group decisions, such as the node on which to bring the resource group online, or the resource group to which to failover.

To manage a resource group, complete the following steps:

From the Resource Group section in the navigation frame in SunPlex Manager, choose Resource Groups or [resource group name].
The Resource Groups window appears.
From the Action Menu, choose Manage Group.
A task window appears. This window prompts you to provide additional information.
Choose the group to be managed.
Click Manage Resource Group.
SunPlex Manager displays a confirmation message, including the command that is used to complete the task. Write down or copy this command for future use in scripts and other automated tasks.

Return to top

Unmanaging a Resource Group

Prior to performing an administrative procedure on a resource group, you might need to unmanage the resource group. Unmanaging a resource group prevents the resource group from failing over and restarting on another node.

You must disable each resource in the resource group before you unmanage the resource group. After you choose Unmanage Group, SunPlex Manager takes the resource group offline.

Performing this task puts the selected resource group into an unmanaged state on all nodes.

To unmanage a resource group, complete the following steps:

From the Resource Group section in the navigation frame in SunPlex Manager, choose Resource Groups or [resource group name].
The Resource Groups window appears.
From the Action Menu, choose Unmanage Group.
A task window appears. This window prompts you to provide additional information.
Choose the group to be unmanaged.
Click Unmanage Resource Group.
SunPlex Manager displays a confirmation message, including the command that is used to complete the task. Write down or copy this command for future use in scripts and other automated tasks.

Return to top

Creating a New Resource Group

A resource group contains a set of resources, all of which are brought online or offline together on a specific node or set of nodes. You must create an empty resource group before placing resources into it.

The two resource group types are failover and scalable. A failover resource group can be online on only one node at any time. A scalable resource group can be online on multiple nodes simultaneously.

To create a resource group, complete the following steps:

From the Resource Group section in the navigation frame in SunPlex Manager, choose Resource Groups or [resource group name].
The Resource Groups window appears.
From the Action Menu, choose Create New Group.
A task window appears. This window prompts you to provide additional information.
Type the name of the resource group.
Choose the primary nodes on which the resource group is to run.
The nodes that you choose become the resource group's ordered node list.
- To add a node to the node list, complete the following steps:
  1. Click on a node name from the Available Nodes list.
    The node name is highlighted.
  2. Click Add.
    SunPlex Manager places the node on the Selected Nodes list.
  3. Add all potential primaries to the Selected Nodes list.
- To remove a node from the node list, complete the following steps:
  1. From the Selected Nodes list, click on a node name:
    The node name is highlighted.
  2. Click Remove.
    SunPlex Manager removes the node from the Selected Nodes list.
- To change the order of the node list, complete the following steps:
  1. From the Selected Nodes list, click on a node name:
    The node name is highlighted.
  2. Click Up or click Down.
    SunPlex Manager moves the node up or down in the list of nodes.
Type the number of nodes that you want the group to run on simultaneously.
The default is 1. If you are creating a failover resource group, the value of this property must be no greater than 1. If you are creating a scalable resource group, a value that is greater than 1 is allowed.
Type the maximum number of nodes where the group might be online at once.
The default is 1. If you are creating a Failover Resource Group, the value of this property must be no greater than 1. If you are creating a Scalable Resource Group, a value that is greater than 1 is allowed.
Click one of these two buttons:
- Create Resource Group to create the resource group
  You are finished with this procedure.
  SunPlex Manager displays a confirmation message, including the command that is used to complete the task. Write down or copy this command for future use in scripts and other automated tasks.
- Configure Additional Properties to continue modifying the new resource group's properties
  A task window appears. This window prompts you to provide additional information.

Modify the information about the resource group property for your configuration.

See the Resource Group Properties table for a complete description of each property.

Note: If you are creating a resource group that is to hold an NFS resource, specify the Pathprefix Directory.
You can specify any directory for this purpose. However, you must manually create the Pathprefix directory before you add an NFS resource to the group.
Installing Sun Cluster HA for NFS contains more information about setting up the Pathprefix Directory.

Click Create Resource Group .
SunPlex Manager displays a confirmation message, including the command that is used to complete the task. Write down or copy this command for future use in scripts and other automated tasks.

Return to top

Deleting a Resource Group

You might need to delete a resource group if you change the cluster's configuration or function.

By deleting a resource group, you permanently delete the selected resource group and all of the resources it contains.

To delete a resource group, complete the following steps:

From the Resource Group section in the navigation frame in SunPlex Manager, choose Resource Groups or [resource group name].
The Resource Groups window appears.
From the Action Menu, choose Delete Group.
A task window appears. This window prompts you to provide additional information.
Choose the resource group to be deleted.
Click Delete Resource Group .
SunPlex Manager displays a confirmation message, including the command that is used to complete the task. Write down or copy this command for future use in scripts and other automated tasks.

Return to top

Modifying Resource Group Properties

If you need to modify resource group properties to change the cluster's configuration, complete the following steps:

From the Resource Group section in the navigation frame in SunPlex Manager, choose Resource Groups or [resource group name].
The Resource Groups window appears.
From the Action Menu, choose Modify Group Properties.
A task window appears. This window prompts you to provide additional information.
Choose the resource group to be modified.
Click Next.
SunPlex Manager displays an additional window that prompts you to provide resource group properties. For a complete description of these properties, see the Resource Group Properties table. In this table, the value Tunable indicates when you can modify the property.
Modify the appropriate property value by typing the new information in the provided field.
Click Modify Group Properties.
SunPlex Manager displays a confirmation message, including the command that is used to complete the task. Write down or copy this command for future use in scripts and other automated tasks.

Return to top