/
Upgrade JetStream DR (On-Premises)

Upgrade JetStream DR (On-Premises)

Owned by Anthony Lai
Last updated: Jun 04, 2024
6 min read

This document describes the procedure for upgrading an on-premises installation of JetStream DR software.
For additional details refer to the JetStream DR Admin Guide.

Introduction

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 does not necessarily upgrade all the components. To ensure a smooth upgrade experience, adhere to the prerequisites listed below.

Rollback to a previous version of JetStream DR 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.

The time required to complete the upgrade process is affected by various external factors beyond the control of JetStream Software (e.g., enter/exit ESX host maintenance mode); therefore, it is not possible to know how long a software upgrade will take before the operation has begun. Schedule your upgrade calendar accordingly.

Prerequisites

The following prerequisite conditions must be met before attempting to upgrade JetStream DR software:

  • 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.

  • Ensure all ESXi hosts are in a healthy state.

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

Upgrade Steps

Perform the following steps to upgrade an on-premises version of JetStream DR software.

Upgrade Bundle

  1. Download the latest GA bundle from your account in the JetStream customer portal or provided to you by JetStream Support.

  2. Transfer the ISO file jetstreamsoft-jetdr-update-x.x.xxx.iso to the datastore where the MSA VM is located.

  3. Ensure the file is error-free by performing checksum validation: certutil -hashfile <Path to the ISO file downloaded> SHA256

    • (Compare the cipher to the SHA256 key provided with the bundle.)

  4. In vCenter:

    • Right-click the MSA-VM then navigate to: Edit Settings > CD/DVD drive > Datastore ISO File.

    • Expand the CD/DVD drive menu then browse to and select the uploaded ISO file (see above).

    • Select the Connected check box.

Picture1a-20240321-185735.png
Connect drive using ISO file.

  1. Log into the MSA through the console and execute the following commands. Each should run then exit without any errors:

    • js_upgrade.py check -v

    • js_upgrade.py upgrade -v

Plugin Upgrade

  1. Log in to the management server (MSA) and a new plugin option should appear:
    ”New plugin available. To upgrade plugin on vCenter server Click here”

  2. Click the hyperlink to upgrade the plugin.

Picture2-20240321-190557.png
Plugin upgrade available.

  1. Click the Confirm button to continue.

Picture3-20240321-191501.png
Confirm plugin upgrade.

  1. A message will appear announcing the new plugin has been deployed.

  2. Refresh the browser to launch the upgraded plugin.

picture 4(a)-20240321-191307.png
Plugin upgraded – refresh the browser.

DRVA Upgrade

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

    • Under the DRVAs tab select all DRVA(s) with a new software version available.

      • Affected DRVAs are indicated with a yellow icon and a “New Version Available” message appears when hovered over by the cursor.

  2. Click the Upgrade button.

Picture5(c)-20240321-213008.png
DRVA upgrade is available.

  1. Click the Confirm button to continue, then wait for the upgrade to complete.

Picture6-20240322-184757.png
Confirm the DRVA upgrade.

  1. After the upgrade has completed, confirm the status of the DRVA and replication log are operational (“green” status).

Picture7-20240322-184508.png
DRVA and Replication Log Volume are operational.

RocVA Upgrade

If Continuous Failover (CFO) domains are present, RocVA(s) may need to be upgraded.

  1. Navigate to: Datacenter > Configure > Jetstream DR > Protected Domains (with CFO running).

    • An info message may appear indicating a new RocVA version is available.

  2. Click the More menu button then select Upgrade RocVA.

Picture8-20240321-214807.png
Upgrading the RocVA.

  1. Verify the upgrade is successful from the Tasks screen.

  2. Repeat the above steps to check the status of RocVAs in all CFO domains and upgrade them as necessary.

RVM Upgrade: After upgrading a RocVA return to the More menu of the CFO domain to check if an Upgrade RVM option becomes available. If so, upgrade the RVM following steps similar to those used to upgrade the RocVA.

Cluster Upgrade

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

    • Under the Configured Clusters section select all cluster(s) with a new software version available.

      • Affected clusters are indicated with a yellow icon and a “New Version Available” message appears when hovered over by the cursor.

  2. Click the Upgrade button.

Picture9a-20240321-231756.png
Cluster upgrade available.

  1. Click the Confirm button to continue then wait for the upgrade to complete.

    • The upgrade process will upgrade the IO Filter of each host by putting them into maintenance mode one at a time.

    • Upgrade progress can be checked from JetStream DR > Task Log.

Picture10-20240321-232158.png
Confirm cluster upgrade.

  1. Verify the upgrade is successful by checking the software version number from: Datacenter > Configure > Jetstream DR > Configurations > Configured Clusters.

Upgrade Conclusion

Cleanup

  • After all components have been upgraded, clean up the upgrade package using the command: js_upgrade.py clean -v

  • The command should exit without any errors.

Confirmation

Confirm success of the upgrade by validating the current software version numbers of the various elements from the JetStream DR UI.

Note: The following images depict example data only and should not be used to confirm any actual software installation.

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

    • Under Site Details:

      • Check the Software Version

    • Under Configured Clusters:

      • Check the Status

      • Check the Software Version

version-cluster-20240326-012103.png
Check the Site and Cluster versions.

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

    • For each DRVA:

      • Check the Status

      • Check for any Child Alerts

      • Check the Software Version

version-appliances-20240326-163743.png
Check the DRVAs.

 

Related content