All Products
Document Center

ApsaraMQ for Kafka:Upgrade instance versions

Last Updated:Mar 15, 2024

ApsaraMQ for Kafka provides major versions 0.10.x, 2.2.0, and 2.6.2. Major version 0.10.x includes minor versions 0.10 and 0.10.2. You can upgrade the version of an ApsaraMQ for Kafka instance to obtain higher performance and new features.


The ApsaraMQ for Kafka instance whose version you want to upgrade is in the Running state.

Background information

  • Major version upgrades

    A major version upgrade is an upgrade from one major version to another major version. For example, you can upgrade an ApsaraMQ for Kafka instance from version 0.10.x to version 2.x.

    • Newly deployed ApsaraMQ for Kafka runs version 2.x. Existing ApsaraMQ for Kafka 0.10.x instances can still be used as expected.

    • The message storage format of instances running version 2.x is different from that of instances running version 0.10.x. After the upgrade, you cannot roll an instance back to version 0.10.x. Proceed with caution.

  • Minor version updates

    A minor version update is an update from one minor version to another minor version. Bug fixes and performance optimization rather than compatibility fixes are involved in minor version updates. For example, you can update an ApsaraMQ for Kafka instance from version 2.2.0 to the kernel-optimized version 2.2.0.


  • Upgrades are free of charge. Upgraded versions are compatible with existing SDKs and API operations.

  • To ensure service continuity during the upgrade, make sure that your client supports automatic reconnection and can handle disconnections. By default, clients support automatic reconnection.

  • We recommend that you purchase a test instance to verify whether the instance can be upgraded as expected before you upgrade your production instance.

  • We recommend that you perform the upgrade during off-peak hours.

  • After you upgrade the major version of an instance, upgrade the client version to keep the client and broker versions consistent. After you update the minor version, you do not need to update the client version.

  • The duration of a major version upgrade or a minor version update increases with the computing specification of the instance. For instances that use the specification, the alikafka.hw.30xlarge specification, or a specification that is lower than the preceding specifications, a major version upgrade requires 25 minutes to complete and a minor version update requires 15 minutes to complete. During the upgrade, the nodes are upgraded one by one, and a specific amount of time is reserved to verify the upgrade of the previous node before the next node is upgraded. In normal cases, the upgrade does not interrupt services or affect your business.


    During the upgrade, an error message that indicates the client is disconnected from the node may appear. You can ignore the message. By default, the client reconnects to the node and obtains the latest metadata.

Upgrade the version of an instance

  1. Log on to the ApsaraMQ for Kafka console. In the Resource Distribution section of the Overview page, select the region where the ApsaraMQ for Kafka instance that you want to manage resides.

  2. On the Instances page, click the name of the instance that you want to manage.

  3. In the Basic Information section of the Instance Details page, perform the following operations:

    • Click Major Version Upgrade next to Major Version to upgrade the major version of the instance.

    • Click Minor Version Update next to Minor Version to update the minor version of the instance.

  4. In the panel that appears, perform the following operations:

    1. Read the content in the Read Before Upgrade section.

    2. Enter your name in the Emergency Contact field.

    3. Enter your emergency phone number in the Emergency Contact Number field.

    4. Select the time of upgrade in the Started At field.

    5. Click Confirm.


      After you click OK, the instance is upgraded immediately or later within seven days.