# Workflow Installation steps

## Steps cQube\_Workflow Installation:

* Open Terminal
* Navigate to the directory where cQube\_Workflow has been downloaded or cloned

  ```
    cd cQube_Workflow/work_deploy/education_usecase
    git checkout release-3.6
  ```
* Copy the config.yml.template to config.yml

  ```
  cp config.yml.template config.yml
  ```
* Edit using `nano config.yml`
* Enable data sources as true or false in datasource\_config.yml
* Edit using `nano datasource_config.yml`
* If infrastructure and udise is set to true in datasource\_config.yml, follow the below steps to configure infrastructure and udise, Else skip the Configuration.

  **Configuration of infrastructure attributes and UDISE data indices, metrics:**

  * Based on the number of infrastructure attributes required by the state, configure the infrastructure report by filling the required fields in the infrastructure\_master.csv file under cQube\_Workflow/development/datasource/infra/postgres/ directory
  * To edit below mentioned infrastructure details

    ```
    nano infrastructure_master.csv
    ```
  * Based on the configured columns in infrastructure\_master.csv, update the infra\_parameters.txt file with the configured columns under development/datasource/infra/nifi/ directory.

    ```
    nano infra_parameters.txt
    ```

    change the value of **infra\_normalize** under infra\_parameters.txt
  * Save and Close the file
  * Based on the number of UDISE attributes required by the state, configure the udise\_config.csv file by filling the required fields in the udise\_config.csv file under cQube\_Workflow/development/datasource/udise/postgres/ directory
  * To edit below mentioned UDISE details

    ```
    nano udise_config.csv
    ```
  * Save and Close the file
  * For more information to configure the weights & columns for UDISE/infrastructure, please refer operational document.
* Update the diksha parameters(api\_url, token, encryption key, dataset name,channel\_id, org\_id) in the diksha\_parameters.txt file under cQube\_Workflow/development/datasource/diksha/nifi/
* cQube\_Workflow installation process configuring the components in a sequence as mentioned below:
  * Configures Ansible
  * Configures OpenJDK
  * Configures Python, pip and flask
  * Configures PostgreSQL
  * Configures NodeJS
  * Configures Angular and Chart JS
  * Configures Apache NIFI
  * Configures Keycloak
  * Configures Grafana
  * Configures Prometheus and node exporter
* Give the following permission to the install.sh file

  `chmod u+x install.sh`
* Install cQube using the non-root user with sudo privilege
* Configuration filled in config.yml will be validated first. If there is any error during validation, you will be prompted with the appropriate error message and the installation will be aborted. Refer the error message and solve the errors appropriately, then re-run the installation script `sudo ./install.sh`
* Start the installation by running install.sh shell script file as mentioned below:

  ```
  sudo ./install.sh
  ```
* Once installation is completed without any errors, you will be prompted the following message. **CQube installed successfully!!**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cqube.sunbird.org/cqube-v-4.1-beta/workflow-installation-steps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
