Upgrade controllers

Map ports from node2 to node4

Contributors netapp-pcarriga netapp-aoife netapp-martyh

You must make sure that the physical ports on node2 map correctly to the physical ports on node4, which will let node4 communicate with other nodes in the cluster and with the network after the upgrade.

Before you begin

You must already have information about the ports on the new nodes, to access this information refer to References to link to the Hardware Universe. You use the information later in this section.

The software configuration of node4 must match the physical connectivity of node4, and IP connectivity must be restored before you continue with the upgrade.

About this task

Port settings might vary, depending on the model of the nodes. You must make the original node’s port and LIF configuration compatible with what you plan the new node’s configuration to be. This is because the new node replays the same configuration when it boots, meaning when you boot node4 that Data ONTAP will try to host LIFs on the same ports that were used on node2.

Therefore, if the physical ports on node2 do not map directly to the physical ports on node4, then software configuration changes will be required to restore cluster, management, and network connectivity after the boot. In addition, if the cluster ports on node2 do not directly map to the cluster ports on node4, node4 may not automatically rejoin quorum when it is rebooted until a software configuration change is made to host the cluster LIFs on the correct physical ports.

  1. Record all the node2 cabling information for node2, the ports, broadcast domains, and IPspaces, in this table:

    LIF Node2 ports Node2 IPspaces Node2 broadcast domains Node4 ports Node4 IPspaces Node4 broadcast domains

    Cluster 1

    Cluster 2

    Cluster 3

    Cluster 4

    Cluster 5

    Cluster 6

    Node management

    Cluster management

    Data 1

    Data 2

    Data 3

    Data 4


    Intercluster port

    See the "Recording node2 information" section for the steps to obtain this information.

  2. Record all the cabling information for node4, the ports, broadcast domains, and IPspaces, in the previous table using the same procedure in the Record node2 information section for the steps to obtain this information.

  3. Follow these steps to verify if the setup is a two-node switchless cluster:

    1. Set the privilege level to advanced:

    2. Verify if the setup is a two-node switchless cluster:

      cluster::*> network options switchless-cluster show
      Enable Switchless Cluster: false/true

      The value of this command must match the physical state of the system.

    3. Return to the administration privilege level:

      cluster::*> set -privilege admin
  4. Get node4 into quorum by performing the following steps:

    1. Boot node4. See Install and boot node4 to boot the node if you have not already done so.

    2. Verify that the new cluster ports are in the Cluster broadcast domain:

      network port show -node node -port port -fields broadcast-domain
      The following example shows that port "e0a" is in the Cluster domain on node4:

      cluster::> network port show -node node4 -port e0a -fields broadcast-domain
      node       port broadcast-domain
      ---------- ---- ----------------
      node4      e1a  Cluster
    3. If the cluster ports are not in the Cluster broadcast-domain, add them with the following command:

      broadcast-domain add-ports -ipspace Cluster -broadcast-domain Cluster -ports node:port

    4. Add the correct ports to the Cluster broadcast domain:

      network port modify -node -port -ipspace Cluster -mtu 9000

      This example adds Cluster port "e1b" on node4:

      network port modify -node node4 -port e1b -ipspace Cluster -mtu 9000

      Note For a MetroCluster configuration, you might not be able to change the broadcast domain of a port because it is associated with a port hosting the LIF of a sync-destination SVM and see errors similar to, but not restricted, to the following:
      command failed: This operation is not permitted on a Vserver that is configured as the destination of a MetroCluster Vserver relationship.

      Enter the following command from the corresponding sync-source SVM on the remote site to reallocate the sync-destination LIF to an appropriate port:

      metrocluster vserver resync -vserver vserver_name

    5. Migrate the cluster LIFs to the new ports, once for each LIF:

      network interface migrate -vserver Cluster -lif lif_name -source-node node4 - destination-node node4 -destination-port port_name

    6. Modify the home port of the cluster LIFs:

      network interface modify -vserver Cluster -lif lif_name –home-port port_name

    7. Remove the old ports from the Cluster broadcast domain:

      network port broadcast-domain remove-ports

      This command removes port "e0d" on node4:
      network port broadcast-domain remove-ports -ipspace Cluster -broadcast-domain Cluster ‑ports node4:e0d

    8. Verify that node4 has rejoined quorum:

      cluster show -node node4 -fields health

  5. Adjust the broadcast domains hosting your cluster LIFs and node-management/cluster-management LIFs. Confirm that each broadcast domain contains the correct ports. A port cannot be moved between broadcast domains if it is hosting or is home to a LIF so you may need to migrate and modify the LIFs as shown in the following steps:

    1. Display the home port of a LIF:

      network interface show -fields home-node,home-port

    2. Display the broadcast domain containing this port:

      network port broadcast-domain show -ports node_name:port_name

    3. Add or remove ports from broadcast domains:

      network port broadcast-domain add-ports

      network port broadcast-domain remove-ports

    4. Modify a LIF’s home port:

      network interface modify -vserver vserver_name -lif lif_name –home-port port_name

  6. Adjust the intercluster broadcast domains and migrate the intercluster LIFs, if necessary, using the same commands shown in Step 5.

  7. Adjust any other broadcast domains and migrate the data LIFs, if necessary, using the same
    commands shown in Step 5.

  8. If there were any ports on node2 that no longer exist on node4, follow these steps to delete them:

    1. Access the advanced privilege level on either node:

      set -privilege advanced

    2. To delete the ports:

      network port delete -node node_name -port port_name

    3. Return to the admin level:

      set -privilege admin

  9. Adjust all the LIF failover groups:
    network interface modify -failover-group failover_group -failover-policy failover_policy

    The following command sets the failover policy to broadcast-domain-wide and uses the
    ports in failover group fg1 as failover targets for LIF data1 on node4:

    network interface modify -vserver node4 -lif data1 failover-policy broadcast-domain-wide -failover-group fg1

    For more information, refer to References to link to Network Management or the ONTAP 9 Commands: Manual Page Reference, and go to Configuring failover settings on a LIF.

  10. Verify the changes on node4:

    network port show -node node4

  11. Each cluster LIF must be listening on port 7700. Verify that the cluster LIFs are listening on port 7700:

    ::> network connections listening show -vserver Cluster

    Port 7700 listening on cluster ports is the expected outcome as shown in the following example for a two-node cluster:

    Cluster::> network connections listening show -vserver Cluster
    Vserver Name     Interface Name:Local Port     Protocol/Service
    ---------------- ----------------------------  -------------------
    Node: NodeA
    Cluster          NodeA_clus1:7700               TCP/ctlopcp
    Cluster          NodeA_clus2:7700               TCP/ctlopcp
    Node: NodeB
    Cluster          NodeB_clus1:7700               TCP/ctlopcp
    Cluster          NodeB_clus2:7700               TCP/ctlopcp
    4 entries were displayed.
  12. If necessary, for each cluster LIF that is not listening on port 7700, set the administrative status of the LIF to down and then up:

    ::> net int modify -vserver Cluster -lif cluster-lif -status-admin down; net int modify -vserver Cluster -lif cluster-lif -status-admin up

    Repeat Step 11 to verify that the cluster LIF is now listening on port 7700.