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 OpenShift
You can find information about the methods and considerations for installation of HCL DevOps Velocity (Velocity) on OpenShift.
Installation prerequisites
You must complete certain tasks before you install HCL DevOps Velocity (Velocity).

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.
  - Installing on OpenShift
    You can find information about the methods and considerations for installation of HCL DevOps Velocity (Velocity) on OpenShift.
    - 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 OpenShift 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 OpenShift by using the offline method
      You can use the online 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 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.

Installation prerequisites

You must complete certain tasks before you install HCL DevOps Velocity (Velocity).

You must have completed the following tasks before you install Velocity on Kubernetes:

Verified that your computer meets the hardware and software requirements. See System Requirements.
Installed Red Hat OpenShift. For more information refer to OpenShift documentation.
Installed Kubernetes on your computer. For more information refer to, Kubernetes documentation.
Installed Helm on the Kubernetes cluster. See Installing Helm.
Configured an OpenShift client instance.
Installed an OpenShift command line interface (CLI) on the client instance.
Obtained access to the PEM-format certificate and private key that you can use to configure OpenShift routes.
Optional: Created a new velocity-image-secret.
Created a project in OpenShift. See Creation of a project.
Installed the mandatory softwares. See Installation of mandatory softwares on Kubernetes cluster.
Configured SSL certificate. See Configuration of custom Secure Sockets Layer (SSL) certificate.

Creation of a project

Ensure that you have created a project in the OpenShift.

Enter the following command in the OpenShift console to create a project:

oc new-project <project_name> --description="<description>" --display-name="<display_name>"

Installation of mandatory softwares on Kubernetes cluster

Ensure that you have installed the following mandatory software:

Installed MongoDB on the Kubernetes cluster. For more information, refer to Bitnami documentation.
Note: MongoDB is not bundled with the installation file, so you must install it separately.
Installed the Ingress controller on the Kubernetes cluster. For more information refer to Bitnami documentation.

Configuration of custom Secure Sockets Layer (SSL) certificate

Ensure that you have configured a custom SSL certificate for the ingress controller external IP address or domain name to secure the data exchanged between browser and the Velocity application. For detailed instructions, see Configuring a custom Secure Sockets Layer (SSL) certificate.