Welcome
Administering
This guide describes how to install HCL DevOps Velocity (Velocity). After you install Velocity, you can perform administrative tasks such as license configuration, upgrading, migrating, managing access permissions and security. This guide is intended for system administrators.
Installing DevOps Velocity
To get started with HCL DevOps Velocity (Velocity), you must install it on any one of the container platforms. You can find information about the selection of a container platform, installation methods, and procedure for installing Velocity.
Installing on Azure Kubernetes Service
You can find information about tasks that you can perform to install HCL DevOps Velocity (Velocity) on the Azure cloud by using the Azure Kubernetes Service (AKS).
Installation prerequisites
You must complete certain tasks before you install HCL DevOps Velocity (Velocity) on Azure Kubernetes Service (AKS).
Configuring a custom Secure Sockets Layer (SSL) certificate
You can configure an SSL certificate to encrypt your organization's data exchanged between the browser and the HCL DevOps Velocity (Velocity) application.

Release Notes
This document includes information about the new features introduced, defects fixed, and known issues identified in this version of HCL DevOps Velocity (Velocity). You can also find the installation and upgrade instructions along with the contact information of HCL Customer Support.
System Requirements
This document contains information about hardware and software requirements for HCL DevOps Velocity (Velocity).
Getting Started
This document provides an overview of HCL DevOps Velocity (Velocity).
High-Level Overview
Use HCL DevOps Velocity (Velocity) to automate your release lifecycle and manage your DevOps value streams.
Learning
Learn how to complete frequently-used tasks such as creating value streams.
Managing licenses
Configure your license or apply a trial key.
Administering
This guide describes how to install HCL DevOps Velocity (Velocity). After you install Velocity, you can perform administrative tasks such as license configuration, upgrading, migrating, managing access permissions and security. This guide is intended for system administrators.
- Installing DevOps Velocity
  To get started with HCL DevOps Velocity (Velocity), you must install it on any one of the container platforms. You can find information about the selection of a container platform, installation methods, and procedure for installing Velocity.
  - Installation overview
    You can find the information related to installing HCL DevOps Velocity (Velocity) on different container platforms.
  - Installing on Kubernetes
    You can find information about the methods and considerations for installation of HCL DevOps Velocity (Velocity) in a Kubernetes cluster.
  - Installing on OpenShift
    You can find information about the methods and considerations for installation of HCL DevOps Velocity (Velocity) on OpenShift.
  - Installing on Google Kubernetes Engine
    You can find information about tasks that you can perform to install HCL DevOps Velocity (Velocity) on Google Cloud Platform (GCP) by using the Google Kubernetes Engine (GKE) service.
  - Installing on Azure Kubernetes Service
    You can find information about tasks that you can perform to install HCL DevOps Velocity (Velocity) on the Azure cloud by using the Azure Kubernetes Service (AKS).
    - Installation prerequisites
      You must complete certain tasks before you install HCL DevOps Velocity (Velocity) on Azure Kubernetes Service (AKS).
      - Configuring a custom Secure Sockets Layer (SSL) certificate
        You can configure an SSL certificate to encrypt your organization's data exchanged between the browser and the HCL DevOps Velocity (Velocity) application.
      - Downloading the installation file
        Before you install HCL DevOps Velocity (Velocity), download the appropriate installaers for HCL DevOps Velocity (Velocity).
    - Installing DevOps Velocity on Azure Kubernetes Service
      You can install HCL DevOps Velocity (Velocity) by using Azure Kubernetes Service (AKS) on Azure Cloud.
  - Logging in to DevOps Velocity
    You can find the information about logging in to HCL DevOps Velocity (Velocity).
  - Logging in to RabbitMQ management console
    You can find the information about logging in to RabbitMQ management console to monitor queues, exchanges, and message activity.
- Installing DevOps Velocity plugins on air-gapped networks
  HCL DevOps Velocity (Velocity) plugin installations on air-gapped networks.
- Uninstalling DevOps Velocity
  You can uninstall HCL DevOps Velocity (Velocity) by stopping the server and removing the product containers.
- Configuring trusted certificates in DevOps Velocity
  The default configuration in Velocity accepts connections with self-signed CA certificates. You can configure Velocity to restrict self-signed CA certificates and allow only a predefined set of trusted CA certificates.
- Upgrading DevOps Velocity
  You can find information about upgrading of HCL DevOps Velocity (Velocity).
- Migrating DevOps Velocity
  You can find information about migration of HCL DevOps Velocity (Velocity) to another container orchestration.
- Configuring DevOps Velocity
  A default HCL DevOps Velocity (Velocity) administrator ID is included as part of Velocity. It is used to install and complete initial configuration tasks.
- DevOps Velocity MCP server
  A Model Context Protocol (MCP) server provides a structured way for GenAI clients to access tools, data, and actions through a consistent, secure interface. When you connect a GenAI client that supports MCP to the HCL DevOps Velocity (Velocity) MCP server, you can use natural-language requests to retrieve information from your Velocity.
Managing Value Streams
A value stream represents the objects and activities that you employ to deliver customer value, from initial concept to final delivered project.
Developing Data Insights
The Insights feature provides DevOps metrics for your project data.
Analytics Dashboards
Analytics creates team-specific dashboards that generate charts for each activity of the product development. HCL DevOps Velocity (Velocity) creates dashboards automatically while you create a team.
Releasing Software
A release is a repeatable plan that is used to drive deployments.
Extending Product Functions
Learn how to extend the function of HCL DevOps Velocity (Velocity)
How to
The topics in this section describe how to work with HCL DevOps Velocity (Velocity) features. Tutorials and workbooks are available for users of all experience levels.
Troubleshooting
Before you contacting support, gather background information and perform tasks that will assist in solving the problem. It helps to be as specific as possible and include all relevant information.
Notices for DevOps Velocity
This document provides information about copyright, trademarks, terms and conditions for the product documentation.
DevOps Velocity GDPR statement
General Data Protection Regulation (GDPR) has been adopted by the European Union (EU) and applies from May 25, 2018.
Glossary

Configuring a custom Secure Sockets Layer (SSL) certificate

You can configure an SSL certificate to encrypt your organization's data exchanged between the browser and the HCL DevOps Velocity (Velocity) application.

Before you begin

You must have performed the following tasks:

Created a Kubernetes cluster, configured Azure CLI, added a node pool and created a namespace on the Kubernetes cluster. See Installation prerequisites.
Created an SSL certificate and got the key.pem and certificate.crt file.

About this task

The Helm install will automatically create a self-signed certificate, and it is stored in a default TLS secret with the name accelerate-tls to match the ingress domain. You can update the self-signed certificate with a custom SSL certificate if you have an SSL certificate from a trusted Certifying Authority (CA). To update a custom SSL certificate, create a Kubernetes secret by following the steps in this task. Then, during the Helm installation, specify the secret name using the tls.secret parameter in the helm install command.

Procedure

Perform the following steps to install the Helm chart on the machine where you have generated the Helm chart and configured the Azure CLI:
1. Sign in to Azure.
  Run the following command:
```
az login
```
2. Set the Azure subscription that contains the Azure Kubernetes Service (AKS) cluster.
  Run the following command:
```
az account set --subscription <subscription_name_or_id>
```
3. Configure kubectl to access the AKS cluster.
  Run the following command:
```
az aks get-credentials \
--resource-group <resource_group_name> \
--name <aks_cluster_name>
                            
```
4. Optional: Verify that you are connected to the AKS cluster.
  Run the following commands:
```
kubectl config current-context
kubectl get nodes
```
Navigate to the directory where you have the key.pem and certificate.crt files of your SSL certificate.

Note:
If you do not have an SSL certificate must create an SSL certificate.
Run the following command:
kubectl create -n <custom_namespace_name> secret tls velocity-custom-tls --key <key.pem> --cert <certificate.crt>

The following message is displayed: secret/velocity-custom-tls created.