Skip to content

Commit 6e9a9cc

Browse files
committed
docs(migrate9): add missing changes for 9.0.0
1 parent eb7b691 commit 6e9a9cc

File tree

1 file changed

+26
-1
lines changed

1 file changed

+26
-1
lines changed

docs/guides/migration/migrate9.md

Lines changed: 26 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,15 @@ title: 'Migrate to version 9.0.0'
66
Here are the Important changes made for 9.0.0
77

88
:::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)
1010
:::
1111

1212
## Breaking Changes
1313

14+
### Minimal NodeJS version is now `14`
15+
16+
With 9.0.0 the minimal nodejs required is `14.20.1`.
17+
1418
### Mongodb Driver Version upgraded to 5.x
1519

1620
The used MongoDB Driver version is now `5.6.0`.
@@ -68,6 +72,19 @@ Some error classes have been merged:
6872

6973
Storage Engines `devnull` and `mmapv1` have been removed because they are not supported in newer versions of mongodb anymore, `wiredTiger` should be used instead.
7074

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+
7188
## Non-Breaking changes / Additions
7289

7390
### Compiler target is now `es2019`
@@ -79,8 +96,16 @@ This should be a non-breaking change
7996

8097
Crypto functions like for the md5 check and uuidv4 generation have been moved to use the `node:crypto` support, resulting in dropping 2 dependencies.
8198

99+
Dropped dependencies are `md5-file` and `uuid`.
100+
82101
## Binary childprocess is now also `.unref()`
83102

84103
The Mongodb Binary childprocess is now also `.unref()`, like the killer process has been for some time.
85104

86105
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

Comments
 (0)