Deployment Guide - Cisco Sync Service

Step 1: Clone the Repository

clone the repository using the following command.

CODE

git clone -b CX-4.9.3_f-CIM-28813 https://efcx:RecRpsuH34yqp56YRFUb@gitlab.expertflow.com/cim/cim-solution.git  CX-4.9.3_f-CIM-28813

Change the directory.

CODE

cd CX-4.9.3_f-CIM-28813/kubernetes

Open the helm/CiscoSyncService/values.yaml file and update the ingressRouter

CODE

vi helm/CiscoSyncService/values.yaml

In values.yaml, update the hostnames and ip of current Cisco Finesse instance under hostAliases.

CODE

hostAliases: 
- ip: "192.168.1.33"
  hostnames:
    - "uccx12-5p.ucce.ipcc"

In values.yaml we have extraEnvVars containing all the configurations of qm-sync-service, change them according to your configurations:

Configuration	Value
REALM	value of REALM of Keycloak instance. in our case its `expertflow`
AUTH_SERVER_URL	Keycloak Instance URL e.g: `https://{{ FQDN }}/auth/`
RESOURCE	The Keycloak client in our REALM that we are going to use, generally its `cim`
SECRET	Client Secret, general secret used for Keycloak instances: `ef61df80-061c-4c29-b9ac-387e6bf67052`
CLIENT_ID	The Keycloak client in our REALM that we are going to use, generally its `cim`
CLIENT_DB_ID	Client Secret, general secret used for Keycloak instances: `ef61df80-061c-4c29-b9ac-387e6bf67052`
USERNAME_ADMIN	Admin user credentials in our target realm. i.e `expertflow` realm admin username.
PASSWORD_ADMIN	Admin user credentials in our target realm. i.e `expertflow` realm admin password.
EF_SERVER_URL	URL of Unified-Admin instance where we want to sync teams. e.g: `https://{{ FQDN }}/unified-admin/`
FINESSE_USERNAME	Administrator Username of Finesse instance
FINESSE_PASSWORD	Administrator Password of Finesse instance
FINESSE_URL	Finesse Instance URL. e.g: `https://uccx12-5p.ucce.ipcc:8445`
SYNC_AGENT_PASSWORD	Password assigned to each user when created/synced on Keycloak Side.
PORT	PORT on which you want to run QM Sync Service. e.g `3004`

Disable the ingress by updating the following values:-

CODE

ingress:
  ## @param ingress.enabled Set to true to enable ingress record generation
  ##
  enabled: false

Deploy the helm chart using the following command

CODE

helm upgrade --install --namespace expertflow cisco-sync-service  --debug  --values helm/CiscoSyncService/values.yaml  helm/CiscoSyncService

Check the pods by running the following command

CODE

kubectl get pods -n expertflow | grep cisco-sync-service

Once the deployment is complete, you can call this API to start the sync process of Users and Teams to CX:

CODE

https://${FQDN}/cisco-sync-service/api/v1/sync