Help Center/ Cloud Bastion Host/ User Guide/ Instances/ Upgrading the CBH System Version
Updated on 2024-09-24 GMT+08:00

Upgrading the CBH System Version

A CBH system of the latest version has system optimizations or new functions. To use those functions, upgrade your instances in a timely manner.

Precautions

  • Before the upgrade
  • During the upgrade

    The version upgrade takes about 30 minutes. Although the CBH system is unavailable during this period, there is no impacts on host resources managed on the instance. However, to prevent important data loss, do not log in to the CBH system during the version upgrade.

  • After the upgrade

    The CBH instance automatically restarts after the upgrade completes. You can then use the mapped CBH system.

    After the upgrade, you can use the configuration and storage data of the original CBH system. Version upgrading does not affect the original configuration and storage data of the CBH system.

  • Rolling Back the Upgrade

    After the version upgrade is complete or during the cross-version upgrade, you can roll back the upgrade on the bastion host details page. After the rollback starts, the status of the bastion host changes to Rolling back edition.

    After the rollback, the basion host will restore to what it is before the upgrade. Data changes and new data will be lost as the basion host will be interrupted during the rollback. Exercise caution when performing this operation.
    • If you plan a scale-out task after an upgrade, start the scale-out task 5 minutes later when the upgrade is finished.
    • A scheduled upgrade must be set at least one day before the actual upgrade time. You are advised to upgrade the service during idle hours.
    • To upgrade the service to the latest version, version 3.3.37.0 and earlier must be upgraded to 3.3.37.5 first, and versions 3.3.38.0 to 3.3.50.0 must be upgraded to 3.3.50.3 first.
    • Manual rollbacks cannot be performed during a minor version upgrade (upgrading version 3.3.37.0 or earlier to 3.3.37.5, or upgrading any version between 3.3.38.0 and 3.5.50.0 to 3.3.50.3).
    • If a scheduled upgrade is set, you cannot shut down, restart, change, or expand the capacity of the basion host.
    • Before the upgrade starts, you can cancel the scheduled upgrade and reset the upgrade time.
    • During the cross-version upgrade, you can manually roll back the version.
    • There is a seven-day retention period for cross-version upgrades. You can roll back a cross-version upgrade within seven days after the upgrade. No rollbacks are allowed once the retention period expires. So, you need to verify the upgrade in a timely manner.
    • If specification change or scale-out tasks are performed after an upgrade, no rollbacks can be performed. So, do not perform any specification change or scale-out operations until you verify the upgrade.
    • After a successful cross-version upgrade, the instance ID, server ID, instance version, and creation time will change.
    • During cross-version upgrade, ports 80, 8080, 443, and 2222 are automatically enabled for the instance. If you do not need to use these ports, disable them immediately after the upgrade.
    • During cross-version upgrade, ports 22, 31036, 31679, and 31873 are automatically enabled for the instance. After the upgrade, keep prot 31679 enabled and disable other ports immediately if you do not need to use them.
    • If a web certificate has been imported for an instance, import the certificate again after the cross-version upgrade for the instance.

Constraints

  • In the new version of CBH, the application publish function is optimized. After the upgrade, to use the application O&M functions as usual, install the required plug-in on the application publish server as prompted. For details, see Installing RemoteApp Program.
  • To upgrade version 3.3.40.0 and 3.3.41.0, synchronize the time of OBS buckets first.
  • In the current version, all instances cannot be upgrade without service interruption. During the upgrade, services need to be suspended.

Prerequisites

Procedure

  1. Log in to the management console.
  2. Click in the upper left corner and select a region or project. In the upper left corner of the page, click and select a region. Choose Security & Compliance > Cloud Bastion Host to go to the CBH instance management page.

    Figure 1 Instances
    Table 1 Instance parameters

    Parameter

    Description

    Instance Name

    Instance name you specify. It cannot be modified after the instance is created.

    Status

    Status of the instance, including the status of the standby node.

    Instance Type

    Instance type you select.

    Login Address

    Private IP address of an instance.

    EIP

    EIP of the instance.

    Billing Mode

    Billing mode of the current instance.

    Enterprise Project

    Enterprise project that the instance belongs to.

  3. Locate the row containing the instance you want to upgrade. In the Operation column, choose More > Upgrade > Upgrade Edition.
  4. In the displayed dialog box, select the schedule upgrade time and enter UPGRADE to confirm. To cancel the upgrade schedule, enter CANCEL in the dialog box. You can also change the upgrade schedule you set before.

    Upgrade types:

    • During a minor version upgrade, the CBH instance you are using will be interrupted. It takes about 15 to 30 minutes to complete the upgrade.
    • During the cross-version upgrade, a new CBH instance will be created, and the CBH instance you are using will be interrupted. It takes about 30 minutes to 2 hours to complete the upgrade. During the cross-version upgrade, the instance status changes to Upgrading first, and then to Migrating data, Configuring HA, and to Running.

  5. Wait for the upgrade to complete. It takes about 15 minutes to 2 hours for the upgrade to finish at the backend. The actual upgrade time varies depending on the upgrade type. Once the upgrade starts, the instance status changes to Upgrading.
  6. When the CBH instance status changes to Running, the CBH system is available.

    After the upgrade completes, you can verify the upgrade. To do so, click the instance name in the Instance Name column. On the displayed page, check the instance version. If the instance version has not changed, the upgrade fails. In this case, contact technical support.

    For details about how to query the version of the upgraded CBH system, see Device System in About System.