SAM 2020.2.5 Release Notes
Release date: March 25, 2021
This topic was last updated on May 10, 2023.
These release notes describe new features, improvements, and fixed issues in the SolarWinds Server & Application Monitor (SAM) 2020.2.5 service release. They also provide details about installation, upgrades, and workarounds for known issues.
These release notes provide the following details:
- New features and improvements in SAM
- New customer installation
- How to upgrade
- Fixed issues
- Known issues
- End of life
- Legal notices
Learn more
- For related documentation, see:
- Looking for release notes from earlier versions? See Previous Versions.
- SAM 2020.2.5 runs on Orion Platform 2020.2.5.
- For details about the latest hotfixes, see SAM hotfixes and Orion Platform hotfixes.
New features and improvements in SAM
SAM 2020.2.5 includes the following updates:
- Expanded integration with SolarWinds AppOptics: If you use SAM with either AppOptics or the APM Integrated Experience that includes AppOptics, Loggly, and Pingdom, you can track service status and metrics on the new APM Services page.
APM service details also appear in a new widget on the SAM Summary page. - Manage Credentials page: Use this new page as a centralized place to manage:
- API Key, Basic Auth, Bearer Token, and OAuth 2.0 credentials for API pollers, and
- SolarWinds Cloud Tokens for the new APM Services page.
- API Poller improvements: Save response headers for use as variables in subsequent requests, which can be helpful if you want to reuse cookies included in set-cookie headers.
Through April 2021, share your homegrown API pollers on THWACK for a chance to win prizes and earn THWACK points. For details, see Wanted: API Pollers — Claim Your Bounty.
You can also delete API poller credentials on the new Manage Credentials page.
- Increased automation: The
CreateApplication
verb in the Orion SDK was updated to support AppInsight applications, so you can use PowerShell scripts to interact directly with SWIS and add AppInsight templates to nodes. A script to add the Windows Scheduled Tasks Monitor (WSTM) is also available. Download scripts here. - Application Dependency updates: Queries and connection-matching algorithms were revamped to improve performance by reducing SolarWinds Platform server CPU usage when detecting connections and processing data. Polling is now restricted to the Main Polling Engine, which receives data from Additional Polling Engines via agents and agent plugins.
- AWS region updates: The following new regions are enabled by default for standard AWS accounts used in SAM and other SolarWinds Platform modules that support cloud infrastructure monitoring:
- Africa (Cape Town)
- Asia Pacific (Hong Kong)
- Europe (Milan)
- Europe (Stockholm)
- Middle East (Bahrain)
The following new regions are also available, but disabled by default. To enable them, see this article.
- Asia Pacific (Osaka-Local)
- AWS GovCloud (US-East)
- China (Ningxia)
You can access this new page from the Global SAM Settings section of the SAM Settings page.
To learn about security improvements, see the Orion Platform 2020.2.5 Release Notes.
New customer installation
Use the Orion Installer, available in the Customer Portal, to install SAM. See the Orion Platform Products Installation and Upgrade Guide for details. After installation, see the SAM Getting Started Guide to learn about configuring and customizing SAM.
How to upgrade
To prepare for the upgrade:
- Read these Release Notes.
- Confirm that all servers comply with SAM 2020.2 System Requirements.
- (Optional) Back up custom code, such as modified SolarWinds .css files or added .js files.
If upgrading from a previous version, note the following details:
- To collect trust data for Global Catalog (GC) servers, AppInsight for Active Directory uses port 3268. If a GC domain controller uses port 3269 instead, update that setting in application monitors assigned to nodes.
- If using deprecated Syslog and Traps, note that they will be replaced by the Orion Log Viewer (OLV) feature in a future release, likely in 2022.
- The Application Dependencies feature is disabled during upgrades to avoid performance issues in large environments. After upgrading, enable it to restart polling.
- If you exceed recommended cloud monitoring limits and receive a 503 Service Unavailable error when adding Azure accounts, click here for a workaround.
- To monitor Exchange Server 2016 or later with AppInsight for Exchange, install PowerShell 5.1 and provide local Administrator rights.
- SAM 2020.2.5 uses OpenJDK 15. If upgrading to OpenJDK 16 or later, see this Success Center article about
CustomWorkerCommandParams
changes in Advanced Configuration settings. - If monitoring containers in your SAM environment, the Kubernetes (K8s) script was updated for Kubernetes 1.16. To download a script for an earlier version, see this article.
- If you upgrade to a localized version of SAM, application monitor templates with new versions that support localization are replaced. Back up any SAM templates and application monitors modified with custom changes. You cannot roll back to English after installing the SolarWinds Platform in another language.
-
Due to Microsoft end-of-support for Basic Authentication in Exchange Online APIs, the following application monitor templates are no longer included in SAM. Consider using API poller templates instead.
- Microsoft Office 365 Exchange Online
- Microsoft Office 365 Mobile Device Management
- Microsoft Office 365 Portal
- Microsoft Office 365 Subscription
- The following application monitor templates are no longer included in SAM, but remain available in THWACK. Click here for the latest templates, including a Citrix Hypervisor template that replaces the Citrix XenServer template.
- Citrix PVS Accelerator for XenServer
- Citrix XenApp 5.0 Core WMI Counters
- Citrix XenApp 5.0 ICA Session WMI Counters
- Citrix XenApp 5.0 Presentation Server WMI Counters
- Citrix XenApp 5.0 Services
- Citrix XenServer
- The following application monitor templates are no longer included in SAM, but remain available in THWACK. Use AppInsight for SQL to monitor the NTA Flow Storage Database instead.
- SolarWinds NetFlow Traffic Analyzer Database
- SolarWinds NetFlow Traffic Analyzer
- The Orion Server 2017.3 and SolarWinds Failover Engine templates were replaced by Orion Server 2020.2 templates. Deprecated templates remain in THWACK and legacy SAM installations.
- Starting in SAM 2020.2.5,
apiversion=v1.0
is required in PowerShell scripts for legacy Microsoft Office 365 Teams and Microsoft Office 365 OneDrive application monitor templates and related application monitors. Otherwise, scripts return[ERROR] The remote server returned an error: (404) Not Found.
messages. Consider using a Microsoft 365 API poller templates instead.
Check THWACK periodically for updates to SAM application monitor templates. Apart from AppInsight templates, those templates are not updated automatically during upgrades, to avoid overwriting any custom changes. For details, see Import and export SAM application monitor templates.
Begin the upgrade
To upgrade your entire Orion deployment, including all Orion Platform products and any scalability engines, run the SolarWinds Orion Installer. Alternatively, upgrade SAM directly from the Orion Web Console by clicking Settings > My Orion Deployment.
Learn more:
- To upgrade SAM and other Orion Platform products, see the Orion Platform Products Installation and Upgrade Guide.
- Do you need to migrate as part of your upgrade? See the Migration Guide.
- To upgrade your scalability engines such as Additional Polling Engines and Additional Web Servers, see Options for upgrading scalability engines.
Fixed issues
Case number | Description |
---|---|
00540852, 00106094, 00539252 |
Days Remaining values in SSL Certificate Expiration and IIS SSL Certificate Expiration widgets reflect the latest data monitored by AppInsight for IIS. |
00205048, 00268181, 00286434, 00446482 |
Application Dependency polling succeeds without exceptions related to duplicate node IDs in the dbo.AgentManagement_Agents table. |
00430879 |
The ServiceDirectoryClient component was updated to prevent high memory utilization and exceptions related to memory leaks linked to the SolarWinds.ServiceHost.Process and the ServiceDirectoryClient component. |
00735548 |
A SolarWinds.Agent.JobEngine.plugin was updated to prevent orphaned processes that cause high CPU loads on AIX servers. |
00607138, 00659629 |
The DHCP User Experience Monitor supports multiple instances running on the same polling engine without mutex-related timeout exceptions. |
00632932 |
The Application Details widget on the AppInsight for Active Directory view uses the local time zone for the Last Successful Poll time, instead of UTC. |
00624563, 00621720, 00510286, 00544651 |
The Asset Inventory feature can poll for warranty data on Dell M100e and Dell PowerEdge servers. Click here for details. |
00651272 |
When upgrading from a SAM 2019.4 environment with Azure SQL, the Configuration Wizard does not display "invalid object name sys.database_mirroring" messages. |
SolarWinds would like to thank our Security Researchers for reporting issues in a responsible manner and working with our security, product, and engineering teams to fix vulnerabilities.
CVE-ID | Vulnerability Title | Description | Severity | Credit |
---|---|---|---|---|
CVE-2021-27277 | Deserialization of Untrusted Data Privilege Escalation Vulnerability | A vulnerable endpoint existed in the Cloud Virtual Infrastructure Monitor (VIM) business layer. A local attacker could leverage this to perform deserialization and execute arbitrary code as SYSTEM. | High | Harrison Neal, ZDI Trend Micro |
To address this issue, SolarWinds recommends using latest version of SAM and the SolarWinds Platform, including hotfixes and service releases. Block low-privilege access to Windows servers hosting the SolarWinds Platform products. Additional recommendations include:
- Apply proper segmentation controls on the network where you deploy the SolarWinds Platform and SQL Server instances.
- Implement strict access control and auditing in your environment at operating system and network layers. Limit access to the SolarWinds Platform and SQL server instances to only those authorized persons who require access as part of their duties.
- Separate SolarWinds Platform servers from your infrastructure on managed VLANs and jumpboxes.
See also Secure Configuration for the Orion Platform.
Known issues
Issue | Notes |
---|---|
AIX template scripts may fail for some component monitors if the "Inherit credentials from node" option is enabled. Header issues in Perl script output block component monitors from inheriting credentials from nodes. This may impact CPU statistics, Paging statistics/sec, Disk operations/sec of system devices, and Top 10 Active Process metrics displayed in widgets. |
As a workaround, edit component monitors to provide credentials, or avoid using "Inherit credentials from node" option. Click here for details. |
Some SAM pages and widgets related to features introduced in SAM 2020.2 are not compatible with Internet Explorer (IE) 11. | Use a Chrome, Firefox, or Microsoft Edge browser instead of IE. |
A known Microsoft issue may create inconsistency in SAM SQL tables, as indicated by a Database Integrity Check message. |
As a workaround, back up the Orion database and execute a SQL query provided here. |
Windows Scheduled Tasks Monitor (WSTM) polling fails for Active Directory nodes with UPN-formatted credentials. "Access is denied" errors appear in Windows Scheduled Tasks widgets. | As a workaround, use the down-level logon name format (domain\user) instead of UPN format (user@domain). Click here for details. |
Microsoft Windows Server 2008 R2-2012 R2 Failover Cluster (Advanced) template fails with errors and node status switches to Down. | If the 64-bit FailoverClusters module conflicts with PowerShell bitness and polling fails, modify scripts in the application monitor assigned to the node. Click here for details. |
Warranty data does not appear after Asset Inventory polling of HPE Proliant servers. | API changes made by HP interrupt polling. No workaround is currently available. Click here for details. |
Starting in SAM 2020.2, Application dependency polling is not supported on target Linux systems that use GNU C Library (glibc) 2.17 or earlier. |
Agent plugins include an Nping executable binary that doesn't support distributions based on glibc 2.17 or earlier, such as CentOS and RHEL 6. As a workaround, update Linux distributions on target systems. Test updates in an experimental OS. |
Summary data for monitored containers does not appear in the AppStack Environment widget on the Node Details page. | As a workaround, display data in the main AppStack Environment instead. In the SolarWinds Platform Web Console, click My Dashboards > Environment. |
Deprecation notice
This version of SAM deprecates the following platforms and features. Features are still supported in the current release, but will be removed in a future release. Avoid using deprecated features.
Type | Details |
---|---|
Syslog and Traps |
If you use legacy Syslog and Traps, note that both features will be replaced by the Orion Log Viewer in a future release, likely to occur in 2022. |
End of life
See the End of Life Policy for details about life cycles for SolarWinds products.
EoL Announcements | EoE Effective Dates | EoL Effective Dates |
---|---|---|
June 4, 2020 End-of-Life (EoL) announcement – Customers on SAM 6.6 and SAM 6.7 should begin transitioning to the latest version of SAM. |
September 4, 2020 End-of-Engineering (EoE) – Service releases, bug fixes, workarounds, and service packs for SAM 6.6 and SAM 6.7 will no longer be actively supported by SolarWinds. |
September 3, 2021 EoL – SolarWinds will no longer provide technical support for SAM 6.6 and SAM 6.7. |
See Currently supported software versions for more information.
Legal notices
© 2021 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.