Product Documentation

cluster nodegroup

Sep 12, 2016

The following operations can be performed on "cluster nodegroup":

add | show | set | unset | bind | unbind | rm

add cluster nodegroup

Adds a nodegroup to the cluster. A nodegroup is a set of cluster nodes to which entities can be bound. Entities that are bound to a specific nodegroup are active on all the nodes of the group and not active on the nodes that are not part of the group.

Synopsys

add cluster nodegroup <name>@ [-strict ( YES | NO )] [-sticky ( YES | NO )] [-state <state>] [-priority <positive_integer>]

Arguments

name

Name of the nodegroup. The name uniquely identifies the nodegroup on the cluster.

strict

Specifies whether cluster nodes, that are not part of the nodegroup, will be used as backup for the nodegroup.

* Enabled - When one of the nodes goes down, no other cluster node is picked up to replace it. When the node comes up, it will continue being part of the nodegroup.

* Disabled - When one of the nodes goes down, a non-nodegroup cluster node is picked up and acts as part of the nodegroup. When the original node of the nodegroup comes up, the backup node will be replaced.

Possible values: YES, NO

Default value: NO

sticky

Only one node can be bound to nodegroup with this option enabled. It specifies whether to prempt the traffic for the entities bound to nodegroup when owner node goes down and rejoins the cluster.

* Enabled - When owner node goes down, backup node will become the owner node and takes the traffic for the entities bound to the nodegroup. When bound node rejoins the cluster, traffic for the entities bound to nodegroup will not be steered back to this bound node. Current owner will have the ownership till it goes down.

* Disabled - When one of the nodes goes down, a non-nodegroup cluster node is picked up and acts as part of the nodegroup. When the original node of the nodegroup comes up, the backup node will be replaced.

Possible values: YES, NO

Default value: NO

state

State of the nodegroup. All the nodes binding to this nodegroup must have the same state. ACTIVE/SPARE/PASSIVE

Possible values: ACTIVE, SPARE, PASSIVE

Default value: VAL_NOT_SET

priority

Priority of Nodegroup. This priority is used for all the nodes bound to the nodegroup for Nodegroup selection

Default value: -1

Minimum value: 0

Maximum value: 31

Example

add cluster nodegroup ng1 -strict yes

show cluster nodegroup

Displays information about the available nodegroups.

Synopsys

show cluster nodegroup [<name>]

Arguments

name

Name of the nodegroup to be displayed. If a name is not provided, information about all nodegroups is displayed.

Outputs

node

Nodes in the nodegroup

strict

Specifies whether cluster nodes, that are not part of the nodegroup, will be used as backup for the nodegroup.

* Enabled - When one of the nodes goes down, no other cluster node is picked up to replace it. When the node comes up, it will continue being part of the nodegroup.

* Disabled - When one of the nodes goes down, a non-nodegroup cluster node is picked up and acts as part of the nodegroup. When the original node of the nodegroup comes up, the backup node will be replaced.

sticky

Only one node can be bound to nodegroup with this option enabled. It specifies whether to prempt the traffic for the entities bound to nodegroup when owner node goes down and rejoins the cluster.

* Enabled - When owner node goes down, backup node will become the owner node and takes the traffic for the entities bound to the nodegroup. When bound node rejoins the cluster, traffic for the entities bound to nodegroup will not be steered back to this bound node. Current owner will have the ownership till it goes down.

* Disabled - When one of the nodes goes down, a non-nodegroup cluster node is picked up and acts as part of the nodegroup. When the original node of the nodegroup comes up, the backup node will be replaced.

vServer

vserver that need to be bound to this nodegroup.

currentNodeMask

Bitmap of current nodes in this nodegroup

backupNodeMask

Bitmap of backup nodes in this nodegroup

boundedEntitiesCntFromPE

Count of bounded entities to this nodegroup accoding to PE

boundedConfigEntitiesCnt

Number of configs bound to this nodegroup

activeList

Active node list of this nodegroup

backupList

Backup node list of this nodegroup

identifierName

stream identifier and rate limit identifier that need to be bound to this nodegroup.

gslbSite

vserver that need to be bound to this nodegroup.

service

name of the service bound to this nodegroup.

stateflag

cfgflags

This contains the flags for Cluster Nodegroup in DB

state

State of the nodegroup. All the nodes binding to this nodegroup must have the same state. ACTIVE/SPARE/PASSIVE

priority

Priority of Nodegroup. This priority is used for all the nodes bound to the nodegroup for Nodegroup selection

devno

count

set cluster nodegroup

Modifies the attributes of a cluster nodegroup.

Synopsys

set cluster nodegroup <name>@ [-strict ( YES | NO )] [-state <state>] [-priority <positive_integer>]

Arguments

name

Name of the nodegroup to be modified.

strict

Specifies whether cluster nodes, that are not part of the nodegroup, will be used as backup for the nodegroup.

* Enabled - When one of the nodes goes down, no other cluster node is picked up to replace it. When the node comes up, it will continue being part of the nodegroup.

* Disabled - When one of the nodes goes down, a non-nodegroup cluster node is picked up and acts as part of the nodegroup. When the original node of the nodegroup comes up, the backup node will be replaced.

Possible values: YES, NO

Default value: NO

state

State of the nodegroup. All the nodes binding to this nodegroup must have the same state. ACTIVE/SPARE/PASSIVE

Possible values: ACTIVE, SPARE, PASSIVE

Default value: VAL_NOT_SET

priority

Priority of Nodegroup. This priority is used for all the nodes bound to the nodegroup for Nodegroup selection

Default value: -1

Minimum value: 0

Maximum value: 31

Example

set cluster nodegroup ng1 -strict yes

unset cluster nodegroup

Unset nodes from the given nodegroup or unset strict option.Refer to the set cluster nodegroup command for meanings of the arguments.

Synopsys

unset cluster nodegroup <name>@ [-strict]

Example

unset cluster nodegroup ng1 -strict

bind cluster nodegroup

Binds a cluster node or an entity to the given nodegroup. A node can be bound to more than one nodegroup.

Synopsys

bind cluster nodegroup <name> (-node <positive_integer>@ | -vServer <string> | -identifierName <string> | -gslbSite <string> | -service <string>)

Arguments

name

Name of the nodegroup to which you want to bind a cluster node or an entity.

node

ID of the node to be bound to the nodegroup.

Default value: -1

Minimum value: 0

Maximum value: 31

vServer

Name of the virtual server to be bound to the nodegroup.

identifierName

Name of stream or limit identifier to be bound to the nodegroup.

gslbSite

Name of the GSLB site to be associated with the nodegroup.

service

Name of the ADNS or ADNS-TCP service to be associated with the nodegroup. This parameter is used to support GSLB in a cluster.

Example

bind cluster nodegroup ng1 -vserver v1

unbind cluster nodegroup

Unbinds a cluster node or an entity from a given nodegroup.

Synopsys

unbind cluster nodegroup <name> (-node <positive_integer>@ | -vServer <string> | -identifierName <string> | -gslbSite <string> | -service <string>)

Arguments

name

Name of the nodegroup from which you want to unbind a cluster node or an entity.

node

ID of the node to be unbound from the nodegroup.

Default value: -1

Minimum value: 0

Maximum value: 31

vServer

Name of the virtual server to be unbound from the nodegroup.

identifierName

Name of stream or limit identifier to be unbound from the nodegroup.

gslbSite

Name of the GSLB site to be unbound from the nodegroup.

service

Name of the service to be unbound from the nodegroup.

Example

unbind cluster nodegroup ng1 -vserver v1

rm cluster nodegroup

Removes a nodegroup from the cluster.

Synopsys

rm cluster nodegroup <name>@

Arguments

name

Name of the nodegroup to be removed.

Example

rm cluster nodegroup ng1