Common instances of Microservices Engine (MSE) Microservices Registry have two editions: Professional Edition and Developer Edition. The Basic Edition has reached the end of sale and is no longer updated. MSE ZooKeeper has its own engine versions. This topic describes how to upgrade Microservices Registry instance versions and ZooKeeper engine versions in the MSE console.
Background information
To provide better services and simplify the edition selection, MSE Microservices Registry Basic Edition was discontinued and instance resources were released at 12:00 on March 3, 2025 (UTC+8). From that time, you cannot access the discontinued instances by using the console or client. The technical support and ticket services for Basic Edition instances remain available until 12:00 on March 3, 2025 (UTC+8). For more information, see Notice on the discontinuation of MSE Microservices Registry Basic Edition instances.
Impact of an upgrade
The period of time that is required for an upgrade is approximately 10 minutes. During the upgrade, you cannot perform operations on the engine in the MSE console. To ensure the continuity of your business, we recommend that you upgrade or downgrade your instance during off-peak hours.
For an instance that contains three or more nodes, a rolling deployment is performed for the nodes, and data is automatically synchronized to these nodes during the upgrade. Your business is not interrupted during the upgrade.
For an instance that contains one or two nodes, the instance cannot provide high availability, and your business may be interrupted during the upgrade.
Connections may be closed and sessions may time out during a rolling deployment of nodes. You must make sure that the client supports the retry mechanism.
For business operations, upgrades do not cause interruptions but may re-establish network connections. As a result, connection re-establishment logs are generated and monitoring data fluctuates for a short period of time due to instance restarts.
Upgrade a ZooKeeper version
Log on to the MSE console, and select a region in the top navigation bar.
In the left-side navigation pane, choose Microservices Registry > Instances.
Use one of the following methods to perform an upgrade in the console:
Method 1: On the Instances page, find the desired instance and click Upgradeable in the Engine version column.
NoteIf the instance is of the latest version, Upgradeable is not displayed in the Engine version column of the instance.
Method 2: Click the name of the instance that you want to upgrade on the Instances page. On the Basic Information page, click Manual Upgrade next to Engine version.
In the Cluster Upgrade message, click OK.
Upgrade a ZooKeeper engine from Basic Edition to Professional Edition or Developer Edition
Preparations before an upgrade
Select an edition: Before an upgrade, select Developer Edition or Professional Edition as the destination edition by referring to Select an instance type and an instance edition. For billing details of different editions, see Billing overview of common instances.
Check the engine version: Dubbo versions earlier than 2.7.4 may encounter registration failures. Before an upgrade, you must make sure that the Dubbo version is 2.7.4 or later.
Upgrade procedure
Log on to the MSE console, and select a region in the top navigation bar.
On the Instances page, find the Zookeeper Basic Edition instance, and click More in the Actions column.
For a subscription instance, select Upgrade or Downgrade based on your business requirements.
For a pay-as-you-go instance, select Upgrade/Downgrade.
On the Upgrade/Downgrade page, select a product edition, and specify parameters such as Engine Specifications and Number of Cluster Nodes based on your business requirements.
For single-node instances, select Developer Edition that does not provide high availability.
For multi-node instances, select Professional Edition that provides high availability.
ImportantWhen you change the product edition, take note of the following limits:
You can upgrade a Basic Edition instance to a Developer Edition instance or a Professional Edition instance.
You can upgrade a Developer Edition instance of an earlier version to a Developer Edition instance of a later version. You cannot upgrade a Developer Edition instance to a Professional Edition instance.
You can upgrade a Professional Edition instance of an earlier version to a Professional Edition instance of a later version. You cannot downgrade a Professional Edition instance to a Developer Edition instance.
Confirm the engine specifications, the number of nodes, and the amount in the lower-right corner of the page. Then, click Buy Now.
ImportantDuring the upgrade, do not downgrade specifications (including the number of nodes) to prevent failures caused by instance capacity risks.