All Products
Search
Document Center

ApsaraMQ for Kafka:Upgrade the versions of instances

Last Updated:Jul 27, 2023

This topic describes how to upgrade the version of a ApsaraMQ for Kafka instance.

Prerequisites

The ApsaraMQ for 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 ApsaraMQ for Kafka instance from version 0.10.x to version 2.x.

    Important
    • ApsaraMQ for 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 ApsaraMQ for 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.

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.

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

  • 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 does not interrupt the service or affect your business.

Upgrade the major version of an instance

  1. Log on to the ApsaraMQ for 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 Major Version Upgrade 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 ApsaraMQ for 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 Minor Version Upgrade 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