You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guides/migration/migrate9.md
+26-1Lines changed: 26 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,11 +6,15 @@ title: 'Migrate to version 9.0.0'
6
6
Here are the Important changes made for 9.0.0
7
7
8
8
:::caution Important, Read this first
9
-
This Guide is written for migration from version `8.13.0` to `9.0.0`, for versions `>9.0.0 <10.0.0`, please consult the [CHANGELOG](https://github.com/nodkz/mongodb-memory-server/blob/master/CHANGELOG.md)
9
+
This Guide is written for migration from version `8.15.0` to `9.0.0`, for versions `>9.0.0 <10.0.0`, please consult the [CHANGELOG](https://github.com/nodkz/mongodb-memory-server/blob/master/CHANGELOG.md)
10
10
:::
11
11
12
12
## Breaking Changes
13
13
14
+
### Minimal NodeJS version is now `14`
15
+
16
+
With 9.0.0 the minimal nodejs required is `14.20.1`.
17
+
14
18
### Mongodb Driver Version upgraded to 5.x
15
19
16
20
The used MongoDB Driver version is now `5.6.0`.
@@ -68,6 +72,19 @@ Some error classes have been merged:
68
72
69
73
Storage Engines `devnull` and `mmapv1` have been removed because they are not supported in newer versions of mongodb anymore, `wiredTiger` should be used instead.
70
74
75
+
### Linux fallback binary has been removed
76
+
77
+
Previously there was a code-path for a fallback linux binary, but this has been removed because mongodb has stopped shipping generic linux binaries since versions after 4.0.
78
+
79
+
If a fallback is still required, try to use the ubuntu binary via [Config Options `DISTRO`](../../api/config-options.md#distro).
80
+
81
+
### Ubuntu fallback year has been updated
82
+
83
+
The ubuntu fallback year has been updated to `22`, instead of the previous `14`, because newer versions of mongodb dont ship for any EOL ubuntu version anymore.
84
+
85
+
This fallback is only used if the ubuntu year could not be parsed from the os-file.
86
+
This can also be overwritten with [Config Option `DISTRO`](../../api/config-options.md#distro).
87
+
71
88
## Non-Breaking changes / Additions
72
89
73
90
### Compiler target is now `es2019`
@@ -79,8 +96,16 @@ This should be a non-breaking change
79
96
80
97
Crypto functions like for the md5 check and uuidv4 generation have been moved to use the `node:crypto` support, resulting in dropping 2 dependencies.
81
98
99
+
Dropped dependencies are `md5-file` and `uuid`.
100
+
82
101
## Binary childprocess is now also `.unref()`
83
102
84
103
The Mongodb Binary childprocess is now also `.unref()`, like the killer process has been for some time.
85
104
86
105
This *should* help with non-closed instances not exiting the nodejs process.
106
+
107
+
## The port testing has been replaced
108
+
109
+
Previously MMS used `get-port`, but it caused some big memory-leakage across big projects, so it has been replaced with one that uses less maps.
110
+
111
+
It also has been replaced because newer versions were ESM only, but we couldnt switch to ESM yet (and using ESM in CommonJS is not a great experience)
0 commit comments