README

PERCONA SERVER FOR MONGODB README

Welcome to Percona Server for MongoDB!

Percona Server for MongoDB is a free, enhanced, fully compatible, open source, drop-in replacement for MongoDB Community Edition with enterprise-grade features. It requires no changes to MongoDB applications or code.

COMPONENTS

  - mongod - The database server.
  - mongos - Sharding router.
  - mongo  - The database shell (uses interactive javascript).
  - tools
    - bsondump
    - mongodump
    - mongorestore
    - mongoexport
    - mongostat
    - perconadecrypt

DOCUMENTATION

- Percona Server for MongoDB Documentation
     https://www.percona.com/doc/percona-server-for-mongodb/LATEST/index.html

- MongoDB Manual
     https://docs.mongodb.com/manual/

INSTALLATION

   Go to https://www.percona.com/doc/percona-server-for-mongodb/LATEST/install/index.html and navigate to the required installation instructions.


RUNNING

  For command line options invoke:

    $ ./mongod --help

  To run a single server database:

    $ sudo mkdir -p /data/db
    $ ./mongod
    $
    $ # The mongo javascript shell connects to localhost and test database by default:
    $ ./mongo
    > help

DRIVERS

  Client drivers for most programming languages are available at
  https://docs.mongodb.com/manual/applications/drivers/. Use the shell
  ("mongo") for administrative tasks.

PACKAGING

  Packages for Percona Server for MongoDB are created by Percona team and are available at Percona website: 
    https://www.percona.com/downloads/percona-server-mongodb-LATEST/.

COMMUNITY

 Find answers to MongoDB-related questions on Percona Server for MongoDB Forum: 
    https://forums.percona.com/categories/percona-server-for-mongodb.

 Get insights about MongoDB from experts in the industry on Percona Database Performance Blog:
    https://www.percona.com/blog/category/mongodb/.

SUBMITTING BUG REPORTS OR FEATURE REQUESTS

If you find a bug in Percona Server for MongoDB, you can submit a report to the Percona JIRA for Percona Server for MongoDB:
    https://jira.percona.com/projects/PSMDB

Start by searching the open tickets in Percona's JIRA (https://jira.percona.com/projects/PSMDB) or MongoDB's Jira (https://jira.mongodb.org/) for a similar report. If you find that someone else has already reported your problem, then you can upvote that report to increase its visibility.

If there is no existing report, submit a report following these steps:

1. Sign in to JIRA issue tracker. You will need to create an account if you do not have one.
2. In the Summary, Description, Steps To Reproduce, Affects Version fields describe the problem you have detected.
3. As a general rule of thumb, try to create bug reports that are:
    * Reproducible: describe the steps to reproduce the problem.
    * Specific: include the version of Percona Server for MongoDB, your environment, and so on.
    * Unique: check if there already exists a JIRA ticket to describe the problem.
    * Scoped to a Single Bug: only report one bug in one JIRA ticket.

LICENSE

   Percona Server for MongoDB is source-available software.