Use these instructions to automate deployment of the LeanSentry monitoring service to a cloud environment.
IMPORTANT: We provide streamlined deployment to Windows Azure Compute Services (Web roles and Worker roles). Please use the Azure environment deployment wizard in the dashboard, and the provided Visual Studio Nuget package to deploy to that environment. Use the instructions below to deploy to Windows Azure VMs, Amazon EC2, or other custom or third party cloud environments.
NOTE: This deployment describes the Local deployment option (each monitored server has an agent on it).
Installer configuration file (needed to run in both .NET .2 and .NET v4 environments)
A required utility dll file.
1. You can download InstallProduct.exe from here.
Add these commands to your deployment automation:
REM Install Monitoring service
InstallProduct.exe 11533B52-131F-4E0A-A565-EB6468EF6FE7 /nowindow /writeerrors /cleanlogs "/p:ClientKey=<ACCESSKEY>;Name=[SERVERNAME];GenerateServiceAccount=true;AddSelf=true"
REM Install Agent
InstallProduct.exe B1B43386-B455-4A34-8637-1D4FF695A697 /nowindow /writeerrors "/p:ClientKey=<ACCESSKEY>;GenerateServiceAccount=true"
Be sure to replace the bolded <required_parameter> and [optional_parameter] tags with the required parameter values.
The environment-specific access key given during installation.
The friendly server name to assign to the server, instead of the machine name. Must be unique in domain/environment.
NOTE: These commands require Administrative privileges on the server where LeanSentry is installed, and must be run in an elevated/Run As Administrator context.
Deploying Windows Debugging tools (STRONGLY RECOMMENDED)
The Windows Debugging tools support LeanSentry's diagnostic capabilities, and are necessary in order to enable most of the diagnostic and optimization features.
NOTE: We strongly recommend deploying the Windows Debugging tools on all or at least some of the servers to insure diagnostic insight is available.
Acquiring the Windows Debugging tools
The Windows Debugging tools is a free Microsoft toolset. You can download it once, and then set up automatic deployment per the options below.
For download instructions, see: https://leansentry.zendesk.com/entries/79075079-Installing-Windows-Debugging-tools.
Deploying the Windows Debugging tools automatically
NOTE: LeanSentry now supports automatically deploying Windows Debuggers from a publicly accessible url (a file URL from your website). You can configure this in your environment settings after deploying LeanSentry.
1. Download the debugger MSIs from Microsoft (see article).
2. Place the MSIs on a publicly available url (we recommend keeping the url secret, do not use file sharing websites).
3. Configure the debugger urls in your environment settings/Other tab.
Deploying the Windows Debugging tools manually
You can deploy Windows Debugging Tools as part of your custom automation.
To deploy Windows Debugging tools:
1. Install the Windows Debugging Tools on your dev machine:
2. Grab the redistributable installers and add them to your deployment, e.g. from:
C:\Program Files (x86)\Windows Kits\8.1\Debuggers\Redist
3. Add this to your startup tasks:
msiexec /i "<YOURPATH>\X64 Debuggers And Tools-x64_en-us.msi" /quiet /passive /norestart
msiexec /i "<YOURPATH>\X86 Debuggers And Tools-x86_en-us.msi" /quiet /passive /norestart
This will install the Windows Debugging tools on your instance/VM. The LeanSentry Agent will automatically detect their presence and use them for diagnostics.
Troubleshooting automatic deployment
Review the installation logs located in %systemdrive%\leanserver\InstallProduct.log and %programdata%\leanserver\updater\log\ if the installation fails. Forward these logs to support AT leanserver DOT com for additional help.