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 OpenShift:

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 OpenShift on your computer. For more information refer to, https://docs.redhat.com/en.
Installed Helm on the OpenShift 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 MongoDB. See Installation of MongoDB.
Note: MongoDB is not bundled with the Velocity installation file. So, you must install MongoDB separately.
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.

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

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

Installation of MongoDB

You can install MongoDB using different methods, depending on your environment and requirements. You should consider installing MongoDB on a standalone virtual machine (VM). This method avoids the complexity of managing Persistent Volume Claims (PVCs) and their reclaim policies in a OpenShift cluster, which typically requires a skilled administrator. Alternatively, if you are installing within the OpenShift cluster, you can deploy MongoDB as a StatefulSet. While this option is supported, the standalone VM setup is the better choice if you want to avoid the added complexity of container orchestration.

Installing MongoDB on a Standalone VM

Download MongoDB: Select the appropriate version of MongoDB for your operating system. For more information, refer to the MongoDB download page page.
Install MongoDB: Follow the installation instructions based on the operating system of your VM, refer to MongoDB installation documentation.
Configure MongoDB: Configure MongoDB.
Note: Configuring MongoDB can include enabling authentication, setting up replication (if needed), and adjusting network settings.
Start MongoDB: Start the MongoDB service. Ensure that it is set to start automatically when the system boots.
Verify Installation: Open the MongoDB shell to verify that the installation is successful and MongoDB is running correctly.

Installing MongoDB on OpenShift cluster (StatefulSet)

If you prefer to deploy MongoDB within an OpenShift cluster, you can use a StatefulSet to ensure persistent storage and stable network identities. The Bitnami MongoDB Helm chart provides a simple and reliable way to deploy MongoDB on OpenShift. Follow these steps to install MongoDB by using the Bitnami chart:

Ensure that Helm is installed on your system. For installation instructions, refer to Helm documentation.

Add the Bitnami Helm Repository:

helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

Install MongoDB:
```
helm install <helm_name> -n <custom_namespace_name> \
--version <helm_chart_version> \
--set persistence.enabled=true \
--set image.repository=bitnamilegacy/mongodb \
--set image.tag=<mongo_image_tag> \
--set auth.rootPassword=<password> \
--set global.compatibility.openshift.adaptSecurityContext=auto \
--set persistence.storageClass=<storage_class_name> \
bitnami/mongodb
```
Update the above command to change the following Helm parameters based on your requirement:
- <helm_name>: Enter any name that you want to give for MongoDB installation.
- <custom_namespace_name>: Enter the name of the Namespace where you want to install MongoDB.
- <helm_chart_version>: Enter the value based on the chart version supported for the version of MongoDB you want to install.
- <mongo_image_tag>: Enter the value based on the version of MongoDB you want to install.
- <password>: Enter the password that you want to set for the root user in MongoDB.
- <storage_class_name>: Enter the storage class name for the persistence volume.
This command installs MongoDB as a StatefulSet with replication enabled.
Access MongoDB: Once the MongoDB pods are running, you can connect to MongoDB either using kubectl or by exposing the MongoDB service to external clients.

For more detailed installation and configuration instructions, refer to the Bitnami documentation.

Considerations

Storage: Ensure that persistent volumes (PVs) are correctly configured for MongoDB in both standalone VM and OpenShift environments to prevent data loss during failures.
Backup: Implement backup strategies to safeguard data in both standalone VM and OpenShift setups.
Security: Enable authentication and configure network access controls to secure MongoDB instances.

OpenShift Cluster (StatefulSet)

Install Helm: Ensure that Helm is installed on your system. For installation instructions, visit the Helm installation guide.

Add the Bitnami Helm Repository:

helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

Install MongoDB:
```
helm install my-mongodb bitnami/mongodb --set replicaSet.enabled=true
```
This command installs MongoDB as a StatefulSet with replication enabled.
Access MongoDB: Once the MongoDB pods are running, you can connect to MongoDB either using kubectl or by exposing the MongoDB service to external clients.

For more detailed installation and configuration instructions, refer to the Bitnami documentation.

Considerations

Storage: Ensure that persistent volumes (PVs) are correctly configured for MongoDB in both standalone VM and OpenShift environments to prevent data loss during failures.
Backup: Implement backup strategies to safeguard data in both standalone VM and OpenShift setups.
Security: Enable authentication and configure network access controls to secure MongoDB instances.

Configuration of custom Secure Sockets Layer (SSL) certificate

Ensure that you have configured a custom SSL certificate for the 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.