Quick start guide for installing and configuring MongoDB and using the Node.js mongoose library.

Download Center

Simplify the path in the installer, I used C:\Program Files\MongoDB

Create the following dirs:

• C:\Program Files\MongoDB\data\db - to house the databases
• C:\Program Files\MongoDB\log - to house log files

Create a config file:

• C:\Program Files\MongoDB\mongo.cfg

To install as a service

mongod.exe --directoryperdb --dbpath "C:\Program Files\MongoDB\data\db" --logpath "C:\Program Files\MongoDB\log\mongo.log" --logappend --config "C:\Program Files\MongoDB\mongo.cfg" --rest --install

Enabling Authentication

To enable authorization, connect to server and add user to admin database

use admin
db.createUser({
    user: <username>,
    pwd: <plaintext password>,
    roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
    });

More Info on MongoDB Roles

In mongo.cfg (YAML), add the following:

security:
    authorization: enabled

Restart the MongoDB service

net stop MongoDB
net start MongoDB

Config File Options

Mongoose Docs

npm install --save mongoose

const mongoose = require('mongoose');

// Connect to db

// Pattern
//mongoose.connect('mongodb://<username>:<password>@host/<dbname>', {<options>});

// Example
mongoose.connect('mongodb://brycejech:myPassword@localhost/test', {useMongoClient: true, keepAlive: 1});
// Note that special chars in username/password should be URL percent-encoded

With Mongoose, everything is derived from a Schema. Schemas map to a collection and defines what documents in that collection look like. Each key in a Schema defines a property that will be cast to it's associated SchemaType.

SchemaTypes:

• String
• Number
• Date
• Buffer
• Boolean
• Mixed
• ObjectId
• Array

Example:

const Schema = mongoose.Schema;

let animalSchema = new Schema({
    // SchemaTypes that are not standard js types seem to be in Schema.Types
    id:         Schema.Types.ObjectId,
    name:       String,
    species:    String,
    actions:    [String], // Array of strings
    numLegs:    Number,
    isAlive:    Boolean,
    born:       Date
});

Note: In order to specify a collection when defining a schema, you must pass in an optional options object as the second argument with the collection name to the Schema constructor.

Example:

let animalSchema = new Schema({<schema object>}, {collection: 'animals'});

Alternatively, if your collection name is plural, i.e. 'animals', then you may indicate your collection name as the singular form of the word when converting your Schema to a Model, more on that later.

To use the Schema definition, we have to convert our Schema into a Model. Pass a model name and the schema to mongoose.model(modelName, schema);.

Example:

let animal = mongoose.model('animal', animalSchema);

Note: Mongoose will pluralize the model name and use that as the collection name unless you pass in the name when defining your schema like this: let animalSchema = new Schema({...}, {collection: 'animals'});. For example, if your collection name is animals, then you would create your model like this: let animal = mongoose.model('animal', animalSchema);, and mongoose will use 'animal' + 's', or animals as the collection name.

Instance of Models ARE documents.