This page contains information on installing and configuring MongoDB to be used with step.

Supported version

We do support MongoDB version starting from 4.0.x up to 5.0.x.

Installation

Follow instructions at : MongoDB documentation

Configuration

If you want to tune your MongoDB instance, you will find all necessary information on the official website at : MongoDB configuration and maintenance.

Activate authentication (optional)

For activating the authentication between the controller and the MongoDB server, the following actions have to be taken:

• Start the MongoDB server without authentication (use the --noauth option upon startup)
• Create your user on the step database:
  

  use step;
  db.createUser({ user: "[myUser]", pwd: "[myPassword]", roles: [{ role: "dbOwner", db: "step"}]})

• Restart the MongoDB server with authentication enabled (add the --auth option to the startup script)
• Add the following properties to the …/conf/step.properties file:
  

  db.username=[myUser]
  db.password=[myPassword]

Installation as a Service (optional, Windows only)

In order to install MongoDB as a Windows service, follow below steps :

• download nssm at https://nssm.cc/download
• open a new command prompt as Administrator and navigate to the nssm executable location
• execute the following command :

nssm install

• nssm GUI will open, you can now specify the “startMongo.bat” location (usually located into the Controller bin folder) and the service name, then click on “Install service” :

• You should then be prompted that the service installation has been successful :

• you can double-check into Windows service list that the service has been properly installed and then you can start it :