Before Started

Prerequisite Knowledge for Linux

To deploy CloudfonCX on Linux, you need to have some knowledge and skills of the Linux operating system, and here are some Linux infrastructures and popular Linux distributions that will be used.

• Debian Buster 10, Debian Bullseye 11

• Ubuntu 20.04 (LTS) Focal, Ubuntu Impish 21.10, Ubuntu 22.04 (LTS) Jammy

• Docker 20.10 or higher.

• IPv4/IPv6

• Systemd

• IP tables

• Firewalld

• HTTP

It only supports 64-bit OS.

This document assumes that the Linux OS is already deployed and administrators of Cloudfon CX have been granted root permission to Linux.

Remove the CloudfonCX v2.x Installation

If your Linux server has installed Cloudfon CX v2.x, please follow the below steps before installing v3.x. These steps will delete all your CX data. You can back up the user data directory first.

Remove the docker instance

# stop cloudfon services instance
sh cloudfon_cc_ctl.sh stop

# remove cloudfon service instance
sh cloudfon_cc_ctl.sh rm

# remove user data folder(You can keep it or remove it. It will not be used anymore, and you MUST NOT install new version into this folder!!)
# The folder is your cloudfon v2.x installation folder 
rm -fr /root/cloudfon-cc

The above commands will deleted the Cloudfon CX v2.x docker instance. Now let us list the Cloudfon CX v2.x docker image .

# This command will list all docker images
sudo docker image list

# You can use the docker image rm command to delete the Cloudfon PCX image, the "4a16"
# is the first 4 characters of the image tag id.
sudo docker image rm 4a16

Cloud and Virtualization Environment Supported

To build a high-availability communication solution to help clients reduce cost and improve communication performance, Cloudfon CX commits support to cloud services and has confirmed compatibility with the following cloud and virtualized environments:

• VMware ESX 5.X and above.

• Microsoft HyperV 2016 R2 and above

• Amazon AWS

• ALI Cloud

• Google Could

• Microsoft AZURE

• Digital Ocean

System Performance Depends On the Following Key Factors

• Maximum simultaneous chat needed for CX

• Maximum online agents needed for CX

• Conversations & Files record storage

• Maximum Flows(Bot) on CX

• Maximum Chat Queues on CX

Depending on the key features listed above, Cloudfon CX is able to run on PCs and servers with various CPUs ranging from Intel i3 CPUs to Xeon.

Other Requirements

• Latest Firefox, Google Chrome, Edge browser

• Knowledge of Linux and Linux Internet administration

• Ensure server date time is synced correctly.

FQDN Support

Although Cloudfon CX is designed to be able to run on servers without FQDN specified, we recommend specifying FQGN with the following advantages:

• Easier access to Web Portal for Cloudfon CX
  

• Easier management of clients after IP address change for CX

• Convenient access to HTTPS when accessing Web Portal

• Avoid browser warnings when accessing the WebRTC Client

The FQDN you are using must be able to be resolved correctly into the server with Cloudfon CX installed in LAN. If Cloudfon CX is installed on the public network, FQDN must be resolved correctly into the public network address for the server with CX installed.

Prepare the TLS certificate

When there is a need for additional security of the conversation traffic for Web (HTTPS) sessions, the Transport Layer Security (TLS) is used to secure the client's conversation connections. In TLS protocol, the data is encrypted and protected. TLS communication requires certificate to authenticate recipient of the secured data.

Preparing TLS Certificates for WSS/HTTPS

This guide is for solving the following SSL certificate issues with Cloudfon CX.