# Install AgentX Client on Windows (mass - SCCM)

Mass install AgentX Client on Windows endpoints using Microsoft System Center Configuration Manager (SCCM) for enterprise deployment.

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

* Windows Server 2016 or later with Domain Controller and SCCM configured
* SCCM administrative permissions
* AgentX Client v1.2.0 or later (.msi file) in a network share (\hostname\Location)
* IP address of Logpoint where AgentX Server and AgentX Manager are installed
* Windows 10 Pro or Windows 11 Pro workstations

#### Create an application in SCCM <a href="#create-an-application-in-sccm" id="create-an-application-in-sccm"></a>

1. Open **Microsoft Configuration Manager**.
2. Navigate to **Software Library** > **Application Management**.
3. Right-click **Applications** and select **Create Application**.
4. Select **Browse** and open the AgentX Client .msi file.
5. Select **Next**.
6. Under **General Information**, enter a **Name** for the application.
7. Review the **Installation Program** field. The default command installs only OSSEC:

```
msiexec /i "AgentX_Client_1.4.1.msi" /q
```

To install osquery and OSSEC, replace with:

```
msiexec /i "AgentX_Client_windows_1.4.1.msi" ADDLOCAL=OsqueryFeature MANAGER_ADDRESS=x.x.x.x /qn
```

Replace `x.x.x.x` with your Logpoint IP address.

To install to a custom path:

```
msiexec /i "AgentX_Client_windows_1.4.1.msi" ADDLOCAL=OsqueryFeature MANAGER_ADDRESS=x.x.x.x INSTALLATION_TYPE=custom INSTALL_DIR="D:\AgentX_Client" /qn
```

If the custom path does not exist, the installation fails.

8. Select **Next**.
9. Select **Next** (accept default detection method).
10. Select **Close**.

#### Deploy the application <a href="#deploy-the-application" id="deploy-the-application"></a>

1. In the **Applications** list, select the AgentX Client application.
2. Select **Deploy** in the ribbon.
3. In **Collection**, select **Browse**.
4. Change the dropdown from **User Collections** to **Device Collections**.
5. Select **All Desktop and Server Clients**.
6. Select **OK**.
7. Select **Next**.
8. Select **Add** > **Distribution Point**.
9. Select your distribution point and select **OK**.
10. Select **Next**.
11. In **Purpose**, select **Required** to enable silent background installation.
12. Select **When a resource is no longer a member of the collection, uninstall this application**.
13. Select **Send wake-up packets**.
14. Select **Next**.
15. Configure **Installation deadline** (e.g., "As soon as possible").
16. Select **Next** through remaining screens.
17. Review the summary and select **Close**.

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

AgentX Client installs silently on all devices in the selected collection according to the deployment schedule.

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

In SCCM:

1. Navigate to **Monitoring** > **Deployments**.
2. Locate the AgentX Client deployment.
3. Review deployment status and success/failure counts.

On endpoints:

1. Verify the AgentX Client service is running in Services (services.msc).
2. In Logpoint, go to **Settings** > **Configuration** > **AgentX** > **Agents**.
3. Verify that endpoints appear in the agents list.

#### Force immediate installation on workstations <a href="#force-immediate-installation-on-workstations-1" id="force-immediate-installation-on-workstations-1"></a>

To apply the installation immediately without waiting for the scheduled update:

1. On the Windows workstation, open **Control Panel** > **Configuration Manager**.
2. Select the **Actions** tab.
3. Select **Machine Policy Retrieval & Evaluation Cycle**.
4. Select **Run Now**.
5. Select **OK**.

This forces synchronization and applies the installation immediately.

#### Configuration guidelines <a href="#configuration-guidelines-13" id="configuration-guidelines-13"></a>

**Use Purpose: Required for silent installation**\
Setting Purpose to "Required" enables silent background installation. Setting it to "Available" may display command prompts during installation, potentially confusing users.

**Distribution points must be configured**\
Ensure distribution points are configured and synchronized before deployment. Missing distribution points cause installation failures.

**Monitor deployment status**\
Regularly check the Monitoring > Deployments view in SCCM to identify and troubleshoot installation failures.

#### Next steps <a href="#next-steps-31" id="next-steps-31"></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)
