How to set up MongoDB for Demo

Last update: April 24, 2024

CREATED FOR:

  • Admin

Introduction

This tutorial describes how to set up MSRP for one author instance and one publish instance.

With this setup, the community content is accessible from both author and publish environments without needing to forward or reverse replicate user-generated content (UGC).

This configuration is suitable for non-production environments such as for development and/or demonstration.

A production environment should:

  • Run MongoDB with a replica set
  • Use SolrCloud
  • Contain multiple publisher instances

MongoDB

Install MongoDB

  • Download MongoDB from https://www.mongodb.com/

    • Choice of OS:

      • Linux®
      • Mac 10.8
      • Windows 7

    • Choice of version:

      • At a minimum, use version 2.6

  • Basic configuration

    • Follow the MongoDB install instructions.

    • Configure for mongod:

      • No need to configure mongos or sharding.

    • The installed MongoDB folder is called <mongo-install>.

    • The defined data directory path is called <mongo-dbpath>.

  • MongoDB may run on same host as AEM or run remotely.

Start MongoDB

  • <mongo-install>/bin/mongod --dbpath <mongo-dbpath>

This starts a MongoDB server using default port 27017.

  • For Mac, increase ulimit with start arg ‘ulimit -n 2048’
NOTE
If MongoDB is started after AEM, restart all AEM instances so they properly connect to MongoDB.

Demo Production Option: Setup MongoDB Replica Set

The following commands are an example of setting up a replica set with 3 nodes on localhost:

  • bin/mongod --port 27017 --dbpath data --replSet rs0&

  • bin/mongo

    • cfg = {"_id": "rs0","version": 1,"members": [{"_id": 0,"host": "127.0.0.1:27017"}]}
    • rs.initiate(cfg)

  • bin/mongod --port 27018 --dbpath data1 --replSet rs0&

  • bin/mongod --port 27019 --dbpath data2 --replSet rs0&

  • bin/mongo

    • rs.add("127.0.0.1:27018")
    • rs.add("127.0.0.1:27019")
    • rs.status()

Solr

Install Solr

  • Download Solr from Apache Lucene:

    • Suitable for any OS.
    • Solr version 7.0.
    • Solr requires Java™ 1.7 or greater.

  • Basic configuration

    • Follow ‘example’ Solr setup.
    • No service is needed.
    • The installed Solr folder is called <solr-install>.