SAM 2023.1 release notes
Release date: February 15, 2023
Last updated: September 30, 2024
New features and improvements in SAM: September 30, 2024
Here's what's new in SAM 2023.1. You can find the applicable system requirements here.
To view release notes, system requirements, and product guide PDFs for supported versions of SAM, see SAM previous versions. To view release notes for multiple versions
SAM runs on the SolarWinds Platform (self-hosted). SAM release notes include the updates from the SolarWinds Platform (self-hosted).
Attention 2023.1 customers
SAM 2020.2.1 can be upgraded from versions 2020.1 and later. If you are running a version earlier than SAM 2020.2.1, please upgrade to SAM 2020.2.6 first and then upgrade to SAM 2023.1.
New features and improvements in SAM
Last updated: September 30, 2024
Improved performance of APM DynamicEvidence
As part of performance improvements, the APM_DynamicEvidence_DetailData table has been removed. The new APM_DynamicEvidence_Current table contains the last value for both numeric and string values including the row and schema id. As a result of this change, scripts referencing the APM_DynamicEvidence_DetailData table will no longer work.
Cloud monitoring improvements
Availability Zone data related to the entities your are monitoring in the cloud are now stored with the entity and used for logical grouping in the Cloud Server Infrastructure widget, filtering in the Cloud Instances Status Summary widget and also in pop overs for individual entities.
New features and improvements in SolarWinds Platform
AlertStack
AlertStack is a new feature that can help reduce alert noise and assist in possible root cause analysis to give you a quicker MTTR (mean time to resolution). AlertStack is an opt-in feature that must be turned on in AlertStack settings. AlertStack continually monitors alerts and change events and correlates these using SolarWinds Platform topological information, pulling associated events and alerts together into a single alert cluster. The alert cluster stays activated, and correlated alerts will continue to be added to the cluster, for as long as any associated alerts remain active.
AlertStack is disabled by default and can be enabled after upgrading by navigating to All Settings > Product Specific Settings > AlertStack Settings.
Additional updates
- SolarWinds Platform Agent installer packages and Linux/AIX repositories are signed.
- SWIS REST Endpoint is now available on port 17774. You can use a custom HTTPS certificate for this port and disable SWIS REST endpoint on 17778. See Disable port 17778 for SWIS Endpoint.
- In 2023.1, you can continue using port 17778. However, please note that it is being deprecated and will not be supported in a future version.
- SolarWinds Platform 2023.1 improves the Kerberos protocol for WMI authentication by adding support for the SAM module. See Configure Kerberos for WMI authentication.
Fixed CVEs
At SolarWinds, we prioritize the swift resolution of CVEs to ensure the security and integrity of our software. In this release, we have successfully addressed the following CVEs.
SolarWinds CVEs
SolarWinds would like to thank our Security Researchers below for reporting on the issue in a responsible manner and working with our security, product, and engineering teams to fix the vulnerability.
| CVE-ID | Vulnerability Title | Description | Severity | Credit |
|---|---|---|---|---|
| CVE-2022-38111 | SolarWinds Platform Deserialization of Untrusted Data Vulnerability | The SolarWinds Platform was susceptible to the Deserialization of Untrusted Data vulnerability. This vulnerability allows a remote adversary with SolarWinds admin-level account access to messaging service to execute arbitrary commands. | 7.2 Medium | Piotr Bazydlo (@chudypb) of Trend Micro Zero Day Initiative |
| CVE-2022-47504 | SolarWinds Platform Deserialization of Untrusted Data Vulnerability | The SolarWinds Platform was susceptible to the Deserialization of Untrusted Data vulnerability. This vulnerability allows a remote adversary with SolarWinds admin-level account access to messaging service to execute arbitrary commands. | 8.8 High | Piotr Bazydlo (@chudypb) of Trend Micro Zero Day Initiative |
| CVE-2022-47503 | SolarWinds Platform Deserialization of Untrusted Data Vulnerability | The SolarWinds Platform was susceptible to the Deserialization of Untrusted Data vulnerability. This vulnerability allows a remote adversary with SolarWinds admin-level account access to messaging service to execute arbitrary commands. | 8.8 High | Piotr Bazydlo (@chudypb) of Trend Micro Zero Day Initiative |
| CVE-2022-47506 | SolarWinds Platform Directory Traversal Vulnerability | The SolarWinds Platform was susceptible to the Directory Traversal vulnerability. This vulnerability allows a local adversary with authenticated account access to edit the default configuration, enabling the execution of arbitrary commands. | 8.8 High | Piotr Bazydlo (@chudypb) of Trend Micro Zero Day Initiative |
| CVE-2022-47507 | SolarWinds Platform Deserialization of Untrusted Data Vulnerability | The SolarWinds Platform was susceptible to the Deserialization of Untrusted Data vulnerability. This vulnerability allows a remote adversary with SolarWinds admin-level account access to messaging service to execute arbitrary commands. | 8.8 High | Piotr Bazydlo (@chudypb) of Trend Micro Zero Day Initiative |
| CVE-2023-23836 | SolarWinds Platform Deserialization of Untrusted Data Vulnerability | The SolarWinds Platform was susceptible to the Deserialization of Untrusted Data vulnerability. This vulnerability allows a remote adversary with SolarWinds admin-level account access to messaging service to execute arbitrary commands. | 8.8 High | Piotr Bazydlo (@chudypb) of Trend Micro Zero Day Initiative |
| CVE-2022-47508 | Disable NTLM: SAM 2022.4 | Customers who had configured their polling to occur via Kerberos did not expect NTLM Traffic on their environment, but since we were querying for data via IP address this prevented us from utilizing Kerberos. | High |
Fixed customer issues
| Case number | Description | Platform product |
|---|---|---|
| 1227289, 1236663, 1236783, 1241870, 1242442, 1244793, 1245886, 1249353, 1257864, 1267299, 1268906, 1274633, 1288868 | Issues with adding Windows user accounts in the SolarWinds Platform Web Console were addressed. | Platform |
| 938365, 987784, 1049100, 1084320, 1120320, 1183057 | The issue where the Database Maintenance failed to execute 'Finalize Maintenance' was addressed. Fixed in the GA version. | Platform |
| 1268655, 1268939, 1270366, 1273013, 1275253 | The SQL Script issue preventing the Configuration Wizard from completing was addressed. Fixed in the GA version. | Platform |
| 1253873, 1254055, 1254256, 1254257, 1254265, 1254276, 1254278, 1254303, 1254316, 1254326, 1254333, 1254339, 1254372, 1254403, 1254405, 1254414, 1254435, 1254499, 1254502, 1254523 | Auto-geolocation issues in the Worldwide Map were addressed. Fixed in the GA version. | Platform |
| 1229888, 1235682 | The issue where HTML reports layout was broken when using the MailBee SMTP client was addressed. | Platform |
| 1208950, 1226555, 1234992 | The issue where upgrading Scalability Engines failed when the SolarWinds Administration service on the main polling engine had been updated was addressed. | Platform |
| 1230025 | The issue where pre-staging of upgrade files failed was addressed. | Platform |
| 1204779, 1206691, 1233017, 1243901 | The issue where the Configuration wizard failed to connect to RabbitMQ because of a timeout was addressed. | Platform |
| 1241585 | Offline help instructions were updated. | Platform |
| 1211020, 1214429 | The issue where new SolarWinds Platform Agent installations were not using FQDN was addressed. | Platform |
| 1197599, 1248066 | The issue where a new SolarWinds Platform database could not be installed on Azure SQL due to incorrectly detected SQL version was addressed. | Platform |
| 1212089 | The issue where a table widget did not update vendor icon properly was addressed. | Platform |
| 1105407, 1192112, 1201507, 1213144 | The issue where the Custom Properties for Nodes widget didn’t show data was addressed. | Platform |
| 1197642 | The issue where shared actions are not re-created during alert import when the original shared action doesn’t exist were addressed. | Platform |
| 1201173 | The issue where the Configuration Wizard enabled Windows Authentication even if the user did not select the option was addressed. | Platform |
| 1198432 | The issue where the Maintenance Expiration pre-installation check did not work for old bundle licenses was addressed. | Platform |
| 1195664 | The issue where a group added on a Intelligent Map was not shown an All Groups was addressed. | Platform |
| 1162734 | The issue where a 2020.2.* installer could not be used on an environment where a 2022.* installer was run was addressed. | Platform |
| 1237949 | The HTTP 500 Internal Server Error caused by blank StyleSheet setting was addressed. | Platform |
| 636868 | The issue where the Database Maintenance failed was addressed. | Platform |
| 1132904 | The issue where SolarWinds Platform Agent installed in the root folder ended non-SolarWinds Platform Agent processes was addressed. | Platform |
| 1190747 | The issue where canceling an upgrade stuck on Active Diagnostics tests was addressed. | Platform |
| 1185124 | The issue where PDF reports generated by alert or report actions were blurred by a Pendo popup was addressed. | Platform |
| 444472, 479695 | The issue where topology polling timeout was not retained after the upgrade was addressed. | Platform |
| 1218043 | The issue when running a simple task in the Unmanage Utility was addressed. | Platform |
| 561899, 1120328 | The issue where special characters in the preview blocked creating a report was addressed. | Platform |
| 732106, 1120328 | The issue where reports failed due to a 'hexadecimal value 0x01 is an invalid character' message was addressed. | Platform |
| 809693 | The issue where the SNMPv3 credentials set was updated unexpectedly on the Edit Node view was addressed. | Platform |
| 1151608, 1193149, 1202770, 1205056, 1216386, 1231980, 1235579, 1242067, 1252490 | The issue where groups based on node custom properties are unsorted in widgets was addressed. | Platform |
| 1162222 | The issue where a LogAdjuster record for SAML and Account Management was missing was addressed. | Platform |
| 615600, 947219, 947737, 989480 | The issue where unmanaged status was incorrectly used for group availability was addressed. | Platform |
| 46302, 213954, 255637, 691325, 777333 | The issue where List Resources cannot proceed a big number of resources thus preventing the user to add a node was addressed. | Platform |
| 1094013 | The issue with filters in the Worldwide Map widget was addressed. | Platform |
| 915697 | The issue where Linux agent deployment methods were not working with FIPS was addressed. |
Platform |
| 938027 | The issue where the Discovery job keeps WMI attempts when WMI credentials are deleted was addressed. | Platform |
| 00666976 | SAM 2020.2.1 no longer automatically upgrades Orion agents to .net 4.8. |
SAM |
| 00519354, 00574585, 00625367 | The Component Details Widget no longer shows the |
SAM |
| 00317146 | The variable for warning and critical statistic threshold is now working for the Linux component. |
SAM |
| 01000359 | The temp table column no longer shows the wrong data type. |
SAM |
| 00603123 | The Start/Restart services buttons now work on the Component Details Widget. |
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
Bad Request error when creating new API Poller
A Bad Request error can appear when creating a new API Poller.
Resolution or workaround: Complete the following steps.
-
Edit the API Poller that has a Bad request error.
-
Click Configure.
-
Turn off the Use custom polling interval option.
-
Save the API Poller.
OpenJDK15 included with SAM, to connect to JBoss using JConsole with either protocol, remote+http or remoting-jmx, results in errors
Different versions of JBoss use different protocol, as shown below.
-
WildFly 8, 9, and 10 and JBoss EAP 7 use protocols: service:jmx:remote+http://ip:9990 or service:jmx:remote+https://ip:9994
-
JBoss EAP 6 and JBoss AS 7 use protocol: service:jmx:remoting-jmx://ip:9999
-
JBoss EAP 5.2 and JBoss AS 6.1 use protocol: service:jmx:rmi:///jndi/rmi://ip:1090/jmxrmi
Resolution or workaround: In order for the SAM JMX Monitor to connect, copy the jboss-cli-client.jar provided by the JBoss EAP installation to a location in SolarWinds Platform. Add the path location in jsl64.ini and then restart the JMXBridge service through Orion Service Manager.
If using JConsole to connect to a remote JBoss server for testing or troubleshooting purposes, install the latest JDK version on SolarWinds Platform server that supports jconsole.jar, and make sure JConsole uses the new JDK path.
Exchange AppInsight is not discovered and the wizard hangs
When adding Exchange 2016 node to be monitored via WMI polling method, Exchange AppInsight is not discovered and the wizard hangs.
Resolution or workaround: In Network Discovery, avoid discovering Exchange 2016 nodes via WMI. Before discovery, add them under Add node Wizard as described below.
-
Choose ICMP polling method.
-
Finish the wizard.
-
Manually assign Exchange AppInsight.
-
Choose Agent polling method.
Last updated: November 1, 2023
Database login fails for Windows accounts after the upgrade
When you use Windows authentication to connect to the HCO database and the database SQL server, you can find Database: Login failed for user 'DOMAIN\MACHINENAME$' in the Website log. This can cause intermittent user logouts from the SolarWinds Web Console.
Resolution or workaround: Change the database account. See Database login failing for Windows account users after upgrading to 2023.1 and above.
2023.1 RC displayed as the GA version in Centralized Upgrades
When you upgrade SolarWinds Platform from 2023.1 RC1 to the GA version, the UI displays upgrade from 2023.1 to 2023.1.
Resolution or workaround: Not available. Functionality is not impacted.
Remanaging nodes triggers the Node Reboot alert
When you unmanage a remanage node, the Node Reboot alert gets triggered.
Resolution or workaround: Before unmanaging nodes, disable the Node Reboot alert. See Mute alerts.
Database maintenance errors related to CMAN_Containers
When you run Database Maintenance, errors including CMAN_Container errors are available in the logs.
Resolution or workaround: Not available. Functionality is not impacted.
SolarWinds Information Service performance issues when users without admin rights use PerfStack
If users without administrator rights open PerfStack views after the upgrade to 2023.1, SolarWinds Information Service (SWIS) performance issues might occur. SWIS log includes error messages and the SolarWinds Platform Web Console displays warnings about long-running queries.
Resolution or workaround: Restart the SWIS service.
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.
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 SAM version 2020.2.5 or earlier should begin transitioning to the latest version of SAM. | February 17, 2023: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SAM 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 SAM version 2020.2.5. |
| 2020.2.4 | October 19, 2022: End-of-Life (EoL) announcement – Customers on SAM version 2020.2.4 or earlier should begin transitioning to the latest version of SAM. | November 18, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SAM 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 SAM version 2020.2.4. |
| 2020.2.1 | October 19, 2022: End-of-Life (EoL) announcement – Customers on SAM version 2020.2.1 or earlier should begin transitioning to the latest version of SAM. | November 18, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SAM 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 SAM version 2020.2.1. |
| 2020.2 | October 19, 2022: End-of-Life (EoL) announcement – Customers on SAM version 2020.2 or earlier should begin transitioning to the latest version of SAM. | November 18, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SAM 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 SAM version 2020.2. |
| 2019.4 | July 27, 2022: End-of-Life (EoL) announcement – Customers on SAM version 2019.4 or earlier should begin transitioning to the latest version of SAM. | August 26, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SAM 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 SAM version 2019.4. |
| 2019.2 | July 27, 2022: End-of-Life (EoL) announcement – Customers on SAM version 2019.2 or earlier should begin transitioning to the latest version of SAM. | August 26, 2022: End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SAM 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 SAM version 2019.2. |
See the End of Life Policy for information about SolarWinds product life cycle phases. To see EoL dates for earlier SAM versions, see SAM 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.