{"id":1590,"date":"2022-05-16T17:36:22","date_gmt":"2022-05-17T01:36:22","guid":{"rendered":"https:\/\/jetstreamsoft.com\/portal\/?post_type=ht_kb&p=1590"},"modified":"2025-07-17T12:15:06","modified_gmt":"2025-07-17T20:15:06","slug":"upgrading-jetstream-dr-software","status":"publish","type":"ht_kb","link":"https:\/\/jetstreamsoft.com\/portal\/jetstream-knowledge-base\/upgrading-jetstream-dr-software\/","title":{"rendered":"Upgrade JetStream DR Software (On-Premises)"},"content":{"rendered":"\n

This document describes the procedure for upgrading an on-premises installation of JetStream DR <\/em>software.<\/p>\n\n\n\n

For additional details refer to the JetStream DR Admin Guide<\/a>.<\/p>\n\n\n\n

Introduction<\/h2>\n\n\n\n

The software upgrade process can involve updating the MSA<\/a>, Plugin<\/a>, DRVA<\/a>, RocVA, RVM<\/a>, 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.<\/span><\/p>\n\n\n\n

<\/p>\n\n\n\n

R<\/strong><\/em>ollback to a previous version of JetStream DR is not supported.<\/strong><\/em>
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.<\/p>\n\n\n\n

<\/p>\n\n\n\n

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.<\/p>\n\n\n\n

Prerequisites<\/h2>\n\n\n\n

The following prerequisite conditions must be met before attempting to upgrade JetStream DR software:<\/p>\n\n\n\n

    \n
  • Select a time window to perform the upgrade when the system is less loaded.<\/li>\n\n\n\n
  • Verify and confirm the integrity of all JetStream DR components, ensuring they are operational and error-free.<\/li>\n\n\n\n
  • Before proceeding, check and resolve any previously unsuccessful update tasks.<\/li>\n\n\n\n
  • From the MSA console, execute the clean-up operation using the command js_upgrade.py clean -v<\/kbd><\/strong> before initiating a new upgrade.<\/li>\n\n\n\n
  • Validate and ensure all ESXi host IO Filter storage\/VASA providers are online: vCenter > Configure > Storage Providers<\/strong>.<\/li>\n\n\n\n
  • Ensure there are no active Affinity rules (ESXi) that could affect the host’s ability to enter maintenance mode.<\/li>\n\n\n\n
  • Ensure all ESXi hosts are in a healthy state.<\/li>\n\n\n\n
  • Temporarily suspend any scheduled backups (snapshot-dependent) during the DRVA upgrade activity to prevent backup failures (snapshots taken during this time will fail).<\/li>\n<\/ul>\n\n\n\n

    Upgrade Steps<\/h2>\n\n\n\n

    Perform the following steps to upgrade an on-premises version of JetStream DR software.<\/p>\n\n\n\n

    Upgrade Bundle<\/h3>\n\n\n\n
      \n
    1. Download the latest GA bundle from your account in the JetStream customer portal or provided to you by JetStream Support.<\/li>\n\n\n\n
    2. Transfer the ISO file jetstreamsoft-jetdr-update-x.x.xxx.iso<\/strong><\/code> to the datastore where the MSA VM is located.<\/li>\n\n\n\n
    3. Ensure the file is error-free by performing checksum validation: certutil -hashfile <Path to the ISO file downloaded> SHA256<\/strong><\/kbd>\n
        \n
      • (Compare the cipher to the SHA256 key provided with the bundle.)<\/li>\n<\/ul>\n<\/li>\n\n\n\n
      • In vCenter:\n
          \n
        • Right-click the MSA-VM<\/strong> then navigate to: Edit Settings > CD\/DVD drive > Datastore ISO File<\/strong>.<\/li>\n\n\n\n
        • Expand the CD\/DVD drive<\/strong> menu then browse to and select the uploaded ISO file (see above).<\/li>\n\n\n\n
        • Select the Connected<\/strong> check box.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n
          \"\"
          Connect drive using ISO file.<\/em><\/figcaption><\/figure>\n\n\n\n
            \n
          1. Log into the MSA through the console and execute the following commands. Each should run then exit without any errors:\n
              \n
            • js_upgrade.py check -v<\/strong><\/kbd><\/li>\n\n\n\n
            • js_upgrade.py upgrade -v<\/strong><\/kbd><\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n

              Plugin Upgrade<\/h3>\n\n\n\n
                \n
              1. Log in to the management server (MSA) and a new plugin option should appear:
                \u201dNew plugin available. To upgrade plugin on vCenter server Click here<\/u>\u201d<\/em><\/li>\n\n\n\n
              2. Click the hyperlink to upgrade the plugin.<\/li>\n<\/ol>\n\n\n\n
                \"\"
                Plugin upgrade available.<\/em><\/figcaption><\/figure>\n\n\n\n
                  \n
                1. Click the Confirm <\/strong>button to continue.<\/li>\n<\/ol>\n\n\n\n
                  \"\"
                  Confirm plugin upgrade.<\/em><\/figcaption><\/figure>\n\n\n\n
                    \n
                  1. A message will appear announcing the new plugin has been deployed.<\/li>\n\n\n\n
                  2. Refresh the browser to launch the upgraded plugin.<\/li>\n<\/ol>\n\n\n\n
                    \"\"
                    Plugin upgraded \u2013 refresh the browser.<\/em><\/figcaption><\/figure>\n\n\n\n

                    DRVA Upgrade<\/h3>\n\n\n\n
                      \n
                    1. Navigate to: Datacenter > Configure > Jetstream DR > Appliances<\/strong>.\n
                        \n
                      • Under the DRVAs<\/em> tab select all DRVA(s) with a new software version available.\n
                          \n
                        • Affected DRVAs are indicated with a yellow icon and a \u201cNew Version Available\u201d message appears when hovered over by the cursor.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                        • Click the Upgrade<\/strong> button.<\/li>\n<\/ol>\n\n\n\n
                          \"\"
                          DRVA upgrade is available.<\/em><\/figcaption><\/figure>\n\n\n\n
                            \n
                          1. Click the Confirm <\/strong>button to continue, then wait for the upgrade to complete.<\/li>\n<\/ol>\n\n\n\n
                            \"\"
                            Confirm the DRVA upgrade.<\/em><\/figcaption><\/figure>\n\n\n\n
                              \n
                            1. After the upgrade has completed, confirm the status of the DRVA and replication log are operational (\u201cgreen\u201d status).<\/li>\n<\/ol>\n\n\n\n
                              \"\"
                              DRVA and Replication Log Volume are operational.<\/em><\/figcaption><\/figure>\n\n\n\n

                              RocVA Upgrade<\/h3>\n\n\n\n

                              If Continuous Failover (CFO)<\/em> domains are present, RocVA(s) may need to be upgraded.<\/p>\n\n\n\n

                                \n
                              1. Navigate to: Datacenter > Configure > Jetstream DR > Protected Domains (with CFO running)<\/strong>.\n
                                  \n
                                • An info message may appear indicating a new RocVA version is available.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                                • Click the More <\/strong>menu <\/strong>button then select Upgrade RocVA<\/strong><\/em>.<\/li>\n<\/ol>\n\n\n\n
                                  \"\"
                                  Upgrading the RocVA.<\/em><\/figcaption><\/figure>\n\n\n\n
                                    \n
                                  1. Verify the upgrade is successful from the Tasks <\/strong><\/em>screen.<\/li>\n\n\n\n
                                  2. Repeat the above steps to check the status of RocVAs in all CFO domains and upgrade them as necessary.<\/em><\/li>\n<\/ol>\n\n\n\n

                                    RVM Upgrade<\/strong>: After upgrading a RocVA return to the More <\/em>menu of the CFO domain to check if an Upgrade RVM<\/strong><\/em> option becomes available. If so, upgrade the RVM following steps similar to those used to upgrade the RocVA.<\/p>\n\n\n\n

                                    Cluster Upgrade<\/h3>\n\n\n\n
                                      \n
                                    1. Navigate to: Datacenter > Configure > Jetstream DR > Configurations<\/strong>.\n
                                        \n
                                      • Under the Configured Clusters<\/em> section select all cluster(s) with a new software version available.\n
                                          \n
                                        • Affected clusters are indicated with a yellow icon and a \u201cNew Version Available\u201d message appears when hovered over by the cursor.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                                        • Click the Upgrade<\/strong> button.<\/li>\n<\/ol>\n\n\n\n
                                          \"\"
                                          Cluster upgrade available.<\/em><\/figcaption><\/figure>\n\n\n\n
                                            \n
                                          1. Click the Confirm <\/strong>button to continue then wait for the upgrade to complete.\n
                                              \n
                                            • The upgrade process will upgrade the IO Filter of each host by putting them into maintenance mode one at a time.<\/li>\n\n\n\n
                                            • Upgrade progress can be checked from JetStream DR > Task Log<\/strong>.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n
                                              \"\"
                                              Confirm cluster upgrade.<\/em><\/figcaption><\/figure>\n\n\n\n
                                                \n
                                              1. Verify the upgrade is successful by checking the software version number from: Datacenter > Configure > Jetstream DR > Configurations > Configured Clusters<\/strong>.<\/li>\n<\/ol>\n\n\n\n

                                                Upgrade Conclusion<\/h2>\n\n\n\n

                                                Cleanup<\/h3>\n\n\n\n
                                                  \n
                                                • After all components have been upgraded, clean up the upgrade package using the command: js_upgrade.py clean -v<\/strong><\/kbd><\/li>\n\n\n\n
                                                • The command should exit without any errors.<\/li>\n<\/ul>\n\n\n\n

                                                  Confirmation<\/h3>\n\n\n\n

                                                  Confirm success of the upgrade by validating the current software version numbers of the various elements from the JetStream DR UI.<\/p>\n\n\n\n

                                                  The following images depict example data only and should not be used to confirm any actual software installation.<\/em><\/p>\n\n\n\n

                                                    \n
                                                  1. Navigate to: Datacenter > Configure > Jetstream DR > Configurations<\/strong>. \n
                                                      \n
                                                    • Under Site Details<\/strong>: \n
                                                        \n
                                                      • Check the Software Version<\/em><\/li>\n<\/ul>\n<\/li>\n\n\n\n
                                                      • Under Configured Clusters<\/strong>: \n
                                                          \n
                                                        • Check the Status<\/em><\/li>\n\n\n\n
                                                        • Check the Software Version<\/em><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n
                                                          \"\"
                                                          Check the Site and Cluster versions.<\/em><\/figcaption><\/figure>\n\n\n\n
                                                            \n
                                                          1. Navigate to: Datacenter > Configure > Jetstream DR > Appliances<\/strong>.\n
                                                              \n
                                                            • For each DRVA<\/strong>:\n
                                                                \n
                                                              • Check the Status<\/em><\/li>\n\n\n\n
                                                              • Check for any Child Alerts<\/em><\/li>\n\n\n\n
                                                              • Check the Software Version<\/em><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n
                                                                \"\"
                                                                Check the DRVAs.<\/em><\/figcaption><\/figure>\n","protected":false},"excerpt":{"rendered":"

                                                                This document describes the procedure for upgrading an on-premises installation of JetStream DR software. 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 […]<\/p>\n","protected":false},"author":1,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"nf_dc_page":"","footnotes":""},"ht-kb-category":[245],"ht-kb-tag":[222],"class_list":["post-1590","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-how-to","ht_kb_tag-upgrade"],"_links":{"self":[{"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/ht-kb\/1590","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/comments?post=1590"}],"version-history":[{"count":4,"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/ht-kb\/1590\/revisions"}],"predecessor-version":[{"id":6881,"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/ht-kb\/1590\/revisions\/6881"}],"wp:attachment":[{"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/media?parent=1590"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/ht-kb-category?post=1590"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/jetstreamsoft.com\/portal\/wp-json\/wp\/v2\/ht-kb-tag?post=1590"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}