Sun Cluster 2.2 System Administration Guide

6.4 Adding and Removing Network Interfaces

The procedures in this section can be used to add or remove public network interface cards within a cluster configuration.

To add or remove a network interface to or from the control of a logical host, you must modify each logical host configured to use that interface. You change a logical host's configuration by completely removing the logical host from the cluster, then adding it again with the required changes. You can reconfigure a logical host with either the scconf(1M) or scinstall(1M) command. The examples in this section use the scconf(1M) command. Refer to "3.5 Adding and Removing Logical Hosts", for the logical host configuration steps using the scinstall(1M) command.

6.4.1 Adding a Network Interface

Adding a network interface requires unconfiguring and reconfiguring all logical hosts associated with the interface. Note that all data services will be inaccessible for a short period of time during the procedure.

6.4.2 How to Add a Network Interface

On each node that will receive a new network interface card, perform the following steps.

Stop the cluster software.
phys-hahost# scadmin stopnode

Add the new interface card, using the instructions included with the card.

Configure the new network interface on each node.

This step is necessary only if the new interface will be part of a logical host. Skip this step if your configuration does not include logical hosts.
phys-hahost# pnmset
For Ethernet, create a new /etc/hostname.if file for each new interface on each node, and run the ifconfig(1M) command as you normally would in a non-cluster environment.

Note -
When you configure a set of network interfaces to be used by different logical hosts within a cluster, you must connect all interfaces in the set to the same subnet.

Start the cluster software.

If all nodes have been stopped, run the scadmin startcluster command on node 0 and then the scadmin startnode command on all other nodes. If at least one node has not had the cluster software stopped, run the scadmin startnode command on the remaining nodes.
phys-hahost# scadmin startnode
If the new interfaces are being added to already existing backup groups, the procedure is complete.

If you modified the backup group configuration, you must bring the cluster back into normal operation and reconfigure each logical host that will be using the new set of network controllers. You will unconfigure and reconfigure each logical host, so run the scconf -p command to print out the current configuration before starting these steps. You can run the scconf -p command on any node that is an active cluster member; it does not need to be run on all cluster nodes.

To unconfigure and reconfigure the logical host, you can use either the scconf(1M) command as shown in these examples, or the scinstall(1M) command as described in "3.5 Adding and Removing Logical Hosts".

Notify users that data services on the affected logical hosts will be unavailable for a short period.

Save copies of the /etc/opt/SUNWcluster/conf/ccd.database files on each node, in case you need to restore the original configuration.

Turn off the data services.
phys-hahost# hareg -n dataservice

Unregister the data services.
phys-hahost# hareg -u dataservice

Remove the logical host from the cluster.

Run this command on any node that is an active cluster member. You do not need to run this command on all cluster nodes.
phys-hahost# scconf clustername -L logicalhost -r

Reconfigure the logical host to include the new interface.

Run this command on any node that is an active cluster member. You do not need to run this command on all cluster nodes.
phys-hahost# scconf clustername -L logicalhost -n nodelist -g dglist -i logaddrinfo
The logaddrinfo field is where you define the new interface name. Refer to the listing taken from the scconf -p command output to reconstruct each logical host.

Turn on the data services.
phys-hahost# hareg -y dataservice

Check access to the data services.

Notify users that the data services are once again available.

This completes the process of adding a network interface.

6.4.3 Removing a Network Interface

Use the following procedure to remove a public network interface from a cluster.

If you have an OPS configuration, no action is required within the cluster to remove a network interface. However, if you want to remove the network adapters from the cluster nodes, perform the following procedure.
If you have an HA configuration, you will need to use this procedure to unconfigure and reconfigure any logical host that uses the network interface to be removed. This requires that all data services will be inaccessible for a short period of time during the procedure.

6.4.4 How to Remove a Network Interface

While all nodes are participating in the cluster, perform the following steps on one node only.

Identify which logical hosts must be reconfigured to exclude the network interface.

All of these logical hosts will need to be unconfigured then reconfigured. Run the scconf -p command to print out a list of logical hosts in the current configuration; save this list for later use. You do not need to run the scconf -p command on all cluster nodes. You can run it on any node that is an active cluster member.

Run the pnmset(1M) command to display the current PNM configuration.

Remove the controller from a backup group, if necessary.

If the controller to be removed is part of a backup group, remove the controller from all logical hosts, then run the pnmset(1M) command to remove the controller from the backup group.

Notify users that any data services on the affected logical hosts will be unavailable for a short period.

Turn off the data services.
phys-hahost# hareg -n dataservice

Unregister the data services.
phys-hahost# hareg -u dataservice

Remove the logical host from the cluster.

Note -
To unconfigure and reconfigure the logical host (Step 7 and Step 8), you can either run the scconf(1M) command as shown, or run the scinstall(1M) command as described in "3.5 Adding and Removing Logical Hosts".

You can run this command on any node that is an active cluster member. You do not need to run it on all cluster nodes.
phys-hahost# scconf clustername -L logicalhost -r

Reconfigure the logical host to include the new interface.

You can run this command on any node that is an active cluster member. You do not need to run it on all cluster nodes.
phys-hahost# scconf clustername -L logicalhost -n nodelist -g dglist -i logaddrinfo
The logaddrinfo field is where you define the new interface name. Refer to the listing taken from the scconf -p command output to reconstruct each logical host.

If the controller being removed was part of a backup group, rerun the pnmset(1M) command.

Rerun the pnmset(1M) command and exclude the controller being removed.

(Optional) If you are removing the network adapter from the nodes, perform the following steps on each affected node:
1. Stop the cluster software.
  phys-hahost# scadmin stopnode
2. Halt the node and remove the interface card.
3. Boot the node.
4. Perform the Solaris system administration tasks you would normally perform to remove a network interface (remove hostname.if file, update /etc/hosts, etc).
5. Restart the cluster software. If all nodes were brought down, start the first node using the scadmin startcluster command. If at least one node is still running the cluster software, restart the other nodes.
  phys-hahost# scadmin startnode

Turn on the data services.
phys-hahost# hareg -y dataservice

Check access to the data services.

Notify users that the data services are once again available.