Adding your SmartHub license

How to add your SmartHub License

In SmartHub 7.0 and later, a new licensing system was introduced. If you are upgrading to or installing SmartHub 7.0 or later, you must add a valid license to your environment. Depending on the status of your license, a message banner in the SmartHub Administration Portal will display text that states one of the following:

  • Error: Your SmartHub license expired or is invalid.

  • Warning: Your SmartHub license has expired and your software license is currently in a grace period ending on <date>.

  • Warning: Your SmartHub license expires on <date>.

If the license is valid, no banner message is displayed.

Additionally, if you do not have a license configured, admins will be able to use the SmartHub administration portal to configure SmartHub, but no search results will be returned.

To add a license to your SmartHub environment, do the following:

  1. If you do not already have a license file, contact Upland Support.

  2. Save the license file onto the same server as your SmartHub Administration Portal.

  3. Copy the license file and paste it to the License folder in the SmartHub installation folder. The default path is "<Smarthub installation folder>\License\".

  4. The web.config file contains a LicenseFolderPath setting. If you change the default location of the license file, you must update the setting with the new location or name.

  5. After copying the license file, activate the license using the LicenseActivation.exe that is found in the same installation folder. In order to activate the license, you must run the activation .exe, select the copied license, select the product you are activating, and click Submit. After successful activation, you will be able to use SmartHub functionality.

    Internet access is required to activate the license file. If your environment does not have internet access, see

  6. After you have added your license, do the following to confirm that your license is valid:

    1. Navigate to the SmartHub administration portal and confirm that a banner message is not visible.

    2. On the left panel, click General Settings. In the License State field, verify that the correct license is displayed.

Activating your SmartHub license offline

When activating your SmartHub license, an API request is made to https://license.bainsight.com/. To activate the SmartHub license this way, internet access is required. If your network does not allow for internet access, you can use the following steps to activate your license:

  1. On a computer that has internet access, open a browser and navigate to the Upland BA Insight License Management portal.

  2. In the license management portal, click Choose File and select your SmartHub license.

    If you do not already have a license file, you can obtain one by contacting Upland Support.

  3. Click Activate and Download.

  4. Save the activated license file and transfer it to the SmartHub server.

  5. Copy the activated license file to the SmartHub license folder. The default path to this folder is <Installation directory>\Upland BA Insight \Upland BA Insight SmartHub\License.