How to upgrade to MongoDB 4.4

The latest delivered MongoDB version is 4.4. It can be used by version 12.14.0 of the Syracuse server.

Important: You must be running MongoDB 4.2 to upgrade to MongoDB 4.4.

Sage delivers a MongoDB setup to upgrade your MongoDB instance.

Prerequisites

For each release, the minimum Syracuse upgrades compatible with MongoDB 4.4 are the following:

Product version	Minimum Sage X3 Syracuse Server version
U9	Not compatible
V11	Not compatible
V12	12.14.0

Upgrade your MongoDB instance

You can upgrade your MongoDB instance to version 4.4 from MongoDB 4.2. Consult this documentation if you need to upgrade to MongoDB 4.2 first.

Upgrade from MongoDB 4.2

1. Stop the Syracuse Agent. This is mandatory in order not to have any MongoDB client. Check that you don’t have any node.js nanny, Nx, Wx or B0 running.
2. Launch the MongoDB 4.4 setup. Use the reinstallation procedure.
3. If you are using a Java Oracle platform and if the MongoDB server will use an SSL connection, you need to:
   1. Be at at least on Java 8 update 151.
   2. Add Java Bouncy Castle to the security providers’ list on your platform:
      1. Unzip the content of the bcprovider.zip file to the $JAVA_HOME/jre/lib/ext/ directory.
      2. Register the Bouncy Castle provider by adding the security.provider.=org.bouncycastle.jce.provider.BouncyCastleProvider line in the $JAVA_HOME/jre/lib/security/java.security file.
      You can find out more about JCE provider here.
   3. Check in $JAVA_HOME/jre/lib/security/java.security that your crypto policy is set to unlimited: crypto.policy=unlimited.
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. Restart your Sage X3 Syracuse Server.