This topic describes how to upgrade the version of a Message Queue for Apache Kafka instance.

Prerequisites

The Message Queue for Apache Kafka instance is in the Running state.

Background information

  • Upgrade the major version of an instance

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

    Note
    • Message Queue for Apache Kafka instances support major versions 0.10.x and 2.x. Major version 0.10.x provides 0.10 and 0.10.2, while major version 2.x provides only 2.2.0.
    • The message storage format of instances of version 2.x is different from that of instances of version 0.10.x. Therefore, you cannot roll back to version 0.10.x after the upgrade. Proceed with caution.
  • Upgrade the minor version of an instance
    A minor version upgrade is an upgrade from one minor version to another minor version. For example, you can upgrade a Message Queue for Apache Kafka instance from version 0.10 to version 0.10.2, or from version 0.10.2 to the 0.10.2 kernel-optimized version.
    Note Version 0.10 may trigger bugs such as deadlocks and frequent rebalancing. We recommend that you upgrade the instance from version 0.10 to version 0.10.2. For more information about the upgrade, see Upgrade the minor version of an instance.

Considerations

  • The upgrade is free of charge and compatible with the existing SDK and API.
  • To avoid impact on your business during the upgrade, make sure that your client supports automatic reconnection and can handle disconnections. By default, the client supports automatic reconnection.
  • We recommend that you purchase a test instance for upgrade verification before you upgrade your production instance.
  • We recommend that you perform the upgrade during off-peak hours.
  • We also recommend that you update the client version after the upgrade to keep the versions of the client and broker consistent.
  • The major version upgrade takes about 25 minutes. During the upgrade, the service is not interrupted, and your business is not affected in normal cases.
  • The minor version upgrade takes about 15 minutes. During the upgrade, the service is not interrupted, and your business is not affected in normal cases.

Upgrade the major version of an instance

  1. Log on to the Message Queue for Apache Kafka console.
  2. In the Resource Distribution section of the Overview page, select the region where your instance resides.
  3. On the Instances page, click the name of the instance that you want to manage.
  4. In the Basic Information section of the Instance Details page, click Upgrade Major Version on the right side of Major Version.
  5. In the Upgrade Major Version of Instance panel, 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 contact number in the Emergency Contact Number field.
    4. Click OK.

Upgrade the minor version of an instance

  1. Log on to the Message Queue for Apache Kafka console.
  2. In the Resource Distribution section of the Overview page, select the region where your instance resides.
  3. On the Instances page, click the name of the instance that you want to manage.
  4. In the Basic Information section of the Instance Details page, click Upgrade Minor Version on the right side of Minor Version.
  5. In the Upgrade Minor Version of Instance panel, 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 contact number in the Emergency Contact Number field.
    4. Click OK.