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.0in 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: mmapv1YAMBAS 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 for Restore 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.