Installing and updating LeanSentry OnPremise in your environment

LeanSentry OnPremise is a standalone version of the LeanSentry monitoring & diagnostic service, that enterprise customers can deploy inside their environment for for 100% data privacy.

More about LeanSentry OnPremise

This article covers installing and updating your copy of LeanSentry OnPremise from your Business tier account.

Installing LeanSentry OnPremise for the first time

LeanSentry OnPremise is offered as a standalone installation package, which sets up the entire LeanSentry system on a virtual machine you supply.

IMPORTANT: In order for us to activate your OnPremise account, we require access to the VM. Contact support for more information. 

LeanSentry OnPremise VM system requirements

To install a LeanSentry OnPremise deployment, you'll need the following:

• A VM running Windows Server 2012+, with .NET Framework 4.0 installed.
• Recommended hardware requirements: 16Gb of RAM, 4+ core CPU. Similar to: Amazon EC2 m3.xlarge instance or Windows Azure Large (A3) instance.
• Disk space: 200Gb available on C: drive.
• IMPORTANT: Install LeanSentry OnPremise on its own dedicated VM. LeanSentry OnPremise will configure your VM for its own use, which may be incompatible with other application tasks running on it. DO NOT install LeanSentry OnPremise on your production servers.
• For production use, WE DO NOT RECOMMEND installing SQL server that will store your LeanSentry OnPremise data on the same VM.

If you have questions about the installation, please email us.

Create your first LeanSentry OnPremise deployment

To get started, create your OnPremise deployment in the LeanSentry OnPremise portal:

1. Log in to your LeanSentry account.
2. Click "OnPremise" to go to the OnPremise portal.
3. Click "Create a new deployment". 
4. Provide the requested information to configure your deployment prior to download.

At this point, you'll be taken to a form asking for key information for this deployment. 

Once you submit this form, your LeanSentry OnPremise deployment will be ready to deploy.

Installing LeanSentry OnPremise

To install the LeanSentry OnPremise deployment you just created, you will need to:

1. Provision a VM (see system requirements above). This VM will host the LeanSentry OnPremise data, expose a dashboard for your team, and receive the data sent by LeanSentry monitoring services on your servers.
2. Prepare a SQL server that will host the data for this deployment, and make sure its network-reachable from the VM.
3. Download the LeanSentry OnPremise setup from your deployment page.
4. Run the installer on the VM.

The installer should take anywhere from 10 to 30 minutes to complete the initial installation.

Once done, it will open your dashboard for your initial login.

Configuring your LeanSentry OnPremise dashboard for the first time

After LeanSentry OnPremise is installed, it will open the dashboard to allow you to log in and begin using LeanSentry.

• Be sure to log in with your LeanSentry account email, and the temporary password provided on the LeanSentry OnPremise deployment page from where you downloaded this installation.

Once logged in, we recommend you follow the Get started checklist to prepare your deployment for use.

This includes some of the following steps:

1. Change the master account password.
2. Invite your team members to the dashboard.
3. Create your first LeanSentry environment and configure it to monitor the OnPremise VM itself. This will help us troubleshoot any issues with our services if this is necessary in the future.
4. Create your actual LeanSentry environments to begin monitoring your internal servers.

Updating your LeanSentry OnPremise installation

To update your installation, log in to your OnPremise portal and locate your LeanSentry OnPremise deployment.

IMPORTANT: Be sure to select the deployment that matches the LeanSentry OnPremise installation you'll be updating.

Then:

1. Re-download the installer and run it on the VM to perform an in-place upgrade.
2. Once upgraded, upgrade the monitoring services on your servers. We do not currently automatically update the monitoring services whenever you install the new LeanSentry OnPremise build.
   1. Go to environment settings for each of your LeanSentry environments inside your local LeanSentry OnPremise dashboard, and download the new service installer.
   2. Run it on each server being monitored by this environment

NOTE: You can use the new cmdline package to perform automated upgrades of multiple servers in your environment.

Licensing your LeanSentry OnPremise deployment

The LeanSentry OnPremise product is an optional feature available as part of the LeanSentry Business family of plans.

To deploy and operate a LeanSentry OnPremise deployment, you can either:

1. Purchase a LeanSentry OnPremise Business plan with OnPremise support,
   OR
2. Have an active LeanSentry OnPremise trial.

LeanSentry OnPremise trial 

To request the LeanSentry OnPremise trial on your LeanSentry account, contact our support team. Please note that we have internal qualifying criteria for LeanSentry OnPremise trial access and not all requests will be approved.

You can also indicate your OnPremise intent when initially signing up for your LeanSentry account:

If you have done so, the dashboard will indicate whether or not you have access to the LeanSentry OnPremise trial. 

1. If you do not have access:

2. If your request is approved, you'll be granted access to the LeanSentry OnPremise trial:

If you have access to the LeanSentry OnPremise trial, you can go ahead and create a new LeanSeentry OnPremise deployment as indicated in Create your first LeanSentry OnPremise deployment.

NOTE: LeanSentry OnPremise trial limitations

1. Each LeanSentry OnPremise trial deployment is licensed to operate up to 10 days, or until the end of your LeanSentry account trial period.
2. During the trial, your diagnostic functionality may be limited depending on trial type.

Managing LeanSentry OnPremise licenses

In order to continue operating your LeanSentry OnPremise deployment, you'll need to obtain and apply your license code. This is necessary to:

1. Activate your LeanSentry OnPremise trial deployment (after purchasing a LeanSentry Business plan with OnPremise support)
2. Renew your LeanSentry OnPremise plan (after your plan automatically renews, or when you manually renew it)
3. Upgrade your LeanSentry OnPremise plan (if you update your plan, e.g. to increase the number of servers being monitored).
4. Assign server licenses to LeanSentry OnPremise deployment (if you assign more server licenses to your deployment).

Applying the LeanSentry OnPremise license

You can obtain your license code when viewing your deployment in the LeanSentry OnPremise portal:

(Be sure to select the deployment first)

NOTE: This code will change when you activate or upgrade your plan, when the plan renews, after your invoice payment is received, and if you assign a different number of servers to your deployment.

To apply this license to your LeanSentry OnPremise deployment, copy the license code and then enter it on your on-premise dashboard:

Managing server licenses for LeanSentry OnPremise

Each LeanSentry OnPremise plan includes a specific number of servers that can be monitored by your LeanSentry OnPremise deployment. The base plan includes 10 servers, but you can purchase additional server licenses if you'd like to monitor more than 10 servers.

When you purchase your LeanSentry OnPremise Business plan, or upgrade your plan to include more servers, you'll need to assign some or all of your server licenses to each OnPremise deployment. You can do this on the LeanSentry OnPremise portal:

1. Select the deployment
2. On the deployment page, adjust the server count for the deployment as desired
3. Click "Apply server count" to effect your change
4. Copy and apply the license to your on-premise dashboard.

Note that:

1. You can only purchase licenses in increments of 10.
2. It is up to you how many servers you actually monitor up to your license count. LeanSentry does not receive or track any information about your onpremise server usage.
3. If you are monitoring more servers than the server license count assigned to your deployment, any server in excess of the limit will be placed in "offline" mode and will not report monitoring data to your LeanSentry OnPremise dashboard.

To upgrade your license count, please visit your upgrade page.

.