Installing Holdings Microservice in Docker

This section helps you to install the Holdings Microservice in Docker.

Procedure:

1. Create the HOLDINGS_SERVICE_HOME directory
2. Extract the ms-holdings-package-docker-<release>.zip release bundle file into the HOLDINGS_SERVICE_HOME directory.
3. Configure the environment variables available in holdings.yml file as follows.

   Variable Name	Variable Value	Description
   POLICY_CALLBACK_ENABLED	true	Enabling the policy callback mechanism
   PDP_CONFIG	classpath:xacml/holdings-pdp-callback-config.xml	Mapping the pdp-callback configuration file available in classpath
   temn.msf.security.authz.xacml.policyset.id	default,BalanceViewer,StatementsViewer,Payments_Domestic_creator	Policy ID names stored in generic-config database
   temn.config.service.base.path	http://<IP_ADDRESS>:<PORT>/ms-genericconfig-api/api/v1.0.0/	Generic-Config microservice end point base URL
   temn.config.service.resource.path	system/configurationGroups/{groupId}/configuration/{configName}	Generic-Config microservice resource path to get by Config-Name
   temn.entitlement.service.base.path	http://<IP_ADDRESS>:<PORT>/ms-entitlement-api/api/v1.0.0	Entitlement microservice endpoint base URL
   temn.entitlement.service.resource.path	/system/entitlements/resources/users/{userId}	Entitlement microservice resource path
   ms.security.tokencheck.enabled	Y	Setting the flag as 'Y' will enable token based authentication
   EXECUTION_ENVIRONMENT	TEST	Remove this variable so that, actual API will call out

4. To communicate from the holdings microservice to the generic-config and entitlement microservices, configure the extra hosts in the yaml file of holdings microservice.

   extra_hosts:
   "genericconfig-api:<IP_ADDRESS_OF_THE_LOCAL_MACHINE>"
   "entitlement-api:<IP_ADDRESS_OF_THE_LOCAL_MACHINE>"

5. To make the microservice up and running, execute the below command for creating images and docker container for that image,
   • Windows: holdings.bat down --remove-orphans
   • Linux: holdings.sh down --remove-orphans

   

6. To stop and remove the existing container, execute the below command.
   • Windows: holdings.bat down --remove-orphans
   • Linux: holdings.sh down --remove-orphans