DocsICP FilingConsole
官方文档
首页

Upgrade the ZooKeeper engine version

更新时间：
复制 MD 格式
产品详情
我的收藏

MSE Microservices Registry instances are available in Professional and Developer Editions, as the Basic Edition has been discontinued. This topic describes how to upgrade both the instance edition and the ZooKeeper engine version in the MSE console.

Background

To improve our services and simplify edition selection, the basic edition of MSE Microservices Registry will be discontinued, and its instances will be terminated at 12:00 (UTC+8) on March 3, 2025. After this time, you will no longer be able to access these instances from the console or your applications. Support and ticket services for basic edition instances will remain available until the deadline. For more details, see the Discontinuation of MSE Microservices Registry Basic Edition notice.

Upgrade impact

  • An instance upgrade takes approximately 10 minutes. During this period, you cannot perform any operations on the instance in the console. We recommend performing the upgrade during off-peak hours to minimize business impact.

  • For instances with three or more nodes, a rolling upgrade updates the nodes and automatically synchronizes data. This ensures a non-disruptive upgrade.

  • Instances with one or two nodes lack high availability, and the upgrade will completely interrupt service.

  • During the rolling upgrade, connections may drop and sessions may time out. Ensure that your client has a retry mechanism.

  • This non-disruptive upgrade does not affect business operations. However, network reconnections will generate logs, and monitoring data may show temporary fluctuations as the cluster restarts.

Upgrade the ZooKeeper engine version

  1. Log on to the MSE console, and select a region in the top navigation bar.

  2. In the left-side navigation pane, choose Microservices Registry > Instances.

  3. You can start the upgrade in two ways:

    • Method 1: On the Instances page, find the target instance and click Manual Upgrade in the Product Engine Edition column.

      Note

      If the instance is already on the latest version, Manual Upgrade is not displayed.

    • Method 2: On the Instances page, click the instance that you want to upgrade. On the Basic Information page, click Manual Upgrade next to Engine Version.

  4. In the Cluster Upgrade dialog box, click OK.

Upgrade Basic to Professional or Developer Edition

Prerequisites

  • Edition selection: Before you upgrade, refer to the Instance Edition Selection Guide to choose between Developer Edition and Professional Edition. For billing details of different editions, see Billing overview of common instances.

  • Version check: Dubbo versions earlier than 2.7.4 contain a registration failure bug. To avoid issues, ensure your Dubbo version is 2.7.4 or later before you upgrade.

Procedure

  1. Log on to the MSE console, and select a region in the top navigation bar.

  2. On the Instances page, find the ZooKeeper Basic Edition instance and click More in the Actions column.

    • For a subscription instance, click Upgrade or Downgrade as needed.

    • For a pay-as-you-go instance, click Upgrade/Downgrade.

  3. On the change specifications page, select the Product Edition, and configure parameters such as Engine specification and Number of Cluster Nodes.

    • Single-node instance: Select Developer Edition. This edition does not provide high availability.

    • Multi-node instance: Select Professional Edition. This edition provides high availability.

    Important

    The following restrictions apply when you change the Product Edition:

    • Basic Edition instances can be upgraded to Developer Edition and Professional Edition.

    • You can upgrade a Developer Edition instance only to the Developer Edition, not to the Professional Edition.

    • A Professional Edition instance can only be upgraded to the Professional Edition and cannot be downgraded to the Developer Edition.

  4. Confirm the Engine specification, Number of Cluster Nodes, and the price in the lower-right corner of the page, then click Buy Now.

    Important

    During the upgrade, do not reduce the cluster specifications, including the number of nodes, to prevent capacity risks and potential failures.

Upgrade Professional to Enterprise Edition

You can seamlessly upgrade an MSE ZooKeeper Professional Edition instance to Enterprise Edition with no service disruption.

Prerequisites

Before upgrading from Professional to Enterprise Edition, assess your capacity needs and refer to ZooKeeper Enterprise Edition Capacity Specifications to select a specification that meets your business needs.

Upgrade impact

  • The instance upgrade takes approximately 10 minutes. During this period, the instance is locked, and you cannot manage it in the console. We recommend performing the upgrade during off-peak hours to minimize business impact.

  • For instances with three or more nodes, a rolling upgrade updates the nodes and automatically synchronizes data.

  • Instances with one or two nodes lack high availability, and the upgrade will completely interrupt service.

  • During the rolling upgrade, connections may drop and sessions may time out. Ensure that your client has a retry mechanism.

  • This non-disruptive upgrade does not affect business operations. However, network reconnections will generate logs, and monitoring data may show temporary fluctuations as the cluster restarts.

  • Engine version compatibility: Enterprise Edition is backward compatible with all versions of Professional Edition.

Procedure

  1. Log in to the MSE Microservices Registry console and select a region. In the navigation pane on the left, choose Microservices Registry > Instances.

  2. Click one of the Upgrade buttons.

MSE ZooKeeper Professional Edition instances offer five ways to start an upgrade, all of which lead to the change specifications page.

  • On the Instances page:

Click Upgrade to Enterprise Edition in the Product Type/Version column of the target instance, or click More > Upgrade/Downgrade in the Actions column.

  • On the instance details page:

Click the target instance's Instance ID to open the Basic Information page, and then click one of the following buttons: Upgrade/Downgrade, Upgrade Now, or Upgrade to Enterprise Edition.

  1. On the instance change specifications page, select Enterprise Edition for the Product Version and configure the following parameters:

    • Product Version: Select Enterprise Edition.

    • Engine Specifications: Refer to ZooKeeper Enterprise Edition Capacity Specifications to select an appropriate specification.

    • Number of Cluster Nodes: Set the number of nodes. The minimum is 3, and the total must be an odd number.

  1. After you confirm the configuration information, click Buy Now to complete the upgrade.

Previous：ZooKeeper enginesNext：Upgrade MSE ZooKeeper Professional Edition to Enterprise