# ISD Installation {% hint style="info" %} This is an older version of the document. To view the most recent version of the document, click [here](https://docs.opsmx.com/products/opsmx-intelligent-software-delivery-platform/opsmx-isd-installation). {% endhint %} This page describes the steps to install ISD in a Kubernetes Cluster. ### Assumptions 1. Ability to install application on a Kubernetes Cluster 2. Internet access from the Kubernetes node 3. Access to Quay and Docker repositories is available ### Pre-requisites **Hardware requirements:** 1\) You should have access to a Kubernetes cluster with at least **2 nodes**\ 2\) Each node having a minimum of **8 CPU** & **32 GB RAM** **Other Pre-requisites** You should have internet access and should be able to access github.com, docker.io and quay.io. You should have the following tools installed. 1. Choco package manager 2. Curl 3. kubectl-cli 4. kubectl-helm 5. git 6. login to "[www.github.com](http://www.github.com)" **If you are using Windows machine**\ Execute the following command in Powershell (running in administrator mode) ``Set-ExecutionPolicy Bypass -Scope Process -Force; `iex ((New-Object System.Net.WebClient).DownloadString('http://chocolatey.org/install.psl'))`` Execute the following command: * Install 'Curl' using the following command `$choco install curl` * Install 'Kubernetes' using the following command `$choco install kubernetes-cli` * Install 'Helm' using the following command `$choco install kubernetes-helm` * Install 'git' using the following command `$choco install git` **If you are using Linux machine** install-using-native-package-management, following the instructions provided here,\ [`https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/`](https://kubernetes.io/docs/tasks/tools/install-kubectl-linux/#install-using-native-package-management) Install helm using the following command & instructions provided here, \ [`https://helm.sh/docs/intro/install/`](https://helm.sh/docs/intro/install/)and follow the instruction provided below Install 'git' using the following command\ `$choco install git` ### Pre-installation steps 1. Ensure that the kubeconfig file is named as "config" and is copied to .kube folder in your machine 2. You should have the NGINX Ingress Controller already available in the cluster; if not, install the same using the following instructions. 1. `$kubectl create ns ingress-nginx`\ \&#xNAN;*Note: It is the controller for service-to-cloud* 2. `$helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx`\ \&#xNAN;*Note: Use "$helm repo" list to check ingress-nginx is added or not* 3. `$helm repo update` 4. `$helm install ingress-nginx ingress-nginx/ingress-nginx -n ingress-nginx`\ \&#xNAN;*Note: Installs nginx control in our namespace* 5. `$kubectl get svc -n ingress-nginx`\ \&#xNAN;*Note: This command is used to check whether it is installed correctly or not* 3. Check whether 'cert-manager' already installed in the cluster or not by running `$kubectl get pods --namespace cert-manager` 4. If not installed, you the following commands to install the 'cert-manager' 1. `$kubectl create namespace cert-manager` 2. `$helm repo add jetstack https://charts.jetstack.io` 3. `$helm repo update` 4. `$helm install cert-manager jetstack/cert-manager --set installCRDs=true -n cert-manager`\ \&#xNAN;*Note: This command installs cert-manager* ### Installation Steps 1. Create a working directory in your local system \ `$mkdir `\ \&#xNAN;*Note: Create a working directory for your installation* 2. Clone '*standard-gitops-repo*' repository from appropriate branch `$git clone https://github.com/OpsMx/standard-gitops-repo.git -b ` 3. Login to GitHub (github.com) with your own credentials. If you don’t have an account, create an account in github. 1. Create a new private repository \ with just README file. Make sure it is marked private. 2. Rename main branch as master branch. Go to settings/branches to rename the branch. 3. Get a git user token. Save this token to be updated in "*values.yaml*" later.\ \&#xNAN;*Note: If the token contains ‘/’ or ‘\’, please generate another token as these special characters create some issues during installation.* 4. Clone the newly created repo using the following commands `$git clone htts://github.com//* 5. Copy files (config, halyard and default) from standard-gitops-repo to the newly cloned repo directory 1. `$cp -R .\standard-gitops-repo\config .\oes-repo\config`\ \&#xNAN;*Note: Copy config file from standard-gitops-repo* 2. `$cp -R .\standard-gitops-repo\halyard.yaml .\oes-repo\halyard.yaml`\ \&#xNAN;*Note: Copy halyard.yaml from standard-gitops-repo* 3. `$cp -R .\standard-gitops-repo\default .\oes-repo\default`\ \&#xNAN;*Note: Copy config file from standard-gitops-repo* 6. Go to your new git directory and execute the following commands: 1. `$git add -A` 2. `$git commit -m "some message”` 3. `$git push` 7. To copy sample pipelines (go to your working dir and execute the following commands): 1. `$git clone https://github.com/OpsMx/sample-pipelines.git` \ \&#xNAN;*Note: For getting pipelines sync with git* 2. `$cp -R .\sample-pipelines\pipeline-jsonfile\ .\\pipeline-jsonfile\`\ \&#xNAN;*Note: Copy pipeline-jsonfile directory into your git dir* 8. Go to your git directory: 1. `$git add .\pipeline-jsonfile\` 2. `$git commit -m "pipeline promotion files"` 3. `$git push` 9. Get "*values.yaml*" file from the Enterprise Spinnaker repo in the Git (**), from the appropriate branch and *charts/oes* directory and copy to your working directory. 10. Modify "*values.yaml*" 1. Under Image credentials make sure you have the right parameters defined: `imageCredentials:` `registry: https://quay.io/` `username:` `Password:` 2. For spinDeck, spinGate, oesUI and oesGate: change the URLs to be used for accessing the OES/Spinnaker `Eg:` `host: spin.oes.opsmx.net` `host: spin-gate.oes.opsmx.net` `host: oes.oes.opsmx.net` `host: oes-gate-ldap.oes.opsmx.net` 3. Set "OpenLdap" to "true" & "installOpenLdap: true" 4. Go to gitopsHalyard section and make the following changes `repo:` `type: git` `baseUrlHostName: github.com` `organization: your-git-org` `projectName: " " <>` `repository: <>` `dynamicAccRepository: <>` `username: your-git-id` `token: your-git-token <>` 5. At pipeline promotion section, make this change: `pipelinePromotion: <>` `enabled: true` 11. Check if helm chart for opsmx is existing or not\ `$helm repo list` 12. Check if is existing. If existing, don't need to add the helm chart. Otherwise, add using `$helm repo add opsmx https://helmcharts.opsmx.com/` 13. `$helm repo update` 14. `$kubectl create namespace `\ \&#xNAN;*Note: Create a namespace* 15. Go to the directory where "values.yaml" is saved/modified and begin the installation using the following command. Note that this will install with the latest helm version. `$helm install oes39 opsmx/oes -f values.yaml -n --timeout 30m` *Note: "oes39" is the release name, "oes-ns" is the namespace.* \ If you need to use any specific version of helm, use the following command: `$helm install oes39 opsmx/oes -f values.yaml -n oes-ns --timeout 30m --version ` 16. Keep monitoring the pods being created using 1. `$kubectl get po -n `\ \&#xNAN;*Note: -w for looping* 2. `$kubectl get sts -n ` 17. Check whether all the pods are up and running 18. Run the following command to get the URLs `$kubectl get ingress -n ` 19. Send the URLs and the external address to the DNS administrator to be added to the DNS server.