Documentation forSolarWinds Platform Self-Hosted

SolarWinds Observability Self-Hosted 2023.1.1 release notes

Release date: March 29, 2023

Here's what's new in SolarWinds Observability Self-Hosted 2023.1.1. You can find the applicable system requirements here.

To view release notes, system requirements, and product guide PDFs for supported versions of SolarWinds Observability Self-Hosted, see SolarWinds Observability Self-Hosted previous versions. To view release notes for multiple versions and multiple SolarWinds Platform products on a single page, see the release notes aggregator.

SolarWinds Observability Self-Hosted runs on the SolarWinds Platform (self-hosted). SolarWinds Observability Self-Hosted release notes include the updates from the SolarWinds Platform (self-hosted).

Attention 2023.1.1 customers

If you are upgrading from a previous version, be aware of the following considerations.

Upgrading from multiple module license keys to a single SolarWinds Observability Self-Hosted license key

  • If you received multiple module keys when you purchased SolarWinds Observability Self-Hosted, after upgrading to the current version, get your SolarWinds Observability Self-Hosted license key from the customer portal and then activate it in the SolarWinds Platform. This will disable your current module license keys.

Upgrading from Orion Platform 2020.2.6 or older

  • Before upgrading from Orion Platform 2020.2.6 and earlier to SolarWinds Observability Self-Hosted, check the SolarWinds Platform release notes for additional information.

New features and improvements in SolarWinds Observability Self-Hosted Essentials

The following features are exclusive to customers with a SolarWinds Observability Self-Hosted license.

General improvements

  • Stability fixes

Fixed customer issues

Case number Description Platform product
1261783, 1271974, 1286979 Issues with the failed installation of new scalability engines caused by the unavailability of the product catalog in the database after the upgrade were addressed. Platform
1269459, 1275846, 1295464 Performance issues in IPAM caused by selecting root level on Manage Subnets & IP Addresses displaying zones were addressed. Platform
1273177, 1281714, 1285292, 1294327, The issue with incorrect DNS resolution when domain in credentials was different than DNS name suffix was addressed. Platform
1125893, 1220248, 1239230, 1244512, 1249564, 1251466, 1254246, 1258643, 1265533, 1260390, 1264367 Issues caused by partition management during Database Maintenance were resolved. Platform
773793, 916997, 1092088 The issue where after HA additional polling engine failover some of components are not licensed temporarily was addressed. Platform
1270128 The issue where the Configuration Wizard failed on applicationHost.config error was addressed. Platform
1273749 The issue where importing alerts with SQL macro variables was blocked for Admin users was addressed. Platform
1118926 The issue where a PowerShell error occurred while creating a pipeline was addressed. Platform
1052957, 1240424, 1245960, 1256606, 1257671, 1266763, 1276328, 1267382, 1280926 SolarWinds Information Service performance issues when users without admin rights use PerfStack were addressed. Platform
1270355, 1274684, 1305945 The issue where sending a test email fails was addressed. Platform
1268777, 1278049, 1280571, 1283153, 1286165, 1288500, 1290501, 1290756, 1295082, 1298612, 1298775, 1299735 The issue where the IPAM navigation tree was not sorted by Subnet/Group name after the upgrade to 2023.1 was addressed. Platform
1297900 The issue where selecting root level on Manage Subnets & IP Addresses displayed zones and scope data causing performance issues was addressed. IPAM
01279876, 01287977, 01288278, 01271813, 01273317, 01290754, 01293024, 01291507, 01231060, 01290325, 01290883, 01289617, 01295126, 01298316, 01301058, 01301006, 01278279, 01298525, 01303487, 01302920, 01298133, 01305835, 01308353, 01304992, 01309937, 01309270 The message stating SAM maintenance is overdue no longer appears. SAM
01281714, 01294327, 01287132, 01273177, 01285292, 01304703 WinRM connections and communications issues after upgrading from 2022.4 to 2023.1 have been resolved. SAM
01118926 PowerShell script for the WMI-polled nodes are no longer giving pipeline errors. SAM

Installation or upgrade

Use the SolarWinds Installer to upgrade your entire SolarWinds Platform deployment (all SolarWinds Platform products and any scalability engines) to the current versions.

You must be on version 2020.2.1 or later to upgrade to the current version. If you are on 2020.2 or earlier, first upgrade to 2020.2.6 and then upgrade to the current version.

Before you upgrade from 2020.2.x

  • Make sure the database user you use to connect to your SQL Server has the db create privilege. Without this privilege, the upgrade will not complete.

  • The legacy syslog and traps functionality has been retired and replaced with new functionality called SolarWinds Log Viewer, which can be upgraded to Log Analyzer for additional capabilities. Current rules and history will automatically be migrated to the new logging functionality (SolarWinds Log Viewer or Log Analyzer). The functionality of SolarWinds Log Viewer and Log Analyzer has been improved to more closely match legacy functionality.

    If you built syslog and trap alerts using custom SQL queries, they will not function after upgrading to 2022.3 or later. SolarWinds recommends you rewrite the alerts using SWQL (Orion.OLM entities) or using the alerting functionality built into Log Viewer/Log Analyzer.

  • Some upgrade situations from the Orion Platform to the SolarWinds Platform are not supported and the installer will stop the upgrade automatically.

    • If you have a SQL Server older than 2016.
    • If you have an Orion Platform product version 2020.2 or earlier.

DPAIM

DPAIM can be installed in either of the following ways:

  • With SolarWinds SAM

    DPAIM is automatically installed with SolarWinds SAM. If you have SAM, all you have to do is set up the integration module.

    To install SAM, use the SolarWinds Platform Installer.

  • Standalone (SAM not required)

    If you do not plan to install SAM, download and run the SolarWinds Platform Installer to install DPAIM as a separate product. You can install DPAIM alone, or you can install DPAIM with other SolarWinds Platform products, such as SolarWinds SRM.

After you install DPAIM, you must set up the DPA Integration Module.

Known issues

Changes to the SolarWinds Platform database

The implementation of time series widgets required changes to the SolarWinds Platform database. If you have custom reports or alerts that query the database, they could be affected by these changes.

Resolution or workaround: SolarWinds recommends using API calls instead of database queries to collect data for custom reports and alerts.

Date range is one day behind on Wait Time resources

The date on Wait Time Trends resources is one day behind for environments where the DPA server and SolarWinds Platform server are in different time zones. The affected resources are:

  • All Instances with the Highest Wait Times

  • Instances with the Highest Wait Times

  • Greatest Downward Wait Time Trends

  • Greatest Upward Wait Time Trends

Resolution or workaround: Set the DPA and SolarWinds Platform servers to the same time zone.

DPAIM stops working after failover

If you have High Availability configured, the DPA Integration Module stops working when a failover occurs after you re-integrate with a previously integrated DPA server.

Resolution or workaround: Re-integrate the DPA server.

After upgrading, attempting to open an NCM page returns an error

In some environments, after an upgrade to NCM 2020.2.5 or later, NCM pages cannot be accessed. When you attempt to open a page that includes NCM data, such as the Node Details page, the message Request timed out is displayed. This occurs because the SolarWinds.NCM.BusinessLayerPlugin.dll.config file was not updated during the upgrade.

Resolution or workaround: If you encounter this issue, complete the following steps on the main polling engine and all additional polling engines (APEs).

  1. Create a backup copy of the following file, and then remove the file:

    C:\Program Files (x86)\SolarWinds\Orion\NCM\SolarWinds.NCM.BusinessLayerPlugin.dll.config

  2. In the Windows Control Panel, open Programs > Programs and Features.

  3. Right-click SolarWinds Orion Network Configuration Manager and choose Repair.

    The repair process updates the SolarWinds.NCM.BusinessLayerPlugin.dll.config file.

NCM does not show current information about overlapping ACL rules after an upgrade

After you upgrade, NCM does not display current information about shadowed or redundant access control list (ACL) rules. Older information is displayed.

Resolution or workaround: Download the configuration files from your Cisco ASA and Nexus devices. After you download the config files, NCM displays current information about shadowed and redundant ACL rules.

Incorrect size shown for VMware VM snapshots

Pages and reports that show snapshot sizes for VMware VMs can sometimes be incorrect.

"Triggered by Event" widget update delay

The "Triggered by Event" widget may in some cases not show the latest event that triggered the alert.

Monitoring a VMWare vCenter via ROP (Remote Orion Poller) shows unknown status

Unknown status can be incorrectly shown when monitoring a VMWare vCenter through a Remote Orion Poller.

Incorrect AppStack data for vCenters

AppStack data for a vCenter may in some cases be displayed incorrectly when the vCenter is deployed as a virtual machine under an ESXi host that is monitored by the same vCenter.

Account limitations may not work with VIM/VMAN groups

Account limitations may not work correctly in some cases with VIM/VMAN groups.

Custom charts show irrelevant host

Custom charts for VMAN clusters may sometimes show an irrelevant host in the chart legend.

Cluster Memory Utilization alerts sometimes show incorrect host

Incorrect hosts, even ones not in the relevant cluster, can sometimes be shown in Cluster Memory Utilization alerts.

Incorrect status shown for vCenter

If VMAN's polling process has failed for any reason, the last known status for a vCenter is shown in VMAN. This could result in a normal, green status being shown for a vCenter when it shouldn't.

End of life

Version EoL announcement EoE effective date EoL effective date
2020.2.5 January 18, 2023: End-of-Life (EoL) announcement – Customers on SolarWinds Observability Self-Hosted version 2020.2.5 or earlier should begin transitioning to the latest version of SolarWinds Observability Self-Hosted. February 17, 2023: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SolarWinds Observability Self-Hosted version 2020.2.5 or earlier will no longer actively be supported by SolarWinds. February 17, 2024: End-of-Life (EoL) – SolarWinds will no longer provide technical support for SolarWinds Observability Self-Hosted version 2020.2.5.
2020.2.4 October 19, 2022: End-of-Life (EoL) announcement – Customers on SolarWinds Observability Self-Hosted version 2020.2.4 or earlier should begin transitioning to the latest version of SolarWinds Observability Self-Hosted. November 18, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SolarWinds Observability Self-Hosted version 2020.2.4 or earlier will no longer actively be supported by SolarWinds. November 18, 2023: End-of-Life (EoL) – SolarWinds will no longer provide technical support for SolarWinds Observability Self-Hosted version 2020.2.4.
2020.2.1 October 19, 2022: End-of-Life (EoL) announcement – Customers on SolarWinds Observability Self-Hosted version 2020.2.1 or earlier should begin transitioning to the latest version of SolarWinds Observability Self-Hosted. November 18, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SolarWinds Observability Self-Hosted version 2020.2.1 or earlier will no longer actively be supported by SolarWinds. November 18, 2023: End-of-Life (EoL) – SolarWinds will no longer provide technical support for SolarWinds Observability Self-Hosted version 2020.2.1.
2020.2 October 19, 2022: End-of-Life (EoL) announcement – Customers on SolarWinds Observability Self-Hosted version 2020.2 or earlier should begin transitioning to the latest version of SolarWinds Observability Self-Hosted. November 18, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SolarWinds Observability Self-Hosted version 2020.2 or earlier will no longer actively be supported by SolarWinds. November 18, 2023: End-of-Life (EoL) – SolarWinds will no longer provide technical support for SolarWinds Observability Self-Hosted version 2020.2.
2019.4 July 27, 2022: End-of-Life (EoL) announcement – Customers on SolarWinds Observability Self-Hosted version 2019.4 or earlier should begin transitioning to the latest version of SolarWinds Observability Self-Hosted. August 26, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SolarWinds Observability Self-Hosted version 2019.4 or earlier will no longer actively be supported by SolarWinds. August 26, 2023: End-of-Life (EoL) – SolarWinds will no longer provide technical support for SolarWinds Observability Self-Hosted version 2019.4.
2019.2 July 27, 2022: End-of-Life (EoL) announcement – Customers on SolarWinds Observability Self-Hosted version 2019.2 or earlier should begin transitioning to the latest version of SolarWinds Observability Self-Hosted. August 26, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SolarWinds Observability Self-Hosted version 2019.2 or earlier will no longer actively be supported by SolarWinds. August 26, 2023: End-of-Life (EoL) – SolarWinds will no longer provide technical support for SolarWinds Observability Self-Hosted version 2019.2.

See the End of Life Policy for information about SolarWinds product life cycle phases. To see EoL dates for earlier SolarWinds Observability Self-Hosted versions, see SolarWinds Observability Self-Hosted release history.

Deprecation notice

The following platforms and features are still supported in the current release. However, they will be unsupported in a future release. Plan on upgrading deprecated platforms, and avoid using deprecated features.

Port 17778

SWIS REST Endpoint on port 17778 is deprecated as of 2023.1 and will be replaced with port 17774 in a future release. SolarWinds recommends that you start migrating SWIS REST Endpoint to port 17774.

If you are using DPAIM, make sure you are running DPA 2024.2 or later to switch to port 17774. Earlier DPA versions cannot send data to DPAIM on port 17774. See Specify the port DPA uses... for more information.

Starting with 2024.2, you can enable the port in Advanced Configuration by clearing the DisableSwisRestEndpointOnPort17778 option. See Enable/disable the SWIS endpoint port.

Browser support

All versions of Internet Explorer will become unsupported in a future release. Some pages are not compatible with IE 11. Do not enable Enterprise Mode in IE 11. It is not supported.

Network Atlas

Network Atlas is deprecated as of Orion Platform 2020.2. It is still available and supported in the current release, but will be removed in a future release. Deprecation is an indication that you should avoid expanded use of this feature and formulate a plan to discontinue using the feature. SolarWinds recommends that you start using Intelligent Maps in the SolarWinds Platform Web Console to display maps of physical and logical relationships between entities monitored by the SolarWinds Platform products you have installed.

Starting with 2024.2, you can import Network Atlas maps to Intelligent Maps. See Import maps.

Legal notices

© 2023 SolarWinds Worldwide, LLC. All rights reserved.

This document may not be reproduced by any means nor modified, decompiled, disassembled, published or distributed, in whole or in part, or translated to any electronic medium or other means without the prior written consent of SolarWinds. All right, title, and interest in and to the software, services, and documentation are and shall remain the exclusive property of SolarWinds, its affiliates, and/or its respective licensors.

SOLARWINDS DISCLAIMS ALL WARRANTIES, CONDITIONS, OR OTHER TERMS, EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, ON THE DOCUMENTATION, INCLUDING WITHOUT LIMITATION NONINFRINGEMENT, ACCURACY, COMPLETENESS, OR USEFULNESS OF ANY INFORMATION CONTAINED HEREIN. IN NO EVENT SHALL SOLARWINDS, ITS SUPPLIERS, NOR ITS LICENSORS BE LIABLE FOR ANY DAMAGES, WHETHER ARISING IN TORT, CONTRACT OR ANY OTHER LEGAL THEORY, EVEN IF SOLARWINDS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

The SolarWinds, SolarWinds & Design, Orion, and THWACK trademarks are the exclusive property of SolarWinds Worldwide, LLC or its affiliates, are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other SolarWinds trademarks, service marks, and logos may be common law marks or are registered or pending registration. All other trademarks mentioned herein are used for identification purposes only and are trademarks of (and may be registered trademarks) of their respective companies.