# Install AgentX Client on Windows (mass - GPO)

Mass install AgentX Client on Windows endpoints using Group Policy Objects (GPO) for domain-wide deployment.

#### Prerequisites <a href="#prerequisites-27" id="prerequisites-27"></a>

* 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 <a href="#enable-msi-logging-with-group-policy" id="enable-msi-logging-with-group-policy"></a>

Before mass installation, enable MSI logging to generate detailed installation logs for troubleshooting.

1. Open **Group Policy Management**.
2. Expand **Domains** and right-click **Default Domain Policy**.
3. Select **Edit**.
4. Navigate to **Computer Configuration** > **Policies** > **Administrative Templates** > **Windows Components** > **Windows Installer**.
5. Double-click **Logging**.
6. Select **Enabled**.
7. In **Logging**, enter: `voicewarmupx`
8. Select **OK**.

#### Create a Microsoft Transform File <a href="#create-a-microsoft-transform-file" id="create-a-microsoft-transform-file"></a>

Create a transform (.mst) file to customize AgentX Client installation settings.

1. Open the AgentX Client .msi file in Orca.
2. Select **Transform** > **New Transform**.
3. In the Property table, locate **MANAGER\_ADDRESS** and enter your Logpoint IP address in the Value column.
4. To enable osquery, press **Ctrl+R** to add a new row:
   * Property: `ADDLOCAL`
   * Value: `OsqueryFeature`
5. To install to a custom path:
   * Change **INSTALLATION\_TYPE** to `custom`
   * Press **Ctrl+R** to add a new row:
     * Property: `INSTALL_DIR`
     * Value: Your custom path (e.g., `C:\CustomPath\AgentX`)
6. Select **Transform** > **Generate Transform**.
7. Enter a name for the .mst file and select **Save**.
8. Copy the .mst file to the same network share as the .msi file.

#### Create a Group Policy for deployment <a href="#create-a-group-policy-for-deployment" id="create-a-group-policy-for-deployment"></a>

1. Open **Group Policy Management**.
2. Expand **Domains** and right-click **Default Domain Policy**.
3. Select **Edit**.
4. Navigate to **Computer Configuration** > **Policies** > **Software Settings**.
5. Right-click **Software Installation** and select **New** > **Package**.
6. Browse to the network share and select the AgentX Client .msi file.
7. Select **Open**.
8. Select **Advanced** and select **OK**.
9. Select the **Modifications** tab and select **Add**.
10. Select the .mst file you created.
11. Select **Open**.
12. Select **OK**.

#### Expected outcome <a href="#expected-outcome-24" id="expected-outcome-24"></a>

AgentX Client installs automatically on all domain computers during the next Group Policy refresh or at startup/logon.

#### Verification <a href="#verification-24" id="verification-24"></a>

On the domain controller:

1. Open **Group Policy Management**.
2. Navigate to **Default Domain Policy** > **Settings** > **Computer Configuration** > **Software Settings**.
3. Verify that AgentX Client appears in the software installation list.

On endpoints:

1. Open Command Prompt as administrator.
2. Run: `gpupdate /force`
3. Verify the AgentX Client service is running in Services (services.msc).
4. In Logpoint, go to **Settings** > **Configuration** > **AgentX** > **Agents**.
5. Verify that endpoints appear in the agents list.

#### Change Logpoint IP address after deployment <a href="#change-logpoint-ip-address-after-deployment-1" id="change-logpoint-ip-address-after-deployment-1"></a>

To update the Logpoint IP address for deployed agents:

1. Create a new .mst file with the updated IP address following the transform file creation steps.
2. In Group Policy Management, edit **Default Domain Policy**.
3. Navigate to **Computer Configuration** > **Policies** > **Software Settings** > **Software Installation**.
4. Right-click the AgentX Client package and select **Properties**.
5. Select the **Modifications** tab and select **Add**.
6. Select the new .mst file.
7. Select **Open** and select **OK**.
8. On endpoints, run: `gpupdate /force`

#### Upgrade AgentX Client using GPO <a href="#upgrade-agentx-client-using-gpo" id="upgrade-agentx-client-using-gpo"></a>

1. Download the upgraded .msi file from the Help Center.
2. Copy it to the network share.
3. In Group Policy Management, edit **Default Domain Policy**.
4. Navigate to **Computer Configuration** > **Policies** > **Software Settings** > **Software Installation**.
5. Right-click **Software Installation** and select **New** > **Package**.
6. Select the upgraded .msi file and select **Open**.
7. Select **Advanced** and select **OK**.
8. Select the **Upgrades** tab.
9. Remove any packages listed under **Packages that this package will upgrade**.
10. Select **Add**.
11. Select the existing AgentX Client package.
12. Select **Package can upgrade over the existing package**.
13. Select **OK**.
14. Select **OK**.
15. On endpoints, run: `gpupdate /force`

#### Uninstall AgentX Client using GPO <a href="#uninstall-agentx-client-using-gpo" id="uninstall-agentx-client-using-gpo"></a>

1. In Group Policy Management, edit **Default Domain Policy**.
2. Navigate to **Computer Configuration** > **Policies** > **Software Settings** > **Software Installation**.
3. Right-click the AgentX Client package and select **All Tasks** > **Remove**.
4. 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
5. Select **OK**.
6. On endpoints, run: `gpupdate /force`

#### Next steps <a href="#next-steps-30" id="next-steps-30"></a>

* [Configure AgentX in device](https://docs.logpoint.com/agentx/configuration/devices/configure-agentx-in-device)
* [Access Windows logs](https://docs.logpoint.com/agentx/analytics-and-visualization/access-windows-logs)
