Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • UI Configuration

  • Menus Configuration

  • Steps to Configure Keycloak after Installation

  • Adding users to Keycloak

  • Redeployment Steps

The first 2 files are the UI Layer changesĀ  config file and the 3rd configuration file is to make the Metric values changes if required for the user.

...

If user needs to change any of the values inside the UI config file, they need to go to specified location directory as shown below and do the changes

...

The images should have the following dimensions: ( Height * Width )

  • logoURL - 60px * 60px

  • imageURl - 780px * 600px

  • dashboard_header2_image1 - 45px * <Any>

  • dashboard_header2_image2 - 45px * 45px

  • dashboard_header1_image - 32px * 32px

dashboard_header1_title : This key is used to change the title of the cQube application page mentioned on the headerĀ 

...

dashboard_header2_image2 : This key is used to change the image of the cQube application ncert mentioned on the header. Need to upload the image into the specified directory dashboard-ms > src > assets > images

...

title : This key is used to change the title in the login page of the application.

...

imageURL : This key is used to change the side image of the application as shown

...

tagLine : This key is used to change the tag line specified in the login page of the application.

...

logoURL : This key is used to change the logo in the login page of the application.

...

  • Menus Configuration

Menus configuration can be changed in the query-builder microservice. In this file (query-builder > menus.csv) users can change the menus sequence, program name etc. They need to add the required details mentioned in the csv to add a new menu into the UI layer. If they add/change any icon for the menu, they need to upload the icon images into the following directory dashboard-ms > src > assets > images

...

Step 6 : Turn on the Direct Access Grant Enabled and save the changes.

...

  • Adding users to Keycloak

Steps to create an new user

Step 1 : Navigate to Users tab

...

Step 4 : Navigate to the Credentials tab and Enter the required password, turn off the temporary password option and save.

...

Adding Bulk Users to the Key-cloak Realm

Step 1 : Navigate to Partial Import tab in manage section

...

Step 2 : Select import file and upload the json file containing information of users. ( Json File format as shown below)

...

Step 3 : In the dropdown select overwrite if required to overwrite existing users with the same information.

Or select skip if you want to skip them

...

Step 4 : After selecting the dropdown according to the need, click import.

...

Step 5 : Now that the users are imported, will be able to login to the application using the credentials.

  • Redeployment Steps

Redeployment Steps of UI config json file changes

Run the below commands one after the other to redeploy the UI config file changes to take effect in Visualization

...

- sudo docker rm ansible_dashboard_app_1 sudo

- sudo docker dashboard_ms:1

- cd cqube-devops/microservices/dashboard-ms

...

- sudo docker run -d -p 4200:80 --network ansible_cqube_net --name dashboard_app dashboard_ms:1

Redeployment Steps of menus.csv file changes

Run the below commands one after the other to redeploy the menus.csv file changes to take effect in Visualization Sidebar

- sudo docker stop ansible_querybuilder_app_1

- sudo docker rm ansible_querybuilder_app_1

- sudo docker querybuilder_ms:1

- cd cqube-devops/microservices/querybuilder-ms

- sudo git pull

- sudo docker build -t querybuilder_ms:1 .

- sudo docker run -d -p 3002:3002 --network ansible_cqube_net --name querybuilder_app querybuilder_ms:1