Upgrading the management node to version 11.7 from version 11.0 or 11.1

You can perform an in-place upgrade of the management node from 11.0 or 11.1 to version 11.7 without needing to provision a new management node virtual machine.

Before you begin

Procedure

  1. Mount the management node ISO image and copy the contents to the file system using the following commands:
    sudo mkdir -p /upgrade
    sudo mount solidfire-fdva-<Element release>-patchX-XX.X.X.XXXX.iso /mnt
    sudo cp -r /mnt/* /upgrade
  2. Change to the home directory, and unmount the ISO file from /mnt:
    sudo umount /mnt
  3. Delete the ISO to conserve space on the management node:
    sudo rm <path to iso>/solidfire-fdva-<Element release>-patchX-XX.X.X.XXXX.iso
  4. Run one of the following scripts with options to upgrade your management node OS version. Only run the script that is appropriate for your version. Each script retains all necessary configuration files after the upgrade, such as Active IQ collector and proxy settings.
    • On an 11.1 (11.1.0.73) management node, run the following command:
      sudo /sf/rtfi/bin/sfrtfi_inplace file:///upgrade/casper/filesystem.squashfs sf_upgrade=1 sf_keep_paths="/sf/packages/solidfire-sioc-4.2.3.2288 /sf/packages/solidfire-nma-1.4.10/conf /sf/packages/sioc /sf/packages/nma"
    • On an 11.1 (11.1.0.72) management node, run the following command:
      sudo /sf/rtfi/bin/sfrtfi_inplace file:///upgrade/casper/filesystem.squashfs sf_upgrade=1 sf_keep_paths="/sf/packages/solidfire-sioc-4.2.1.2281 /sf/packages/solidfire-nma-1.4.10/conf /sf/packages/sioc /sf/packages/nma"
    • On an 11.0 (11.0.0.781) management node, run the following command:
      sudo /sf/rtfi/bin/sfrtfi_inplace file:///upgrade/casper/filesystem.squashfs sf_upgrade=1 sf_keep_paths="/sf/packages/solidfire-sioc-4.2.0.2253 /sf/packages/solidfire-nma-1.4.8/conf /sf/packages/sioc /sf/packages/nma"
    The management node reboots with a new OS after the upgrade process completes.
  5. On the 11.7 management node, run the upgrade-mnode script to retain previous configuration settings.
    Note: If you are migrating from an 11.0 or 11.1 management node, the script copies the Active IQ collector to the new configuration format.
    • For a single storage cluster managed by an existing management node 11.0 or 11.1 with persistent volumes:
      sudo /sf/packages/mnode/upgrade-mnode -mu <mnode user> -pv <true - persistent volume> -pva <persistent volume account name - storage volume account>
    • For a single storage cluster managed by an existing management node 11.0 or 11.1 with no persistent volumes:
      sudo /sf/packages/mnode/upgrade-mnode -mu <mnode user>
    • For multiple storage clusters managed by an existing management node 11.0 or 11.1 with persistent volumes:
      sudo /sf/packages/mnode/upgrade-mnode -mu <mnode user> -pv <true - persistent volume> -pva <persistent volume account name - storage volume account> -pvm <persistent volumes mvip>
    • For multiple storage clusters managed by an existing management node 11.0 or 11.1 with no persistent volumes (-pvm flag is just to provide one of the cluster's MVIP addresses):
      sudo /sf/packages/mnode/upgrade-mnode -mu <mnode user> -pvm <mvip for persistent volumes>
  6. (For all NetApp HCI installations and SolidFire stand-alone storage installations with NetApp Element Plug-in for vCenter Server) Update the vCenter Plug-in on the 11.7 management node:
    1. Log out of the vSphere Web Client.
      Note: The web client will not recognize updates made during this process to your vCenter Plug-in if you do not log out.
    2. Browse to the registration utility (https://<ManagementNodeIP>:9443).
    3. Click the vCenter Plug-in Registration tab.
    4. Within Manage vCenter Plug-in, select Update Plug-in.
    5. Update the vCenter address, vCenter administrator user name, and vCenter administrator password.
    6. Click Update.
    7. Log in to the vSphere Web Client and verify that the plug-in information has been updated by browsing to Home > NetApp Element Configuration > About.
      Note: Logging into vSphere Web Client after updating registration installs the new plug-in updates and creates a new database.
      You should see the following version details or details of a more recent version:
      • NetApp Element Plug-in Version: 4.3.0
      • NetApp Element Plug-in Build Number: 233
  7. Use the mNode API to add assets:
    1. Using a browser, go to the storage MVIP and log in.
      This action causes certificate to be accepted for the next step.
    2. Using a browser, go to https://<ManagementNodeIP>/mnode.
    3. Add a vCenter controller asset to the management node known assets for HCI monitoring (NetApp HCI installations only) and Hybrid Cloud Control (HCC):
    4. Click Authorize and enter your MVIP user name and password credentials. Close the pop-up window.
    5. Run GET /assets to pull the base asset ID needed to add the vCenter/controller asset.
    6. Run POST /assets/{ASSET_ID}/controllers to add a controller asset with vCenter credentials.
    7. For NetApp HCI or to access cloud services options in HCC, add a compute asset to the management node known assets:
      Attention: You must perform this step or Cloud Services options will not be available from HCC.
    8. Click Authorize and enter your MVIP user name and password credentials. Close the pop-up window.
    9. Run GET /assets to pull the base asset ID needed to add the compute asset.
    10. Run POST/assets/{asset_id}/compute-nodes to add a compute asset with credentials for the compute asset. The type is ESXi Host.