Skip to main content
ONTAP tools for VMware vSphere 10.3

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

Contributors netapp-jani
PDFs

The upgrade is supported for both HA and non-HA deployments. The supported upgrade paths are:

From ONTAP tools for VMware vSphere 10.1 and 10.2 configuration

To ONTAP tools for VMware vSphere 10.3 configuration

Non-HA small

Non-HA and advanced small

Non-HA medium

Non-HA and advanced medium

Advanced small

Non-HA and advanced small

Advanced medium

Non-HA and advanced medium

HA small

HA small

HA medium

HA medium

HA large

HA large
Note Upgrades from ONTAP tools for VMware vSphere 10.1 and 10.2 to 10.3 are supported. Direct upgrades from ONTAP tools 10.0 to 10.3 are not supported.

Before you begin

For a non-HA upgrade, power off the ONTAP tools VM, and for an HA upgrade, power off the first node before making the following changes to the virtual machine (VM) settings.

  • Add an additional 100 GB hard disk to each node, as the service data is stored locally on the VM.

  • Change the CPU and memory for the powered-off VM according to the flavor of your deployment. Enable the hot plugin for CPU and RAM.

    10.3 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

  • Power ON the VM after the changes are done and wait for the services to come to a running state.

  • In case of HA deployment, make the resource changes, enable the hot plugin for CPU and RAM, and add 100 GB hard disks for the second and the third node as well. There is no need to reboot these nodes.

  • If the appliance was deployed as a local path (easy deployment) with ONTAP tools 10.1 or 10.2, you need to take a quiesce snapshot before upgrading.

If you're upgrading from ONTAP tools for VMware vSphere 10.0 to 10.1, you need to complete the following steps before proceeding with the upgrade task:

Enable Diagnostics

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

  2. Log in as the maintenance user.

  3. Enter 4 to select Support and Diagnostics.

  4. Enter 2 to select Enable remote diagnostic access.

  5. Enter y to set the password of your choice.

  6. Log in to the VM IP address from the terminal/putty with the user as 'diag' and the password that was set in the previous step.

Take a backup of MongoDB

Run the following commands to take a backup of MongoDB:

  • kn exec -it ntv-mongodb-0 sh - kn is an alias of kubectl -n ntv-system.

  • Run env | grep MONGODB_ROOT_PASSWORD command inside the pod.

  • Run exit command to come out of the pod.

  • Run kn exec ntv-mongodb-0 --mongodump -u root -p MONGODB_ROOT_PASSWORD --archive=/tmp/mongodb-backup.gz --gzip command to replace the MONGO_ROOT_PASSWORD set from the above command.

  • Run kn cp ntv-mongodb-0:/tmp/mongodb-backup.gz ./mongodb-backup.gz command to copy the mongodb backup created using the above command from the pod to the host.

Take the quaise snapshot of all the volumes

  • Run 'kn get pvc' command and save the command output.

  • Take snapshots of all the volumes one by one using one of the following methods:

    • From CLI, run the command volume snapshot create -vserver <vserver_name> -volume <volume_name> -snapshot <snapshot_name>

    • From the ONTAP system manager user interface, search the volume by its name in the search bar, then open that volume by selecting on the name. Go to snapshot and add the snapshot of that volume.

Take the snapshot of ONTAP tools for VMware vSphere VMs in vCenter (3VMs in case of HA Deployment, 1 VM in case of non-HA deployment)

  • In the vSphere client user interface, select the VM.

  • Go to the snapshots tab and select the Take Snapshot button. Take a quiesced snapshot of the VM. Refer to Take a Snapshot of a Virtual Machine for details.

Before performing the upgrade, delete the completed pods from the log bundle with the prefix “generate-support-bundle-job.” If support bundle generation is in progress, wait for it to complete and then delete the pod.

For any type of upgrade, you need to add an additional 100 GB hard Disk Drive (HDD). To add an HDD, perform the following task.

  1. Select the VM in single node configuration or all three VMs in HA configuration.

  2. Right-click on the VM(s) and select Add New Device > Hard Disk

  3. Add a 100 GB HDD in the New Hard disk field.

  4. Select Apply

After adding the hard disk, update the VM's resources for the respective configurations and restart the primary VM.

A new HDD will be created. Dynamic storage provisioner uses this HDD to generate or replicate the volumes.

Steps

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

  2. In the primary VM page, select Actions > Edit Settings

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

  4. Select the ISO file and select OK. Choose the connected checkbox across the CD/DVD drive field. Edit settings

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

  6. Log in as the maintenance user.

  7. Enter 3 to select the System Configuration menu.

  8. Enter 7 to select the upgrade option.

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

    1. Certificate upgrade

    2. Remote plug-in upgrade

After upgrading to ONTAP tools for VMware vSphere 10.3, 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 a non-HA medium or to a HA medium or large configuration.

  • In case of a non-HA upgrade, reboot the ONTAP tools VM to reflect the changes. In case of an HA upgrade, reboot the first node to reflect the changes on the node.

After you finish

After you upgrade from previous releases of ONTAP tools for VMware vSphere to 10.3, rescan the SRA adapters to verify that the details are updated on the VMware Live Site Recovery Storage Replication Adapters page.

After you upgrade successfully, delete the Trident volumes from ONTAP manually using the following procedure:

Note These steps are not required if the ONTAP tools for VMware vSphere 10.1 or 10.2 was in non-HA small or medium (local path) configurations.

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

  2. Log in as the maintenance user.

  3. Enter 4 to select the Support and Diagnostics menu.

  4. Enter 1 to select the Access diagnostics shell option.

  5. Run the following command

    sudo python3 /home/maint/scripts/ontap_cleanup.py

  6. Enter the ONTAP username and password

This deletes all the Trident volumes in ONTAP used in ONTAP tools for VMware vSphere 10.1/10.2.

Related information

Migrate from ONTAP tools for VMware vSphere 9.x to 10.3