Breadcrumbs

Deployment on Windows using Docker Desktop

Windows Setup Prerequisites

In addition to Solution Prerequisites, following are the setup requirements for the solution to run on Windows. 

Requirement

OS

Windows Server 2019 (Version 1809)

Docker Desktop

2.3 or higher


Docker Desktop requires bare metal server. However if you are using virtual machine make sure that VMware Hypervisor with Nested Virtualization is enabled. See this guide to enable Nested Virtualization in VMware Hypervisor.

Installation Methods

There are two methods by which you can deploy HC on Docker Desktop. 

  1. Manual Installation without Script

  2. Installation via Python Script.

Installation Steps for Manual Deployment

  1. Install

    Docker Desktop

    on the host operating system.

  2. Download the

    Git

    and install it on the host operating system.

  3. Navigate to C:\ and create a directory with name Hybrid-Chat. Navigate inside the directory and run the following command to clone the Chat-Solution directory on to your Server Machine.


  4. git clone https://connect:wCuQQzDRP-N7gcFk-7Ak@gitlab.expertflow.com/chat-solution/chat-solution.git --branch=3.12

    Now we have chat-solution downloaded in our Windows Server 2019.

  5. Open the Docker Desktop and navigate to Settings. 

  6. Click on Resources and then select File Sharing, Enter the path of the Hybrid-Chat.  image2020-12-10_16-10-32.png

Core Chat Solution Configuration

  1. Navigate to the downloaded directory of chat-solution and navigate to  docker/environment-variables

  2. Made the following changes in the following files.

 agent-gadget-variables.env 


Variable Names

Variable Value

SERVER_URL

https://<fqdn>/chat

SOCKET_URL

https://<fqdn>

FILE_SERVER_URL

https://<fqdn>/file-engine

MRE_URL

https://<fqdn>/mre

DB_URL

https://<fqdn>/database-connector
customer-gadget-variables.env


Variable Names

Variable Value

SERVER_URL

https://<fqdn>/chat

SOCKET_URL

https://<fqdn>

FILE_SERVER_URL

https://<fqdn>/file-engine

WORKING_HOURS_URL

https://<fqdn>/eabc

EWT_URL

https://<fqdn>/mre

CUSTOMER_GADGET_URL

https://<fqdn>/customer-gadget

CALLBACK_URL

https://<fqdn>/ecm


mre-ui-variables.env 

Variable Names

Variable Value

GAT_URL

https://<fqdn>

MRE_MICRO_URL

https://<fqdn>/mre-microservice


ecm-frontend-variables.env 

Variable Names

Variable Value

GAT_URL

https://<fqdn>/umm


umm-variables.env

Variable Names

Variable Value

SERVER_URL

https://<fqdn>

mre-variables.env

Variable Names

Variable Value

UMM

https://<fqdn>

DB_CONNECTOR_API_PATH

https://<fqdn>/database-connector

MRE_MICROSERVICE_PATH

https://<fqdn>/mre-microservice

REPORTING_CONNECTOR_API_PATH

https://<fqdn>/reporting-connector

Chat Solution Configuration with Standalone Agents

If you want to configure Chat Solution with Standalone agents, we need to make further changes to the following variables.

 agent-gadget-variables.env

Variable Names

Variable Value

STANDALONE_AGENTS

true


comm-server-variables.env 

Variable Names

Variable Value

IS_STANDALONE

true

mre-variables.env

Variable Names

Variable Value

USER_TYPE

DB

mre-microservice-variables.env

Variable Names

Variable Value

USER_TYPE

DB


Nginx Configuration

Navigate to chat-solution\docker\nginx and open the https-singleton.conf file in text editor and make the following changes.

Press CTRL + F and look for chatsolution.expertflow.com

It is going to be in following variables.

Line Number

Variable Name

Value

14

server_name

FQDN of the machine on which the solution is deployed and/ or I.P address.

179

server_name

FQDN of the machine on which the solution is deployed and/ or I.P address.

283

host

FQDN of the machine on which the solution is deployed.

289

server_name

FQDN of the machine on which the solution is deployed.

Next thing we want to change is the variable name proxy_pass. For that, press CTRL + H and look for primary_ip and replace it with the IP of the Windows Server 2019. 

image2020-12-10_18-57-55.png

Installation of Chat Solution

First of all, we need to create a network named, chat-solution by running the following command.

docker network create chat-solution

After that, we need to docker login into gitlab registry by running the following command.

docker login gitlab.expertflow.com:9242 --username deployment --password xWb8WafM8ZvdwBHNxLm3


Its time to install the Chat Solution, Navigate to chat-solution directory and run the following command.

docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-agent-gadget.yml up -d



docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-amq.yml up -d



docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-campaigns.yml up -d



docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-ccm.yml up -d 



docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-customer-gadget.yml up -d 



docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-db-connector.yml up -d 



docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-eabc.yml up -d 



docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-hc-server.yml up -d 



docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-mongo.yml up -d 



 docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-mysql.yml up -d



 docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-routing.yml up -d



 docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-service-gateway.yml up -d



 docker-compose --env-file .\coreversion.env -f .\sds\docker-compose-umm.yml up -d


That is all. You have working Chat Solution deployed in Docker Desktop. Now you can access UMM at https://fqdn/umm and after applying license, you can create agents and then restart MRE. You can access the Customer Gadget at https://fqdn/customer-gadget/  and use this link in Pre Chat Form to initiate a chat. 


Installation via Python Script

You need Python 3 for Windows installed for this script to run. To download: Python Releases for Windows | Python.org This script has some limitations.
1. It only Install the solution. You cannot stop the solution using this script.

2. It deploys only Core version of HC with Contact Center or without Contact Center.


Simply need to download the Python Script from Installation-3.12.1.py and run it. Just answer the questions asked in the script and in the end you will have Hybrid Chat installed in your Docker Desktop.