Prerequisites

• DC/OS installed on your cluster.

Steps

1. Generate and save 4 x random passwords for the system-level MongoDB users (backup, userAdmin, clusterAdmin and clusterMonitor), using the openssl tool:

   $ openssl rand -base64 8
   sLWGYC0yAIU=
   $ openssl rand -base64 8
   7Spl1m2bgo0=
   $ openssl rand -base64 8
   DH1UXPVrKyA=
   $ openssl rand -base64 8
   rtJx/fcJSIk=
   

2. Generate and save a 1023-length key for MongoDB using the openssl tool:

   $ openssl rand -base64 756
   

3. Install and configure percona-server-mongodb from the DC/OS web interface by adding the 4 x generated passwords and key to the required fields of the Mongodb Credentials section of the service config.

4. The service will now deploy with a default configuration. You can monitor its deployment via the Services tab of the DC/OS web interface.

5. Gather the dns names of the member nodes.

   $ dcos percona-server-mongodb endpoints mongo-port
       {
         "address": [
           "10.0.3.53:27017",
           "10.0.3.159:27017",
           "10.0.1.211:27017"
         ],
         "dns": [
           "mongo-rs-0-mongod.percona-server-mongodb.autoip.dcos.thisdcos.directory:27017",
           "mongo-rs-1-mongod.percona-server-mongodb.autoip.dcos.thisdcos.directory:27017",
           "mongo-rs-2-mongod.percona-server-mongodb.autoip.dcos.thisdcos.directory:27017"
         ]
       }
   

6. Connect to MongoDB and add a non-admin user using the mongo shell tool and the userAdmin user (replace username/password for your situation).

   $ mongo mongodb://useradmin:useradminpassword@mongo-rs-0-mongod.percona-server-mongodb.autoip.dcos.thisdcos.directory,mongo-rs-1-mongod.percona-server-mongodb.autoip.dcos.thisdcos.directory,mongo-rs-2-mongod.percona-server-mongodb.autoip.dcos.thisdcos.directory:27017/admin?replicaSet=rs
   > use admin;
   > db.createUser({
         user: "myApp",
         pwd: "myAppPasswd123456",
         roles: [
             { db: "myApp", role: "readWrite" }
         ]
     });
   > quit()
   

   You can also add a MongoDB user using the DC/OS CLI and a .json file describing the MongoDB user:

   $ cat <<EOF >myApp.json
   {
      "user": "myApp",
      "pwd": "myAppPasswd123456",
      "roles": [
          { "db": "myApp", "role": "readWrite" }
      ]
   }
   EOF
   $ dcos percona-server-mongodb user add admin myApp.json
   

7. Reconnect using your new application-level user myApp.

   $ mongo mongodb://myApp:myAppPasswd123456@mongo-rs-0-mongod.percona-server-mongodb.autoip.dcos.thisdcos.directory,mongo-rs-1-mongod.percona-server-mongodb.autoip.dcos.thisdcos.directory,mongo-rs-2-mongod.percona-server-mongodb.autoip.dcos.thisdcos.directory:27017/admin?replicaSet=rs
   

8. Change to MongoDB database myApp and write a document to the collection test.

   > use myApp;
   > db.test.insert({ message: "This is a test!" });
   WriteResult({ "nInserted" : 1 })
   >
   

9. Read all documents from collection test.

   > db.test.find()
   { "_id" : ObjectId("5ab8fa034af828c184b57616"), "message" : "this is a test!" }
   

10. Get the number of documents for collection test.

    > db.test.count()
    1
    

11. Drop/delete the collection test.

    NOTE: Drops/deletes cannot be undone. Always back up important data before dropping it.

    > db.test.drop()
    true
    

See Also

• Connecting clients