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 Test Hub, you can migrate those user data.

Before you begin

You must have upgraded Test Hub 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
{main}

The name of the release that you provided during the installation of Test Hub.
{backup-release}

The Helm release name of Test Hub where you store the backup data.
{target-release}

The Helm release name of Test Hub where you want to restore the data.
Remember: The devops-system is the name of the namespace that you created during the installation of Test Hub. If you created a namespace by using a different value, then you must use that value in place of devops-system in all the instances in this procedure.

Procedure

  1. Run the following script from the hcl-onetest-server/files directory to create a directory that contains metadata related to the Persistent Volume Claims and their Persistent Volumes: 
    migrate.sh create-pvcs -n devops-system {{main}}
  2. Run the following script from the hcl-onetest-base 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 Test Hub: 
    k3s-killall.sh
  4. Run the following script from the hcl-onetest-base 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 Test Hub: 
    sudo systemctl start k3s
  6. Run the following script from the hcl-onetest-server/files directory to merge the data into the server: 
    migrate.sh merge-dbs -n devops-system {{main}}
  7. Run the following command to remove the resources that were created during the migration process: 
    migrate.sh delete-temp-resources -n devops-system {{main}}
  8. Run the following script from the hcl-devops/files directory to verify and test the installed instance: 
    hcl-devops/files/helm-test-diag.sh {main} -n devops-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: