Configuring the agent by using the silent response file

When you install the Microsoft Office 365 agent, the agent must be configured and started manually after providing the configuration settings. Use the silent response file to configure the custom settings.

Before you begin

Edit the response file to modify the following default configuration settings:
KMO_USER_NAME
The user name of the Office 365 global administrator.
KMO_PASSWORD
The password of the Office 365 global administrator.
KMO_MAIL_ADDRESSES1
A list of email addresses to be targeted for verifying mailbox reachability. The list of email addresses must be delimited using semicolons.
KMO_DATA_COLLECTION_DURATION
The duration (in hours) for which the agent waits before fetching the mailbox and OneDrive usage data.
The response file is available at the following location:
<CANDLEHOME>\samples

About this task

You can configure the agent when the agent is running or stopped. The agent remains in the same state after configuration. For example, if the agent is running, it remains in the running state after configuration.

Procedure

To configure the Microsoft Office 365 agent, complete the following steps:

  1. On the command prompt, change the path to the directory that contains the microsoft_office365-agent.bat file.
  2. Enter the following command: microsoft_office365-agent.bat absolute path to the response file.

    The response file contains the following parameters:

  3. If the agent is in the stopped state, start the agent.

What to do next

  • Change the user account from the local user to the domain user. For details, see Changing the user account.
  • Log in to the Cloud APM console to view the data that is collected by the agent in the dashboards. For information about using the Cloud APM console, see Starting the Cloud APM console.

  • For help with troubleshooting, see the Troubleshooting section.