KB No. 02: Deploying the Mail Agent via GPO

In this article, you will find detailed instructions on how to deploy the Mail Agent via GPO.

Background

Deployment via GPO allows you to remotely and easily deploy the Olfeo SaaS Agent on your organization's workstations and servers.

Prerequisites

You must pre-configure the Olfeo SaaS Mail Agent installer or have a script of your choice so that it can be deployed and installed with a predefined configuration. For this, you can refer to KB No. 11.

Note

The procedure below only applies to workstations running Windows 10 or higher.

Procedure

  • Create a shared folder with the following settings:
    • Share permission: "Everyone" with Full Control
    • NTFS permissions on the share folder: "Domain Computers" read-only
    • Share accessible via this path: \\SRV-ADDS-01\Applications$
  • Place the original Mail Agent .msi file in the share folder.
  • Open the Group Policy Management console.
  • Create a new GPO and name it (example: "deploy-agent-trustlane").
  • Edit the new GPO and navigate to the following location: Computer Configuration (or User Configuration) > Policies > Software Settings > Software Installation.
  • Right-click on "Software Installation" and create a New Package.
  • Specify the path to the original Mail Agent .msi file in the share folder.
  • Select the "advanced" mode.
  • In the tab Deployment :
    • select Assigned mode;
    • check the box "Install this application at logon";
    • Check "Basic" in Installation user interface options.
  • In the tab Changes : add the .mst file created earlier (see KB No. 11):
  • Click OK:
  • Link the GPO to an Organizational Unit affected by the deployment.

 

Caution

In some cases, the Agent systray may not start after installation in this deployment mode (desktop and user rights used by the "WAPT" user where the systray requires admin space). To avoid these side effects, plan to restart the workstation after installing the Agent.

Tags: Deployment, UC-02, Agent