Use an existing MongoDB installation

Follow this process if you wish to use an existing MongoDB server with TeamForge Orchestrate

This article provides alternate installation instructions if you wish to use an existing MongoDB server with TeamForge Orchestrate. Follow the installation instructions in Installation walk-through until it refers you to this article. After following instructions here, continue with Installation walk-through, picking up with the RabbitMQ section

Install MongoDB or use an existing installation
```
> Do you have an existing MongoDB system you would like to use? [No]:
```
The following steps assume you answer "Yes". If your answer is "No", skip these steps and refer to the primary installation guide: Installation walk-through.
Determine whether your MongoDB is clustered
```
> Is your MongoDB clustered (replset) [No]:
```
Answer Yes here if your MongoDB database is using sharding, which distributes a single logical database system across a cluster of machines. Answer "No" here if your MongDB runs on a single machine.
1. If your MongoDB is clustered, provide hosts
```
> What are the hostnames and ports for your Mongo cluster nodes (comma-separated):
```
  Enter the server and port for each MongDB server in your cluster.
  mongo1.example.com:27017,mongo2.example.com:27017
2. If your MongoDB is a single host, provide hostname
```
> What is the hostname for your mongo server [localhost]:
```
  Enter the name of the server where your existing MongoDB server is currently running.
3. If your MongoDB is a single host, provide port number
```
> What port is MongoDB running on [27017]:
```
  Enter the port being used by your existing MongoDB server. The default here is the standard port used by MongoDB.
Provide a database name for TeamForge Orchestrate use
```
> What is the name of the database you wish to use [orchestrate]:
```
Enter the name of the database to use. This name must be unique within your existing MongoDB server; use a name that is currently unused.
Provide a MongoDB user for accessing the TeamForge Orchestrate database
```
> What username should we use to connect to this database [collabnet-mongodb]:
```
Enter a username to use when Orchestrate makes connections to the database server.
1. If this user does not currently exist you need to create this user for the specified database. Here are the steps to add the user to your existing MongoDB:
  - connect to your MongDB server using the mongo shell as an admin user that can create databases and users
  - run the following command:
    db.getSiblingDB('MONGODB_ORCHESTRATE_DB_NAME').addUser({user: 'USER', pwd: 'PASS', roles: ['readWrite', 'dbAdmin']})
  - replace MONGODB_ORCHESTRATE_DB_NAME with the database name you specified for the database in the previous installer question
  - replace USER with the username you chose in the previous installer question
  - replace PASS with the password you chose in the previous installer question
Continue with Installation walk-through, picking up with the RabbitMQ section.