Home
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.

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
    HCL DevOps Velocity (Velocity) can be installed on Docker Compose, which is a supported platform for non-production instances of 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.
    - 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).
- 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.
- 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.

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 Kubernetes cluster is set up on the host system and have sufficient cluster-level permission.
Installed Helm on the Kubernetes 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 ingress domain. 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 Kubernetes 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, enter 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, enter 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.