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 Shell ButtonActivate 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_.sh" 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 start the upgrade, run the following command:

      DESTINATION_DIRECTORY/upgrade_.sh 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.

  6. To confirm the upgrade, on the Admin & Settings page, check the Version.

What's next