You can perform an in-place upgrade of the management node from 11.0 or 11.1 to version 11.5 without needing to provision a new management node virtual machine.
Before you begin
- Storage nodes are running Element 11.3 or later.
Note: Use the latest HealthTools to upgrade Element software.
- The management node you are intending to upgrade is version 11.0 or 11.1 and uses IPv4 networking. The management node 11.5 does not support IPv6.
Tip: To check the version of your management node, log in to your management node and view the Element version number in the login banner.
Note: For management node 11.0, the VM memory needs to be manually increased to 12GB.
- You have configured an additional network adapter (if required) using the instructions for configuring a storage NIC (eth1) in the management node user guide your product.
Note: Persistent volumes might require an additional network adapter if eth0 is not able to be routed to the SVIP. Configure a new network adapter on the iSCSI storage network to allow the configuration of persistent volumes.
- You have logged in to the management node virtual machine using SSH or console access.
- You have downloaded the management node ISO for NetApp HCI or Element software from the NetApp Support Site to the management node virtual machine.
Note: The name of the ISO is similar to solidfire-fdva-sodium-patch5-11.5.0.xxxx.iso
- You have checked the integrity of the download by running md5sum on the downloaded file and compared the output to what is available on NetApp Support Site for NetApp HCI or Element software, as in the following example:
sudo md5sum -b <path to iso>/solidfire-fdva-sodium-patch5-11.5.0.xxxx.iso
Steps
- 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-sodium-patch5-11.5.0.xxxx.iso /mnt
sudo cp -r /mnt/* /upgrade
- Change to the home directory, and unmount the ISO file from /mnt:
- Delete the ISO to conserve space on the management node:
sudo rm <path to iso>/solidfire-fdva-sodium-patch5-11.5.0.xxxx.iso
- 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.
- On the 11.5 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>
- (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.5 management node:
- 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.
- Browse to the registration utility (https://<ManagementNodeIP>:9443).
- Click the vCenter Plug-in Registration tab.
- Within Manage vCenter Plug-in, select Update Plug-in.
- Update the vCenter address, vCenter administrator user name, and vCenter administrator password.
- Click Update.
- Log in to the vSphere Web Client and verify that the plug-in information has been updated by browsing to .
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:
- NetApp Element Plug-in Version: 4.3.0
- NetApp Element Plug-in Build Number: 233
- Use the mNode API to add assets:
- Using a browser, go to the storage MVIP and log in.
This action causes certificate to be accepted for the next step.
- Using a browser, go to https://<ManagementNodeIP>/mnode.
- Add a vCenter controller asset to the management node known assets for HCI monitoring (NetApp HCI installations only) and Hybrid Cloud Control (HCC):
- Click Authorize and enter your MVIP user name and password credentials. Close the pop-up window.
- Run GET /assets to pull the base asset ID needed to add the vCenter/controller asset.
- Run POST /assets/{ASSET_ID}/controllers to add a controller asset with vCenter credentials.
- 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.
- Click Authorize and enter your MVIP user name and password credentials. Close the pop-up window.
- Run GET /assets to pull the base asset ID needed to add the compute asset.
- Run POST/assets/{asset_id}/compute-nodes to add a compute asset with credentials for the compute asset. The type is ESXi Host.