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.
GPO Software Installation installs MSI packages and takes install properties from a transform. The registration token and the other properties go into an MST applied to the MSI. Use the MSI: GPO Software Installation does not install an EXE.
First, download and verify the MSI.
Single-org procedure
-
Copy the
.msito a UNC share readable by the target computers (a network path, not a local path):\\server\share\SparkLogsAgent-x64-1.14.13.msi -
Build one MST in Orca, which is part of the Windows SDK, or in another MSI editor: New Transform, then the Property table, add the properties below, then Generate Transform and save the
.mstbeside the.msi:EULA = ACCEPTREGISTRATION_TOKEN = us_97...USEPARENTORG = 1 -
In Group Policy Management, create a GPO or edit one. Go to Computer Configuration, then Policies, then Software Settings, then Software Installation, then New, then Package. Enter the UNC path, then choose Advanced.
-
Package Properties, then the Modifications tab, then Add, then select the
.mst, then OK. -
Link the GPO to the target OU or security group.
Installs in SYSTEM context at the next reboot.
Group Policy does not report success for each machine, so confirm in the Agents list or with Get-Service SparkLogsAgent.
Client-org (MSP) differences
-
Build one MST per client. Its Property table has the registration token of your Clients organization and the client's identifiers, and no
USEPARENTORG:EULA = ACCEPTREGISTRATION_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.