Updated on 2025-08-29 GMT+08:00

Upgrading a ServiceComb Engine

ServiceComb engines are created using the latest engine version. When a later version is released, you can upgrade your engine.

During upgrade, two instances are upgraded in rolling mode without service interruptions. However, one of the two access addresses may be unavailable. In this case, you need to quickly switch to the other instance. Currently, ServiceComb SDK and Mesher support instance switching. If you call the APIs of the service center and configuration center for service registry and discovery, instance switching is required.

Restrictions

  • During the ServiceComb engine upgrade, the microservice and engine are intermittently disconnected, but services of running microservices are not affected. You are advised not to upgrade, restart, or change microservices when upgrading a ServiceComb engine.
  • Version rollback is not supported after the upgrade.
  • For details about the precautions for upgrading an exclusive ServiceComb engine from 1.x to 2.x, see What Do I Need to Know Before Upgrading an Exclusive ServiceComb Engine?

Upgrading a ServiceComb Engine

  1. Click Upgrade in the Operation column of the target engine. Alternatively, click the target engine and click Upgrade in the ServiceComb Engine Information area.
  1. Select Target Version and view the version description. Determine whether to upgrade the software to this version.
  2. Click OK. If the engine status changes from Upgrading to Available, the upgrade is complete.

    If the upgrade fails, click Retry to perform the upgrade again.