This section contains two procedures:
To configure a cluster node to be an additional master of a resource group
To remove a node from a resource group
The procedures are slightly different, depending on whether you are adding or removing the node to or from a failover or scalable resource group.
Failover resource groups contain network resources that are used by both failover and scalable services. Each IP subnetwork connected to the cluster has its own network resource specified and included in a failover resource group. This is either a logical host name or a shared address resource. Each network resource includes a list of NAFO groups that it uses. For failover resource groups, you must update the complete list of NAFO groups for each network resource included in the resource group (the netiflist resource property).
For scalable resource groups, in addition to changing the scalable group to be mastered on the new set of hosts, you must repeat the procedure for failover groups that contain the network resources used by the scalable resource.
For additional information, see scrgadm(1M).
Run either of these procedures from any cluster node.
To complete this procedure, you must supply the following information:
The names and node IDs of all the cluster nodes
The names of the resource groups to which you are adding the node
The name of the NAFO group that will host the network resources used by the resource group on all the nodes
Also note the following:
Be sure to verify that the new node is already a cluster member.
For failover resource groups, perform all the steps below.
For scalable resource groups, you must do the following:
For each network resource used by a scalable resource in the resource group, make the resource group where the network resource is located run on the new node (Steps 1 through 4 below).
Add the new node to the list of nodes that can master the scalable resource group (the nodelist resource group property) (Step 3 below).
(Optional) Update the Load_balancing_weights property of the scalable resource to assign a weight to the node you wish to add to the resource group. Otherwise, the weight defaults to 1. See scrgadm(1M).
Display the current node list and the current list of NAFO groups configured for each resource in the resource group.
# scrgadm -pvv -g resource-group | grep -i nodelist # scrgadm -pvv -g resource-group | grep -i netiflist |
The output of the command line for nodelist identifies the nodes by node name; the one for netiflist identifies them by node ID.
Update netiflist for the network resources affected by the node addition.
This step overwrites the previous value of netiflist, so you must include all NAFO groups here. Also, you must input nodes to netiflist by node ID. To find the node ID, use scconf -p.
# scrgadm -c -j network-resource -x netiflist=netiflist |
Changes a network resource.
Specifies the name of the network resource (logical host name or shared address) being hosted on the netiflist entries.
Specifies a comma-separated list that identifies the NAFO groups on each node. Each element in netiflist must be in the form of NAFO-group-name@nodeid.
Update the node list to include all the nodes that can now master this resource group.
This step overwrites the previous value of nodelist so you must include all the nodes that can master the resource group here.
# scrgadm -c -g resource-group -h nodelist |
Changes a resource group.
Specifies the name of the resource group to which the node is being added.
Specifies a comma-separated list of nodes that can master the resource group.
Verify the updated information.
# scrgadm -pvv -g resource-group | grep -i nodelist # scrgadm -pvv -g resource-group | grep -i netiflist |
This example shows how to add a node (phys-schost-2) to a resource group (rg-1), which contains a logical host name resource (schost-2).
# scrgadm -pvv -g rg-1 | grep -i nodelist (rg-1) Res Group Nodelist: phys-schost-1 phys-schost-3 # scrgadm -pvv -g rg-1 | grep -i netiflist (rg-1:schost-2) Res property name: NetIfList (rg-1:schost-2:NetIfList) Res property class: extension(rg-1:schost-2:NetIfList) List of NAFO interfaces on each node(rg-1:schost-2:NetIfList) Res property type: stringarray(rg-1:schost-2:NetIfList) Res property value: nafo0@1 nafo0@3 (Only nodes 1 and 3 have been assigned NAFO groups. You must add a NAFO group for node 2.) # scrgadm -c -j schost-2 -x netiflist=nafo0@1,nafo0@2,nafo0@3 # scrgadm -c -g rg-1 -h phys-schost-1,phys-schost-2,phys-schost-3 # scrgadm -pvv -g rg-1 | grep -i nodelist (rg-1) Res Group Nodelist: phys-schost-1 phys-schost-2 phys-schost-3 # scrgadm -pvv -g rg-1 | grep -i netiflist (rg-1:schost-2:NetIfList) Res property value: nafo0@1 nafo0@2 nafo0@3 |
To complete this procedure, you must supply the following information:
The names and node IDs of all the cluster nodes
The name of the resource group or groups from which you are removing the node
The name of the NAFO group that will host the network resources used by the resource group on all the nodes
Also note the following:
Be sure to verify that the resource group is not mastered on the node you will remove. If that's not the case, use scswitch(1M) to take the resource group offline on the node you want to remove.
For failover resource groups, perform all the steps below.
For scalable resource groups, you must do the following:
Remove the node from the list of nodes that can master the scalable resource group (the nodelist resource group property) (Step 1 below).
(Optional) For each network resource used by a scalable resource in the resource group, update the resource group where the network resource is located to not be mastered on the removed node (Steps 1 through 4 below).
(Optional) Update the Load_balancing_weights property of the scalable resource to remove the weight of the node you wish to remove from the resource group. See scrgadm(1M).
Update the node list to include all the nodes that can now master this resource group.
This step removes the node and overwrites the previous value of nodelist; be sure to include all the nodes that can master the resource group here.
# scrgadm -c -g resource-group -h nodelist |
Changes a resource group.
Specifies the name of the resource group from which the node is being removed.
Specifies a comma-separated list of nodes that can master this resource group.
Display the current list of NAFO groups configured for each resource in the resource group.
# scrgadm -pvv -g resource-group | grep -i netiflist |
The output of the above command lines identifies the nodes by node ID.
Update netiflist for network resources affected by the removal of the node.
This step overwrites the previous value of netiflist; be sure to include all NAFO groups here. Also, you must input nodes to netiflist by node ID. To find the node ID, use scconf -p.
# scrgadm -c -j network-resource -x netiflist=netiflist |
Changes a network resource.
Specifies the name of the network resource (logical host name or shared address) being hosted on the netiflist entries.
Specifies a comma-separated list that identifies the NAFO groups on each node. Each element in netiflist must be in the form of NAFO-group-name@nodeid.
Verify the updated information.
# scrgadm -pvv -g resource-group | grep -i nodelist # scrgadm -pvv -g resource-group | grep -i netiflist |
This example shows how to remove a node (phys-schost-3) from a resource group (rg-1), which contains a logical host name resource (schost-1).
# scrgadm -pvv -g rg-1 | grep -i nodelist (rg-1) Res Group Nodelist: phys-schost-1 phys-schost-2 phys-schost-3 # scrgadm -c -g rg-1 -h phys-schost-1,phys-schost-2 # scrgadm -pvv -g rg-1 | grep -i netiflist (rg-1:schost-1) Res property name: NetIfList(rg-1:schost-1:NetIfList) Res property class: extension(rg-1:schost-1:NetIfList) List of NAFO interfaces on each node(rg-1:schost-1:NetIfList) Res property type: stringarray(rg-1:schost-1:NetIfList) Res property value: nafo0@1 nafo0@2 nafo0@3 (nafo0@3 is the NAFO group to be removed.) # scrgadm -c -j schost-1 -x netiflist=nafo0@1,nafo0@2 # scrgadm -pvv -g rg-1 | grep -i nodelist (rg-1) Res Group Nodelist: phys-schost-1 phys-schost-2 # scrgadm -pvv -g rg-1 | grep -i netiflist (rg-1:schost-1:NetIfList) Res property value: nafo0@1 nafo0@2 |