Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The software upgrade process can involve updating the MSA, Plugin, DRVA, RocVA, RVM, and Cluster followed by a post-upgrade clean-up. Every version upgrade need does not necessarily upgrade all these the components. . To ensure a smooth upgrade experience, adhere to the prerequisites listed below.

Note

Rollback to a previous version of JetStream DR version is not supported.
Since JetStream DR is comprised of multiple components (MSA, DRVA, IO Filter, Plugin, etc..) that span the environment, rollback/revert to a prior JetStream DR version after an upgrade is not possible. Furthermore, VMware does not support the rollback of IO filters and plugins.

...

  • Select a time window to perform the upgrade when the system is less loaded.

  • Verify and confirm the integrity of all JetStream DR components, ensuring they are operational and error-free.

  • Before proceeding, check and resolve any previously unsuccessful update tasks.

  • Execute the clean-up operation using the command js_upgrade.py clean -v before initiating a new upgrade.

  • Validate and ensure all ESXi host IO Filter storage/VASA providers are online: vCenter > Configure > Storage Providers.

  • Ensure there are no active Affinity rules (ESXi) that could affect the host's ability to enter maintenance mode.

  • Verify the health of all vSAN objects. Navigate to: vSAN Cluster > Monitor > vSAN Skyline Health - Data - vSAN Object Health.

  • Confirm no resync operations are currently running in the vSAN cluster. Resyncing can affect the maintenance mode process. Monitor ongoing resync activities at: vSAN Cluster > Monitor > Resyncing Objects.

  • Temporarily suspend any scheduled backups (snapshot-dependent) during the DRVA upgrade activity to prevent backup failures (snapshots taken during this time will fail).

Upgrade Procedure

The AVS commandlet cmdlet Update-JetDR is employed used to perform the JetStream DR software version upgrade. This cmdlet manages upgrading JetStream DR components to their latest versions. Additionally, it includes a “resume” option that allows continuation of a previously failed upgrade task.

...

  1. View the list of Packages and select JSDR.Configuration 5.1.2.

...

  1. Select the commandlet cmdlet Update-JetDR.

...

  1. Enter Run command details for the cmdlet then click the Run button:

...

Required information for the Run commandUpdate-JetDR cmdlet:

  • MSA IP: IP of the JetStream MSA.

  • MSA Credentials: Login credentials of the MSA.

  • Datacenter: Exact name of the datacenter where JetStream DR is deployed.

  • Datastore: Name of the datastore where the MSA VM is hosted.

  • MSA VM Name: The exact name of the MSA VM as per the vCenter (not the FQDN)

  1. Once the Run command cmdlet has been initiated, monitor its status under Run execution > Information.
    (Click the Refresh option to update the screen to show its current status.)

...

Warning

NOTE : The AVS Run command may time out after 60 minutes. This is an AVS limitation.
If this happens, the Update-JetDR cmdlet should be re-run with using the Resume option (see below).

...

Note

The Resume option should only be used if a previous attempt to execute the Update-JetDR command has failed.

  • If

the
  • Update-JetDR

commandlet
  • successfully completes, but the MSA upgrade has failed, the cause of the failure must be identified and resolved.

If it is then
    • After resolving the MSA upgrade failure, if becomes necessary to execute the Update-JetDR

command
    • cmdlet again,

the cmdlet
    • it should be run without using the Resume option.


The following screenshot highlights the “Resume” option of the Update-JetDR Run cmdlet:

...

Upgrade Conclusion

...

  • Navigate to: Datacenter > Configure > Jetstream DR > Configurations

    • Under Site Details:

      • Check the Software Version

    • Under Configured Clusters:

      • Check the Status

      • Check the Software Version

...

  • Navigate to: Datacenter > Configure > Jetstream DR > Appliances

    • For each DRVA:

      • Check the Status

      • Check for any Child Alerts

      • Check the Software Version

...

IO Filter Synchronization

...

If the cluster has been upgraded to the latest version but some hosts still report old IO Filter versions, use the

...

Resolve-Clusterissue cmdlet to resolve the discrepancy.

...

How to Check IO Filter Version

  1. Navigate to: Datacenter > Configure > Jetstream DR > Configurations

  2. Note the current software version of the cluster and if it has any warning.

  3. Click the Host Details link to review the details of the individual hosts of the cluster.

...

  1. This example illustrates two hosts that have older Software Versions and should be updated using the Resolve Cluster Issue” Run command Resolve-Clusterissue cmdlet.

...