Skip to main content

Group Policy (GPO)

Deploy the agent with Group Policy Software Installation by staging the MSI and applying an MST transform that carries the install properties.

Why a transform: GPO Software Installation cannot pass msiexec properties, and the installer is generic (no baked-in token). The registration token and other properties go into an MST transform applied to the MSI. MSI only here; EXE is not supported by GPO Software Installation.

First, download and verify the MSI.

Single-org procedure​

  1. Copy the .msi to a UNC share readable by the target computers (a network path, not a local path):

    \\server\share\SparkLogsAgentSetup-x64-1.6.0.msi

  2. Build one MST in Orca (or another MSI editor): New Transform, then the Property table, add the properties below, then Generate Transform and save the .mst beside the .msi:

    EULA               = ACCEPT
    REGISTRATION_TOKEN = us_97...
    USEPARENTORG       = 1

  3. Computer Configuration, then Policies, then Software Settings, then Software Installation, then New, then Package. Enter the UNC path, then choose Advanced.

  4. Package Properties, then the Modifications tab, then Add, then select the .mst, then OK.

  5. Link the GPO to the target OU or security group.

Behavior

Installs in SYSTEM context at the next reboot. GPO Software Installation gives no per-machine success reporting; confirm via the Agents list or Get-Service SparkLogsAgent.

Client-org (MSP) deltas​

  • Build one MST per client. Its Property table uses the Clients-org token plus the client's identifiers (no USEPARENTORG):

    EULA               = ACCEPT
    REGISTRATION_TOKEN = us_97...
    RMMCLIENTID        = <RMM_CLIENT_ID>
    CLIENTNAME         = "<CLIENT_NAME>"   (optional override)

  • One client usually maps to one domain or OU; link each client's GPO to that client's OU or group.

  • Replace the <...> placeholders with the client's real values before saving the MST.

The EULA = ACCEPT property accepts the SparkLogs Agent license for the unattended install.

See Deployment scope for the property meanings and Troubleshooting for common failures.