Welcome
Administrator Guide
This guide describes how to install the HCL DevOps Test Hub (Test Hub) software.
Migration of user data
You can find information about the migration limitations and methods when you want to migrate data such as projects, test resources, configuration details of integrated applications, and so on. You can migrate data that is generated in an earlier version of HCL DevOps Test Hub (Test Hub) after you upgrade to or install the latest version, and then use that data in the latest version.
Migrating user data on Red Hat OpenShift
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.

Release Notes
This document includes information about the new features introduced, features deprecated or removed, defects fixed, and known issues identified in this version of HCL DevOps Test Hub (Test Hub). You can also find the installation and upgrade instructions along with the contact information of HCL Customer Support.
System Requirements
This document includes information about hardware and software requirements for HCL DevOps Test Hub (Test Hub).
Getting Started Guide
This guide provides an introduction to HCL DevOps Test Hub (Test Hub) covering key features, task flows, and setup instructions. You can get started with installation, integration, user access management, and core functionalities like test data creation, test asset management, and reporting. This guide is intended for new users.
Administrator Guide
This guide describes how to install the HCL DevOps Test Hub (Test Hub) software.
- Installation of DevOps Test Hub
  To get started working with HCL DevOps Test Hub (Test Hub), you must first install Test Hub.
- DevOps Test Hub upgrade methods
  When you want to use the enhanced functionalities of HCL DevOps Test Hub (Test Hub), you must upgrade Test Hub to the latest version.
- Migration of user data
  You can find information about the migration limitations and methods when you want to migrate data such as projects, test resources, configuration details of integrated applications, and so on. You can migrate data that is generated in an earlier version of HCL DevOps Test Hub (Test Hub) after you upgrade to or install the latest version, and then use that data in the latest version.
  - Migrating user data on Red Hat OpenShift
    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.
  - 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.
  - Migrating user data on Ubuntu from 10.1.3 or later
    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..
- Backup and restoration of the DevOps Test Hub data
  You must back up HCL DevOps Test Hub (Test Hub) data before you uninstall the current version of Test Hub or upgrade to the latest version. You must back up the data to avoid data loss or inaccessibility of data.
- Uninstallation of DevOps Test Hub
  When you no longer require HCL DevOps Test Hub (Test Hub), you can uninstall Test Hub. You can uninstall Test Hub from the platform on which you installed Test Hub.
- Configuration of DevOps Test Hub
  You can find information about the tasks that you must perform after you installed HCL DevOps Test Hub (Test Hub) to configure Test Hub.
- Team space administration
  You can find information about team spaces including the initial team space on HCL DevOps Test Hub (Test Hub) along with the tasks that you can perform to administer a team space.
- Management of resources
  You can find information about managing resources on HCL DevOps Test Hub (Test Hub) along with the tasks that you can perform to define retention rules and monitor resource usage for test results.
Test Author Guide
This guide describes how to create and edit test assets in HCL DevOps Test Hub (Test Hub), and then publish test assets to the remote Git repository that you have configured in your project. This guide is intended for testers and test managers.
Test Execution Specialist Guide
This guide describes tasks that you must complete before you can configure and run tests in HCL DevOps Test Hub (Test Hub). You can find information about configuring runs for the different test types that are supported. You can also find information about other tasks that you can perform on the Resource Monitoring Service, Virtualization, and Integrations with third-party applications. This guide is intended for testers or test execution specialists.
Test Manager Guide
This guide describes how to manage and track your overall test effort. This guide is intended for test managers.
Troubleshooting
This guide describes how to analyze and resolve some of the common problems that you might encounter while you work with HCL DevOps Test Hub (Test Hub).
All Guides (PDF)
You can find the link to view or download the content of the release notes, system requirements, and persona guides of HCL DevOps Test Hub (Test Hub) as a PDF file.
Security Considerations
This document describes the actions that you can take to ensure that your installation is secure, customize your security settings, and set up user access controls in HCL DevOps Test Hub (Test Hub).
Notices
This document provides information about copyright, trademarks, terms and conditions for the product documentation.

Migrating user data on Red Hat OpenShift

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

You must replace {main} with the name of the release that you provided during the installation of Test Hub in all the instances in this procedure.

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

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 devops-system {{main}}
```
Run the following script from the ibm-rtas-prod/files directory to merge the data into Test Hub:
```
migrate.sh merge-dbs -n devops-system {{main}}
```
Run the following command to remove the resources that were created during the migration process:
```
migrate.sh delete-temp-resources -n devops-system {{main}}
```
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:

Configure licenses for team spaces. See Configuring licenses for team spaces.
Configure Test Hub. See Configuration of DevOps Test Hub.