

Note: Relativity no longer supports Service Bus for Windows. RabbitMQ is now the only the message broker option available for use with Relativity.
The Relativity Service Bus is a message delivery service that communicates information about agent jobs to different application components. This infrastructure feature supports this communication by routing messages between application components. For example, Relativity uses the service bus for submitting conversion jobs to agents and returning converted documents.
Note: Before installing or upgrading, you must install and configure your environment’s message broker. Next, install or upgrade your primary SQL Server and the Relativity Service Bus.
The Relativity Service Bus supports the following features:
The Relativity Service Bus is built on your environment’s message broker, so it leverages the capabilities offered by these industry-standard software. You must install it on a node in your environment’s message broker. The Relativity installer updates the Instance setting table on your primary SQL Server with information about the location of the Relativity Service Bus that you provide during installation. It updates the following instance settings:
Table section | Relativity.ServiceBus |
Value | localhost |
Description | Specifies the fully-qualified domain name for the machine hosting your Relativity Service Bus provider. The Relativity installer automatically sets this value during an installation or upgrade based on the inputs in the RelativityResponse.txt file. Note: The value for this setting should match the FarmDNS output from the Get-SBFarm command available in the Service Bus PowerShell utility. For more information, see . Note: When using RabbitMQ, Relativity also supports the IP address for the Server or cluster. |
Table section | Relativity.ServiceBus |
Value | Relativity |
Description |
RabbitMQ - the virtual host to be used by Relativity Service Bus |
Table section | Relativity.ServiceBus |
Value | Default value varies by environment. |
Description |
RabbitMQ - Specifies the value of the Relativity RabbitMQ user’s password used when authenticating. |
Table Section | Relativity.ServiceBus |
Value | Relativity |
Description |
RabbitMQ - Specifies Relativity RabbitMQ username used when authenticating. |
Table Section | Relativity.ServiceBus |
Value | RabbitMQ |
Description |
Specifies the message broker that Relativity will use for Service Bus messaging. RabbitMQ is the only acceptable value here. |
Table Section | Relativity.ServiceBus |
Value | False |
Description |
Only used for RabbitMQ. Specifies whether or not client connections to RabbitMQ should use TLS. Note: If set to True, your RabbitMQ server or cluster must be configured for TLS. |
The web and agent servers request information about the location of the Relativity Service Bus from the primary SQL Server. The Relativity Service Bus then facilitates communication between application components by sending and receiving messages. A typical Relativity installation requires only one message broker server. You can optionally configure your environment to have multiple servers. This can be accomplished by leveraging a RabbitMQ cluster. The following diagram illustrates how the Relativity Service Bus integrates with your environment's infrastructure in a typical installation.
To install the Relativity Service Bus, you must first install and configure your environment’s message broker. You next run the Relativity installer to add the Relativity Service Bus to your environment and complete other related tasks. The following diagram illustrates the installation process for a typical Relativity installation for service bus. You can optionally install your environment’s message broker on multiple hosts.
Use the following workflow to install the Relativity Service Bus in your environment:
Note: For general troubleshooting information, see Troubleshooting RabbitMQ.
Why was this not helpful?
Check one that applies.
Thank you for your feedback.
Want to tell us more?
Great!