Skip to main content
ONTAP MetroCluster

Set the required bootarg (for MetroCluster IP upgrades to systems introduced in ONTAP 9.15.1 or later)

Contributors netapp-aoife
PDFs

Controller upgrades to systems introduced in ONTAP 9.15.1 or later require you to set a bootarg on the old controllers before you can start the upgrade.

Note You must set the required bootarg on all of the old nodes at both sites before you start the upgrade.

Step 1: Determine the bootarg you need to set on the old controllers

All supported upgrades to the following systems require you to set a bootarg on the old controllers before performing the controller upgrade:

  • AFF A70, AFF A90, AFF A1K

  • FAS70, FAS90

  • AFF C80

  • AFF A50, AFF A20, AFF A30

  • AFF C30, AFF C60

  • FAS50

Caution If you are upgrading to any of the systems listed, you must set a required bootarg on the existing system before performing the upgrade. For all other upgrades, you can skip this task and go directly to Prepare the system for upgrade.

Most upgrades to systems introduced in ONTAP 9.15.1 or later require you to set the hw.cxgbe.toe_keepalive_disable bootarg on the old controllers. However, certain upgrade paths require you to set the bootarg.siw.interop_enabled bootarg instead.

Use the following table to determine which bootarg you need to set for your specific upgrade combination.

For this upgrade…​ Set the bootarg…​

From AFF A250 to AFF A30

bootarg.siw.interop_enabled

From AFF C250 to AFF C30

bootarg.siw.interop_enabled

From AFF A150 to AFF A20

bootarg.siw.interop_enabled

From AFF A220 to AFF A20

bootarg.siw.interop_enabled

All other supported upgrades to AFF A70, AFF A90, AFF A1K, FAS70, FAS90, AFF C80, AFF A50, AFF A20, AFF A30, AFF C30, AFF C60, or FAS50 systems

hw.cxgbe.toe_keepalive_disable

Step 2: Set the required bootarg on the old controllers

This task is only required when you upgrade to an AFF A70, AFF A90, AFF A1K, FAS70, FAS90, AFF C80, AFF A50, AFF A20, AFF A30, AFF C30, AFF C60, or FAS50 system.

Steps

  1. Halt one node at both sites and allow its HA partner to perform a storage takeover of the node:

    halt -node <node_name>

  2. Set the required bootarg for your upgrade combination. You already determined the bootarg that you need to set by using the table in determine which bootarg you need to set.

    hw.cxgbe.toe_keepalive_disable

    1. At the LOADER prompt of the halted node, enter the following:

      setenv hw.cxgbe.toe_keepalive_disable 1

      saveenv

      printenv hw.cxgbe.toe_keepalive_disable

    bootarg.siw.interop_enabled

    1. At the LOADER prompt of the halted node, enter the following:

      setenv bootarg.siw.interop_enabled 1

      saveenv

      printenv bootarg.siw.interop_enabled

  3. Boot the node:

    boot_ontap

  4. When the node boots, perform a giveback for the node at the prompt:

    storage failover giveback -ofnode <node_name>

  5. Repeat the steps on all nodes in the DR group or DR groups that you are upgrading.

What's next?

Prepare the system for upgrade.