Promotion Guide: A step by step approach to deploy and configure services for migrating to new dashboard

Overview

This guide lists out a step by step approach to deploy and configure services for migrating to DSS dashboard.

Pre-requisites

Prior Knowledge of Java/J2EE.
Prior Knowledge of SpringBoot.
Prior Knowledge of PostgresSQL.
Prior Knowledge of ElasticSearch.
Prior Knowledge of REST APIs and related concepts like path parameters, headers, JSON etc.

Configurations and step by step Setup -

iFIX Migration Toolkit -

Deploy the latest build of iFIX Migration toolkit.
Set the following properties to configure iFIX migration toolkit -

# MIGRATION KAFKA TOPIC CONFIGURATIONS
ifix.migration.batch.push.topic=ifix-fiscal-events-migrate-latest
ifix.migration.progress.topic=migration-progress-topic
ifix.migration.batch.size=200

# HOST CONFIGURATIONS
ifix.department.entity.service.host=http://localhost:8034/
ifix.fiscal.event.service.host=http://localhost:8280/

2. iFIX ES Pipeline -

Deploy the latest build of iFIX ES Pipeline.
Set the following properties to configure iFIX ES Pipeline -

# KAFKA TOPIC CONFIGURATIONS
fiscal.event.kafka.push.topic=fiscal-event-request-validated
fiscal.event.es.push.topic=index-fiscal-events
fiscal.events.migration.topic=ifix-fiscal-events-migrate-latest
fiscal.events.kafka.connector.push.topic=fiscal-events-migration-connector
fiscal.event.migration.origin.push.topic=ifix-fiscal-events-migration-origin

# HOST CONFIGURATIONS
ifix.department.entity.service.host=http://localhost:8034/
ifix.department.entity.search.endpoint=ifix-department-entity/departmentEntity/hierarchyLevel/v1/_search
ifix.master.data.service.host=http://localhost:8032/
ifix.master.data.service.search.endpoint=ifix-master-data/chartOfAccount/v1/_search

# COA HEAD NAMES
coa.electricity.head.name=Eelctricity
coa.operations.head.name=O&M
coa.salary.head.name=Salary

*** NOTE: The COA head names for electricity, operations and salary depends on how they have been configured in that particular environment. We have only provided sample values as present on iFIX QA environment.

3. Dashboard Analytics -

Deploy the latest build of dashboard analytics service.
Add the configurations mentioned here to set the dashboard up - DSS Configurations for various charts

4. Persister Service -

Deploy persister service and promote the following persister configuration as we will be commiting migration progress to database -

https://github.com/misdwss/config-mgramseva/blob/master/egov-persister/ifix-migration-progress.yml

5. Indexer Service -

Deploy indexer service and promote the following indexer configuration -

https://github.com/misdwss/config-mgramseva/blob/master/egov-indexer/ifix-fiscal-event-indexer.yml

6. Localization Service -

Deploy latest localization service build and create the following localization entries -

6. DIGIT UI -

The final step is to deploy DIGIT UI.
Steps to setup and deploy UI are mentioned here - Deployment of iFix Digit-UI

7. MDMS Service -

Add the following configurations to your environment specific branch of MDMS repo (for e.g. UAT environment has the following branch for referring to mdms configuration - https://github.com/misdwss/mdms-mgramseva/tree/UAT ) -