Configuring Holdings Microservice
This section helps you to perform the required configuration in Holdings microservice.
AWS Configuration
|
PROPERTY |
EXISTING VALUE |
TO BE UPDATED AS |
DESCRIPTION |
|---|---|---|---|
|
Stream creation value after this command : aws kinesis create-stream --stream-name |
table-update-holdings |
As configured in T24 DES |
topic for Consuming T24 DES Events. |
|
Stream creation value after this command : aws kinesis create-stream --stream-name |
data-event-holdings |
As configured in T24 DES |
topic for Consuming T24 DES Events. |
|
Stream creation value after this command : aws kinesis create-stream --stream-name |
error-holdings |
any value |
error stream for failed events |
|
Stream creation value after this command : aws kinesis create-stream --stream-name |
context-event |
As configured in Account Aggregation. |
topic for streaming to Arrangement. |
|
Stream creation value after this command : aws kinesis create-stream --stream-name |
externalacc-event |
As configured in Account Aggregation. |
topic for streaming to Account Aggregation. |
|
Stream creation value after this command : aws kinesis create-stream --stream-name |
holdings-event |
As configured in Account Aggregation. |
topic for streaming to Holdings. |
|
Stream creation value after this command : aws kinesis create-stream --stream-name |
notification-event |
As configured in Account Aggregation. |
topic for streaming to Notification MS. |
|
security_authz_enabled |
false |
true or false |
enable/disable the XACML policy authorization |
|
security_tokencheck_enabled |
Y |
Y or N |
enable/disable the JWT token authorization |
|
JWT_TOKEN_ISSUER |
Fabric |
Issue value present in XACML Policy file |
The JWT token issuer to be sent in iss field in JWT token |
|
JWT_TOKEN_PRINCIPAL_CLAIM |
FABRICUSER |
Value should match with JWT token used |
Principal Claim to be sent in sub field in JWT token |
Azure Configuration
|
Property |
Existing Value |
Updated to |
Description |
COMPONENT |
|---|---|---|---|---|
|
RESOURCE_GROUP_NAME |
nas-ssl-sandyyyaccagg |
Env specific resource name can be appended |
Groups all the function app and configuration of deployment |
function app |
|
APP_NAME |
holdingsaccaggapp |
Env specific app name can be appended |
functionapp for ingestor created in azure, if App name is changed, then rename the folder in this path ms-holdings-package-azure-202010.0.0\Holdings-Azure\target\azure-functions |
function app |
|
LOCATION |
northeurope |
location of azure account |
location of azure account |
function app |
|
MONGODB_CONNECTIONSTR |
test connect string |
mongodb connect string deployed on VM/cloud |
mongodb connect string for microservice to connect to database |
function app |
|
EVENT_HUB_NAME_SPACE |
AccAgg-Kafka |
What is defined in Account Aggregation MS |
EventHub for kafka |
function app |
|
EVENT_HUB |
external-holding-event |
As configured inAccount Aggregation MS |
topic name for Ingestion |
function app |
|
REGISTRY_URL |
external-holding-event |
As configured in Account Aggregation MS |
Ingestor creation |
function app |
|
KAFKA_SERVER |
accagg-kafka.servicebus.windows.net:9093 |
As per EVENT_HUB_NAME_SPACE defined in Account Aggregation. |
Kafka server creation |
function app |
|
context-event |
context-event |
As configured in Account Aggregation. |
topic for streaming to Account Aggregation. |
function app |
|
AUTHZ_ENABLED |
false |
true or false |
enable/disable the XACML policy authorization |
function app |
|
ms_security_tokencheck_enabled |
Y |
Y or N |
enable/disable the JWT token authorization |
function app |
|
JWT_TOKEN_ISSUER |
Fabric |
Issue value present in XACML Policy file |
The JWT token issuer to be sent in iss field in JWT token |
function app |
|
JWT_TOKEN_PRINCIPAL_CLAIM |
FABRICUSER |
Value should match with JWT token used |
Principal Claim to be sent in sub field in JWT token |
function app |
|
T24APP_NAME |
holdingst24ingesterapp |
Env specific name can be updated |
functionapp for ingestor created in azure, if App name is changed, then rename the folder in this path ms-holdings-package-azure-202010.0.0\Holdings-Azure\target\azure-functions |
T24 Ingestor function app |
|
REGISTRY_URL |
EB.CONTRACT.BALANCES,STMT.ENTRY,Data |
topic name configured in DES |
Ingestor for T24 Ingestion |
T24 Ingestor function app |
|
EVENT_HUB |
data-event |
topic name configured in DES |
topic name configured in DES |
T24 Ingestor function app |
|
JAR_NAME |
ms-holdings |
MS Name |
MS Name |
T24 Ingestor function app |
|
JAR_VERSION |
DEV.0.0-SNAPSHOT |
Release version of MS |
Release version of MS |
T24 Ingestor function app |
API Configuration
It includes two configurations:
Docker Configuration
Configuration Properties are available in holdings.yml and api is the container used for internal ingestion.
The following are the property configuration required.
|
Property |
Default Value |
Description |
|---|---|---|
|
DATABASE_KEY |
mongodb |
Database key |
|
MONGODB_DBNAME |
ms_holdings |
Database name |
|
MONGODB_CONNECTIONSTR |
mongodb://mongo7:27017,mongo8:27017,mongo9:27017 |
Database Connection String |
|
tem.msf.disableInbox |
"true" |
Enable or disable inbox outbox |
|
temn.msf.security.authz.enabled |
"false" |
Enable or disable xacml validation |
|
PDP_CONFIG |
xacml/holdings-pdp-config.xml |
Path of the xacml config file |
|
temn.msf.pdp.resource.type |
API |
Resource type used in xacml validation |
|
temn.msf.pdp.resource.manager |
HOLDING |
Resource manager used in xacml validation |
|
ms.security.tokencheck.enabled |
N |
Enable or disable token check |
|
temn.entitlement.service.enabled |
"false" |
Enable or disable entitlement service |
|
temn.entitlement.service.base.path |
http://localhost:8095/ms-entitlement-api/api/v1.0.0 |
Base path of entitlement service |
|
temn.entitlement.service.resource.path |
system/entitlements/users/{userId}/roles |
resource path of entitlement service |
|
temn.entitlement.stubbed.service.enabled |
"false" |
Enable or disable stubbed entitlement service |
|
temn.entitlement.service.api.key |
<x-api-key here> |
Api key of the entitlement service |
|
ID_TOKEN_SIGNED |
"false" |
Signed token used for fabric |
|
JWT_TOKEN_ISSUER |
Fabric |
Token issue for fabric |
|
JWT_TOKEN_PRINCIPAL_CLAIM |
FABRICUSER |
Token Principal claim for fabric |
J2EE Configuration
The api.properties used to configure the ingestion. The above files are available in the ms-holdings-api.war\WEB-INF\classes\properties\ path.
The following are the property configuration required (api.properties).
|
Property |
Default Value |
Description |
|---|---|---|
|
DATABASE_KEY |
mongodb |
Database key |
|
MONGODB_DBNAME |
ms_holdings |
Database name |
|
MONGODB_CONNECTIONSTR |
mongodb://mongo7:27017,mongo8:27017,mongo9:27017 |
Database Connection String |
|
tem.msf.disableInbox |
"true" |
Enable or disable inbox outbox |
|
temn.msf.security.authz.enabled |
"false" |
Enable or disable xacml validation |
|
PDP_CONFIG |
xacml/holdings-pdp-config.xml |
Path of the xacml config file |
|
temn.msf.pdp.resource.type |
API |
Resource type used in xacml validation |
|
temn.msf.pdp.resource.manager |
HOLDING |
Resource manager used in xacml validation |
|
ms.security.tokencheck.enabled |
N |
Enable or disable token check |
|
temn.entitlement.service.enabled |
"false" |
Enable or disable entitlement service |
|
temn.entitlement.service.base.path |
http://localhost:8095/ms-entitlement-api/api/v1.0.0 |
Base path of entitlement service |
|
temn.entitlement.service.resource.path |
system/entitlements/users/{userId}/roles |
resource path of entitlement service |
|
temn.entitlement.stubbed.service.enabled |
"false" |
Enable or disable stubbed entitlement service |
|
temn.entitlement.service.api.key |
<x-api-key here> |
Api key of the entitlement service |
|
ID_TOKEN_SIGNED |
"false" |
Signed token used for fabric |
|
JWT_TOKEN_ISSUER |
Fabric |
Token issue for fabric |
|
JWT_TOKEN_PRINCIPAL_CLAIM |
FABRICUSER |
Token Principal claim for fabric |
External Ingestion Configuration
It includes two configurations.
Docker Configuration
Configuration Properties are available in holdings.yml.
Ingester is the container used for internal ingestion
The following are the property configuration required.
|
Property |
Default Value |
Description |
|---|---|---|
|
temn.msf.stream.vendor |
kafka |
data stream vendor name |
|
temn.msf.schema.registry.url |
http://schema-registry:8081 |
url of the schema registry |
|
temn.msf.stream.kafka.bootstrap.servers |
kafka:29092 |
ip and port of kafka bootstrap server |
|
temn.msf.ingest.source.stream |
external-holdings-event |
source stream of the incoming event |
|
temn.msf.ingest.source.stream.consumergroup.id |
msf-holdings-ingester-consumer |
id of the consumer consuming the event |
|
temn.msf.ingest.is.avro.event.ingester |
"false" |
Is the incoming data is multi event |
|
temn.msf.ingest.generic.ingester |
com.temenos.microservice.holdings.ingester.HoldingIngester |
Class name of AMS which is triggered for ingestion |
|
class.inbox.dao |
com.temenos.microservice.framework.core.inbox.InboxDaoImpl |
class names for inboxoutbox feature |
|
class.outbox.dao |
com.temenos.microservice.framework.core.outbox.OutboxDaoImpl |
class names for inboxoutbox feature |
|
temn.msf.security.authz.enabled |
"false" |
enable xacml validation |
|
MONGODB_DBNAME |
ms_holdings |
database name |
|
CASSANDRA_USER |
cassandra |
database username |
|
MONGODB_CONNECTIONSTR |
mongodb://mongo7:27017,mongo8:27017,mongo9:27017 |
database connection url |
|
DATABASE_KEY |
mongodb |
database key |
J2EE Configuration
The dataIngester.properties is used to configure the ingestion.
The above files are available in the ms-holdings-binary-ingester.war\WEB-INF\classes\properties\ path.
The following are the property configuration required (commandIngester.properties).
|
Property |
Default Value |
Description |
|---|---|---|
|
temn.msf.stream.vendor |
kafka |
data stream vendor name |
|
temn.msf.schema.registry.url |
http://10.94.2.34:8081 |
url of the schema registry |
|
temn.msf.stream.kafka.bootstrap.servers |
10.94.2.34:29092 |
ip and port of kafka bootstrap server |
|
temn.msf.ingest.source.stream |
external-holdings-event |
source stream of the incoming event |
|
temn.msf.ingest.source.stream.consumergroup.id |
msf-holdings-ingester-consumer |
id of the consumer consuming the event |
|
temn.msf.ingest.sink.error.stream |
error-holdings |
error topic name |
|
temn.msf.ingest.sink.error.enabled |
true |
property to enable writing data into error topic |
|
temn.msf.ingest.generic.ingester |
com.temenos.microservice.holdings.ingester.HoldingIngester |
Framework class file used for multi event ingestion |
|
temn.msf.ingest.is.avro.event.ingester |
false |
Is the incoming data is multi event |
|
class.inbox.dao |
com.temenos.microservice.framework.core.inbox.InboxDaoImpl |
class names for inboxoutbox feature |
|
class.outbox.dao |
com.temenos.microservice.framework.core.outbox.OutboxDaoImpl |
class names for inboxoutbox feature |
|
context-event |
context-event |
Topic name for account aggregation response |
|
DATABASE_KEY |
mongodb |
Database key |
|
MONGODB_DBNAME |
ms_holdings |
Database name |
|
MONGODB_CONNECTIONSTR |
mongodb://mongo1:27017,mongo2:27018,mongo3:27019 |
Database Connection string |
Internal Ingestion Configuration
It includes two configurations.
Docker Configuration
Configuration Properties are available in holdings.yml. IngesterT24 is the container used for internal ingestion.
The following are the property configuration required.
|
Property |
Default Value |
Description |
|---|---|---|
|
temn.msf.stream.vendor |
kafka |
data stream vendor name |
|
temn.msf.schema.registry.url |
http://schema-registry:8081 |
url of the schema registry |
|
temn.msf.stream.kafka.bootstrap.servers |
kafka:29092 |
ip and port of kafka bootstrap server |
|
temn.msf.ingest.source.stream |
assembled-event |
source stream of the incoming event |
|
temn.msf.ingest.source.stream.consumergroup.id |
msf-holdings-ingester-consumer |
id of the consumer consuming the event |
|
temn.msf.ingest.sink.error.stream |
error-holdings |
error topic name |
|
temn.msf.ingest.sink.error.enabled |
"true" |
property to enable writing data into error topic |
|
temn.msf.ingest.event.ingester |
com.temenos.microservice.framework.core.ingester.MicroserviceIngester |
Framework class file used for multi event ingestion |
|
temn.msf.ingest.is.multi.event.data |
"true" |
Is the incoming data is multi event |
|
temn.ingester.mapping.enabled |
"false" |
is the jolt spec mapping is handled at framework level |
|
temn.msf.ingest.multi.event.ingester.class |
com.temenos.microservice.holdings.ingester.HoldingTransactionIngester |
Class name of AMS which is triggered for ingestion |
|
class.inbox.dao |
com.temenos.microservice.framework.core.inbox.InboxDaoImpl |
class names for inboxoutbox feature |
|
class.outbox.dao |
com.temenos.microservice.framework.core.outbox.OutboxDaoImpl |
class names for inboxoutbox feature |
|
temn.msf.security.authz.enabled |
"false" |
enable xacml validation |
|
MONGODB_DBNAME |
ms_holdings |
database name |
|
CASSANDRA_USER |
cassandra |
database username |
|
MONGODB_CONNECTIONSTR |
mongodb://mongo7:27017,mongo8:27017,mongo9:27017 |
database connection url |
|
DATABASE_KEY |
mongodb |
database key |
J2EE Configuration
The dataIngester.properties is used to configure the ingestion. The above files are available in the ms-holdings-data-ingester.war\WEB-INF\classes\properties\ path.
The following are the property configuration required (dataIngester.properties).
|
Property |
Default Value |
|---|---|
|
temn.msf.stream.vendor |
kafka |
|
temn.msf.schema.registry.url |
http://10.94.2.34:8081 |
|
temn.msf.stream.kafka.bootstrap.servers |
10.94.2.34:29092 |
|
temn.msf.ingest.source.stream |
assembled-event |
|
temn.msf.ingest.source.stream.consumergroup.id |
msf-holdings-ingester-consumer |
|
temn.msf.ingest.sink.error.stream |
error-holdings |
|
temn.msf.ingest.sink.error.enabled |
true |
|
temn.msf.ingest.event.ingester |
com.temenos.microservice.framework.core.ingester.MicroserviceIngester |
|
temn.msf.ingest.is.multi.event.data |
true |
|
temn.ingester.mapping.enabled |
false |
|
temn.msf.ingest.multi.event.ingester.class |
com.temenos.microservice.holdings.ingester.HoldingTransactionIngester |
|
class.inbox.dao |
com.temenos.microservice.framework.core.inbox.InboxDaoImpl |
|
class.outbox.dao |
com.temenos.microservice.framework.core.outbox.OutboxDaoImpl |
|
temn.msf.security.authz.enabled |
false |
|
DATABASE_KEY |
mongodb |
|
MONGODB_DBNAME |
ms_holdings |
|
MONGODB_CONNECTIONSTR |
mongodb://mongo1:27017,mongo2:27018,mongo3:27019 |
In this topic
