Skip to main content
ONTAP tools for VMware vSphere 10

Upgrade from ONTAP tools for VMware vSphere 10.x to 10.5

Contributors netapp-jani jani
PDFs

You can upgrade from ONTAP tools for VMware vSphere 10.3 or 10.4 to 10.5. However, to upgrade from ONTAP tools 10.0, 10.1, or 10.2 to 10.5, you must first upgrade to 10.3 or 10.4 before proceeding to 10.5.

Note

  • For ASA r2 systems, make sure you upgrade to ONTAP tools for VMware vSphere to 10.5 and ONTAP to 9.16.1, before setting up more storage availability zones (SAZs).

  • If the upgrade from ONTAP tools for VMware vSphere 10.3 or 10.4 to 10.5 fails, you cannot roll back. Use low RPO or snapshot recovery to restore the setup. For ONTAP tools for VMware vSphere 10.2 and earlier, use zero-RPO to restore the setup.
Before you begin

  • Ensure that all nodes are active.

  • Ensure the ONTAP system certificate and onboarded vCenter certificates are valid for at least 5 days. If the certificates expire sooner, the upgrade fails.

  • Ensure you have a fifth disk with a capacity of 100 GB on all nodes.

  • Verify that the node configuration matches the specifications in the table below.

Deployment Type CPU(Core) per node Memory(GB) per node Disk Space(GB) per node Total CPU(Core) Memory(GB) Total Disk Space(GB)

Non-HA Small

9

18

350

9

18

350

Non-HA Medium

13

26

350

13

26

350

HA Small

9

18

350

27

54

1050

HA Medium

13

26

350

39

78

1050

HA Large

17

34

350

51

102

1050

  • Ensure hot plug-in for CPU and RAM is enabled.

  • Enable low RPO backup and ensure one backup is visible in vCenter Client interface. Download the backup folder before upgrade.

  • Low RPO backup is recommended. However, in non-HA deployment, you can take a quiesced snapshot of the ONTAP tools virtual machine before upgrading.

    Refer to Edit Backup settings and Recover the ONTAP tools setup for more information about backup and recovery.

Steps

  1. Upload ONTAP tools for VMware vSphere upgrade ISO to content library.

  2. In the primary VM page, select Actions > Edit Settings. To identify the primary VM name:

    1. Enable diag shell on any node

    2. Run the following command: grep sourceHost /opt/netapp/meta/ansible_vars.yaml

  3. Select the content library ISO file in the edit settings window under the CD/DVD drive field.

  4. Select the ISO file, check the Connected box for the CD/DVD drive field, and click OK.

  5. From the vCenter Server, open a console to ONTAP tools.

  6. Log in as the maintenance user.

  7. Enter 2 to select the System Configuration menu.

  8. Enter 7 to select the Upgrade option.

  9. Provide the vCenter credentials, when prompted. This is the vCenter instance where the ONTAP tools is hosted.

    If you are using ONTAP tools in a two-vCenter Server topology—where the appliance is hosted in one vCenter instance and manages another—you can assign a restricted role for the vCenter instance hosting the ONTAP tools. You can create a dedicated vCenter user and role with only below listed datastore permissions:

    • Allocate space

    • Browse datastore

    • Low-level file operations

    • Remove file

    • Update virtual machine files

    • Update virtual machine metadata

      For the vCenter instance that will be managed by ONTAP tools, make sure the vCenter user account has administrator privileges.

      During the upgrade, if any onboarded storage backend certificates are missing Subject Alternative Name (SAN) entries, you will receive a prompt indicating the missing SAN. If you choose to proceed without validating the SAN, the upgrade will continue, but this is not recommended because of potential security risks.

  10. When you upgrade, the following actions are performed automatically:

    1. The gateway certificate is renewed with a 1-year validity period. When you remove the previous SRA adapter and upload the new 10.5 adapter, the SRA certificate validity changes from 10 years to 1 year.

    2. Remote plug-in is upgraded

    3. ONTAP and vCenter Server certificates are validated and added to ONTAP tools

    4. Backup is enabled

What's next

After upgrading to ONTAP tools for VMware vSphere 10.5:

  • Monitor system alerts and plan to renew the gateway certificate before it expires in one year.

  • Remove the ONTAP tools 10.4 or 10.3 SRA adapter and upload the 10.5 SRA adapter tar file.

  • Run the install command after uploading SRA adapter tar. the Then, rescan the SRA adapters to update the VMware Site Recovery Storage Replication Adapters page.

After upgrading you can:

  • Disable the services from the manager user interface

  • Move from a non-HA setup to an HA setup

  • Scale up a non-HA small configuration to a non-HA medium, or to an HA medium or large configuration.

Related information

Migrate from ONTAP tools for VMware vSphere 9.xx to 10.5