Migrating user data on Ubuntu from 10.1.2 or earlier

When you want to use the data, which was in your earlier version, in a new version of IBM® Rational® Test Automation Server, you can migrate those user data.

Before you begin

You must have upgraded Rational® Test Automation Server to a new version.

About this task

The following table lists the variables that you must replace with the actual value in the command.

Variables Description
{my-rtas}

The name of the release that you provided during the installation of the server software.

{backup-release}

The Helm release name of the server where you store the backup data.

{target-release}

The Helm release name of the server where you want to restore the data.

{backup-file-name}

The name of the backed-up file that you saved.

Remember: The test-system is the name of the namespace that you created during the installation of the server software. If you created a namespace by using a different value, then you must use that value in place of test-system in all the instances in this procedure.

Procedure

  1. Run the following script from the ibm-rtas-prod/files directory to create a directory that contains metadata related to the Persistent Volume Claims and their Persistent Volumes:
    migrate.sh create-pvcs -n test-system {my-rtas}
  2. Run the following script from the ibm-rtas-case/inventory/ibmRtasBase/files directory to back up the data:
    sudo backup.sh create-pvc-links -v ~/migration-pvc-links
  3. Run the following command to stop the cluster and Rational® Test Automation Server:
    k3s-killall.sh
  4. Run the following script from the ibm-rtas-case/inventory/ibmRtasBase/files directory to restore the backed-up data:
    sudo backup.sh restore -v ~/migration-pvc-links --release {backup-release}:{target-release} {backup-file-name}
  5. Run the following command to restart Kubernetes and to start Rational® Test Automation Server:
    sudo systemctl start k3s
  6. Run the following script from the ibm-rtas-prod/files directory to merge the data into the server:
    migrate.sh merge-dbs -n test-system {my-rtas}
  7. Run the following command to remove the resources that were created during the migration process:
    migrate.sh delete-temp-resources -n test-system {my-rtas}
  8. Run the following script from the ibm-rtas-prod/files directory to verify and test the installed server software:
    ibm-rtas-prod/files/helm-test-diag.sh {my-rtas} -n test-system

Results

You have migrated the user data from the earlier version to the new version.

What to do next

You can perform the following tasks: