Back to blog

How to Deploy the Quadrotech On-Premises Agent

12 Oct 2017 by emma.robinson

One of the latest additions to Radar Reporting is reporting for on-premises mailboxes.Data for mailboxes located on-premises and in Exchange Online can now be viewed side by side, which means that the reports can be used to track migration progress, or get a better understanding of a hybrid environment. In order to gather reporting data for on-premises mailboxes, you will have to install an agent. Are you a Radar Reporting subscriber with on-premises mailboxes that you would like to report on? Here’s how to get set up.

Prerequisites
Before installing the agent, make sure .Net 4.6.2 is installed on the Windows Server where the On-Premises agent will be installed.

The agent should be installed on a Windows server, the following versions are currently supported; Windows Server 2012, Windows Server 2012 R2 & Windows Server 2016.

You will also need:

  • A local service account with “Run as a service” rights. This account will be used to start the agent service. See “Creating a local service account”
  • A domain user account with “View-Only administrator” rights to the exchange environment you wish to report on. This account will be used to access your exchange environment. See “Creating an Exchange access account”

Supported Exchange versions

  • Exchange 2010
  • Exchange 2013
  • Exchange 2016

Installation

In order for on-premises data to be collected for Radar Reporting you will need to deploy an agent to a Windows Server. It is NOT recommended to install this on the Exchange Server itself.  The Windows Server should be in the same domain, or be able to contact your exchange environment via PowerShell.

During the installation process, you will be required to enter the following information:

  • Local service account username & password
  • Exchange access account username & password
  • IP address of your Exchange Server
  • Agent ID
  • Agent AUTH Token

The Agent ID & AUTH Token will be supplied from the Radar Reporting site during the installation process.

Download and Install the On-Premises agent

1. Log into your Radar Reporting account.

2. From the left-hand menu select Profile and Settings > On-Premises

3. Click the Download agent button

4. Copy the installation file to your Windows Server and double-click to install

5. On the Welcome page – Click Next

6. Check through the Terms & Conditions, then click Next

7. Token Verification – Copy the Agent Id & AUTH Token from the On-Premises Settings page in Radar Reporting. You can obtain this by clicking Add New Agent and pasting the data into the agent installer. Click Verify and Next.

8. Paths – Accept or modify the installation paths as desired, and click Install

9. Once the installation has completed you must enable the agent through the Profile & Settings page in the Radar portal so that the Status is showing as Online.Configuring the agent for access to Exchange

10. Once the agent has been enabled, the next stage is to set the Exchange access account in the Credential Editor.

11. Navigate to C:\Program Files\Quadrotech\OnPremises\Reporting\Credential Editor

12. Press SHIFT and right-click ADAM.Credentialeditor.exe and click Run as a different user.

13. Click Add and enter the following details into the field.

Name: ex1

Account: Exchange service account that has “View-Only Administrative” access to your exchange environment. See Prerequisites

Password: Password for the above account

Tag 1: IP Address of your Exchange Server 14. Click OK, then SAVE, and restart the Windows service Quadrotech On-Premises Reporting Agent

Creating a local service account.
The local service account is required for the agent to log in to the local system and run as a service. To do this:

  1. Log onto the local machine and create a new user.
  2. Once you have the account created, you must grant it access to “Log on as a service”.
  3. Next, follow the instructions in this article, https://technet.microsoft.com/en-gb/library/cc794944(v=ws.10).aspx

Creating an Exchange access account

The Exchange access account is used by the agent to pull information from your exchange environment. This should be a domain user account that MUST be a member of Exchange View-Only Administrators.

This article explains how to create a user account in your domain. https://technet.microsoft.com/en-us/library/dd894463(v=ws.10).aspx

Once this process has been completed, we will have everything we need to gather information on your on-premises mailboxes. If you have any questions, or trouble configuring the agent, please contact our support team, by clicking the ‘?’ Icon in the top-right of the application.