How to upgrade to MongoDB 3.6
MongoDB version 3.6 can be used by the latest Syracuse release (U9, V11 and V12).
Important: You must be running MongoDB 3.4 to upgrade to MongoDB 3.6.
Sage X3 Syracuse Server is delivered with an embedded MongoDB driver.
Sage also delivers MongoDB setup files with each Sage X3 release.
MongoDB is not upgraded automatically when you upgrade Syracuse.
You need to use the standalone MongoDB setup to upgrade your MongoDB instance.
Prerequisites
For each release, the minimum Syracuse upgrades compatible with MongoDB 3.6 are the following:
| Product version | Minimum Sage X3 Syracuse Server version |
|---|---|
| U9 | 9.19.0 |
| V11 | 11.19.0 |
| V12 | 12.5.0 |
Upgrade your Sage X3 Syracuse Server
In order to comply with the prerequisites, you have to upgrade your Sage X3 Syracuse Server first.
1 - Stop the Syracuse Agent.
2 - Lauch the Sage X3 Syracuse Server setup (it embeds the new Node.js driver).
Use the Modify installation type.
Upgrade your MongoDB instance
You can upgrade your MongoDB instance to version 3.6 from:
Upgrade from MongoDB 3.2
1 - Stop the Syracuse Agent again. This is mandatory to not have any MongoDB client.
Check that you don’t have any node.js nanny, Nx, Wx or B0 running.
2 - Launch the MongoDB 3.4 setup.
Use the reinstallation procedure.
3 - If the original installation was set only to accept a secure connection, pay attention to
The server uses and accepts only SSL encrypted connections option.
4 - Update the MongoDB compatibility version to 3.4, either with the db.adminCommand( { setFeatureCompatibilityVersion: "3.4" } ) MongoDB command or by restarting the Sage X3 Syracuse Server.
5 - Then launch the MongoDB 3.6 setup.
Use the Modify installation type.
6 - Restart your Sage X3 Syracuse Server.
Upgrade from MongoDB 3.4
1 - Stop the Syracuse Agent again. This is mandatory to not have any MongoDB client.
Check that you don’t have any node.js nanny, Nx, Wx or B0 running.
2 - Check your compatibility version using the db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } ) MongoDB command. Update the MongoDB compatibility version to 3.4 if necessary, either with the db.adminCommand( { setFeatureCompatibilityVersion: "3.4" } ) MongoDB command or by restarting the Sage X3 Syracuse Server.
3 - Launch the MongoDB 3.6 setup.
Use the Modify installation type.
4 - If the original installation was set only to accept secure connection, pay attention to
The server uses and accepts only SSL encrypted connections option.
5 - Then launch the MongoDB 3.6 setup.
Use the Modify installation type.
6 - Restart your Sage X3 Syracuse Server.