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

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}
```
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
```
Run the following command to stop the cluster and Rational® Test Automation Server:
```
k3s-killall.sh
```
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}
```
Run the following command to restart Kubernetes and to start Rational® Test Automation Server:
```
sudo systemctl start k3s
```
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}
```
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}
```
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:

Configure licenses for team spaces. See Configuring licenses for team spaces.
Configure the server software. See Configuration of the server software.