Use an existing RabbitMQ installation

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

This article provides alternate installation instructions if you wish to use an existing RabbitMQ 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 the configuration section.

Install RabbitMQ or use an existing installation
```
> Do you have an existing RabbitMQ 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.
Provide a RabbitMQ hostname
```
> What is your RabbitMQ host [localhost]:
```
Enter the hostname of your existing RabbitMQ server.
Provide a RabbitMQ port number
```
> What port is RabbitMQ running on [5672]:
```
Enter the port being used by your existing RabbitMQ server. The default here is the standard port used by RabbitMQ.
Provide a RabbitMQ vhost
```
> What is your RabbitMQ vhost [/]:
```
Enter the desired vhost on your existing RabbitMQ server. The default here is the standard vhost used by RabbitMQ.
Provide a RabbitMQ username for use by Orchestrate to communicate with adapters:
```
> Provide a RabbitMQ username Orchestrate should use to communicate with adapters [guest]:
```
Enter the RabbitMQ username that Orchestrate should use to read and write information to and from Orchestrate related queues.

To setup a new RabbitMQ user with proper permissions:

sudo PATH_TO_RABBIT_CTL/rabbitmqctl add_user USERNAME PASSWORD sudo PATH_TO_RABBIT_CTL/rabbitmqctl set_permissions -p VHOST USERNAME "^orchestrate.*" "^orchestrate.*|amq.default" "^orchestrate.*|amq.default"

where PATH_TO_RABBIT_CTL , VHOST, USERNAME and PASSWORD should be replaced by your actual values.
Provide associated RabbitMQ password
```
> What is the password for this user? [guest]:
```
Enter the password for the user specified in the previous installer question.
Provide a RabbitMQ username with permission to create new users with write access
```
> Provide a RabbitMQ username that has permission to create new RabbitMQ users with write access to Orchestrate queues:
```
Supply a username that has permissions to create new users that have write access to Orchestrate queues. When creating data sources, TeamForge Orchestrate creates RabbitMQ users that have permissions to put data onto Orchestrate related queues. Creating RabbitMQ credentials on demand simplifies the process of disseminating queue credentials to users setting up adapters.

To setup a new RabbitMQ user with proper permissions:

sudo PATH_TO_RABBIT_CTL/rabbitmqctl add_user USERNAME PASSWORD sudo PATH_TO_RABBIT_CTL/rabbitmqctl set_user_tags USERNAME administrator

where PATH_TO_RABBIT_CTL , VHOST, USERNAME and PASSWORD should be replaced by your actual values.
Provide associated RabbitMQ password
```
> What is the password for this user?:
```
Enter the password for the user specified in the previous installer question.
Continue with Installation walk-through, picking up with the configuration section.