Installing DevOps Test Hub on Ubuntu

Before you begin

You must have read and been familiar with additional Helm parameters. See Additional Helm parameters.
Completed the tasks provided in the Prerequisites section. See Prerequisites to install DevOps Test Hub on Ubuntu.

About this task

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

Variables	Description
{PASSWORD_SEED}	A value of your choice for the password. Important: This password seed is used to create several default passwords for the server. You must store the password seed securely. When you install Test Hub by using the backup of the user data, you can reuse the password seed. You can use this seed to restore the backed-up files either on the current or later versions of Test Hub.
{HCL_LICENSING_ID}	The ID of the License Server for the initial team space, if you want to set the license for the first time. Important: When you want to upgrade the product from the previous version, you must configure the value of License Server ID from the Team Space License Configuration page when the installation of the server is complete.

Procedure

Log in to the Ubuntu server using an SSH session.

Run the following command:

helm pull --untar oci://hclcr.io/ot/hcl-devops --version 11.0.1
cd hcl-devops

Run the following command to install Test Hub:
Notes:
- You must provide the namespace as the value for $NAMESPACE in the command. You can use devops-system as the value for $NAMESPACE.
  
  You must provide the value for $HELM_NAME in the command. You can use main as the value for $HELM_NAME.
- When the ingress domain is accessible to untrusted parties, then you must set the signup parameter to false in the following command.
```
chmod +x k3s/*.sh

sudo k3s/init.sh -n $NAMESPACE \
  --set-literal passwordSeed=$PASSWORD_SEED \
  --set signup=true \
  --set hclFlexnetURL=https://hclsoftware.compliance.flexnetoperations.com \
  --set hclFlexnetID=$HCL_LICENSING_ID
```
Optional: Run the following command to remove a job that is used to initialize the PostgreSQL database during the installation of Test Hub:
```
kubectl delete job {{main}} -postgresql-init -n devops-system
```
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

On completion of the installation of server software, the output displays the following information on the command-line interface:

Instructions to access Keycloak to manage and authenticate users.
The username can be keycloak and the password can be retrieved by running the following command:
```
kubectl get secret -n devops-system -keycloak-postgresql -o jsonpath="{.data.password}" | base64 --decode; echo 
```
The URL to access the Test Hub UI.

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.

You can migrate the user data if you upgraded Test Hub from the earlier version to a new version.

The migration procedure is different based on the existing version of Test Hub. For more information about migration process, go to the following topics: