Issue
- Deploy the ESET Management Agent using GPO in enterprise environments or environments with a high number of client computers
- Create the installer file in ESET PROTECT On-Prem
- Deploy the ESET Management Agent using GPO
- Update the ESET Management Agent using GPO
Solution
Create the installer file in ESET PROTECT On-Prem
- Create the
install_config.ini
configuration script. It contains the parameters for the Agent to communicate with your ESET PROTECT Server.-
Open ESET PROTECT On-Prem in your web browser and log in.
-
Click Installers → Create Installer.
-
Select Windows and select the Use GPO or SCCM for deployment option. Deselect the check box next to Participate in product improvement program if you do not want to help ESET to improve the product. Configure other settings such as Parent group, Server hostname, Port number (2222 by default), Peer Certificate or Certificate passphrase if needed. Optionally, click Customize more settings to view other options. Click Finish.
-
Click the Configuration GPO/SCCM script icon and click your preferred Agent to download
install_config.ini
file and Agent installer.msi
file, respectively. When the download is complete, click Finish.
-
-
Alternatively, you can download the ESET Management Agent installer .msi file from the ESET download page.
-
Save the Agent installer
.msi
file and theinstall_config.ini
file to a shared folder on the domain controller so that all your client computers can access it with read and execute permissions.
Deploy the ESET Management Agent using GPO
-
Install Microsoft Group Policy Management Console (GPMC) on your Domain Controller server.
-
Open Server Manager, click Manage → Add Roles and Features.
-
Follow the wizard and in Add Roles and Features, select the check box next to Group Policy Management. Click Next and Install.
-
To open Group Policy Management, press the Windows key + R, type
gpmc.msc
and click OK. -
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.
-
Right-click Agent deployment GPO and click Edit.
-
In the Computer Configuration section, expand Policies → Administrative Templates: Policy definitions (ADMX files) retrieved from the local computer → System 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.
-
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.
-
Right-click the domain and select Link an Existing GPO.
-
Select the GPO that you created and click OK.
-
Right-click the linked GPO and click Edit to edit the GPO in Group Policy Management Editor.
-
Expand Computer Configuration → Policies → Software settings. Right-click Software installation, select New → Package.
-
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.
-
Select Assigned and click OK.
-
The package is displayed in the Group Policy Management Editor.
-
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.
-
Assign GPO to client computers:
-
-
Assign GPO to all Domain computers: Click Add → type domain computers and click OK.
-
-
-
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.
-
-
GPO is now assigned to the selected computers. When the GPO updates, the computers will receive it and ESET Management Agent will be installed.
See the Microsoft Knowledgebase instructions on using Group Policy to remotely install software in Windows Server 2008 (and later).
Update the ESET Management Agent using GPO
-
Download the latest version of ESET Management Agent. Rename the file to
agent_x64_xxx.msi
(oragent_x32_xxx.msi
) wherexxx
is the current version number. -
Create a folder at a shared location that can be accessed by domain computers and rename the folder to
ESET Agent xxx
wherexxx
is the current version number. Move the ESET Management Agent installer and theinstall_config.ini
file to the folder. -
Follow steps 12–15 above to create a new installation package. Select the location with the latest version of ESET Management Agent.
-
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.