Zero-downtime upgrade for Dataphin

Limits

A zero-downtime upgrade is supported only when the first three segments of the current and target version numbers are the same. For example, you can upgrade from V5.1.2.02 to V5.1.2.04.

Prerequisites

• You understand the impact of the version upgrade. For more information, see Impact of version upgrades.

• No configurations or upgrades are in progress. If an upgrade is in progress, wait for it to complete, or force stop it if necessary before you try again.

Background information

A zero-downtime upgrade consists of two steps: selecting the version and upgrade mode, and performing the upgrade. Users can continue to log on to Dataphin during the upgrade. Applications are updated through a rolling upgrade. The following figures show the complete flow:

Procedure

Step 1: Select the version and upgrade mode

1. Append /opsconsole/v2 to the logon URL of Dataphin to go to the Dataphin Manager logon page.

2. On the Dataphin Manager logon page, enter your Username and Password, and then click Log on. Contact Dataphin O&M personnel to obtain the username and password.

3. On the Upgrade Record page, click Upgrade Dataphin.

4. On the Upgrade Dataphin page, select the version and upgrade mode. The following table describes the parameters.

   Parameter	Description
   Target version	Select the target version from the version list. If the target version is not in the list, click Upload Version Configuration to upload the configuration file for the target version. After the upload, the system validates the configuration file. If the content is incorrect, validation fails and the system reports the failure reason. If validation passes and no configuration file exists for this version, the version configuration is imported. If a configuration file already exists, the upload overwrites the existing configuration.
   Upgrade mode	Select Zero-downtime upgrade. During the upgrade, the data service remains active, and data service API calls remain available. This includes synchronous and asynchronous invocations. The system checks the compatibility between the current and target versions to determine if a zero-downtime upgrade is supported. If it is not supported, the system defaults to a downtime upgrade.

5. Select the risk disclaimer checkbox, and then click Start Upgrade.

Step 2: Start the upgrade

A progress bar shows the upgrade progress. During the upgrade, click View Log to view detailed upgrade logs.