How to add an Exchange agent (4370480)

How to add an Exchange agent

The Exchange Environment dashboard | Administration tab allows you to deploy the Exchange agent package, create Exchange agent instances for one or more servers at a time, activate or deactivate Exchange agents, and start and stop collecting data.


 

The Agent Setup wizard guides you through the process of adding and configuring Exchange agent instances on one or more servers.

To add and configure a new agent:

1. At the top of the Agent Management view, click Add to launch the Agent Setup wizard.

2. On the Prepare page, carefully read the instructions about the steps that you need to take before proceeding with the wizard. You can either manually configure your Exchange environment for monitoring, or download and run a script that automatically configures the Exchange servers. To download the script, click Script for configuring the Exchange settings.

When done, click Next.

3. On the Auto-Discovery or Manual page, indicate if you want to manually configure an agent to monitor a single Exchange server, or search your domain and auto-discover Exchange servers and create one or several agents. Click Next.

• If you selected Auto-discover, continue with Step 4.
• If you selected Manual, continue with Step 6.

4 On the Select the Search Domain page, specify the domain to be used to search for Exchange servers where Exchange agent instances are to be created and activated.

• Domain: Type the fully qualified name (myDomain.com) of a domain to search for Exchange servers.
• User Name: Type the user principal name of the account to be used to query Active Directory® on the selected domain.The following formats are accepted for the user principal name: myUser@myDomain.com, myUser, and myDomain.com\myUser.
• User Password: Enter the password associated with the above user account.
• Enable SSL For LDAP: Selecting this check box if security LDAP is required.

Click Next.
 
5. On the Select Servers page, select one or more Exchange servers that you want to monitor
This page displays the following information about the Exchange servers found on the selected domain:

• Exchange Server: The name of the Exchange server found on the selected domain.
• Exchange Agent Exists: Indicates whether an Exchange agent instance has already been created for an Exchange server. A green check mark in this check box indicates that an agent instance is already created to monitor the Exchange server. Servers already monitored by other Exchange agents are unavailable for selection in the list.

Click Next.

6. On the Configure Agent Properties page, review the Exchange agent properties, and edit them, as necessary.

• Exchange Server(s): The name of one or more Exchange servers found on the selected domain.
• Domain Controller: The name of the domain controller found on the selected domain.
• Communication Protocol: Selects to run the WMI query through DCOM or WinRM.
• WinRM Port: The WinRM port number on the monitored server. This property only appears if the Communication Protocol is set to WinRM through HTTP or WinRM through HTTPS.
• NOTE:
• 1. When setting Communication Protocol as WinRM through HTTPs, import the root certificate of the monitoring domain into FglAM keystore.
• 2. Ensure that the Subject Alternative Name of the certificate used by LDAP service includes both server FQDN and Domain name.
• LDAP Authentication Mechanism: The authentication scheme used to connect to the LDAP server: Simple (default) or Kerberos.
• Enable SSL For LDAP: Indicates if the LDAP connection is secure or not (default)

• Is a Virtual Host?: Indicates if the selected Exchange server runs on a virtual host. If it runs on a physical host, by default the Windows Agent is delegated to collect host metrics
• Virtual Environment: The type of the virtual environment: VMware or Hyper-V. This property only appears if the selected Exchange server runs on a virtual host.
• Enable ActiveSync Collection: Indicates if the collection of ActiveSync Top N users is disabled or enabled.
• IIS Log Folder: The file path to the IIS log on the Exchange Client Access Server.
• ActiveSync Collection Time: The time when the ActiveSync collection task starts.
• Top N Users: The number of top N users for which data is submitted to the Management Server.

Click Next.

7. On the Select the Agent Manager Host page, select the Foglight Agent Manager host to be used for the new Exchange agent instances. The table displays the following Foglight Agent Manager information (the same information is displayed on the Administration | Agents | Agent Hosts dashboard):

• Host Name
• Agent Manager Version
• OS Type
• OS Architecture
• The Exchange Agent Package Deployed column indicates whether the Exchange agent package is already deployed to the Agent Manager host(s). A green check in this column indicates that the Exchange agent package has been deployed.

• The Windows Agent Package Deployed column indicates whether the Windows agent package is already deployed to the Agent Manager host(s). A green check in this column indicates that the Windows agent package has been deployed. This column is displayed only if the Exchange server runs on a physical host.

Click Next.

8. On the Assign and Validate Credentials page, review the available credentials, and edit them, as necessary.

• To create a new credential, click Add host(s) to a new credential.
  • In the Create New Credential and Assign dialog box, create a credential that you want to use to access the monitored resource. Type a new credential name, domain, user name, password, and lockbox, and click Submit.
• To select an existing credential, click Add host(s) to an existing credential.
  • In the Select Existing Credential dialog box, select an existing credential, and click Submit.
• To bypass the prerequisites verification, select the Do not check for prerequisites check box.

Click Next.

9. On the Summary page, review the configuration settings chosen for the new agent, and its prerequisite diagnostics, including:

• Exchange Agent: The name of the selected Exchange agent instance.
• Windows Agent: The name of the selected Windows agent instance.
• Diagnostic Result:

• Success: The agent instance can connect to the monitored Exchange server and collect data.
• Error: The agent instance cannot connect to the monitored Exchange server instance and collect data. Click this link to find out what causes this error. Carefully review the information in the popup that appears in order address the problem.

Click Finish.

The Agent Setup wizard closes. The Exchange agent is now added and configured, and appears in the Agent Management view, on the Administration tab.