resourcegroup

The egosh resourcegroup sub-command manages the resource groups in your cluster.

resourcegroup add group_name [-d description] [-s slot | -e slot_expr] [-t Dynamic -R host_req | -t Static -r host[,host...]]

Adds a new resource group for slot-based scheduling. See the subsequent section to add a resource group for multidimensional scheduling.

This is an administrative subcommand. You must first log on as cluster administrator before you can issue this subcommand.

group_name
Specifies the name of the slot-based resource group. The name must adhere to the following naming rules:
  • The resource group name must be unique.
  • The resource group name must not use the same name as the resource plan name.
  • The resource group name can only contain the following characters: 0 to 9, lowercase letters, uppercase letters, hyphens (-), or underscores (_). It cannot contain the these characters: \ / : * ? \ " < > | '
  • The resource group name can be a maximum of 64 characters.
-d description
A description of the resource group, up to a maximum of 200 characters. This is optional (by default, it is empty).
-s slot
Specifies the number of slots per host. Default is 0 indicating one slot per CPU. Can be a integer greater than 0, indicating the number of slots per host.
-e slot_expr
Specifies the slot expression for the resource group. Default is (ncpu*1) indicating one slot per CPU.
-t type
Specifies the type of resource group, which can be either static or dynamic. Default is dynamic. The type is case-insensitive.
-R host_req
Specifies the requirement for the host selection in dynamic resource groups. Default is "", indicating all hosts.
-r host[,host...]
Lists the hosts for the static resource groups. At least one host must be provided.

resourcegroup add group_name -MDS [-d description] [-t {Dynamic -R host_req | Static -r host[,host...]}]

Adds a new resource group for multidimensional scheduling.

This is an administrative subcommand. You must first log on as cluster administrator before you can issue this subcommand.

group_name
Specifies the name of the multidimensional resource group. The name must adhere to the following naming rules:
  • The resource group name must be unique.
  • The resource group name must not use the same name as the resource plan name.
  • The resource group name can only contain the following characters: 0 to 9, lowercase letters, uppercase letters, hyphens (-), or underscores (_). It cannot contain the these characters: \ / : * ? \ " < > | '
  • The resource group name can be a maximum of 64 characters.
-MDS
Specifies the resource group for multidimensional scheduling.
-d description
The description of the resource group. Default is empty.
-t type
Specifies the type of resource group, which can be either static or dynamic. Default is dynamic. The type is case-insensitive.
-R host_req
Specifies the requirement for the host selection in dynamic resource groups. Default is "", indicating all hosts.
-r host[,host...]
Lists the hosts for the static resource groups. At least one host must be provided.

resourcegroup addhost group_name-r host[,host...] [-s slot_num]

Adds a new host to a resource group (static resource group only) for slot-based and multidimensional scheduling.

This is an administrative subcommand. You must first log on as cluster administrator before you can issue this subcommand.

group_name
Specifies the name of the resource group.
-r host[,host...]
Lists the hosts for the static resource groups. At least one host must be provided.
-s slot_num
Optional static number of slots for the hosts being added. If specified, this value will override the group-level slot expression for these hosts.

resourcegroup delete group_name

Deletes a resource group for slot-based and multidimensional scheduling.

group_name
Specifies the name of the resource group.

resourcegroup list [-l] [group_name[ group_name ...]]

Lists information about all slot-based resource groups in the cluster. See the subsequent section to list resource groups for multidimensional scheduling.

-l
Lists values for allocated and free slots within a resource group. Detailed usage information includes a breakdown of owned, shared, and borrowed slots (both in-use and unused) in the cluster.
group_name
Specifies the name of the slot-based resource group. To specify multiple resource groups, separate the resource group names with a space.

resourcegroup list -MDS [-l] | [-P resource_plan [-slotmap consumer_name] | [-l]]

Lists information about all multidimensional resource groups in the cluster.

-MDS
Lists multidimensional resource groups.
-l
Lists values for allocated and free units within a resource group. Detailed usage information includes a breakdown of owned, shared, and borrowed units (both in-use and unused) in the cluster.
-P resource_plan
Specifies the name of the multidimensional resource plan that is associated with the resource group.
-slotmap consumer_name
Shows the resource group in the perspective of the consumer's slot mappings.

resourcegroup modify group_name [-d description] [-s slot | -e slot_expr] [-t Dynamic -R host_req] | [-t Static -r host[,host...]]

Modifies an existing slot-based resource group (acts as an override). See the subsequent section to modify resource groups for multidimensional scheduling.

This is an administrative subcommand. You must first log on as cluster administrator before you can issue this subcommand.

group_name
Specifies the name of the resource group.
-d description
The description of the resource group. Default is empty.
-s slot
Specifies the number of slots per host. Default is 0 indicating one slot per CPU. Can be a integer greater than 0, indicating the number of slots per host.
-e slot_expr
Specifies the slot expression for the resource group. Default is (ncpu*1) indicating one slot per CPU.
-t type
Specifies the type of resource group, which can be either static or dynamic. The type is case-insensitive.
-R host_req
Specifies the requirement for the host selection in dynamic resource groups.
-r host[,host...]
Lists the hosts for the static resource groups. At least one host must be provided.

resourcegroup modify group_name -MDS [-d description] [-t Dynamic -R host_req] | [-t Static -r host[,host...]]

Modifies an existing multidimensional resource group (acts as an override).

This is an administrative subcommand. You must first log on as cluster administrator before you can issue this subcommand.

group_name
Specifies the name of the resource group.
-MDS
Specifies a multidimensional resource group.
-d description
The description of the resource group. Default is empty.
-t type
Specifies the type of resource group, which can be either static or dynamic. The type is case-insensitive.
-R host_req
Specifies the requirement for the host selection in dynamic resource groups.
-r host[,host...]
Lists the hosts for the static resource groups. At least one host must be provided.

resourcegroup removehost group_name -r host[,host...]

Removes a host from a resource group (static resource group only) for slot-based and multidimensional scheduling.

This is an administrative subcommand. You must first log on as cluster administrator before you can issue this subcommand.

-g group_name
Specifies the name of the resource group.
-r host[,host...]
Lists the hosts for the static resource groups. At least one host must be provided.

resourcegroup view [-MDS] group_name[ group_name ...]

Displays information about all resource groups in the cluster, including the number of hosts in the group, the number of free and allocated slots or units, and detailed usage information describing distribution among consumers.

-MDS
Specifies multidimensional resource groups.
group_name[ group_name ...]
Specifies the name of the resource group. To specify multiple resource groups, separate the resource group names with a space.