Tools

Enable HTTPS for Engineer's Toolset on the Web when unable to discover interfaces, volumes, and other components

This article troubleshoots an issue where the Engineer's Toolset on the Web installed on a server with HTTPS enabled is not discovering interfaces, volumes, and other components. The default installation does not connect to HTTPS website and bindings are not set to all unassigned in IIS. ETS Web. No interface, no volume, the discovery not working.

First published date

11/29/2018 10:38 PM

Last published date

3/20/2025 4:52 AM

Overview

Engineer's Toolset on the Web is installed on a server with HTTPS enabled. It is not discovering interfaces, volumes, and other components. 

The following error can occur when running Configuration wizard a second time.

"Exception while configuring plugin Orion Toolset component Toolset Website Cannot create a file when that file already exists"

Step 5 is relevant with this error. 

Another error that can show up is below:

ERROR SolarWinds.Toolset.BusinessLayer.Jobs.JobSchedulerEventsHandler - Unhandled Exception while processing job results.
System.ArgumentException: The provided URI scheme 'https' is invalid; expected 'http'.
Parameter name: via

Product section

Engineers Toolset

Cause

The default installation does not connect to an HTTPS website, and bindings are not set to all unassigned in IIS.

Resolution

**For the latest version of Orion, please use the steps in  Unresponsive tools in the Toolset tab in the Orion web interface



Follow these steps to enable HTTPS functionality for the Engineer's Toolset on the Web. If HTTPS is already enabled in Orion, skip this part and go to the next step.

  1. In the Orion database's website table, confirm that the SSLEnabled value is 1 (enabled).  If SSLEnabled value is 0, use the following query to update the value to 1
    1	UPDATE dbo.Websites
    2	SET SSLEnabled=1
    3	WHERE WebsiteID=1     (NOTE: WebsiteID=1 is the usual value, however your WebsiteID may be different if your primary Orion server has a different WebsiteID. Find your primary server's WebsiteID in the Database Manager before running this query, and use the WebsiteID that matches your environment.)
  2. Please make a backup of the following files (make sure you put the backup in a separate folder, preferably in a separate drive or as long as it is not inside the program files or install directory).
    C:\inetpub\SolarWinds\Orion\Toolset\web.config
    C:\inetpub\SolarWinds\Orion\Toolset\Web_SSL.config
    C:\Program Files (x86)\SolarWinds\Orion\Toolset\SolarWinds.Toolset.BusinessLayer.dll.config
    C:\Program Files (x86)\SolarWinds\Orion\Toolset\SolarWinds.Toolset.BusinessLayer.dll_SSL.config
  3. In C:\inetpub\SolarWinds\Orion\Toolset, rename the file web.config to web_http.config.
  4. In C:\inetpub\SolarWinds\Orion\Toolset, rename the file Web_SSL.config to web.config
  5. In C:\Program Files (x86)\SolarWinds\Orion\Toolset (Toolset default installed location), rename SolarWinds.Toolset.BusinessLayer.dll.config to SolarWinds.Toolset.BusinessLayer.dll_http.config.
  6. In C:\Program Files (x86)\SolarWinds\Orion\Toolset (Toolset default installed location), rename SolarWinds.Toolset.BusinessLayer.dll_SSL.config to SolarWinds.Toolset.BusinessLayer.dll.config.
  7. With Notepad run as Administrator, edit the following files.
    C:\inetpub\SolarWinds\Orion\Toolset\web.config and C:\inetpub\SolarWinds\Orion\Toolset\web_http.config files.
    Could you set the value for CustomBaseServiceURL to the URL of the Orion web interface? For example: 
    <add key="CustomBaseServiceUrl" value="https://myorion.domain.com"/>
  8. Restart all Orion services using Orion Service Manager.

Note:
Do not leave a copy of the SolarWinds.Toolset.BusinessLayer.dll_SSL file in the directory or any of the program files directory. Move it to the backup folder if needed.

**For HA (High Availability Environments)  Please disable the HA pools first before performing the steps above.


If the above procedure does not work, do the additional instructions below.

  1. Enable WCF HTTP Activation in IIS in the Control Panel on the SolarWinds server as described below:
    • Control Panel >Turn Windows features on or off > Next> In features, select .Net FFrameworkFeatures > Expand WCF Services > Select HTTP Activation>Install
  2. Restart all Orion services using Orion Service Manager.

Update:
For HCO environments, the files would be in  C:\ProgramFiles\SolarWinds\Orion\Web\Orion\Toolset\web.config

 

On Version: 2025.1

  • In order to view the Toolset options on version 2025.1, you would need to enable the ETS options for the user. Kindly follow the steps below.

1. In the Web Console, modify the URL in the browser using "Orion/Toolset/Admin/LicenseSettings/Default.aspx". For example, https://{hostname}/Orion/Toolset/Admin/LicenseSettings/Default.aspx. Kindly see the sample screenshot below.

Image_2025-03-17_08-59-55.png

2. Select place a check on the user.

3. Then click on Enable.

4. Log into the Web Console using the user credentials.

5. Go to a node and the user will be able to see the Toolset options now.