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

  • Major version upgrades

    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.

    Important
    • 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 the message storage format of instances 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 updates
    A minor version update is an update from one minor version to another, such as the update of 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.
    Important When you use version 0.10, you may encounter issues such as deadlocks and frequent rebalances. We recommend that you update your instance from version 0.10 to version 0.10.2. For more information about how to update the minor version of an instance, see Update the minor version of an instance.

Usage notes

  • Upgrades are free of charge, and upgraded versions are compatible with the existing SDKs and API operations.
  • 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 duration for the upgrade of a major version depends on the size of the instance. The more nodes that an instance contains, the longer the upgrade duration is. The upgrade duration is about 25 minutes for an average-sized instance. During a major version upgrade, the nodes are upgraded one by one, and a certain amount of time is reserved to verify the upgrade of the previous node before the next node is upgraded. In normal cases, the upgrade will not interrupt the service or affect your business.
  • The duration for the update of a minor version depends on the size of the instance. The more nodes that an instance contains, the longer the update duration is. The update duration is about 15 minutes for an average-sized instance. During a minor version update, the nodes are updated one by one, and a certain amount of time is reserved to verify the update of the previous node before the next node is updated. In normal cases, the update will not interrupt the service or affect your business.

Upgrade the major version of an instance

  1. Log on to the Message Queue for Apache Kafka console. In the Resource Distribution section of the Overview page, click the name of the region where your instance is deployed.
  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, click Upgrade Major Version to the right of Major Version.
  4. 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.
    5. Click OK.
      Note

Update the minor version of an instance

  1. Log on to the Message Queue for Apache Kafka console. In the Resource Distribution section of the Overview page, click the name of the region where your instance is deployed.
  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, click Upgrade Minor Version to the right of Minor Version.
  4. 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 phone number for emergency contact in the Emergency Contact Number field.
    4. Select the time of update in Started At.
    5. Click OK.
      Note