Observability

Calls on SWIS endpoint breaks with error "405 Method Not Allowed" after upgrading to SolarWinds Platform 2024.2 and above

Starting with SolarWinds Platform 2024.2 and above, the SWIS TCP port has been changed from 17778 to 17774, by default. This change aims to enhance security and streamline network configurations.

First published date

6/11/2024 4:54 PM

Last published date

2/12/2026 1:31 AM

Overview

In the SolarWinds Platform 2024.2 and above, the SWIS TCP port configuration was moved from 17778 to 17774 by default.

Logs would give similar wordings from below for the error message:
 
INFO SolarWinds.InformationService.Core.InformationServiceService - (null) (null) Trying to find swis REST endpoint certificate according certificate name: sanitized.orionurl.here
2024-01-22 10:11:03,559 [9] INFO SolarWinds.InformationService.Core.InformationServiceService - (null) (null) For safequard SWIS REST endpoint on address https://sanitized.orionurl.here:17774/SolarWinds/InformationService/v3/Json will be used certificate with name: 
2024-01-22 10:11:03,559 [9] INFO SolarWinds.InformationService.Core.InformationServiceService - (null) (null) For safequard SWIS REST endpoint on address https://sanitized.orionurl.here:17774/SolarWinds/InformationService/v3/OrionBasic will be used certificate with name: sanitized.orionurl.here, 
2024-01-22 10:11:03,574 [9] INFO SolarWinds.InformationService.Core.InformationServiceService - (null) (null) No sslcert http configuration for endpoint 0.0.0.0:17774 exists. Creating a new one. System.IO.FileNotFoundException: No SSL Certificate configuration for IP Endpoint 0.0.0.0:17774 could be found. ---> System.ComponentModel.Win32Exception (0x80004005): The system cannot find the file specified
at SolarWinds.Orion.Common.HttpSys.DeleteSslCertConfig(IPEndPoint endpoint)
at SolarWinds.InformationService.Core.InformationServiceService.AddHttpSysSslCertConfig(Int32 port, X509Certificate2 cert)
2024-01-22 10:11:03,590 [9] ERROR SolarWinds.InformationService.Core.InformationServiceService - (null) (null) Information Service failed to open a channel.
System.ComponentModel.Win32Exception (0x80004005): A specified logon session does not exist. It may already have been terminated
at SolarWinds.Orion.Common.HttpSys.AddSslCertConfig(Guid appId, IPEndPoint endpoint, Byte[] sslHash)
at SolarWinds.InformationService.Core.InformationServiceService.AddHttpSysSslCertConfig(Int32 port, X509Certificate2 cert)
at SolarWinds.InformationService.Core.InformationServiceService.SetupCertificateForRestEndpoints(ServiceHost serviceHost, Uri baseAddressInfoSvcOnly)
at SolarWinds.InformationService.Core.InformationServiceService.CreateService(ServiceElement serviceElement, String dnsHostName, Uri baseAddress, Uri baseAddressInfoSvcOnly, WcfBootstrapper& bootstrapper)
at SolarWinds.InformationService.Core.InformationServiceService.Start(InformationServiceSettings settings, String baseAddress, String baseAddressHttps, String configurationFile)
2024-01-22 10:11:03,621 [9] INFO SolarWinds.InformationService.Core.InformationServiceService - (null) (null) Information Service communication stopped.
Sending 'GET' request to URL :
https://sanitized.orionurl.here:17778/SolarWinds/InformationService/v3/json/query?query=SELECT+NodeID,IPAddress,Caption,NodeDescription,Description,Severity,Status,StatusDescription,UnManaged+FROM+Orion.Nodes

Sending 'GET' request to URL :
https://sanitized.orionurl.here:17778/SolarWinds/InformationService/v3/json/query?query=SELECT+NodeID,IPAddress,Caption,NodeDescription,Description,Severity,Status,StatusDescription,UnManaged+FROM+Orion.Nodes
2024-04-22 19:17:22,565 [ceeview-0024 [SolarWindsHealthMonitor]] DEBUG com.ceesoft.ceeview.healthmonitor.solarwinds.UrlClient - Response Code : 405
2024-04-22 19:17:22,565 [ceeview-0024 [SolarWindsHealthMonitor]] DEBUG com.ceesoft.ceeview.healthmonitor.solarwinds.UrlClient - Response Message: Method Not Allowed
2024-04-22 19:17:22,565 [ceeview-0024 [SolarWindsHealthMonitor]] ERROR com.ceesoft.ceeview.healthmonitor.solarwinds.SolarWindsClient - Exception from getPageContent: request failed: Method Not Allowed
com.ceesoft.ceeview.core.common.exceptions.ExecutionException: request failed: Method Not Allowed
 (/SolarWinds/InformationService/v3/Json/Query) with code: 405
There was no endpoint listening at https://sanitized.orionurl.here:17778/SolarWinds/InformationService/v3/json/query?query=SELECT+NodeID,IPAddress,Caption,NodeDescription,Description,Severity,Status,StatusDescription,UnManaged+FROM+Orion.Nodes that could accept the message.  This is often caused by an incorrect address or SOAP action.  See InnerException, if present, for more details.

Product section

Hybrid Cloud Observability

Cause

The primary reason for changing the SWIS TCP port from 17778 to 17774 and disabling it by default is to enhance security and minimize potential vulnerabilities. By disabling the port initially, the update aims to reduce unauthorized access and ensure that network communications occur only through explicitly enabled channels.

Refer to SolarWinds Platform 2024.2 Release notes.

Resolution

For customers who have developed custom SWIS scripts that specifically reference port 17778 will need to adjust their scripts or re-enable the port in the settings. Here are the steps to resolve any issues related to this change:

Update Custom Scripts:

Customers should modify their custom SWIS scripts to use port 17774 instead of 17778. This involves finding and replacing the port number in the script's configuration, only if the script explicitly indicates a port.

Enable the New Port:

If updating the script is not feasible or if there are other dependencies, customers can re-enable the previous port by adjusting the settings in the HCO configuration.
  1. Open the custom SWIS script.
  2. Locate the section where the port number is (if)specified.
  3. If the script explicitly indicates port 17778, change the port number to 17774.
  4. Save the script and test it to ensure it functions correctly with the new port configuration.

Steps to Re-enable the Old Port:

  1. In http://OrionHostname/Orion/admin/AdvancedConfiguration/global.aspx, configure the following settings:
    • Set CertificateNameForSafeguardCommunicationOnSwisRestEndpoint to SolarWinds-Orion
    • Uncheck DisableSwisRestEndpointOnPort17778
Example Screenshot:
image.png
  1. Click SAVE
  2. Restart all Orion services from main and additional polling engine/web servers.