Skip to main content

Map ports from node1 to node3

Contributors netapp-pcarriga netapp-aoife

You must make sure that the physical ports on node1 map correctly to the physical ports on node3, which will let node3 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 from the Hardware Universe. (Go to References to link to the Hardware Universe). You use the information later in this section and in Map ports from node2 to node4.

The software configuration of node3 must match the physical connectivity of node3, 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.

  1. Perform the following steps to verify if the setup is a two-node switchless cluster:

    1. Set the privilege level to advanced:

      set -privilege advanced

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

      network options switchless-cluster show

      For example:

       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:

      set -privilege admin

  2. Make the following changes:

    1. Modify ports that will be part of Cluster broadcast domain:

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

      This example adds Cluster port e1b on "node1":

      network port modify -node node1 -port e1b -ipspace Cluster -mtu 9000
    2. Migrate the cluster LIFs to the new ports, once for each LIF:

      network interface migrate -vserver Vserver_name -lif lif_name -source-node node1 -destination-node node1 -destination-port port_name

      When all cluster LIFs are migrated and cluster communication is established, the cluster should come into quorum.

    3. Modify the home port of the Cluster LIFs:

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

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

      network port broadcast-domain remove-ports -ipspace Cluster -broadcast-domain Cluster -ports node1:port

    5. Display the health state of node1 and node3:

      cluster show -node node1 -fields health

    6. Depending on the ONTAP version running on the HA pair being upgraded, take one of the following actions:

      If your ONTAP version is…​ Then…​

      9.8 to 9.11.1

      Verify that the cluster LIFs are listening on port 7700:

      ::> network connections listening show -vserver Cluster

      9.12.1 or later

      Skip this step and go to Step 3.

      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.
    7. 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 substep (f) to verify that the cluster LIF is now listening on port 7700.

  3. Modify the broadcast domain memberships of physical ports hosting data LIFs.

    1. List the reachability status of all ports:

      network port reachability show

    2. Repair the reachability of the physical ports, followed by VLAN ports, by running the following command on each port, one port at a time:

      reachability repair -node node_name -port port_name

      A warning like the following is expected. Review and enter y or n as appropriate:

      WARNING: Repairing port "node_name:port" might cause it to move into a different broadcast domain, which can cause LIFs to be re-homed away from the port. Are you sure you want to continue? {y|n}:
    3. To enable ONTAP to complete the repair, wait for about a minute after running the reachability repair command on the last port.

    4. List all broadcast domains on the cluster:

      network port broadcast-domain show

    5. As the reachability repair is performed, ONTAP attempts to place the ports in the correct broadcast domains. However, if a port’s reachability cannot be determined and does not correspond to any of the existing broadcast domains, ONTAP will create new broadcast domains for these ports. As required, you can delete the newly created broadcast domains if all their member ports will become member ports of the interface groups. Delete broadcast domains:

      broadcast-domain delete -broadcast-domain broadcast_domain

    6. Review the interface group configuration, and as required, add or delete member ports.

      Add member ports to interface group ports:

      ifgrp add-port -node node_name -ifgrp ifgrp_port -port port_name

      Remove member ports from interface group ports:

      ifgrp remove-port -node node_name -ifgrp ifgrp_port -port port_name

    7. Delete and re-create VLAN ports as needed. Delete VLAN ports:

      vlan delete -node node_name -vlan-name vlan_port

      Create VLAN ports:

      vlan create -node node_name -vlan-name vlan_port

      Note Depending on the complexity of the networking configuration of the system being upgraded, you might be required to repeat Substeps (a) to (g) until all ports are placed correctly where needed.
  4. If there are no VLANs configured on the system, go to Step 5. If there are VLANs configured, restore displaced VLANs that were previously configured on ports that no longer exist or were configured on ports that were moved to another broadcast domain.

    1. Display the displaced VLANs:

      cluster controller-replacement network displaced-vlans show

    2. Restore the displaced VLANs to the desired destination port:

      displaced-vlans restore -node node_name -port port_name -destination-port destination_port

    3. Verify that all displaced VLANs have been restored:

      cluster controller-replacement network displaced-vlans show

    4. VLANs are automatically placed into the appropriate broadcast domains about a minute after they are created. Verify that the restored VLANs have been placed into the appropriate broadcast domains:

      network port reachability show

  5. Beginning with ONTAP 9.8, ONTAP will automatically modify the home ports of LIFs if the ports are moved between broadcast domains during the network port reachability repair procedure. If a LIF’s home port was moved to another node, or is unassigned, that LIF will be presented as a displaced LIF. Restore the home ports of displaced LIFs whose home ports either no longer exist or were relocated to another node.

    1. Display the LIFs whose home ports might have moved to another node or no longer exist:

      displaced-interface show

    2. Restore the home port of each LIF:

      displaced-interface restore -vserver Vserver_name -lif-name LIF_name

    3. Verify that all LIF home ports have been restored:

      displaced-interface show

    When all ports are correctly configured and added to the correct broadcast domains, the network port reachability show command should report the reachability status as "ok" for all connected ports, and the status as "no-reachability" for ports with no physical connectivity. If any ports are reporting a status other than these two, repair the reachability as outlined in Step 3.

  6. Verify that all LIFs are administratively up on ports belonging to the correct broadcast domains.

    1. Check for any LIFs that are administratively down:

      network interface show -vserver Vserver_name -status-admin down

    2. Check for any LIFs that are operationally down:

      network interface show -vserver Vserver_name -status-oper down

    3. Modify any LIFs that need to be modified to have a different home port:

      network interface modify -vserver Vserver_name -lif LIF_name -home-port home_port

      Note For iSCSI LIFs, modification of the home port requires the LIF to be administratively down.
    4. Revert LIFs that are not home to their respective home ports:

      network interface revert *