Supported Linux OS
Ubuntu 20.04 (LTS) Focal, Ubuntu Impish 21.10, Ubuntu 22.04 (LTS) Jammy
Debian Buster 10, Debian Bullseye 11
It only supports 64bit OS
Hardware Requirements
In order to ensure the normal operation of the server's functions, the following are some configuration suggestions, and the specific requirements will change according to the actual situation.
Agents(Online) | vCPUs | Memory | Disk |
50 | 4 | 16 | 100G |
200 | 8 | 32 | 500G |
500 | 16 | 32 | 1000G |
Note: It is best to consider the scalability of subsequent CPU, memory, and disk during deployment.
Note: Please note that this is only a basic configuration required for CX system deployment. With the use of the system and the increase in configuration and storage information, hardware resources need to be further expanded.
Each CPU core need 2.5Ghz or Higher.
In terms of disk storage, as more information is stored, it will need to be expanded again, and subsequent dynamic expansion needs to be considered during deployment
If using third-party Oss, such as AWS S3/Azure Blob/Mini, please activate storage services with the same storage size according to the situation.
Preparing the Linux Host Machine for Installation
Tasks that MUST be completed before installing CloudFon CX
If the Linux on which Cloudfon CX will be installed is located in LAN, assign a static LAN IP address; if it's in a public network, please assign a static IP address for the public network.
Install all available updates & service packs before installing Cloudfon CX.
Do not install PostgreSQL on your Cloudfon CX Server.
Ensure that all power-saving options for your System and Network adapters are disabled (by setting the system to High Performance).
Do not install TeamViewer, VPN, and other similar software on the host machine.
The CloudFon CX must not be installed on a host that is a DNS or DHCP server.
Port must be permitted by your firewall: TCP: 9001,9006,443
Please also ensure the above ports have not been used by other applications.
Ensure server date-time is synced correctly, how to check date-time?
Ensure server that must has more than 8G of memory.
Please reserve 100G space to install & use the Cloudfon CX (The amount of disk used depends on the number of agents you plan to deploy and the subsequent session history and related files).
Must perform all Linux commands by the root user, please su root First.
Note: If the Cloudfon CX runs on a Cloud platform such as AWS, and the cloud platform has the firewall itself, you MUST open the ports on the cloud platform firewall too.
Note: All the following Linux commands must be executed in the same working path, which is assumed to be /root/cloudfon_cx in this example.
Note: The installation steps may need about 20 minutes to complete.
Installation Steps
1. Make directory and change directory
mkdir -p /root/cloud_cx/ && cd /root/cloud_cx/
Note: cloud_cx is an example here, you can change to your directory name, and this directory will storage user data.
2. Download install scripts
curl https://raw.githubusercontent.com/cloud-cx/cloudfon-cx-install/main/v3.2.x/cloudfon_cx_ctl.sh -o cloud_cx_ctl.sh
curl https://raw.githubusercontent.com/cloud-cx/cloudfon-cx-install/main/v3.2.x/install_docker_cx.sh -o install_docker_cx.sh
Note: cloud_cx_ctl.sh is an example here, you can download and rename to your name.
3. Install docker environment and configure firewall.
/bin/sh install_docker_cx.sh
4. Install MySQL, CX Service, etc.
/bin/sh cloud_cx_ctl.sh run -i puteyun/cloud_cx:${tag}
Note: ${tag} is the release version of CloudFon CX, for example: 3.2. X,
Please MUST replace the tag in the above command with the latest tag. The latest version is 3.2.2.3
/bin/sh cloud_cx_ctl.sh run -i puteyun/cloud_cx:3.2.2.3
5. Login and configure the CloudFon CX.
Open Browser, input “https://IP_Address:9006/”, the “IP_Address” is the IP address of your Cloudfon CX server (Linux Server).
IMPORTANT: To complete CloudFon CX initial configuration, please refer to 'System initialization' guide.
6. CX Control Commands
Show cloud-cx services status
cd /root/cloud_cx && /bin/sh cloud_cx_ctl.sh status
Restart cloud-cx services
cd /root/cloud_cx && /bin/sh cloud_cx_ctl.sh restart
Restart the selected service of cloud-cx
cd /root/cloud_cx && /bin/sh cloud_cx_ctl.sh restart -s [Service Name]
Stop cloud-cx Services
cd /root/cloud_cx && /bin/sh cloud_cx_ctl.sh stop
Stop the selected service of cloud-cx
cd /root/cloud_cx && /bin/sh cloud_cx_ctl.sh stop -s [Service Name]
Start cloud-cx Services
cd /root/cloud_cx && /bin/sh cloud_cx_ctl.sh start
Start the selected service of cloud-cx
cd /root/cloud_cx && /bin/sh cloud_cx_ctl.sh start -s [Service Name]
Uninstall cloud-cx Services
cd /root/cloud_cx && /bin/sh cloud_cx_ctl.sh rm
Uninstall Cloufon CX
Please use the below steps to uninstall the Cloudfon CX for Linux.
Uninstall the CX
Stop and delete the CX Docker instances.
cd /root/cloud_cx /bin/sh cloud_cx_ctl.sh stop /bin/sh cloud_cx_ctl.sh rm
The below commands will delete the CX data; please be careful.
cd /root/ rm -fr cloud_cx
Note: cloud_cx is an example here, you can change to your directory name, and this directory will store user data.