Upgrade all JetStream DR software components using an automated script process.

Overview

The first stage of the upgrade process is updating the MSA and plugin.

    • A new version of the MSA is deployed and all configuration from the current MSA is copied to it.
    • The existing MSA is then powered off to begin the upgrade process. (Note: Replication is not impacted during the upgrade process).
    • After the MSA and plugin upgrades are complete, the existing MSA will be renamed to <MSA_Name>_Backup and the new MSA will be renamed to <MSA_Name>

Next, all remaining components are upgraded. This includes: DRVA, ROCVA, and RVM.

    • If the existing JetStream version is lower than 4.2.2, the upgrade will also update the IO Filter (which requires the hosts to be moved to maintenance mode one at a time).
    • If the existing JetStream version is 4.2.2 or higher, no IO Filter update is involved. 
    • If the upgrade fails at any step after the MSA and plugin have been upgraded, the script can be re-triggered with the command
      -Resume:$true to resume the upgrade process from where it last failed.
    • If the upgrade failed during the MSA or plugin upgrade, the script should be re-triggered from the beginning.

Upgrade Procedure

  1. Deploy the jstools OVA provided by JetStream Software. 
    (Contact your JetStream Software representative for assistance.)

Deploy the OVA.

  1. Specify a name and select a folder to install the target virtual machine.

Specify name and folder.

  1. Verify the installation template details.


Verify installation template.

  1. Complete the remaining required installation details then review.


Provide installation details.

  1. After jstools has been successfully deployed, power on the virtual machine.
  2. ssh to the jstools virtual machine then execute the following commands (adjust parameter values as needed):
    # cd /opt/jetstream/jetdr/script/support
    # pwsh
    # ./upgradeJetDRTo43.ps1 -VCIp <vCenter ip/fqdn> -MSAVMName "old-MSA-name" -MSAIp "old-MSA-ip" -NewMSAVMName "new-MSA-name" -DownloadPath /tmp
    • Script parameters:
      • PARAMETER VCIp: Ip of Vcenter
      • PARAMETER VC_Credential: Vcenter credential of user with administrator privilege
      • PARAMETER MSAVMName: Name of existing MSA
      • PARAMETER MSAIp: IP of existing MSA
      • PARAMETER MSACredential: Credentials of root user of MSA
      • PARAMETER NewMSAVMName: Name of new MSA to be deployed
      • PARAMETER DownloadPath: Absolute path of downloaded JetStream software bundle. Skip if the bundle doesn't already exist and needs to be downloaded
      • PARAMETER Resume: Resume upgrade if it failed during upgrading of any components after upgrading MSA
    • Upgrade logs will be located under: /var/lib/vme2/log
    • During the upgrade, MSA logs from the current existing MSA are copied to the newly deployed MSA. The logs can be checked from a web browser after the upgrade at: <MSA IP>/pkg