chrg

Name

chrg - Changes persistent attribute values of one or more resource groups, including starting and stopping resource groups.

Synopsis

chrg [-h] [-i] [-u a | d | r] -s "selection_string" [-l relationship ] [-n node_name | -e equiv_name] [-o nominal_state] [-p priority] [-N Owner] [-D Description] [-I InfoLink] [-T] [-V] [-x node1, ...noden]

chrg [-h] [-i] [-u a | d | r] [-c new_name] [-l relationship ] [-n node_name | -e equiv_name] [-o nominal_state] [-p priority] [-N Owner] [-D Description] [-I InfoLink] [-T] [-V] [-x node1, ...noden] Resource_group [ … ]

Description

The chrg command changes the persistent attribute values of one or more resource groups. The name of the resource group is specified by Resource_group. The resource groups to be changed can also be determined using the selection string with the -s option. The name of a resource group can also be changed with this command using the -c option. System Automation for Multiplatforms will then update all the associated member resources with this change. To allow System Automation for Multiplatforms to monitor and control these resource groups, the resource group must be in an Online Nominal State.

Options

-c new_name

Specifies the new Resource_group name. Renames the Resource_group name with new_name.

-e equiv_name

Specifies the equivalency name of the nodes on which the Resource_group can run. This option cannot be combined with the -n option. To set the resource group with the equivalency of all nodes in the cluster, specify equiv_name as the string ALL.

-h

Writes the command's usage statement to standard output.

-i

Interactive. Prompt before changing resource groups.

-u a | d | r

Specifies what should be done with the specified node list. Note that these options require the -x option.

a: Adds the specified nodes to the list of excluded nodes.
d: Deletes the specified nodes from the list.
r: Replaces the exclude list with the specified nodes.

-x node1, ...noden

Specifies the excluded node list. Only to be used in conjunction with -u a | d | r.

-l relationship

Specifies the location relationship among the members of the resource group. The location relationship value can be entered as the numeric value or as the word (not case-sensitive):

0x0000 or None: None. Specifies that member resources of the resource group can be on any node
0x0001 or Collocated: Specifies that member resources of the resource group are to be located on the same node.

-n node_name

Specifies the node on which the Resource_group can run. This option cannot be combined with the -e option.

-o nominal_state

Specifies the Nominal state of the resource group, which can be online or offline. Nominal state values can be entered as the numeric value or as the word (not case-sensitive):

0x0000 or Online: Online. Specifies that the desired state of Resource_group is online.
0x0001 or Offline: Offline. Specifies that the desired state of Resource_group is offline.

-p priority

Specifies the relative importance of this resource group compared to other resource groups. Priority can be any integer from 0 to 200: the higher the integer, the higher the priority. The default priority value is 0.

-N Owner

A string with the name of the owner or contact for the group.

-D Description

A string describing the purpose of the group.

-I InfoLink

A string containing the URL of a HTML page which shows additional information about the resource group.

-s Selection_string

Specifies the source selection string of the persistent attribute values to change. Selection_string is applied to all existing resource groups.

The selection string must be enclosed within either double or single quotation marks. If the selection string contains double quotation marks, enclose the entire selection string in single quotation marks. For example:

-s 'Name == "testing"'

-s 'Name ?= "test"'

-s 'Name like "%"' ( For all resources)

-T

Writes the command's trace messages to standard error. For your software-service organization's use only.

-V

Writes the command's verbose messages to standard output.

Parameters

Resource_group: The unique name of the resource group to be changed. This resource group must already exist for this operation to succeed. Multiple resource groups can be specified but must be separated by spaces.

Exit Status

0: The command ran successfully.
1: Error occurred with RMC.
2: Error occurred with CLI script.
3: Incorrect flag on command line.
4: Incorrect parameter on command line.
5: Error occurred with RMC that was based on faulty command line input.
6: Resource specified was not found.
7: Resource already exists.

Security

This command requires root authority, or a user ID with appropriate permissions.For more information, see Setting up non-root user Ids for the command line interface.

Examples

To change the persistent-attribute location relationship to Collocated, Nominal state to Online, and the priority value to 34 of a resource group called resA, enter:
```
chrg -l collocated -o 0 -p 34 resA
```
To change the name of resource group resA to clusterfoo with location relationship now changed to None, and allowed node name of cluster, enter:
```
chrg -c clusterfoo -l 0 -n cluster resA
```
To change the location relationship to None, and allowed node name cluster for all resource groups containing the name resA, enter:
```
chrg -l none -n cluster -s 'Name like "%resA%"'
```

Files

/usr/sbin/rsct/bin/chrg: Location of the chrg command.