All Products
Search
Document Center

Data Management:Upgrade the version of DMS Dify

Last Updated:May 13, 2025

DMS allows you to upgrade DMS Dify from an earlier version (V0.15.3 or earlier) to V1.1.3. After the upgrade, you can use the latest plugin feature. This topic describes the procedure to upgrade the major version of DMS Dify.

Precautions

The upgrade feature is in canary release. To use this feature, contact DMS technical support.

Preparations

Before upgrading DMS Dify, we recommend that you back up the resources used by Dify to prevent unexpected situations. Then, create a dify_plugin database on the desired ApsaraDB RDS for PostgreSQL instance to manage metadata of installed plugins.

Back up data

You need to back up the ApsaraDB RDS for PostgreSQL and vector database instances used by Dify.

Back up an ApsaraDB RDS for PostgreSQL database instance

  1. Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.

  2. Click Backup Instance in the upper-right corner. In the Back Up Instance dialog box that appears, click OK.

  3. You can click Task Center in the upper-right corner to check whether the backup is complete.

    If the backup progress is 100%, the backup is complete.

Back up a vector database instance

In this example, an AnalyticDB for PostgreSQL database instance is backed up.

  1. Log on to the AnalyticDB for PostgreSQL console.

  2. In the upper-left corner of the console, select the region where the instance resides.

  3. Find and click the desired instance ID. In the left-side navigation pane, click Backup and Restoration.

  4. In the upper-right corner of the page, click Create Backup. In the dialog box that appears, click OK.

    When the backup status is Success, the backup is complete.

Click here to view the engine types of vector database instances supported by DMS Dify.

AnalyticDB for PostgreSQL, AnalyticDB for MySQL, PolarDB for PostgreSQL, PG Vector, and Lindorm.

Prepare the database

You need to modify the password of the dify_user account in the Redis console to make it the same as the password of the default account r-xxxx. You also need to create a dify_plugin database on the desired ApsaraDB RDS for PostgreSQL instance.

Note

The dify_user account is automatically created on the corresponding database instance when you deploy DMS Dify.

Check whether database account passwords are the same in the Redis console

Go to the Instances page, select a region in the top navigation bar, and then click the desired instance ID. Check whether the password of the default account r-xxxx is the same as the password of the dify_user account. If they are different, modify the password of the dify_user account.

If you modify the password of the dify_user account, you need to update the database password on the Edit page in DMS. To do this, perform the following operations:

  1. Log on to the DMS console V5.0.
  2. Find the desired database instance in the database instance list on the left-side navigation pane, right-click the instance name, and select Edit.

  3. Enter the new database password, and make sure that Access mode is set to Security Hosting - Manual and Database Account is set to dify_user. Then, click Save.

Create a dify_plugin database on the ApsaraDB RDS for PostgreSQL instance

  1. Go to the Instances page, select a region in the top navigation bar, and then click the desired instance ID.

  2. In the left-side navigation pane, click Databases, and then click Create Database.

    Set the Database Name parameter to dify_plugin and select dify_user for the Authorized By parameter.

  3. Click Create.

Upgrade the version of DMS Dify

  1. Log on to the DMS console V5.0.
  2. Go to the Workspace Management page.

    You can choose one of the following methods to go to the workspace based on your requirements:

    Note

    Dify is in invitational preview. To use Dify, contact DMS technical support.

    Method 1

    Move the pointer over the 2023-01-28_15-57-17.png icon in the upper-left corner and choose All Features > Data+AI > Dify.

    Note

    If you use the DMS console in normal mode, choose Data+AI > Dify in the top navigation bar.

    image

    Method 2

    In the left-side navigation pane, click the image icon and then click Workspace.

    Note

    If you use the DMS console in normal mode, choose Digital Intelligence Factory > Workspace in the top navigation bar.

  3. In the left-side navigation pane, choose image > Dify, and click Upgrade to Latest Version.

    Note

    The entire upgrade process takes about 10 minutes during which Dify services will become unavailable. For example, models deployed through Dify and applications created in Studio will become unavailable during the upgrade process.

  4. After the upgrade is complete, you can use the latest version of Dify.

    You can click the profile picture of the Dify workspace to view the current version in the About section. If the version is 1.1.3, the version upgrade is successful.

Install Dify plugins

  1. After the upgrade is complete, you can click image > Studio in the left-side navigation pane of the workspace.

  2. Click PLUGINS in the upper-right corner, and then click Install plugin.

    Supported plugin sources are Marketplace, GitHub, and local plugins.

  3. Select an appropriate plugin source and install the plugins based on your requirements, such as model plugins, tool plugins, and Agent policy plugins.

    Note

    After the plugins are installed, if the original Dify application uses model services or knowledge base retrieval, you need to reconfigure the corresponding models or knowledge bases.

    For example, install the latest version of the TONGYI plugin from Marketplace.

  4. Proceed with large model application development. For more information, see the Dify official documentation.