This Document will guide you how to upgrade CloudCX from the version3.2.2 release sequence to 3.2.3
Notes:
All of the following Linux commands must be executed in the same working path, which is assumed to be /root/cloud_cx in this example.
Should perform all Linux commands by the root user, please su root First.
Before installation please take a snapshot of your VM or backup your CX data Folder:
/root/cloud_cx/cc_api
/root/cloud_cx/mariadb_data
You can tar those folder and move them to a safe folder
Please know the impact of the version before upgrading the version.
Separate deployment of application servers:
In this deployment model, the application server and database server are deployed on separate machines. It is recommended to keep the Midware in the same LAN for local installations or on the same switch for cloud installations to ensure better performance and connectivity.
Deploy Midware Server:
Stop CloudCX Application Services
Perform the following commands as root to stop & rm the current CX Docker instance:
cd /opt/cloud_cx && /bin/sh cloud_cx_ctl.sh stop cd /opt/cloud_cx && /bin/sh cloud_cx_ctl.sh rm
Prepare a Linux server for Midware service. You can prepare an installation environment for Midware services according to the first two chapters of this document: Midware Service Requirement
Please create a folder path identical to the older version 3.2.2 host:
/root/cloud_cxSync MariaDB data from the older version 3.2.2 host to new Midware Server.
scp -r /root/cloud_cx/mariadb_data/ root@${midware_server_host}:/root/cloud_cx/
Download the new scripts
curl https://raw.githubusercontent.com/cloud-cx/cloudfon-cx-install/main/v3.3.x/cloud_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
Install docker environment and configure firewall.
/bin/sh install_docker_cx.sh
Install Midware services(DB & Redis)
sh cloud_cx_ctl.sh run -t mid -m ${db_passwd} -r ${redis_passwd}
Note: Please MUST replace the Variables in the above command with the correctly value
${db_passwd} is the password of the database. 3.2.2 version has a default DB password, please contact us to obtain it.
${redis_passwd} is the password of the redis. Please set a new password for it.
Deploy Application Server:
After the deployment of the middleware server, we can start to upgrade the current application service 3.2.2 to 3.2.3.
Stop CloudCX Application Services
Perform the following commands as root to stop & rm the current CX Docker instance:
cd /opt/cloud_cx && /bin/sh cloud_cx_ctl.sh stop cd /opt/cloud_cx && /bin/sh cloud_cx_ctl.sh rm
List the CX Docker Images
Perform the following command to list the CX Docker images:
docker images
You will get the result shown in the below screenshot.
Delete the CX Docker Images
Please delete all of images include MariaDB and Redis, Use the first 4 digits of the IMAGE ID to delete the Docker image:
docker image rm 52d2
Delete the CX Scripts
rm cloud_cx_ctl.sh
Download new install scripts
curl https://raw.githubusercontent.com/cloud-cx/cloudfon-cx-install/main/v3.3.x/cloud_cx_ctl.sh -o cloud_cx_ctl.sh
Install New Application Services
sh cloud_cx_ctl.sh run -i puteyun/cloud_cx:3.2.3 -t api -w ${db_addr} -m ${db_passwd} -r ${redis_passwd}
Note: Please MUST replace the Variables in the above command with the correctly value
${tag} is the release version of CloudCX, for example: 3.2.3
${db_addr} is the Database Server address of CX (Midware Services Address). It is recommended to keep the Midware in the same LAN for local installations or on the same switch for cloud installations to ensure better performance and connectivity.
${db_passwd} is the password of the database for midware server
${redis_passwd} is the password of the Redis for midware server
Mixed deployment of application servers (on a single machine):
In this deployment model, both the application server and database server are deployed on the same machine.
1. Stop CloudCX Services
Perform the following commands as root to stop & rm the current CX Docker instance:
cd /opt/cloud_cx && /bin/sh cloud_cx_ctl.sh stop cd /opt/cloud_cx && /bin/sh cloud_cx_ctl.sh rm
2. List the CX Docker Images
Perform the following command to list the CX Docker images:
docker images
You will get the result shown in the below screenshot.
3. Delete the CX Docker Images
Please delete all of images include MariaDB and Redis, Use the first 4 digits of the IMAGE ID to delete the Docker image:
docker image rm 52d2
4. Delete the CX Scripts
rm cloud_cx_ctl.sh
5. Download new install scripts
curl https://raw.githubusercontent.com/cloud-cx/cloudfon-cx-install/main/v3.3.x/cloud_cx_ctl.sh -o cloud_cx_ctl.sh
6. Install CX Services and Midware
/bin/sh cloud_cx_ctl.sh run -i puteyun/cloud_cx:${tag} -m ${db_passwd}
Note: Please MUST replace the Variables in the above command with the correctly value
${tag} is the release version of CloudCX, for example: 3.2.3
${db_passwd} is the password of the database. 3.2.2 version has a default DB password, please contact us to obtain it.