Install AgentX Client on Windows (mass - GPO)
Mass install AgentX Client on Windows endpoints using Group Policy Objects (GPO) for domain-wide deployment.
Prerequisites
Windows Server 2016 or later with Domain Controller configured
Domain administrative permissions
Orca (MSI editor) installed
AgentX Client v1.2.0 or later (.msi file) in a network share accessible to all domain computers
IP address of Logpoint where AgentX Server and AgentX Manager are installed
Windows 10 Pro or Windows 11 Pro workstations joined to the domain
Enable MSI logging with Group Policy
Before mass installation, enable MSI logging to generate detailed installation logs for troubleshooting.
Open Group Policy Management.
Expand Domains and right-click Default Domain Policy.
Select Edit.
Navigate to Computer Configuration > Policies > Administrative Templates > Windows Components > Windows Installer.
Double-click Logging.
Select Enabled.
In Logging, enter:
voicewarmupxSelect OK.
Create a Microsoft Transform File
Create a transform (.mst) file to customize AgentX Client installation settings.
Open the AgentX Client .msi file in Orca.
Select Transform > New Transform.
In the Property table, locate MANAGER_ADDRESS and enter your Logpoint IP address in the Value column.
To enable osquery, press Ctrl+R to add a new row:
Property:
ADDLOCALValue:
OsqueryFeature
To install to a custom path:
Change INSTALLATION_TYPE to
customPress Ctrl+R to add a new row:
Property:
INSTALL_DIRValue: Your custom path (e.g.,
C:\CustomPath\AgentX)
Select Transform > Generate Transform.
Enter a name for the .mst file and select Save.
Copy the .mst file to the same network share as the .msi file.
Create a Group Policy for deployment
Open Group Policy Management.
Expand Domains and right-click Default Domain Policy.
Select Edit.
Navigate to Computer Configuration > Policies > Software Settings.
Right-click Software Installation and select New > Package.
Browse to the network share and select the AgentX Client .msi file.
Select Open.
Select Advanced and select OK.
Select the Modifications tab and select Add.
Select the .mst file you created.
Select Open.
Select OK.
Expected outcome
AgentX Client installs automatically on all domain computers during the next Group Policy refresh or at startup/logon.
Verification
On the domain controller:
Open Group Policy Management.
Navigate to Default Domain Policy > Settings > Computer Configuration > Software Settings.
Verify that AgentX Client appears in the software installation list.
On endpoints:
Open Command Prompt as administrator.
Run:
gpupdate /forceVerify the AgentX Client service is running in Services (services.msc).
In Logpoint, go to Settings > Configuration > AgentX > Agents.
Verify that endpoints appear in the agents list.
Change Logpoint IP address after deployment
To update the Logpoint IP address for deployed agents:
Create a new .mst file with the updated IP address following the transform file creation steps.
In Group Policy Management, edit Default Domain Policy.
Navigate to Computer Configuration > Policies > Software Settings > Software Installation.
Right-click the AgentX Client package and select Properties.
Select the Modifications tab and select Add.
Select the new .mst file.
Select Open and select OK.
On endpoints, run:
gpupdate /force
Upgrade AgentX Client using GPO
Download the upgraded .msi file from the Help Center.
Copy it to the network share.
In Group Policy Management, edit Default Domain Policy.
Navigate to Computer Configuration > Policies > Software Settings > Software Installation.
Right-click Software Installation and select New > Package.
Select the upgraded .msi file and select Open.
Select Advanced and select OK.
Select the Upgrades tab.
Remove any packages listed under Packages that this package will upgrade.
Select Add.
Select the existing AgentX Client package.
Select Package can upgrade over the existing package.
Select OK.
Select OK.
On endpoints, run:
gpupdate /force
Uninstall AgentX Client using GPO
In Group Policy Management, edit Default Domain Policy.
Navigate to Computer Configuration > Policies > Software Settings > Software Installation.
Right-click the AgentX Client package and select All Tasks > Remove.
Select a removal method:
Immediately uninstall the software - Removes the software at next Group Policy refresh
Allow users to continue to use the software - Prevents new installations but doesn't remove existing installations
Select OK.
On endpoints, run:
gpupdate /force
Next steps
Last updated
Was this helpful?