[KB6864] Deploy the ESET Management Agent using a Group Policy Object (GPO)

Issue

Solution

Deploy the ESET Management Agent using GPO

Prerequisites

Before you proceed, make sure you have your ESET PROTECT or Server configured with network visibility to client machines. Your server machine and client computers need to be joined to a domain.

Perform these steps on the Domain Controller:

  1. Create the install_config.ini configuration script. It contains the parameters for the Agent to communicate with your ESET PROTECT / ESMC Server.

    1. Open the ESMC Web Console or

      Open the ESET PROTECT Web Console in your web browser and log in.

    2. Click InstallersCreate Installer → GPO or SCCM script.
Figure 1-1
Click the image to view larger in new window
    1. Follow the script creation wizard and save the install_config.ini.

  1. Download the ESET Management Agent installer .msi file from the ESET download page:

  1. Save the Agent installer .msi file and the install_config.ini file to a shared folder on the domain controller so that all of your client computers can access it with read and execute permissions.

  2. Install Microsoft Group Policy Management Console (GPMC) on your Domain Controller server.

  3. Open Server Manager, click ManageAdd Roles and Features.
Figure 1-2
Click the image to view larger in new window
  1. Follow the wizard and in Add Roles and Features select the check box next to Group Policy Management. Click Next and Install.
Figure 1-3
Click the image to view larger in new window
  1. To open Group Policy Management, press the Windows key + R, type gpmc.msc and click OK.

  2. Create a new Group Policy Object (GPO) to deploy the ESET Management Agents. Right-click Group Policy Objects and select New. Type a name in the Name field, for example, Agent deployment, and click OK.

Figure 1-4
Click the image to view larger in new window
  1. Right-click Agent deployment GPO and click Edit.

Figure 1-5
Click the image to view larger in new window
  1. In the Computer Configuration section, expand Policies Administrative Templates: Policy definitions (ADMX files) retrieved from the local computerSystem and click Logon. On the right side of the window, double-click Always wait for the network at computer startup and logon. In the dialog window, select Enabled and click OK.

Figure 1-6
Click the image to view larger in new window
  1. Click Group Policy and on the right side of the window, double-click Specify startup policy processing wait time. In the dialog window, select Enabled and ensure that the Amount of time to wait (in seconds) is set to 120. You can set a different time to wait, but we recommend setting at least 30 seconds. Click OK.

Figure 1-7
Click the image to view larger in new window
  1. Right-click the domain and select Link an Existing GPO.
Figure 1-8
Click the image to view larger in new window
  1. Select the GPO that you created and click OK.
Figure 1-9
  1. Right-click the linked GPO and click Edit to edit the GPO in Group Policy Management Editor
Figure 1-10
Click the image to view larger in new window
  1. Expand Computer ConfigurationPolicies Software settings. Right-click Software installation, select New Package.
Figure 1-11
Click the image to view larger in new window
  1. Navigate to the location where the ESET Management Agent installer .msi is saved. Type the full Universal Naming Convention (UNC) path of the shared installer package (for example, \\fileserver\share\filename.msi) and click Open.

If you are deploying to 64-bit and 32-bit clients, repeat this step for both installer packages (Agent_x64.msi and Agent_x32.msi) and then follow the steps in Deploy ESET Management Agents to both 32-bit and 64 bit systems below.

Figure 1-12
Deploy ESET Management Agents to both 32-bit and 64-bit systems

To deploy ESET Management Agents to both 32-bit and 64-bit systems, add the 64-bit and 32-bit .msi files to the shared folder.

In Advanced settings for the 32-bit.msi file, deselect the check box next to Make this 32-bit X86 application available to Win64 machines.

Figure 1-13
Click the image to view larger in new window
  1. Select Assigned and click OK.
Figure 1-14
  1. The package is displayed in the Group Policy Management Editor.
Figure 1-15
Click the image to view larger in new window
 
  1. Close the Group Policy Management Editor window. In the left tree of Group Policy Management window, select the GPO you created. In the Security Filtering section, select Authenticated Users, click Remove and OK.
Figure 1-16
Click the image to view larger in new window
  1. Assign GPO to client computers:
    • Assign GPO to all Domain computers: Click Add → type domain computers and click OK.
Figure 1-17
Click the image to view larger in new window
    • Alternatively, you can assign GPO to the selected computers only: Click Add Object Types → select the check box next to Computers and click OK. Type the name of the computer and click OK. You can add more computers by repeating this step.
Figure 1-18
Click the image to view larger in new window
  1. GPO is now assigned to the selected computers. When the GPO updates, the computers will receive it and ESET Management Agent will be installed.
Figure 1-19
Click the image to view larger in new window

See the Microsoft Knowledgebase instructions on how to use Group Policy to remotely install software in Windows Server 2008 (and later).


Update the ESET Management Agent using GPO

Keep the original installation files.

Do not replace or delete the original files used for ESET Management Agent Deployment, including the installer .msi file and the install_config.ini file. ESET recommends keeping all files and packages in the GPO. Deleting or replacing the files or packages may cause issues with the update.

  1. Download the latest version of ESET Management Agent. Rename the file to agent_x64_xxx.msi (or agent_x32_xxx.msi) where xxx is the current version number.

  2. Create a folder at a shared location that can be accessed by domain computers and rename the folder to ESET Agent xxx where xxx is the current version number. Move the ESET Management Agent installer and the install_config.ini file to the folder.

  3. Follow steps 15-17 above to create a new installation package. Select the location with the latest version of ESET Management Agent.

  4. When you assign the package, GPO automatically detects the version number of the installer. To confirm that the latest package upgrades the earlier version double-click the latest package, click Upgrade and verify that the earlier package name is listed.

    Figure 2-1
    Click the image to view larger in new window