VAST Upgrade Checks Script

Purpose

We are ensuring that we’re using the most up-to-date version of the pre-upgrade script so that we know we are applying the latest checks prior to the upgrade. The checks change slightly over time as we find cases that must be addressed. 

Latest Script Version

Latest Version Number: v1.0.18

Latest Version Release Date: Jun 8th, 2023

How to Run the Script

• Locate the CNODE running VMS:

  ##find vms: 
  clush -g cnodes -b 'docker ps -q --filter label=role=vms'
  #example output
  #---------------
  #10.10.128.51
  #---------------

• ssh to the node indicated in the previous step
• Download the script:
  

  wget "https://vastdatasupport.blob.core.windows.net/support-tools/upgrade-checks.py" -O /vast/data/upgrade-checks.py

• Add execute permission:

  ## Add execute permissions
  chmod +x /vast/data/upgrade-checks.py

• Running options:

  • Script Version:

    /vast/data/vms.sh /vast/data/upgrade-checks.py -v 

  • Pre Upgrade:

    /vast/data/vms.sh /vast/data/upgrade-checks.py -s pre
    
    #If you don't want to run this with the FSTRIM operation on the DNODES, add a -t:
    /vast/data/vms.sh /vast/data/upgrade-checks.py -s pre -t

• • For OS Upgrade:

    /vast/data/vms.sh /vast/data/upgrade-checks.py -s pre -o 

• • Post Upgrade:

    /vast/data/vms.sh /vast/data/upgrade-checks.py -s post
    
    #If the cluster does not have internet access, add -n so it won't try to upload the vtasks file:
    /vast/data/vms.sh /vast/data/upgrade-checks.py -s post -n

     

     

  • Extra options -

    • -o/--os-upgrade - pre upgrade checks for upgrade with OS

    • -n/--no-vtask-upload - do not upload the vtasks in the end

    • -x/--no-verify-ssl - whether or not to verify SSL certificates. By default SSL certificates are verified

    • -e/--end-point-url - specific end point URL to use in vtasks upload

    • -t/--skip-dnodes-trim - skip the dnodes TRIM function

      /vast/data/vms.sh /vast/data/upgrade-checks.py --help
      usage: upgrade-checks.py [-h] [-v] -s PRE_POST [-o] [-n] [-x]
                               [-e ENDPOINT_URL]
      
      Pre Upgrade script
      
      optional arguments:
      -h, --help               show this help message and exit
      -v, --version            show program's version number and exit
      -s PRE_POST, --step PRE_POST
                               pre or post
      -o, --os-upgrade         os upgrade
      -n, --no-vtask-upload
                               explictly no upload vms tasks to aws
      -x, --no-verify-ssl      Whether or not to verify SSL certificates. By default
                               SSL certificates are verified
      -e ENDPOINT_URL, --endpoint-url ENDPOINT_URL
                               custom end point url
      -t, --skip-dnodes-trim
                               skip trim on local dnodes ssd

       

Upgrade Checks Script Version History

You can see the version history of the VAST Upgrade Checks Script here.