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

Prerequisites

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

Background information

  • Major version upgrade

    A major version upgrade is an upgrade from one major version to another major version, such as the upgrade of 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 includes minor versions 0.10 and 0.10.2. Major version 2.x includes only minor version 2.2.0.
    • The message storage format of instances running version 2.x is different from that running version 0.10.x. Therefore, you cannot roll an instance back to version 0.10.x after the upgrade. Proceed with caution.
  • Minor version upgrade
    A minor version upgrade is an upgrade from one minor version to another., such as the upgrade of an 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 When you use version 0.10, you may encounter issues such as deadlocks and frequent rebalancing. We recommend that you upgrade your instance from version 0.10 to version 0.10.2. For more information about how to upgrade instance versions, see Upgrade the minor version of an instance.

Precautions

  • Upgrades are free of charge, and updated versions are compatible with the existing SDK and OpenAPI.
  • To ensure your service continuity 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 recommend that you upgrade the client version after the upgrade to ensure that the versions of the client and broker are the same.
  • The major version upgrade takes about 25 minutes, during which your service is not interrupted.
  • The minor version upgrade takes about 15 minutes, during which your service is not interrupted.

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 to the right 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 phone number for emergency contact in the Emergency Contact Number field.
    4. Select the time of upgrade in Started At.
      Note After you click OK, the instance is immediately upgraded or is upgraded at a specific time point within seven days.
    5. 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 to the right 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. Select the time of upgrade in Started At.
      Note After you click OK, the instance is immediately upgraded or is upgraded at a specific time point within seven days.
    5. Click OK.