MongoDB Manual Configuration

Manually install MongoDB 4.4.3 (or higher) by following these steps:

1. Download MongoDB from here.

2. Create the Nintex-db database.

3. Create the Process Discovery Administrator and default users following one of the options below:

Option 1: Create users through running designated commands

Option 2: Install and configure Robo 3T to create database users

4. Add TLS configuration for MongoDB (optional).

Create the Nintex-db database

1. Create a new cluster of MongoDB with engine Version 4.0.0 and only one instance within the database subnet.

Make sure to activate encryption and audit logs

2. Connect to MongoDB.

You can use Robo 3T ({InstallFolder}\Nintex\SupportTools\mongodb-client-robo3t-1.4.1-windows-x86_64-122dbd9\robo3t-1.4.1-windows-x86_64-122dbd9\robo3t.exe to connect to MongoDB.

3. Create the databaseNintex-db.

4. Execute the following query on the MongoDB to create the users (or use Robo 3T to create users) :

   ```json
   use admin
   db.createUser(
   {
   user: "Nintex-admin",
   pwd: "<<new-password-for-mongodb>>",
   roles: [ "root" ]
   }
   )
   db.createUser(
   {
   user: "Nintex-rw",
   pwd: "<<new-password-for-mongodb>>",
   roles: [ { role : "readWrite", db: "Nintex-db"}]
   }
   )

Create users through running designated command

Run the following commands to create users:

1. To create a Process Discovery Administrator user run:

cd C:\Nintex\MongoDB\Server\4.4\bin
mongo
use admin
db.createUser( { user: "Nintex-admin", pwd: "Kryon2020!", roles: [ 'root'] } )

2. To create a Process Discovery default user run:

   cd C:\Nintex\MongoDB\Server\4.4\bin
   mongo
   use admin
   createUser({user: 'Nintex-rw', pwd: 'Kryon123!', roles: [ { role : 'readWrite', db: 'Nintex-db'}]})

Add TLS configuration for MongoDB (optional)

1. Copy the file rds-combined-ca-bundle.pem to C:\Nintex\config\prod\general\ssl\rds-combined-ca-bundle.pem (you might need to create the folder first).

2. Replace the content of the file C:\Nintex\config\prod\general\mongodb-connector-Nintex-db-r.json with the following and insert the domain:

```json
{
"name" : "mongodb-connector-Nintex-db-r",
"value" : {
"dbName" : "Nintex-db",
"url" : "mongodb://<<domain-of-cluster>>:27017/Kryon-db?authSource=admin&tls=true&tlsCAFile=rds-combined-ca-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false",
"debug" : true,
"options": {
"poolSize": 10,
"tls": true,
"tlsInsecure": false,
"tlsCAFile": "rds-combined-ca-bundle.pem",
"useNewUrlParser": true,
"sslValidate": true
}
}
}
```

3. Replace the content of the file C:\Nintex\config\prod\general\mongodb-connector-Nintex-db.json with the following and insert the password and the domain:

```json
{
"name": "mongodb-connector-Nintex",
"value": {
"description": "",
"dbName" : "Nintex-db",
"url": "mongodb://Kryon-rw:<<password>>@<<domain-of-cluster>>:27017/Kryon-db?authSource=admin&tls=true&tlsCAFile=rds-combined-ca-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false",
"debug": true,
"options": {
"poolSize": 10,
"tls": true,
"tlsInsecure": false,
"tlsCAFile": "rds-combined-ca-bundle.pem",
"useNewUrlParser": true,
"sslValidate": true
}
}
}
```

4. Replace the content of the file C:\Nintex\config\prod\general\mongodb-connector-Nintex-db-admin.json with the following and insert the password and the domain:

```json
{
"name": "mongodb-connector-Nintex",
"value": {
"description": "",
"dbName" : "admin",
"url": "mongodb://Kryon-admin:<<password>>@<<domain-of-cluster>>:27017/admin?authSource=admin&tls=true&tlsCAFile=rds-combined-ca-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false",
"debug": true,
"options": {
"poolSize": 10,
"tls": true,
"tlsInsecure": false,
"tlsCAFile": "rds-combined-ca-bundle.pem",
"useNewUrlParser": true,
"sslValidate": true
}
}
}
```

5. Open CMD and run:

```bat
cd C:\Nintex\PDServer\Support\Nintex-admin-cli
set CONFIG_DIR=C:\Nintex\config
set NODE_ENV=prod
set Nintex_ENC_CFG=C:\Nintex\config\prod\general\Nintex-decrypt.json
set NODE_PATH=C:\Nintex\PDServer\MicroServices\node_modules
node bin\cli.js --provider=mongodb --command=uploadCodex --collectionName=masking-codex --fileName=C:\Nintex\PDServer\MicroServices\AlgoNextGen\masking-private-codex.csv --tenantName=default
```

Install and configure Robo 3T to create database users

Robo 3T (Robomongo) is the free, lightweight, open-source MongoDB GUI with an embedded mongo shell.

1. Downland and install Robo 3T: Floating Content Panels.

   • Robo 3T is included in Process Discovery installation under ${InstallationFolder}\Nintex\SupportTools.

   • You can download Robo 3T also from here.

2. Open Robo 3T > Click on File > Click on Connect.

3. Click Create to create a new connection.

4. In the Connection tab, specify the MongoDB server FQDN and port.

EXAMPLE:



5. In the Authentication tab, Check the “Perform authentication” checkbox and specify the username and password.

EXAMPLE:



6. Make sure the details are accurate by clicking on Test.



7. Click Save.

8. Select the newly created connection and click Connect.