Skip to content
This repository has been archived by the owner on Mar 21, 2024. It is now read-only.

Simplify dump version section since v1.0 can import all dumps #203

Merged
merged 2 commits into from
Feb 6, 2023
Merged

Simplify dump version section since v1.0 can import all dumps #203

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
73e0eb6
Simplify dump version section since v1.0 can import all dumps
dureuill Dec 1, 2022
489647d
Relax target import version
dureuill Dec 1, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 10 additions & 13 deletions text/0105-dumps-api.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,19 +92,16 @@ To handle dump and Meilisearch version compatibility, it is necessary to also ve

The following table describes which version of the dump correspond to which version of Meilisearch

| Dump version | Meilisearch version | Highest compatibility dump version |
|--------------|--------------------------------------|------------------------------------|
| `v1` | `v0.20.0` and below | `v3` |
| `v2` | `v0.21.0` and `v0.21.1` | `v6` |
| `v3` | From `v0.22.0` to `v0.24.0` included | `v6` |
| `v4` | From `v0.25.0` to `v0.27.2` included | `v6` |
| `v5` | From `v0.28.0` to `v0.29.1` included | `v6` |
| `v6` | `v0.30.0` and later | `v6` |

What does "Highest compatibility dump version" means?

For maintainance reasons, we cannot guarantee the compatibility from old dump versions to the newest ones.
Concretely, if the user wants to upgrade from Meilisearch `v0.19.0` (dump `v1`) to `v0.26.0` (dump `v4`), migration should be done in two steps. First, import your `v0.19.0` dump into an instance running any version of Meilisearch between v0.21 and v0.24. Second, export another dump from this instance and import it to a final instance running with `v0.26.0`.
| Dump version | Meilisearch version |
|--------------|--------------------------------------|
| `v1` | `v0.20.0` and below |
| `v2` | `v0.21.0` and `v0.21.1` |
| `v3` | From `v0.22.0` to `v0.24.0` included |
| `v4` | From `v0.25.0` to `v0.27.2` included |
| `v5` | From `v0.28.0` to `v0.29.1` included |
| `v6` | `v0.30.0` and later |

All dumps created before and up to Meilisearch v1.0 can be imported into Meilisearch v1.X.Y.

## 4. Technical Aspects

Expand Down