. . .

Configure MongoDB

MongoDB is not included in our installation package and must be installed separately. Follow the instructions for Linux or Windows from MongoDB directly.

Supported versions

Please find our supported MongoDB versions in the infrastructure requirements.

BindIP

Starting with version 3.6, running MongoDB on other servers requires the BindIP to be set up properly. If you e.g. want access to the MongoDB host from all computers, you have to set up

net:
bindIp: 0.0.0.0

in mongod.conf. https://docs.mongodb.com/manual/release-notes/3.6-compatibility/#localhost-binding-compatibility-changes

Storage Engine

Since version 3.2, MongoDB uses a new storage engine "Wired Tiger" as default. This engine improves speed during parallel changes, but decreases speed on structural changes. That is, if you are running a unit test environment or you plan to create many applications and data model changes, the previous engine "MMAPv1" will be faster.

Also, take a look a the documentation at the MongoDB website.

Storage engine can be switched in the mongodb config file (to use Wired Tiger simply remove the "engine" line):

storage:
engine: mmapv1

YAMBAS Config

The yambas.conf/apiomat.yaml file takes several arguments to setup the mongo connection:

yambas.conf Key

apiomat.yaml Key

Description

Default

mongodbHostsLIVE

yambas.mongodb.hosts.live

comma separated list of mongo nodes for LIVE system (URL with port separated by colon)

localhost:27017

mongodbHostsSTAGING

yambas.mongodb.hosts.staging

comma separated list of mongo nodes for STAGING system (URL with port separated by colon)

localhost:27017

mongodbHostsTEST

yambas.mongodb.hosts.test

comma separated list of mongo nodes for TEST system (URL with port separated by colon)

localhost:27017

mongodbHosts

yambas.mongodb.hosts

comma separated list of mongo nodes for all systems (URL with port separated by colon)

localhost:27017

mongodbConnections

yambas.mongodb.connections

Number of connections of this YAMBAS node to the master DB; only change if you know what you are doing!

100

mongoDumpPath

yambas.mongodb.dumpPath

Directory where to store DB dumps for Restore Module

mongoBinPath

yambas.mongodb.binPath

Binary of mongo client forRestore Module

mongoUseSSL

yambas.mongodb.useSsl

indicates whether to use ssl for the connection to the mongodb

false

Starting with 1.15.7, YAMBAS offers the possibility to set up different node sets per system. If you need this feature, define the mongodbHosts{LIVE,STAGING,TEST} rather using a single mongodbHosts.

As of Yambas 2.6.5 it is possible to enable an SSL/TLS encrypted connection between the MongoDB and Yambas. Note that the CA-Certificate that signed the certificate of the connection has to be part of the cacerts java keystore which is used to run Yambas. Be sure that the CA certificate is imported there.