Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This Document will guide you how to upgrade CloudCX from the version3.2.2 release sequence to 3.2.3

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#FFFAE6

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.

  • Shouldperform 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.3

Easy heading
linkText4
linkText10
linkText3
linkText6
linkText5
relatedLinksLabels
linkText2
linkText1
headingTagsH1,H2,H3
sidebarMaxHeight450
linkType2Page
linkType3Page
linkType1Page
linkType10Page
sidebarTitleON THIS PAGE
linkUrl3
linkUrl4
linkUrl1
linkUrl2
linkUrl10
includedPageModeDisable_Included_Pages
linkText8
linkText7
relatedLinksOrderLabels_First
sidebarModeOpened
headingNumberingModeDisable_Numbering
linkText9
sidebarMarginRight20
relatedLinksTargetNew_Window
relatedLinksTitleRELATED LINKS
linkUrl9
linkUrl7
linkUrl8
numberedHeadingTagsH1,H2,H3
linkUrl5
linkUrl6
linkType8Page
linkType9Page
linkType6Page
headingLinkTextModeWrap
linkType7Page
linkType4Page
linkType5Page
sidebarWidth240
sidebarTop160
headingLinkExpandModeCollapse_All_By_Default
headingLinkIndent10

...

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:

Code Block
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.

Code Block
scp -r /root/cloud_cx/mariadb_data/ root@${midware_server_host}:/root/cloud_cx/
  1. Download the new scripts

Code Block
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.

Code Block
/bin/sh install_docker_cx.sh
  1. Install Midware services(DB & Redis)

Code Block
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:

Code Block
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:

...

You will get the result shown in the below screenshot.

...

    ...

    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:

    Code Block
    docker image rm 52d2

    ...

    1. Delete the CX Scripts

    Code Block
    rm cloud_cx_ctl.sh

    ...

    1. Download new install scripts

    Code Block
    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

    ...

    1. New Application Services

    ...

    Code Block
    /bin/sh cloud_cx_ctl.sh run -i puteyun/cloud_cx:${tag3.2.3 -t api -w ${db_addr} -m ${db_passwd} -t apir ${redis_passwd}

    Note: Please MUST replace the Variables in the above command with the correctly value

    • ${tag} is the release version of

    cloud CX
    • CloudCX, for example: 3.2.3

    .1, Please MUST replace the ${tag} in the above command with the latest tag.
    • ${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):

    ...

    Code Block
    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:

    ...

    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:

    Code Block
    docker image rm 52d2

    4. Delete the CX Scripts

    Code Block
    rm cloud_cx_ctl.sh

    5. Download new install scripts

    Code Block
    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

    Code Block
    /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.