Upgrade a database to Search 2.x

Upgrade a database from Search 1.x to Search 2.x.

RediSearch 2.x includes some significant architectural changes that improve functionality. The main change is that RediSearch 2.x stores indexes outside of the Redis database that contains the data. This makes commands more efficient and improves replication between clusters because the index changes are managed by the participating clusters rather than being synchronized with the data.

This change allows databases with RediSearch to support:

In addition, RediSearch 2.x indexes data that already existed in the database at the time that the index was created.

To upgrade a Redis Enterprise Software database with RediSearch 1.x to RediSearch 2.x, you have to set up a new database with RediSearch 2.x and use the RediSearch_Syncer.py script to replicate the data from the old database into the new database.

After you create the database or after you replicate the data, create an index with a prefix or filter that defines the keys that you want to index.


Install Python 3 on the host where you plan to run the synchronization script:

sudo apt install python3


  • Suggestions (FT.SUG APIs) and spell check dictionaries are not replicated from the source database. You need to add them manually.
  • If there are multiple indexes on the source and the documents do not have prefixes that identify them with an index, RediSearch 2.x can't index the documents in their respective indexes.
  • The NOSAVE option is no longer supported. Indexes created with the NOSAVE option can't be upgraded.
  • Databases that contain temporary indexes can't be upgraded.
  • Any attempt to add, delete, or modify an index during the upgrade will cause the replication process to fail. During the upgrade, the source database can only receive FT.ADD and FT.DEL commands.

Replicate data from RediSearch 1.x to RediSearch 2.x

To replicate a RediSearch 1.x database to a RediSearch 2.x database:

  1. Sign in to the admin console of the Redis Enterprise cluster where you want to host the new RediSearch 2.x database.

  2. Add the RediSearch 2.x module to the cluster.

  3. Create a new database with RediSearch 2.x.

  4. Migrate data to the RediSearch 2.x database.

Add RediSearch 2.x to the cluster

  1. Download the RediSearch 2.x module package from the Redis Download Center.

  2. In the Redis Enterprise admin console, select settings.

  3. In redis modules, select the Add module button.

  4. Use the file browser to select the module package and upload it to the cluster.

Create a RediSearch 2.x database

  1. Create a database and configure its settings.

  2. In the Redis Modules section:

    1. Select the Add button:

      The Add icon
    2. Select RediSearch 2 from the dropdown list.

    3. Select the OK button to confirm:

      The Save icon
  3. Select the Activate button to create the database.

Migrate data

  1. Download the RediSearch_Syncer package for your operating system:

  2. Extract the package:

    unzip <package_name>
  3. In the extracted directory, run the RediSearch_Syncer.py script:

    python3 RediSearch_Syncer.py -d <destination_url> -s <source_url> [--add-prefix <prefix>]

    Replace the following variables with your own values:

    • destination url - The replication URL of the RediSearch 2.x database. To find this value, go to the database configuration screen in the admin console and select Get Replica of source URL.

    • source url - The replication URL of the RediSearch 1.x database. To find this value, go to the database configuration screen in the admin console and select Get Replica of source URL.

    • --add-prefix <prefix> (optional) - Adds a prefix to all of the hashes that are replicated to the new database.

      Only use the add-prefix option if you want to index all of the hashes in the same index in the source database.

    The script shows a table with the progress of the replication process. Press F5 to see the updated status.

    For example:

    python RediSearch_Syncer.py -d redis://admin:IBrS0xaL6rShfB1wKTtUkcQG1g3UWAlTd53AotPdTcQvGIVP@redis-19472.cluster1.local:19472 -s redis://admin:1GjFuUbBqTSPDbRfaxEPLSoXpFmRdFxmBKMD0BuxwMJ2DEaO@redis-19636.cluster1.local:19636
  4. Stop the processes that are sending requests to the source database so all of the data gets synchronized to the destination database.

  5. Run FT.INFO on both source and destination databases and compare the number of indexed documents. The replication process is complete when the number of indexed documents is the same in both databases.

  6. When the status field is st_in_sync, you can press Ctrl-C to cancel the synchronization process.

  7. Press Q to quit the RediSearch_Syncer.py.

You can now redirect your database connections to the RediSearch 2.x database.

Back to top ↑