SQL Sentry License Management

Important:  SQL Sentry versions 2021.8 or later are licensed with a SolarWinds license through the SolarWinds License Manager. SQL Sentry versions before 2021.8 are licensed with a SentryOne license.

Licensing

SQL Sentry is generally licensed per each individually monitored target. This includes products for SQL Server, SQL Server Analysis Services, and Azure SQL Database. No additional licensing is needed for the SQL Sentry Portal, clients, or monitoring services installed in your environment. You may install as many of these as needed with your SQL Sentry license.

Important:  To host the SQL Sentry database in an Availability Group, the Monitoring Service and SQL Sentry Client Connection(s) must use the Listener name. Ensure that the Monitoring Service and any SQL Sentry Client connections are using the Listener name before activating your license key.

Important:  To host the SQL Sentry database in a Failover Cluster Instance (FCI), the Monitoring Service and SQL Sentry Client Connection(s) must use the virtual cluster name. Ensure that the Monitoring Service and any SQL Sentry Client connections are using the virtual cluster name before activating your license key.

Additional Information: See the product pricing and SQL Sentry licensing options section of the product page for more information on licensing models and what is included with each option such as monitoring of the Hyper-V or VMware host.

Free SQL Sentry License for Monitoring the SQL Sentry Database Instance

It's possible to obtain a free license of SQL Sentry for monitoring the SQL Server instance that contains the SQL Sentry database. The database license is free to monitor regardless of how many  licenses you already have. 

Note:  The free license doesn't appear in the license count in the Help > About window, despite whether the free license is used.

Success: There are no annual software maintenance costs for the free license, and the license is perpetual.

SQL Sentry License Usage Overview

View additional license information, such as the number of licenses applied throughout the environment, in the About SolarWinds SQL Sentry window.

About SolarWinds SQL Sentry window showing 11 of 50 licenses used

Access the About SolarWinds SQL Sentry window by selecting Help > About.

SQL Sentry Help > About menu options

Inventory View

To get an overview of how your licenses are applied throughout your environment you can also select the Inventory node, (Navigator > Configuration > Inventory). See the Inventory View article for instructions.

SolarWinds License Manager for SQL Sentry Online Activation

Use the SolarWinds License Manager to activate a new license key or upgrade the existing one to watch a different number of targets. The license manager can be launched from within the SQL Sentry client.

  1. Go to Help > Manage Licenses:SQL Sentry > Help > Manage Licenses menu options
  2. The License Manager screen appears for SolarWinds SQL Sentry: SolarWinds SQL Sentry License Manager screen and options
    Important:  If you have an existing license, the Action will have an Upgrade option. If you have an evaluation license or just upgraded from a SentryOne licensed version of SQL Sentry and need to apply a SolarWinds branded license, the Action will have an Activate option.
  3. To apply a license, use the Upgrade or Activate option. If you have internet access, you can use the first option to enter the activation key obtained from the SolarWinds Customer Portal. There are additional options to use a specific proxy server or perform a manual activation if there is no internet access. Select Next to continue. Activate SQLS window enter activation key and select Next.
  4. Enter your information (name, email, and phone number) to register SQL Sentry. Select Next to continue.
  5. You should see a message that reads, "SolarWinds SQL Sentry is now licensed and activated! Your license has been imported successfully." Select Finish to return to the License Manager screen.
  6. Select Exit to return to the SQL Sentry client.

SolarWinds License Manager for SQL Sentry Offline Activation

Use the SolarWinds License Manager to activate a new license key or upgrade the existing one to watch a different number of targets. Activate your license on an offline machine by completing the following steps:

1. Go to Help > Manage Licenses to open the SolarWinds SQL Sentry License Manager.SQL Sentry Client Help Manage Licenses

Important:  If you have an existing license, the Action will have an Upgrade option. If you have an evaluation license or just upgraded from a SentryOne licensed version of SQL Sentry and need to apply a SolarWinds branded license, the Action will have an Activate option.

2.  To apply a license, use the Upgrade or Activate option. SolarWinds License Manager Upgrade license

3. Select the This server does not have internet access option and then select Next to continue. SolarWinds License Manager offline manual activation

4. Complete the steps on the Activate Product page:

1. Select Copy Unique Machine ID and then paste the id into a text editor. Save the .txt document, and then move the document onto a machine with internet access.SolarWinds License Manager Copy Unique Machine ID

Note:  You can transfer the document to a shared location, or copy the document onto a portal drive for transfer.

2. Log into the SolarWinds customer portal, select Licenses > Manage Licenses, and then navigate to the product you are trying to activate.

3. Select Activate license manually to open the Manage License Activation page. SolarWinds License Management Activate license manually

4. Paste the unique machine id from your .txt file into the Unique Machine ID field. Enter a computer name for your machine, and then select Generate License File.SolarWinds Manage License Activation Generate License File

5. Select Download Activation File, and then move the file onto your offline machine.SolarWinds Manage License Activation Download Activation File

Note:  A copy of the download file is emailed to the email associated with your SolarWinds customer account.SolarWinds Software License File email

5. Select Browse, select the location of your license key file, and then select Next to continue.SolarWinds License Manager Activate Product Next 6. Select Finish to activate your license.SolarWinds License Manager Finish

7. Select Exit to return to the SQL Sentry client.

Applying Multiple Licenses to the Same Installation

1. Go to Help > Manage Licenses to open the License Manager.SQL Sentry Client select Help > Manage Licenses,2. Select Upgrade for the installed license key.SolarWinds License Manager select Upgrade for license.3. Enter the applicable license key and then select Next.Activate SQLS enter activation key and select Next.4. Verify your user information on the product registration page, and then select Next.Activate SQLS verify user info and select Next.5. Select Finish to return to the License Manager.Activate SQLS Your license has been imported successfully.6. Repeat these steps for any additional licenses.

Success: New licenses will display in the list for the License Manager. License Manager with the added license applied.

SentryOne License Management for SQL Sentry

Deprecated:  This section applies only to SentryOne-branded versions of SQL Sentry (earlier than 2021.8).

The Hardware Key

Your SentryOne SQL Sentry license has a hardware key that's tied to the location of your SQL Sentry database (denoted by the SQL Server instance name). If you decide to relocate the SQL Sentry database, this hardware key can be updated through the SentryOne Customer Portal by any authorized account holder (see the SentryOne Account Management article). Contact support if you have any issues. For more information about moving the SQL Sentry database, see the Relocating the SQL Sentry Database topic. 

An exception to this process is when the SQL Sentry database is part of an Availability Group. To allow licensing to be aware of the SQL Sentry database and to continue working, the hardware key must be tied to the Availability Group ID. You can get this ID by executing the following query against the instance that will be hosting the SQL Sentry database: 

SELECT group_id as AG_ID, name
FROM sys.availability_groups

For more information, see the Hosting SQL Sentry Database On An Availability Group article. 

APS and DW Sentry Licensing

EOL:  These products (APS Sentry and DW Sentry) are no longer for sale.

The licensing for Microsoft Analytics Platform System (APS) and SQL Data Warehouse (SQL DW) differ from the traditional SQL Sentry licensing model. APS is licensed by the number of Compute nodes on the target, and SQL DW is a flat monthly subscription with an annual term. 

Important:  If the number of Compute nodes exceeds the number of license units, monitoring will be suspended until additional license units are applied. For example, if a SQL DW target with six compute nodes is being monitored with a six node license, and then two additional nodes are added to the SQL DW environment to accommodate increased activity, monitoring will stop until an updated license that includes additional license units is applied.

Applying a New SentryOne License

When your license is near expiration, a notification that your license is about to expire displays on the SQL Sentry client status bar. Manage your license within the SQL Sentry client by completing the following: 

  1. Select Help on the client toolbar, and then select Manage License to open the License Entry dialog box. SentryOne Help > Manage Licenses
  2. Select Edit to change your license information. Select Clear to erase the current license from the text box. SentryOne License Entry window Clear license
  3. Copy your new product license from the SentryOne customer portal, and then paste the text in the text-box, or drag-and-drop a license file into the space provided. Select Save to save the changes to your license, and then select OK to close the License Entry dialog box. This opens the License Change Detected prompt. SentryOne License Entry window Save license
  4. Select OK to restart the application with your new license. SentryOne License Change Detected

Success: You have now successfully updated your SentryOne SQL Sentry License!

SentryOne Licensing Errors

License Key Mismatch

SentryOne License Configuration Error License Key Mismatch

Receiving this error while applying the license key indicates that the hardware key of the license doesn't match the name of the server currently housing the SQL Sentry database. This typically happens when you need to migrate your SQL Sentry Database to a new instance of SQL Server, or to a new server altogether.

Note:  To get the instance name, connect to the server where the SQL Sentry database will reside and run the following query:

SELECT serverproperty('servername')

Resolve this error by logging into your Customer portal account, and then update the instance name. To update the hardware key of the license in the Customer portal complete the following steps: 

  1. Scroll to the Licenses section at the bottom of the Customer portal.
  2. Select the license you'd like to modify from the Perpetual License list on the left.
  3. In the Update Server Name section, enter the name of the SQL Server instance housing the SQL Sentry database, and the reason for making this change.
  4. Select Update to update the license. In the License Key form, choose to email the new license key or copy it to the clipboard. 

Product Version Mismatch

SentryOne License Configuration Error Product Verison Mismatch 

Receiving this error indicates that the version number of the license that you're applying isn't valid for the version of SQL Sentry that you're running. 

Note:  This error message may be encountered when you try to apply a license after a major version upgrade because the version number of the license keys are incremented for each major version release.

Resolve this issue by logging into your Customer portal, and then update the license version. To upgrade the license key in the Customer portal, complete the following steps:

  1. Go to the Available Upgrades section in the portal.
  2. Select the license key(s) that you'd like to upgrade, and then select Upgrade.

Note:  Once the license is upgraded, the new license key is emailed to you.

Invalid Signature

SentryOne License Configuration Error Invalid Signature

Receiving this error indicates that the license key has been modified.

Note:  Adding an extra character or space in the license key trigger this error message.

Resolve this issue by selecting the original license key attachment from the licensing email and reapplying it, or select the original license key from the Customer portal and reapply it. 

Invalid License Schema

SentryOne License Configuration Error Invalid License Schema

Receiving this error indicates that the license key has been modified. This error is specific to the license key being modified by an email-security system.

Resolve this issue by selecting the original license key attachment from the licensing email and reapplying it, or select the original license key from the Customer portal and reapply it.

Changing the credentials of the SQL Sentry Monitoring Service Account

To update the account credentials used for the monitoring service, see the Monitoring Service Logon Account article for instructions on using the Service Configuration Utility.

Hosting the SentryOne Database On An Availability Group

Hosting the SQL Sentry database on an availability group gives you a License Key Mismatch error because SQL Sentry recognizes that the SQL Sentry database is part of an Availability Group and is looking for the Availability Group ID, rather than the server currently hosting the database.

To allow licensing to be aware of SQL Sentry database movements and continue working, the Hardware Key must be tied to the Availability Group ID.

You can get this ID by executing the below query against the instance that will be hosting the SQL Sentry database:

SELECT group_id as AG_ID, name
FROM sys.availability_groups

Next, update the hardware key through the Customer portal

Important:  When running the client, use the Listener name for the Server Name. This allows the Monitoring Service to connect regardless of where the database is currently hosted.

SentryOne Database Connection


  1. A
  2. B
  3. B
    1. C