Instance upgrades - Hologres - Alibaba Cloud Documentation Center

This topic describes how to upgrade Hologres instances.

Upgrade modes

Supported upgrade modes

Hologres is backward compatible. Major version upgrades involve new features, whereas minor version updates involve issue fixes. We recommend that you upgrade your Hologres instances to the latest version.

Hologres instances can be upgraded in standard mode or hot upgrade mode. The following table provides details about these two upgrade modes.

Note

The upgrade duration differs based on the amount of data stored in Hologres instances. Service interruption caused by instance upgrades is not defined in the service level agreement (SLA).

Upgrade mode	Upgrade duration	Instance status	Impact on tasks	Scenario	Remarks
Standard mode (services stopped)	5 to 10 minutes	Instances stop providing services when they are being upgraded.	Fully managed Flink tasks that involve data writes to Hologres tables must be stopped during instance upgrades and be restarted after the upgrades are complete. Otherwise, data may be lost. DataWorks data integration tasks and Blink tasks do not need to be stopped. During upgrades, a failover is triggered for the tasks and data is automatically restored based on the configured failover policy. We recommend that you set the number of failover retries to more than 10.	Minor version updates Example: V1.3.25 to V1.3.36 Major version upgrades Example: V1.1 to V1.3	For regular Hologres instances, you can manually upgrade them in the Hologres console. For more information, see the Manual upgrade (beta) section in this topic. For Hologres instances that are deployed in multi-instance high-availability mode, you can join the Hologres DingTalk group to ask Hologres O&M engineers for upgrades of primary and secondary instances in the background. This DingTalk group presents online technical support from Hologres experts. For more information about how to obtain technical support, see Obtain online support for Hologres. Note The service interruption duration for a standard upgrade varies based on the instance specifications and the amount of data stored in the instance. In special cases, the service interruption duration may be longer. If an instance is upgraded across multiple major versions, such as an upgrade from V0.10 to V1.3, the upgrade takes about 10 to 30 minutes. The specific upgrade duration varies based on the instance specifications and the amount of data stored in the instance. The upgrade does not cause changes in the endpoints of the instances, but may cause changes in the IP addresses of the instances.
Hot upgrade mode	10 to 30 minutes	Instances are read-only when they are being upgraded. You can query data from the instances, but cannot write data to the instances.			Only instances of Hologres V1.1.82 and later can be upgraded in hot upgrade mode. To perform a hot upgrade, you can join the Hologres DingTalk group to apply for a hot upgrade. This DingTalk group presents online technical support from Hologres experts. For more information about how to obtain technical support, see Obtain online support for Hologres. Note The upgrade does not cause changes in the endpoints of the instances, but may cause changes in the IP addresses of the instances. A hot upgrade across multiple major versions is not supported. For example, a Hologres instance cannot be upgraded from V0.10 to V1.3 in hot upgrade mode.

Upgrade modes supported by different types of products

The following table describes the upgrade modes supported by different types of products. You can select an upgrade mode based on your business requirements.

Product type	Standard mode (services stopped)	Hot upgrade mode
Regular instance	Supported. This upgrade mode is used by default. Note If you manually upgrade a regular instance, the standard mode with service stopped is used by default.	Supported. This upgrade mode is optional. Note Hologres V1.1.82 and later support the hot upgrade mode. A hot upgrade can be performed only by Hologres O&M engineers.
Primary and secondary instances	Supported. This mode is used if you upgrade primary and secondary instances from V1.1 to V1.3.	Supported. If you upgrade primary and secondary instances from V1.3 to a later minor version of V1.3, the hot upgrade mode is used by default. In this case, the primary instance is upgraded in standard mode with services stopped, and the secondary instances are upgraded in hot upgrade mode. Note By default, the primary and secondary instances must be upgraded together. The primary instance is upgraded in standard mode with services stopped, and the secondary instances are upgraded in hot upgrade mode. This minimizes the impact on the secondary instances. During the upgrade, the secondary instances are disconnected for a short period of time.
Shared cluster	Supported. This upgrade mode is used by default. Note Hologres O&M engineers are responsible for upgrades of shared clusters and will notify you of the upgrade time in advance in the product announcement. You are not allowed to separately upgrade an instance in a shared cluster.	Not supported.

Information required for upgrades

You need to ask Hologres O&M engineers to upgrade Hologres instances in the background in the following scenarios:

Upgrades of regular instances
- The source instance version is earlier than V1.1.
  Note
  If the version of your Hologres instance is V1.1 or later, you can manually upgrade your Hologres instance in the Hologres console. For more information, see the Manual upgrade (beta) section in this topic.
- The hot upgrade mode is required.
Upgrades of primary and secondary instances

You need to provide related information if your Hologres instances need to be upgraded by Hologres O&M engineers in the background.

Minor version updates
Pre-upgrade checks of instances are not required for minor version updates. The instances can be directly upgraded. You can join the Hologres DingTalk group to apply for upgrades. You need to provide the IDs of your Hologres instances and the upgrade time window. For more information about how to obtain technical support, see Obtain online support for Hologres.

Major version upgrades

Pre-upgrade checks of instances are required for major version upgrades. A pre-upgrade check takes about one to three days. You can join the Hologres DingTalk group to provide required information in the following table.

Note

To ensure compatibility between instance versions and retain the custom settings of parameters, a pre-upgrade check is required for the instance before the upgrade. The time window to perform the check is 1 to 3 days. Wait for the O&M engineers to inform you of the specific upgrade time.

Information	Description
Username	The name of your Alibaba Cloud account or a RAM user.
Instance ID	The ID of the Hologres instance that you want to upgrade. You can obtain the instance ID from the Basic Information section of the Instance Details page in the Hologres console. For more information, see Instance configurations.
Region and zone	The region and zone in which the Hologres instance that you want to upgrade resides. You can obtain the region and the zone from the Basic Information section of the Instance Details page in the Hologres console. For more information, see Instance configurations.
Instance version	The current version of the Hologres instance that you want to upgrade. You can obtain the instance version from the Basic Information section of the Instance Details page in the Hologres console. For more information, see Instance configurations.
Real-time write	If you use Blink, Realtime Compute for Apache Flink, or Apache Flink to write data in real time, provide the version number of the engine. Note If the version of the engine is outdated, data may be lost during the upgrades. To prevent data loss, make sure that you use Blink V3.7.9 or later, or Flink with the VVR version of V3.0 or later. If you use DataWorks to write data in real time, provide the real-time synchronization log and the region in which the resource group resides. If you use multiple exclusive resource groups for Data Integration, you must provide the real-time synchronization logs of all the resource groups.
Expected upgrade time	The point in time at which you want to start to upgrade the Hologres instance. Note The instance stops providing services when it is being upgraded. The duration of an upgrade varies based on the version and the specifications of the instance. The upgrade may last for a few minutes or even more than 10 minutes.

Manual upgrade (beta)

Hologres allows you to manually upgrade Hologres instances in the Hologres console. This allows you to upgrade your instances in a more convenient and efficient manner.

Limits

You can manually upgrade Hologres instances only in standard mode. If you want to upgrade regular Hologres instances in hot upgrade mode, you need to contact Hologres O&M engineers for help.
You can manually upgrade Hologres instances of only V1.1 or later.
You cannot manually upgrade primary and secondary Hologres instances.
If you manually upgrade an instance as a RAM user, you must make sure that the AliyunHologresFullAccess policy is attached to the RAM user. For more information about the permissions of RAM users, see Grant permissions on Hologres to RAM users.
You must perform the upgrade within seven days after the pre-upgrade check is complete. Otherwise, you need to perform the pre-upgrade check again.

Procedure

A manual upgrade for a Hologres instance involves the following phases:

Note

We recommend that you manually upgrade Hologres instances during the off-peak hours of your business.

Click Start upgrade preparation to start a pre-upgrade check.
- The pre-upgrade check generally takes 1 to 3 hours.
- The instance works properly during the pre-upgrade check.
- The system performs operations such as compatibility checks and data backup in this phase.
Note
If the pre-upgrade check fails, contact the Hologres O&M engineers to obtain the cause of the failure and perform troubleshooting under the guidance of the Hologres O&M engineers.
After the pre-upgrade check is complete, you can click Upgrade now to upgrade the instance.
- The instance stops providing services when it is being upgraded.
- The upgrade may last 5 to 10 minutes. The specific upgrade duration varies based on the amount of data involved.
- If the upgrade is not complete in 30 minutes, the system performs a rollback operation by using the data backed up before the upgrade.

Example

This section describes how to manually upgrade a Hologres instance.

Log on to the Hologres console. In the left-side navigation pane, click Instances.
On the Instances page, click the name of the instance that you want to upgrade.
On the instance details page, click Version for upgrade next to the Version parameter.
In the Upgrading an instance panel, check the version information and click Start upgrade preparation.
After the pre-upgrade check is complete, click Upgrade now.
Note
You can click Upgrade now to upgrade the instance within 7 days after the pre-upgrade check is complete.
Your Hologres instance is upgraded to the latest version after the upgrade is complete.

Operation logs of manual upgrades

The events of the manual upgrade are recorded in ActionTrail. For more information about how to query event logs in the ActionTrail console, see Query event logs.