Upgrade from 3.2.2 release sequence to 3.2.3

Owned by SUPPORT
Last updated: Apr 10, 2024
3 min read

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.

The impact of upgrading from 3.2.2 to 3.2.3archived

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:

  1. 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

  1. 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

  2. Please create a folder path identical to the older version 3.2.2 host: /root/cloud_cx

  3. Sync 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/

  1. 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

  1. Install docker environment and configure firewall.

/bin/sh install_docker_cx.sh

  1. 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.

  1. 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

  1. 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.

图片-20240205-115808.png

  1. 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

  1. Delete the CX Scripts

rm cloud_cx_ctl.sh

  1. 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

  1. 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.

图片-20240205-115808.png

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.