Master Data Service Promotion Doc

Adapter Master Data Service v1.0 And iFIX Master Data Service v2.0

This page provides step-wise details on how to migrate Department, Project and Expenditure from iFix Master Data Service to Adapter Master Data Service.

Steps To Migrate To The Master Data Service

1. Yaml configurations

   • Update "mongo-db-username", "mongo-db-password" and "mongo-db-authenticated-uri" in secrets db config in respective environment secret yaml file (iFix-DevOps/mgramseva-qa-secrets.yaml at mgramseva · misdwss/iFix-DevOps ).

   • Update "mongo-db-name", "mongo-db-host" and "mongo-db-url" in egov-config of configmaps in respective environment yaml file (iFix-DevOps/mgramseva-qa.yaml at mgramseva · misdwss/iFix-DevOps ).

   • Update "adapter-master-data-service" and "ifix-department-entity-service" in egov-service-host in respective environment yaml file (iFix-DevOps/mgramseva-qa.yaml at mgramseva · misdwss/iFix-DevOps ).

2. Create a new DB in the MongoDB instance for these new services.

3. Next, create the same master data again in the new (mgramseva) database using the adapter-master-data-service's /_create APIs.

4. After restoring DB collections, drop the unused collections from the iFIX MongoDB.

   Follow the steps below to drop the unused collections.

   1. Connect to ifix namespace playground pod

      kubectl exec -it <playground-pod> -n ifix -- /bin/bash

   2. Connect to the particular mongo db mongo --host <hostname>:27017 -u <username> -p <password>

   3. Use db

      use <db_name>

   4. Check the above-mentioned collection name using the below commands

      db.getCollectionNames();

   5. If collections are there then drop them off using the below commands

      e.g.

      db.department.drop();

      db.expenditure.drop();

      db.project.drop();

Steps To Use Adapter Master Data Service

Port-forward the Adapter master data service in localhost from a specific environment (like QA/UAT/Prod).

Below is the command to port-forward :

e.g.

kubectl port-forward <pod-name> 8030:8080 -n mgramseva

Steps To Use iFix Master Data Service

We need the access token from keycloak server and pass it as a bearer token while requesting the ifix-master-data-service create APIs.

Technical Docs

Adapter Master Data Service v1.0

IFIX Core Master Data Service v2.0

​All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.