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 Kubernetes
You can find information about the methods and considerations for installation of HCL DevOps Velocity (Velocity) in a Kubernetes cluster.
Installation prerequisites
You must complete certain tasks before you install HCL DevOps Velocity (Velocity).
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 Docker Compose
    You can install HCL DevOps Velocity (Velocity) version 5.1.0 and 5.1.1 on Docker Compose, which is a platform for non-production instances. Only the versions 5.1.0 and 5.1.1 are supported for installation on Docker Compose.
  - Installing on Kubernetes
    You can find information about the methods and considerations for installation of HCL DevOps Velocity (Velocity) in a Kubernetes cluster.
    - Installation prerequisites
      You must complete certain tasks before you install HCL DevOps Velocity (Velocity).
      - 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.
    - Installing on Kubernetes by using the online method
      You can use the online method to install HCL DevOps Velocity (Velocity) when you are able to connect to the Internet on your computer. In the online method, the installation files continuously extracts Docker images from the remote repository during installation.
    - Installing on Kubernetes by using the offline method
      You can use the offline method to install HCL DevOps Velocity (Velocity) when you are not able to connect to the Internet on the your computer. In the offline method, the Docker images are bundled with the installation file.
    - Node allocation and Resource limits
      You can find the information on how the different services of HCL DevOps Velocity (Velocity) has to be allocated to different nodes in Kubernetes and how the enforce limits on Argo resources.
  - 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.
  - 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.
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.
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 completed the following tasks:

Ensured that the OpenShift cluster is set up on the host system and have sufficient cluster-level permission.
Installed Helm on the OpenShift cluster. See Installing Helm.
You must have 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 OpenShift route. You can update the self-signed certificate with a custom SSL certificate if you have an SSL certificate by a trusted Certifying Authority (CA). To update a custom SSL certificate you must create a secret in the OpenShift cluster by following the steps in this task and you can provide the name of the new secret that you created for the tls.secret parameter in the helm install command during installation.

Procedure

If you don't have an SSL certificate you can generate an OpenSSL certificate and get the certificate.crt and key.pem files. To create an OpenSSL certificate perform any of the following steps:
- On the Linux operating system, run the following command in command line to create the certificate and key.
```
openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.crt
```
  The certificate.crt and key.pem files will be created in the directory from which you ran the command.
- On the Windows operating system, run the following command in Git to create the certificate and key.
```
openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.crt
```
  Git creates the certificate.crt and key.pem files in Program Files\Git\usr\bin directory.
Navigate to the directory where the certificate.crt and key.pem files are available and 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.