Database Issues

This section contains information on how to troubleshoot MongoDB database-related issues.

MongoDB Authentication

The StackStorm installation script automatically creates two new MongoDB users, stackstorm and admin. The user stackstorm is granted the readWrite role on the st2 database. The user admin is granted the dbAdmin role on the admin db.

The script generates a random password, and assigns it to both users. The password is stored in the [database] section of /etc/st2/st2.conf, e.g.:

username = stackstorm
password = ZXqvqSRejrY6gKO9wvYgJFdh

Here’s an example of using that username and password to authenticate using the Mongo CLI:

[vagrant@st2vagrant ~]$ mongo -u stackstorm -p ZXqvqSRejrY6gKO9wvYgJFdh st2
MongoDB shell version: 3.2.16
connecting to: st2