clRGmove command

Purpose

Perform a user-requested rg_move event to bring a resource group offline or online, or to move a resource group from one node to another node.

Syntax


clRGmove -g <groupname> -n <nodename> | -x -n <sitename> |-r | -a [-m | -u | -d] [-i] [-s true | false]

Description

You can use the clRGmove to manually control the location and state of resource groups.

You can perform any of the following actions for a non-concurrent resource group:

Take the resource group offline from an online or online secondary node.
Bring the resource group online or online secondary to a specific node.
Move the resource group from its current hosting node to a new location.

You can perform any of the following actions for a concurrent resource group:

Take the resource group offline from all nodes in the group node list.
Take the resource group offline from one node in the group node list.
Bring the resource group online on all nodes in the group node list.
Bring the resource group online on one node in the group node list.

Priority Override Location

A priority override location overrides all other node policies and possible locations for the resource group.

The following are the priority override locations for non-concurrent resource groups:

For every non-concurrent resource group movement that uses the -n flag to explicitly specify a destination instead of the -r flag, the destination becomes the priority override location. The priority override location lasts until you explicitly use the -r flag for the location instead of the -n flag when you manually move the resource group again.
When you move a resource group offline, the resource group remains offline until you manually bring it back online. If you manually bring the resource group back online with the -n flag to specify a node, that node becomes the priority override location. When you bring a resource group back online with the -r flag, the active highest priority node is used and the priority override location is removed from the resource group.

The following are the priority override locations for concurrent resource groups:

When you bring a concurrent resource group offline on all nodes, the priority override location is in the OFFLINE state for all nodes in the resource group. When you bring a concurrent resource group offline on just one node, the OFFLINE state for the resource group on the node is added to the priority override location list.
When you bring a concurrent resource group online on all nodes, the priority override location is removed for all nodes in the resource group. When you bring a concurrent resource group online on just one node, the OFFLINE state for the resource group on that node is removed from the priority override location list.

For all resource group movements you can use one of the following movements:

non-persistent movement: Lasts until all nodes in the cluster are offline. As soon as the entire cluster goes offline, the priority override location is forgotten, and the resource group resumes normal behavior when the cluster comes back online.
persistent movement: Lasts after a cluster reboots. The priority override location remains when the cluster comes back online.

Limitations

The following are limitations for the clRGmove command:

You can bring only one resource group online or offline at a time.
When you move multiple resource groups with the command line, you must make sure that the request is rational. Thus, it is recommended that you use the SMIT interface for moving resource groups as it eliminates any possibility of administrative errors. To move resource groups with the SMIT interface enter smit cspoc from the command line and select Resource Group and Applications.

Flags

-a

You can use this flag only for concurrent resource groups. Use this flag to bring the resource group online or offline for all nodes in the resource group. Use the -n flag to bring a concurrent resource group online or offline on a single node.

-d

Brings the resource group offline. You cannot use this flag with the -u flag or the -m flag.

-g

Specifies the name of the resource group to move in the following formats:

-g <groupname>: Specific a single resource group name.
-g "groupname1,groupname2,...": Specifies a comma-separated list of multiple resource group names.

-i

Runs the clRGinfo command after the resource group has been moved successfully.

-m

Moves the resource group to another node. You cannot use this flag with the -u flag or the -d flag. Use this flag to move multiple online resource groups to another node one node at a time.

-n <nodename>

The name of the node that contains the resource group that is moved, brought online, or brought offline. You cannot use this flag with the -r or the -a flag. If the node name has a * character in front of it, that node is configured to be the highest priority node for this resource group and the resource group was moved to another node. If you move a resource group in a node that is identified with a * character, the movement changes the original configuration for the resource group.

-n <sitename>

The name of the site that contains the resource group that is moved across a site. You must use this flag with the -x flag. If the site name has a * character in front of it, that site is configured to be the highest priority site for this resource group and the resource group was moved to another site. If you move a resource group in a site that is identified with a * character, the movement changes the original configuration for the resource group.

-r

You can use this flag only for non-concurrent resource groups. Use the highest priority node that is available for the destination node where the resource group is moving. This flag removes the priority override location attribute for the resource group that is being moved. You can use this flag only when you are bringing a non-concurrent resource group online or moving a non-concurrent resource group to another node. You cannot use this flag with the -n flag or the -a flag.

-s true | false

Specifies actions on the primary or secondary instance of a resource group (if sites are defined). You use this flag to take the primary or the secondary instance of the resource group offline, online, or move it to another node within the same site. You can use this flag with the -r, -d, -u, and -m flags.

-s true: Specifies actions on the secondary instance of a resource group.
-s flase: Specifies actions on the primary instance of a resource group.

-u

Brings the resource group online. You cannot use this flag with the -d flag or the -m flag.

-x

You can use this flag to move the resource group across a site. You must use this flag with the -n <sitename> flag.

Examples

To bring an offline non-concurrent resource group online on a node named nodeB:
```
clRGmove -g rgA -n nodeB -u
```
To move an online non-concurrent resource group to another node named nodeB:
```
clRGmove -g rgA -n nodeB -m
```
To move multiple online non-concurrent resource groups to another node named nodeB:
```
clRGmove -g "rgA,rgB,rgC" -n nodeB -m 
```
To bring an online non-concurrent resource group offline on a node named nodeB:
```
clRGmove -g rgA -n nodeB -d
```
To move an online non-concurrent resource group to the active highest priority node that is removing the previous configuration settings that are caused by another rg_move event:
```
clRGmove -g *rgA -m -r
```
To bring an online concurrent resource group offline on one node named nodeB:
```
clRGmove -g rgA -n nodeB -d
```
To bring an online concurrent resource group offline on all nodes:
```
clRGmove -g rgA -a -d
```
To bring an offline concurrent resource group online on one node named nodeB:
```
clRGmove -g rgA -n nodeB -u
```
To bring an offline concurrent resource group online on all nodes:
```
clRGmove -g rgA -a -u
```
To move a resource group to a site named site2:
```
clRGmove -s false -x -g rgA -n site2
```