Upgrade Mainframe Assessment Tool

This page describes how to upgrade Mainframe Assessment Tool.

Limitations

Mainframe Assessment Tool supports only sequential upgrades. You can upgrade only to the next immediate version and can't skip intermediate versions. For example, to upgrade from version 2.1.0 to 2.3.0, you must first upgrade to 2.2.0 and then upgrade to 2.3.0.

Before you begin

• Use Mainframe Assessment Tool version 2.1.0 or later. Earlier versions don't support upgrades.

• Complete all in-progress assessments before you start the upgrade.

  If you upgrade while an assessment is in progress, Mainframe Assessment Tool won't resume the assessment following the upgrade and the assessment can't be restarted. You must re-upload your application to restart the assessment. However, your previously completed assessments are preserved.

• Confirm that you have superuser privileges on the Mainframe Assessment Tool VM instance to complete the upgrade.

Upgrade Mainframe Assessment Tool

To upgrade Mainframe Assessment Tool, follow these steps:

1. In the Google Cloud console, click Activate Cloud Shell.

   Go to the Google Cloud console

2. To connect to the Mainframe Assessment Tool VM, run the following command:

    gcloud compute ssh VM_NAME 
   --tunnel-through-iap 
   

   Replace VM_NAME with the name of the Mainframe Assessment Tool VM.

3. In the Mainframe Assessment Tool VM's command-line interface, to change your privileges to superuser, run the following command:

      
   sudo  
   su 
   

4. To download the upgrade script, run the following command:

    gcloud storage cp "gs://mainframe-ai-release/mat/ VM_IMAGE_NAME 
   /upgrade" DESTINATION_DIRECTORY 
    
   

   Replace the following:

   • VM_IMAGE_NAME : the name of the VM image that you want to upgrade to. For example, mainframe-assessment-2-2-0 .
   • DESTINATION_DIRECTORY : the directory in your Mainframe Assessment Tool VM where you want to download the upgrade script.

5. To make the script executable, run the following command:

    chmod  
   +x  
    DESTINATION_DIRECTORY 
   /upgrade 
   

   Replace DESTINATION_DIRECTORY with the directory in your Mainframe Assessment Tool VM

6. To start the upgrade, run the following command:

      
    DESTINATION_DIRECTORY 
   /upgrade  
    VERSION 
     
   us-docker.pkg.dev/migrate-modernize-public/mainframe-assessment-prod 
   

   Replace the following:

   • DESTINATION_DIRECTORY : the directory in your Mainframe Assessment Tool VM where you have downloaded the upgrade script.
   • VERSION : the Mainframe Assessment Tool version that you want to upgrade to. The version must be in mainframe-assessment-x-y-z format; example: mainframe-assessment-2-2-0 .

7. To confirm the upgrade, on the Admin & Settingspage, refresh the page and check the Version.

What's next

• Learn how to configure settings for Mainframe Assessment Tool .