Migrating from management node 10.x to version 11.x

If you have a management node at version 10.x, you cannot upgrade from 10.x to 11.x. You can instead use this migration procedure to copy over the configuration from 10.x to a newly deployed 11.1 management node. If your management node is currently at 11.0 or higher, you should skip this procedure. You need management node 11.0 or 11.1 and the latest HealthTools to upgrade Element software from 10.3 + through 11.x.

Before you begin

About this task

For upgrades from older Element software versions, see upgrade information.

NetApp Knowledgebase Answer 1088254: Upgrade matrix for storage clusters running NetApp Element Software

Attention: If you have an existing management node that has been updated to 10.3 using update-fdva, it might need a patch from NetApp Support before it can be used to run HealthTools and/or upgrade the storage cluster.

Steps

  1. Download the OVA or ISO for your installation from the NetApp Support Site:
  2. If you downloaded the OVA, deploy it in vSphere.
  3. If you downloaded the ISO, follow these steps:
    1. Create a new 64-bit virtual machine from your hypervisor with the following configuration:
      • Six virtual CPUs
      • 12GB RAM
      • 400GB virtual disk, thin provisioned
      • (Optional) One virtual network interface with internet access and access to the storage MVIP.
      Attention: Do not power on the virtual machine prior to the step indicating to do so later in this procedure.
    2. Attach the ISO to the virtual machine and boot to the .iso install image.
      Note: Installing a management node using the image might result in 30-second delay before the splash screen appears.
  4. Power on the virtual machine for the management node after the installation completes.
  5. Using the terminal user interface (TUI), create a new administrator ID and assign a password.
    Tip: To enter text, press Enter three times on the keyboard to open edit mode. After you enter text, press Enter again to close the edit mode. To navigate between fields, use the arrow keys.
  6. Configure the management node network using the TUI.
  7. In the management node TUI, log in to the management node with the new ID and password and validate that it works.
  8. If you have the Element Plug-in for vCenter Server as part of your installation, follow these steps:
    1. From vSphere, open the VM console for the management node that brings up the management node terminal user interface (TUI).
    2. Get the management node 11.0 or 11.1 IP address and go to the IP address on port 9443 to open the management node UI.
      https://<mNode IP address>:9443
    3. In vSphere, select NetApp Element Configuration > mNode Settings. In older versions, the top-level menu is NetApp SolidFire Configuration.
    4. Click Actions > Clear.
    5. To confirm, click Yes. The mNode Status field reports Not Configured.
      Note: When you go to the mNode Settings tab for the first time, the mNode Status field might display as Not Configured instead of the expected status of UP; you might not be able to select Actions > Clear. Refresh the browser. The mNode Status field will eventually display UP.
    6. Log out of vSphere.
    7. In a web browser, open the management node registration utility (https://<mNode IP address>:9443) and select QoSSIOC Service Management.
    8. Set the new QoSSIOC password.
      Note: The default password is solidfire. This password is required to set the new password.
    9. Click the vCenter Plug-in Registration tab.
    10. Select Update Plug-in.
    11. Enter required values. When you are finished, click UPDATE.
    12. Log in to vSphere and select NetApp Element Configuration > mNode Settings.
    13. Click Actions > Configure.
    14. Provide the management node IP address, management node user ID (the user name is admin), password that you set on the QoSSIOC Service Management tab of the registration utility, and vCenter user ID and password.
      In vSphere, the mNode Settings tab should display the mNode Status as UP, which indicates the management node 11.1 is registered to vCenter.
    15. From the management node registration utility (https://<mNode 11.1 IP address>:9443), restart the SIOC service from QoSSIOC Service Management.
    16. Wait for one minute and check the NetApp Element Configuration > mNode Settings tab. This should display the mNode Status as UP.
      If status is DOWN, check the permissions for /sf/packages/sioc/app.properties. The correct permission is as follows: -rwx------
  9. If you have SolidFire Active IQ as part of your installation, follow these steps:
    1. SSH in to the management node and go to the /sf/packages/collector directory.
    2. Run the following command:
      sudo ./manage-collector.py --set-username netapp --set-password --set-mvip <MVIP>
    3. Enter the management node UI password when prompted.
    4. Run the following commands:
      ./manage-collector.py --get-all
        sudo systemctl restart sfcollector
    5. Verify sfcollector logs to confirm the collector is working.
  10. From vSphere, select NetApp Element Configuration > mNode Settings and confirm that the management node is reporting as UP.
  11. If everything is working as expected, shut down the management node you are replacing and delete the VM.