Help Center/ Cloud Bastion Host/ User Guide (Ally Region)/ Managing Instances/ Upgrading the Instance Version
Updated on 2025-12-10 GMT+08:00
View PDF
Share

Upgrading the Instance Version

CBH periodically upgrades the bastion host instance version to optimize functions or add new features. So the latest instance version is recommended.

Precautions

  • Before the upgrade
    • Back up data to ensure a quick rollback in case of upgrade failure. For details, see Which Types of System Data Can Be Backed Up in the CBH System?.
    • If you schedule an upgrade, the start time must be at least 24 hours later than the current time. You are advised to upgrade the service during idle hours. If a scheduled upgrade is set, you cannot shut down, restart, change, or expand the capacity of the bastion host. Before the upgrade starts, you can cancel the scheduled upgrade and reset the upgrade time.
  • 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 version upgrade is complete, you can roll back the upgrade on the bastion host details page. After the rollback starts, the status of the bastion host will change to Rolling back edition.
  • 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.
    • The scale-out after the upgrade cannot be rolled back. If you plan a scale-out task after an upgrade, start the scale-out task 5 minutes later when the upgrade is finished.
  • Version rollback

    After a rollback, the bastion host will restore to what it is before the upgrade. Data changes and new data will be lost as the bastion host will be interrupted during the rollback. Exercise caution when performing this operation.

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

The CBH system data has been backed up.

Before you upgrade, back up the CBH system data in the event of upgrade failures.

Procedure

  1. Log in to the management console.
  2. In the upper left corner of the page, select a region, click , and choose Security > Cloud Bastion Host from Service List.
  3. In the row containing the target instance, choose More > Plan Upgrade > Upgrade Schedule in the Operation column.
  4. In the displayed instance upgrade dialog box, select the scheduled upgrade time and enter YES in the dialog box.
  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 is complete, click the instance name and check the instance version on the details page.

    • If the instance version does not change after the upgrade, the upgrade fails. Contact technical support.

Parent topic: Managing Instances