Master Data Service Promotion doc v2.0

Adapter Master Data service v1.0 And iFix Master Data Service v2.0

It migrates Department, Project and Expenditure from iFix Master Data Service to Adapter Master Data Service.

Please find below the steps to master data service.

1. Yaml configurations

   • Please update "mongo-db-username", "mongo-db-password" and "mongo-db-authenticated-uri" in secrets db config in respective environment secret yaml file (https://github.com/misdwss/iFix-DevOps/blob/2aafdf90c2d4e4627d40a3128652a8153483797d/deploy-as-code/helm/environments/mgramseva-qa-secrets.yaml#L8 ).

   • Please update "mongo-db-name", "mongo-db-host" and "mongo-db-url" in egov-config of configmaps in respective environment yaml file (https://github.com/misdwss/iFix-DevOps/blob/2aafdf90c2d4e4627d40a3128652a8153483797d/deploy-as-code/helm/environments/mgramseva-qa.yaml#L121 ).

   • Please update "adapter-master-data-service" and "ifix-department-entity-service" in egov-service-host in respective environment yaml file (https://github.com/misdwss/iFix-DevOps/blob/2aafdf90c2d4e4627d40a3128652a8153483797d/deploy-as-code/helm/environments/mgramseva-qa.yaml#L222 ).

2. Create a new DB in the MongoDB instance for these new services.https://github.com/misdwss/iFix-DevOps/blob/2aafdf90c2d4e4627d40a3128652a8153483797d/deploy-as-code/helm/environments/mgramseva-qa.yaml#L121

3. You would need to create the same master data again in the new (mgramseva)database using the adapter-master-data-service's /_create apis.

4. Please follow the migration steps to migrate the data from ifix core to mGramSeva ifix adapter(MongoDB Migration Doc v2.0 ).

5. After restoring DB collections, we can drop unused collections from ifix MongoDB.

       Please follow the steps below.

   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();

6. Steps to use Adapter Master Data service..

   Please 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

7. Steps to use iFix Master Data Service

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

    

Technical Doc

Adapter Master Data Service v1.0

IFIX Core Master Data Service v2.0