[OnPremise] Automating agent deployment

Summary

This article describes a process for automating the deployment of LeanSentry agents in an OnPremise environment.

NOTES:

1. For information about automating deployment of a SAAS version of LeanSentry, please see this article.
2. This article describes the deployment of LeanSentry agents, AFTER you have already deployed the LeanSentry OnPremise system itself. For more information about deploying LeanSentry OnPremise, see your OnPremise portal.

Obtaining the required files

You'll need the following files from your OnPremise installation:

c:\LeanServer\Dashboard\Assets\Installer\NewInstaller

1. InstallProduct.exe
2. InstallProduct.exe.config
3. LeanServer.AutoUpdater.Shared.Util.dll
4. LeanServer.AutoUpdater.Updater.dll

c:\LeanServer\Dashboard\Assets\Installer\OnPremise

1. InstallLSUpdater.exe
2. InstallLSUpdater.exe.config
3. lsupdater.cab
4. RecordingService.cab
5. AgentService.cab

Place all these files into the same directory from where the agent installation will take place.

Installing the agent

To install the agent on each server, you'll need to copy the files and run the following commands on each server. Note that these commands install both the LeanSentry Monitoring service AND the LeanSentry Agent diagnostic service.

InstallProduct.exe RecordingService.cab /local "/p:ClientKey=KEY;ServerName=SERVERNAME;ControlEndpointHostName=CONTROLENDPOINT;ControlEndpointAllowUntrusted=true;DisableUpdate=true;AccountName=ACCOUNTNAME;AccountPassword=ACCOUNTPASSWORD;AddSelf=true;GenerateServiceAccount=false" 

InstallProduct.exe AgentService.cab /local "/p:ClientKey=KEY;ControlEndpointHostName=CONTROLENDPOINTHOSTNAME;ControlEndpointAllowUntrusted=true;DisableUpdate=true;AccountName=ACCOUNTNAME;AccountPassword=ACCOUNTPASSWORD;AddSelf=true;GenerateServiceAccount=false"

 The following parameters must be replaced in the command lines above to install: 

KEY  <REQUIRED>	The environment-specific access key given during installation.
CONTROLENDPOINT <REQUIRED>	The onpremise VM hostname (to which the data will be sent).
ACCOUNTNAME [OPTIONAL]	Omit if using autogenerated local accounts to run the monitoring service. Otherwise, specify a valid local or domain account to run the service as.
ACCOUNTPASSWORD [OPTIONAL]	Omit if using autogenerated local accounts to run the monitoring service. Otherwise, specify a valid local or domain account password to run the service as.
GenerateServiceAccount	true: will autogenerate local service account. false: will require AccountName and AccountPassword properties to be provided.
SERVERNAME  [OPTIONAL]	The friendly server name to assign to the server, instead of the machine name. Must be unique in domain/environment.