WikiSysop at 13:01, February 21, 2023

2023-02-21T13:01:04Z

Santhosh Annamalai: Published

2022-02-14T11:17:11Z

Published

Santhosh.annamalai@genesys.com: Published

2021-10-29T16:44:10Z

Published

New page

{{Article
|Standalone=No
|DisplayName=Configure IWD Data Mart
|Context=Learn how to configure IWD Data Mart.
|ComingSoon=No
|Section={{Section
|sectionHeading=Override Helm chart values
|alignment=Vertical
|structuredtext=The following table provides information on the IWD Data Mart deployment settings:
{{{!}} class="wikitable"
{{!}}-
!Key
!Type
!Default
!Description
{{!}}-
{{!}}image.imagePullSecrets
{{!}}list
{{!}}`[]`
{{!}}imagePullSecrets must have the following format: - name: pullSecret1 - name: pullSecret2
{{!}}-
{{!}}image.pullPolicy
{{!}}string
{{!}}`"IfNotPresent"`
{{!}}Image pull policy
{{!}}-
{{!}}image.registry
{{!}}string
{{!}}`""`
{{!}}Image registry
{{!}}-
{{!}}image.repository
{{!}}string
{{!}}`""`
{{!}}Image repository
{{!}}-
{{!}}image.tag
{{!}}string
{{!}}`""`
{{!}}Image tag
{{!}}-
{{!}}iwddm.cronjob.schedule
{{!}}string
{{!}}`"*/15 * * * *"`
{{!}}IWDDM cronjob start schedule in cron format
{{!}}-
{{!}}iwddm.cronjob.suspend
{{!}}bool
{{!}}`false`
{{!}}IWDDM suspend: if true, it won't start
{{!}}-
{{!}}iwddm.db.createConfigmap
{{!}}bool
{{!}}`false`
{{!}}Create a config map for db access parameters
{{!}}-
{{!}}iwddm.db.dbname
{{!}}string
{{!}}`nil`
{{!}}IWDDM database name
{{!}}-
{{!}}iwddm.db.host
{{!}}string
{{!}}`nil`
{{!}}IWDDM database hostname
{{!}}-
{{!}}iwddm.db.port
{{!}}int
{{!}}`5432`
{{!}}IWDDM database port
{{!}}-
{{!}}iwddm.db.secret.enabled
{{!}}bool
{{!}}`false`
{{!}}Create IWDDM database secret
{{!}}-
{{!}}iwddm.db.secret.password
{{!}}string
{{!}}`nil`
{{!}}IWDDM database password to put in the secret
{{!}}-
{{!}}iwddm.db.secret.secretName
{{!}}string
{{!}}`nil`
{{!}}IWDDM database secret name
{{!}}-
{{!}}iwddm.db.user
{{!}}string
{{!}}`nil`
{{!}}IWDDM database user
{{!}}-
{{!}}iwddm.env.batchSize
{{!}}int
{{!}}`10000`
{{!}}Events load batch size
{{!}}-
{{!}}iwddm.env.executionChain
{{!}}string
{{!}}`"full"`
{{!}}
{{!}}-
{{!}}iwddm.env.httpProxyUrl
{{!}}string
{{!}}`""`
{{!}}IWDDM will try to connect to IWD using http proxy
{{!}}-
{{!}}iwddm.env.httpsProxyUrl
{{!}}string
{{!}}`""`
{{!}}IWDDM will try to connect to IWD using https proxy
{{!}}-
{{!}}iwddm.env.monitoring.enabled
{{!}}bool
{{!}}`false`
{{!}}Enable push metrics to Pushgateway
{{!}}-
{{!}}iwddm.env.monitoring.pushgateway_url
{{!}}string
{{!}}`""`
{{!}}Since IWDDM is a short living cronjob, it uses Pushgateway for providing metrics
{{!}}-
{{!}}iwddm.env.restUrl
{{!}}string
{{!}}`""`
{{!}}IWD REST endpoint url
{{!}}-
{{!}}iwddm.env.wfm
{{!}}object
{{!}}`{"enabled":false}`
{{!}}Push data to WFM if enabled
{{!}}-
{{!}}iwddm.helmTest.args
{{!}}list
{{!}}`["export PGPASSWORD=${IWDDM_PASSWORD}; psql -c \"select now()\""]`
{{!}}Arguments passed to the helm test command
{{!}}-
{{!}}iwddm.helmTest.command
{{!}}list
{{!}}`["/bin/bash","-c"]`
{{!}}Command for helm test
{{!}}-
{{!}}iwddm.helmTest.image
{{!}}string
{{!}}`"postgres:latest"`
{{!}}Image for helm test
{{!}}-
{{!}}iwddm.labels
{{!}}object
{{!}}`{}`
{{!}}Extra labels ref: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/
{{!}}-
{{!}}iwddm.nodeSelector
{{!}}object
{{!}}`{}`
{{!}}Node labels for assignment. ref: https://kubernetes.io/docs/user-guide/node-selection/
{{!}}-
{{!}}iwddm.priorityClassName
{{!}}string
{{!}}`""`
{{!}}Priority Class ref: https://kubernetes.io/docs/concepts/configuration/pod-priority-preemption/
{{!}}-
{{!}}iwddm.resources.limits.cpu
{{!}}string
{{!}}`"100m"`
{{!}}IWDDM Kubernetes CPU limit
{{!}}-
{{!}}iwddm.resources.limits.memory
{{!}}string
{{!}}`"160Mi"`
{{!}}IWDDM Kubernetes memory limit
{{!}}-
{{!}}iwddm.resources.requests.cpu
{{!}}string
{{!}}`"50m"`
{{!}}IWDDM Kubernetes CPU request
{{!}}-
{{!}}iwddm.resources.requests.memory
{{!}}string
{{!}}`"128Mi"`
{{!}}IWDDM Kubernetes memory request
{{!}}-
{{!}}iwddm.securityContext
{{!}}object
{{!}}`{}`
{{!}}Security Context ref: https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-the-security-context-for-a-container Containers should run as genesys user and cannot use elevated permissions '''Note:''' These options must not be changed unless instructed by Genesys.
{{!}}-
{{!}}iwddm.serviceAccount.create
{{!}}bool
{{!}}`true`
{{!}}Create service account for IWDDM
{{!}}-
{{!}}iwddm.serviceAccount.name
{{!}}string
{{!}}`nil`
{{!}}The name of the ServiceAccount to use. If not set and create is true, a name is generated using the fullname template
{{!}}-
{{!}}iwddm.tenantId
{{!}}int
{{!}}`1`
{{!}}Tenant short 4-digit ID
{{!}}-
{{!}}iwddm.volumeMounts
{{!}}object
{{!}}`{}`
{{!}}Volumes mounted into an IWDDM container
{{!}}-
{{!}}iwddm.volumes
{{!}}string
{{!}}`nil`
{{!}} Volumes provided to IWDDM pod Must be declared with starting `\ {{!}}Must be declared with starting |- since they are parsed as a template
{{!}}-
{{!}}podAnnotations
{{!}}object
{{!}}`{}`
{{!}}Add annotations to all pods
{{!}}-
{{!}}podLabels
{{!}}object
{{!}}`{}`
{{!}}Add labels to all pods
{{!}}}
 
|Status=No
}}{{Section
|sectionHeading=Configure Kubernetes
|alignment=Vertical
|structuredtext====ConfigMaps===
Not applicable as all required ConfigMaps are created via Helm Chart basing on the provided values.

===Secrets===
IWD Data Mart requires several secrets to be created.
===Create the pull secret===
Use the following code snippet as an example of how to create pull secret:
kubectl create secret docker-registry mycred --docker-server=pureengage.jfrog.io --docker-username=<jfrog_username> --docker-password=<API key from jfrog>
You can add ''mycred'' to Helm override values by setting '''image.imagePullSecrets''' to ''[ mycred ]''.

For OpenShift, you may add the ''mycred'' secret in current namespace as the default pull secret:<source>oc secrets link default mycred --for=pull </source>
====IWDDM PostgreSQL password====

It can be configured in Helm values as shown in the sample:<source>
iwddm:
db:
secret:
enabled: true
secretName: iwddm-db-secret-0001
password: somePassword1
volumes: |-
- name: iwddm-db-secrets
secret:
secretName: iwddm-db-secret-0001

volumeMounts: |-
- name: iwddm-db-secrets
readOnly: true
mountPath: "/mnt/env-file-secrets/db-file-secrets"
</source>

====IWDDM iWD x-api-key====
It must exist before your IWDDM deployment. It must be created with the following format:
IWDDM_API_KEY=value
Sample password creation:
<source>
kubectl create secret generic 0001-iwd-secrets \
--from-literal='IWDDM_API_KEY=123456-abcde-4568734'
</source>
IWD x-api-key can be configured as shown below:
<source>
iwddm:
volumes: |-
- name: iwd-secrets
secret:
secretName: 0001-iwd-secrets

volumeMounts: |-
- name: iwd-secrets
readOnly: true
mountPath: "/mnt/env-file-secrets/iwd-file-secrets"
</source>

====GIM database password====
Create a multi-line secret in the following way:

Create a file, '''gim-secret.txt''' with the following text:<source>
IWDDM_GIM_DBUSER=<gim_user>
IWDDM_GIM_PASSWORD=<gim_password>
IWDDM_GIM_URL=jdbc:postgresql://<gim_db_host>:5432/<gim_db_name>
</source>
Create a secret from the file:
<source>
kubectl create secret generic gim-secrets \
--from-file=gim-secret.txt
</source>
Then, mount it using Helm values:<source>
iwddm:
volumes: |-
- name: gim-secrets
secret:
secretName: gim-secrets

volumeMounts: |-
- name: gim-secrets
readOnly: true
mountPath: "/mnt/gim-secrets/gim-secret"
</source>
 
|Status=No
}}{{Section
|sectionHeading=Configure security
|alignment=Vertical
|structuredtext=IWDDM needs the username and password provided for PostgreSQL access.
===Arbitrary UIDs in OpenShift===
To use arbitrary UIDs in your OpenShift deployment, ensure the following settings:<source>securityContext:
runAsNonRoot: true
runAsUser: null
runAsGroup: 0
</source>
|Status=No
}}{{Section
|sectionHeading=Configure IWD REST endpoint
|alignment=Vertical
|structuredtext=IWD REST URL provided for IWDDM in the '''iwddm.env.restUrl''' parameter must be:
<nowiki>http://iwd.iwd.svc.cluster.local:4024/iwd/v3</nowiki>
The above endpoint may change depending on the configuration and where IWD is installed. Refer to {{Link-AnywhereElse|product=PEC-IWD|version=Current|manual=IWDPEGuide|topic=Deploy|display text=IWD documentation}} for information on this endpoint.
|Status=No
}}
|PEPageType=9c3ae89b-4f75-495b-85f8-d8c4afcb3f97
}}

@@ Line 235: / Line 235: @@
 You can add ''mycred'' to Helm override values by setting '''image.imagePullSecrets''' to ''[ mycred ]''.
 ====IWDDM PostgreSQL password====
@@ Line 309: / Line 308: @@
 |alignment=Vertical
 |structuredtext=IWDDM needs the username and password provided for PostgreSQL access.
 ===Arbitrary UIDs in OpenShift===
 To use arbitrary UIDs in your OpenShift deployment, ensure the following settings:<source>securityContext:
@@ Line 315: / Line 315: @@
    runAsGroup: 0
 </source>
 |Status=No
 }}{{Section

@@ Line 322: / Line 322: @@
   <nowiki>http://iwd.iwd.svc.cluster.local:4024/iwd/v3</nowiki>
 The above endpoint may change depending on the configuration and where IWD is installed. Refer to {{Link-AnywhereElse|product=PEC-IWD|version=Current|manual=IWDPEGuide|topic=Deploy|display text=IWD documentation}} for information on this endpoint.
 |Status=No
 }}
 |PEPageType=9c3ae89b-4f75-495b-85f8-d8c4afcb3f97
 }}

PEC-IWD/Current/IWDDMPEGuide/Configure - Revision history

WikiSysop at 13:01, February 21, 2023

Santhosh Annamalai: Published

Santhosh.annamalai@genesys.com: Published