The MongoDB persistence has to be set up with a URI in the following form (for more details see here):
inet_persistence="mongodb://(<USERNAME>:<PASSWORD>@)<MONGODB SERVER>/<DATABASE>"
It is important to know, that many cloud providers offer a persistence based up on the MongoDB interfaces, e.g. Azure CosmosDB SQL-API. We do not support these third party abstraction layers and advise you to use a directly supported persistence layer instead.
Note: The authentication using <USERNAME>:<PASSWORD>
is optional. If the given <DATABASE>
does not exist, it will be created.
Note: The following versions of MongoDB are currently supported: 2.6
up to 4.0
.
Have a look at https://github.com/mongodb/mongo-java-driver for additional information
Note: You can use the ssl_ca_certs
parameter to add additional trusted root certificates.
Note: When using the MongoDB persistence in a docker container, please also define the environment property DEFAULT_CONFIG=System/Default
. A cloud-based persistence requires the configuration to be stored in a system scope.
Using the MongoDB persistence requires additional components to be installed into the plugins/persistence
subfolder of the installation. There are pre-made Docker containers in case of a containerized usage.
If the respective files do not yet exist, you have to download them from the public maven repository at:
The MongoDB driver package has to be extracted into the plugins/persistence
subfolder. The persistence main jar has to be saved into this directory without extracting it.
Note: You have to navigate and download the version matching your installation.
Note: In addition to the released version, there may be beta versions available: Persistence beta version, MongoDB beta version package
The following numbers will allow to get an insight on how much memory is required:
Component | Memory used | Comment |
---|---|---|
Configuration | 50KB | |
Event log | 50MB | Can be reduced in the confirmation settings |
User Metadata | 10K per User | mostly depends on the Avatar size |
User Data (uploaded files) | Size of compared documents x 3 (for result) | Depends on the quota |