Step 4. Perform CBC Platform Upgrade

After you fixed errors reported by the pre-check tool and verified your system against the prerequisites, you can launch the upgrade of CBC Platform.

To upgrade CBC Platform, complete the following steps:

1. Perform yum update on the CloudBlue Commerce Management Node.

2. Upgrade the CBC Platform:

   Note: CBC Platform upgrades are performed incrementally from one major version to the next until you have the necessary version.

   1. Download the CloudBlue Commerce distribution package for the next major version to the Management Node and extract files from the archive to a directory.

   2. Launch the upgrade procedure by running the following command:

      python update.py

      In case of an unexpectedly long upgrade procedure, please refer to the Troubleshooting Upgrade Performance section for recommendations.

      Important:
      1. Use the --repo-base-url <URL> parameter to specify the URL to the mirror of CloudBlue Commerce Central YUM repository. Omit this parameter if the original CloudBlue Commerce Central YUM repository will be used. Instructions on how to create a mirror of CloudBlue Commerce Central YUM repository is provided in Making CloudBlue Commerce Central YUM Repository Accessible.
      2. Use the --repo-proxy-url <URL> parameter to specify the URL of a proxy server through which the CloudBlue Commerce YUM repository can be accessible.

   3. Repeat the previous steps to upgrade to the necessary platform version.
3. Install the necessary hotfixes.

After you complete your CBC Platform upgrade, you can upgrade service nodes as described in Step 5. Perform CBC Service Nodes Upgrade.

The CBC Platform upgrade consists of several phases. The order and description of these phases are provided below.

Phase	Description
Prepare	During this phase, the pre-check actions are executed after the CloudBlue Commerce installation is verified. No changes to CloudBlue Commerce are applied during this phase.
Pre	During this phase, the custom upgrade actions are executed in order to prepare your installation for the main phase. As of this phase, the upgrade cannot be reverted.
Main	This is the phase where the upgrade of CloudBlue Commerce hosts and packages is performed.
Pre_Pkg	This is a part of the Main phase. During this phase, the packages are removed, updated and installed.
Post	During this phase, the asynchronous upgrade tasks are scheduled, and the upgrade of CloudBlue Commerce is completed.

Note: During the CBC Platform upgrade, a number of tasks are scheduled. The CBC Platform upgrade process is finished as soon as all these tasks are completed.