HMS Transact Ingestion

1. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\TAFJ\conf\tafj.properties.
2. Set temn.tafj.runtime.use.df.cache to true.
   
3. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\src\main\resources\des-config\des-kafka-t24.properties.
4. Update the following property in the Event Pull Adapter section, for DES to understand from where t24 tables must pull data and post it into Kafka.

   

   The file name mentioned will change based on the company mnemonic.

5. Update the Event Processor section, and add new assembly definition for Holdings Microservice, for DES to understand from the regex pattern which event must be posted into the assembled-event topic.

   

1. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\TAFJ\conf\tafj.properties.
2. Set temn.tafj.runtime.use.df.cache to true.

   

3. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\src\main\resources\des-config\des-eventhub-t24.properties.
4. In the Event Processor block, make the changes as show in below image highlighted in red.

   

5. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\config\eventhub-t24.env.
6. Add the following event hub properties as per your configuration in azure.

   

   #Event Hub Properties

   EVENT_HUB_RESOURCE_GROUP_HOST=transactdessur.servicebus.windows.net
   EVENT_HUB_RESOURCE_GROUP_PORT=9093
   EVENT_HUB_SHARED_ACCESS_KEY=4CX2krSX9MdlTHIAO158ayC8+DJPNQD7cA84uj4S/JA=

   #Since Event hub supports only 10 eventhubs per name space so we are seperate the config-installer seperate Event hub

   EVENT_HUB_CI_RESOURCE_GROUP_HOST=transactdessurschema.servicebus.windows.net
   EVENT_HUB_CI_RESOURCE_GROUP_PORT=9093EVENT_HUB_CI_SHARED_ACCESS_KEY=gHDAsboJCRgPo++/87SGWcDPxeUHJci/3ULS0kIEKKU=

   #Event hub config for demo webapp, since webapp using spring config

   EVENT_HUB_JASS_CONFIG=-DeventHubPassword="Endpoint=sb://transactdessur.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=4CX2krSX9MdlTHIAO158ayC8+DJPNQD7cA84uj4S/JA="EVENT_HUB_DWA_RESOURCE_GROUP_HOST=-Devent.hub.resource.group.host=transactdessur.servicebus.windows.net
   EVENT_HUB_DWA_RESOURCE_GROUP_PORT=-Devent.hub.resource.group.port=9093

   

7. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\src\eventhub-t24.yml
8. Remove the volumes from eventhub-t24.yml and add to kafka.yml as following.

   

9. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\utp\modelbank\configure-des.bat
10. Update :installDesConfig properties as shown in below image highlighted in red.

    

11. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\launch-des.bat
12. Set the env for eventhub as shown in below image highlighted in red.

    

Alternative to start DES:

If launch-des.bat fails to start the DES or if it fails by throwing error try the alternative way:

1. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\des-tool.bat

   

2. From F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\des-tool.bat, open the command prompt and execute the following commands:
   • des-tool.bat build
   • des-tool.bat install
   • ​des-docker.bat build
   • ​des-docker.bat up -d

To check the DES_Configuration:

1. In the SQL window execute the following command:

   select * from F_EB_DES_CONFIG;
   RECID | XMLRECORD
   kafka | <row id='kafka'><c1 m='1'>temn.des.version</c1><c2 m='1'>2019-02-07T13:17:58.113</c2><c1 m='2'>temn.

   Here, it must not be kafka, it must be event hub. If it is, execute the following commands:

   • From F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\des-tool.bat open the command prompt and execute the following command:
     des-tool.bat stage-des-config F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\src\main\resources\des-config\des-eventhub-t24.properties eventhub
2. In the SQL window execute the following command:

   select * from F_EB_DES_CONFIG;
   RECID | XMLRECORD
   kafka | <row id='kafka'><c1 m='1'>temn.des.version</c1><c2 m='1'>2019-02-07T13:17:58.113</c2><c1 m='2'>temn.
   eventhub | <row id='eventhub'><c1 m='1'>temn.des.version</c1><c2 m='1'>2019-02-07T13:17:58.113</c2><c1 m='2'>temn.

   Check whether the DES is created successfully using the following commands:

   • docker ps -a

     

   • docker logs –f src_event-processor_1

     Here you could see the eventhub connecting to the created transactdessur.servicebus.windows.net:9093.

     

Ensure that you configure the EventHub Creation for Transact ingestion in HMS Configuration. For more information, refer to HMS Transact Kinesis Creation.

1. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\TAFJ\conf\tafj.properties.
2. Set temn.tafj.runtime.use.df.cache to true.

   

3. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\src\main\resources\des-config\des-kinesis-t24.properties.
4. In the Event Processor block, make the changes as shown below highlighted in red:

   

5. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\config\kinesis-t24.env.

• Add the following Kinesis properties as per your configuration in AWS

  AWS_REGION=eu-west-2

  AWS_ACCESS_KEY_ID=AKIAJ2OHEFOWXOZGBMOA

  AWS_SECRET_ACCESS_KEY=PxkgTRaPxrKgcXUy72befXiCXh1xeqFDfSKaKdPX

  

6. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\utp\modelbank\configure-des.bat
7. Change line 50 as shown in figure

   

8. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\launch-des.bat
9. Update the following in :installDesConfig

   

Alternative to start DES:

If launch-des.bat fails to start the DES or if it fails by throwing error try the alternative way:

1. Navigate to F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\des-tool.bat

   

2. From F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\des-tool.bat open the command prompt and execute the following commands:
   • des-tool.bat build
   • des-tool.bat install
   • ​des-docker.bat build
   • ​des-docker.bat up -d

To check the DES_Configuration:

1. In the SQL window, execute the following command:

   select * from F_EB_DES_CONFIG;
   RECID | XMLRECORD
   kafka | <row id='kafka'><c1 m='1'>temn.des.version</c1><c2 m='1'>2019-02-07T13:17:58.113</c2><c1 m='2'>temn.

   Here, it must not be kafka, it must be kinesis. Then, execute the following commands:

   • From F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\des-tool.bat open the command prompt and execute the following commands:
     des-tool.bat stage-des-config F:\UTP-DEV-RET-2021.03.04-01-1064-saf-retailsuite-developer-s08\Temenos\DES\des-docker\src\main\resources\des-config\des-kinesis-t24.properties kinesis

2. In the SQL window, execute the following command:

   select * from F_EB_DES_CONFIG;
   RECID | XMLRECORD
   kinesis | <row id='kinesis'><c1 m='1'>temn.des.version</c1><c2 m='1'>2019-02-07T13:17:58.113</c2><c1 m='2'>tem>temn.

   Check whether the DES is created successfully using the following commands:

   • docker ps -a

     

   • docker logs –f src_event-processor_1

     Here you can view the aws kinesis connecting to the assembled-event-MSRetail.