Online Help

Installing the Audit Agent for E-mail Delivery

Updated in 2022.2

After you have created an E-mail Audit Source, you must perform the next steps: create an audit agent installer for Windows and macOS and install the audit agent on computers you want audited.

Creating an audit agent installer

To prepare the installable agent for an E-mail Audit Source:

  1. Open the properties window for the Audit Source:

    1. In the Sidebar, right-click the Site that contains this source, and select Properties from the pop-up menu.

    2. In the grid under Audit Sources, double-click the desired Audit Source. The properties window for this audit source opens.

  2. Make sure that all e-mail settings are specified as needed. When the agent is installed, it will use those settings to deliver audit snapshots.

  3. On the General tab, under Audit Agent Installer, view and optionally change the default schedules for the agents. The Windows Task Scheduler will use this schedule to run the agent. By default, the task will be scheduled to run the audit automatically every day at 12 AM.

  4. Click the Create Installer button under Windows Installer, select the audit agents (Windows and/or macOS) and specify where to save the installation package

  5. Click Save.

  6. Click OK to close the properties window for this Audit Source.

IMPORTANT: Any changes made in the Audit Profile or updated versions of the installable agents have to be manually re-deployed.

NOTE: You can customize the audit agent installer with additional post-processing actions using the PrepareAuditAgent.cmd. For details, see Customizing the audit agent installer.

Installing the Audit Agent

When the agent installer is created, deploy it to target computers.

In a Windows domain environment, we recommend you to use Group Policy to distribute the agent installer. If this does not work for you, it is possible to install the agent manually from a command line in the unattended mode:

msiexec /i AlloyAuditAgent.msi /qn

NOTE: By default, the Windows Task Scheduler starts the audit on time only if the network connection is available. Otherwise, the audit will be postponed until the connection is restored.

TIP: If the audit fails, the error details will be available in the audit log file (C:\ProgramData\Alloy Software\Audit Agent\Log).