Documentation forServer & Application Monitor

SAM 2020.2.6 Release Notes

Release date: July 15, 2021

This topic was last updated on July 26, 2021.

These release notes describe new features, improvements, and fixed issues in the SolarWinds Server & Application Monitor (SAM) 2020.2.6 service release. They also provide details about installation, upgrades, and workarounds for known issues.

This document includes the following sections:

Learn more

New features and improvements in SAM

Orion Platform 2020.2.6 includes updated password policies that impact individual Orion accounts. After you upgrade to 2020.2.6, all passwords for individual Orion accounts will expire in 30 days. To learn more, see the Orion Platform 2020.2.6 Release Notes.

SAM 2020.2.6 includes the following updates:

In addition to updated password policies, Orion Platform 2020.2.6 removed the guest account feature. For details, see the Orion Platform 2020.2.6 Release Notes.


New customer installation

Use the Orion Installer, available in the Customer Portal, to install SAM, as described in the Orion Platform Products Installation and Upgrade Guide. When finished, see the SAM Getting Started Guide to learn about configuring and customizing SAM.

How to upgrade

Return to top

To prepare for the upgrade:

  1. Read these Release Notes.
  2. Confirm that all servers comply with SAM 2020.2.6 System Requirements.
  3. (Optional) Back up custom code, such as modified SolarWinds .css files or added .js files.

Orion Platform 2020.2.6 includes updated password policies that impact individual Orion accounts. After you upgrade, all passwords for individual Orion accounts will expire in 30 days. To learn more, see the Orion Platform 2020.2.6 Release Notes.

In addition, note the following details:

  • Starting in SAM 2020.2.6, Container Monitoring requires a new type of Orion Platform credential: SolarWinds Tokens for container services.
    • Edit existing container services to use SolarWinds Tokens. Otherwise, polling stops.

      Open port 38102 to support communication between the Orion server and container environments.
    • The required weaveworks/scope for images is 1.13.2.
  • New versions of several API Poller templates are available, to support changes made by third-party vendors that host remote APIs.

    Recreate any existing API pollers based on updated templates. Otherwise, polling stops and a "Bad request: Unexpected character following indexer" message appears.

  • MSMQ is not included in new SAM installations, but it is not automatically removed during upgrades to avoid disrupting other applications or services used by your organization.
  • If using legacy Syslog and Traps, note that they will be replaced by the Orion Log Viewer (OLV) feature in a future release, likely in 2022.
  • To support AppInsight for Exchange, SAM 2020.2.6 uses RestrictedLanguage as the PSLanguageMode on target servers. For a script to adjust that setting on existing servers, see this Success Center article.
  • Starting in SAM 2020.2.6, you can disable dynamic components for AppInsight for IIS and AppInsight for SQL. Be careful if disabling components at the template level; all child application monitors will be impacted.
  • The Orion.APM.CurrentComponentStatus.IsFallback column was removed from the SWIS database schema.
  • SAM 2020.2.6 includes OpenJDK 16 to support monitoring in JMX and Hyper-V environments. You can also use a commercial version of Java SE. See this article to upgrade.
  • Microsoft ended support for Basic Authentication in Exchange Online APIs, so the following application monitor templates were deprecated in SAM 2020.2. 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
  • If upgrading to a localized version of SAM, back up any application monitor templates and application monitors that were modified with custom changes before upgrading. You cannot roll back to English after installing the Orion Platform in another language.
  • Visit THWACK to download an updated version of the SolarWinds NetFlow Traffic Analyzer Database application monitor template, which was deprecated from fresh installs in SAM 2020.2.1.

SolarWinds recommends checking THWACK periodically for updates to application monitor templates. Only AppInsight templates are updated during upgrades. SAM doesn't update standard templates automatically during upgrades to avoid overwriting custom changes. For details, see Import and export SAM application monitor templates.

Begin the upgrade

To upgrade your entire deployment, including all Orion Platform products and scalability engines:

  1. Log in to the Orion Web Console.
  2. Click Settings > My Orion Deployment.
  3. Follow the onscreen instructions.

Alternatively, download the latest SolarWinds Orion Installer from the Customer Portal and run it.

Learn more:


Fixed issues

Return to top

Case number Description

0000236665

The System Information widget on the Asset Inventory view of the Node Details page displays OS details for supported Linux distributions.

00433358, 00762573

After upgrading SAM, the licensing cache is updated so the following message does not appear: "Due to licensing constraints, application polling is disabled."

00716074, 00660298, 00605130, 00723228

The Application Connections widget no longer appears on the Application Details page for AIX nodes. The Application Dependencies feature does not currently support AIX so related agent plug-ins do not need to be deployed to AIX nodes. In earlier versions, this issue caused List Resources widget errors.

00594027

To avoid certificate errors related to WinRM application monitor polling over HTTPS if a polling engine is an ORC, code was updated so agents and Orion Remote Collectors (ORCs) respect APM.WMI.Settings on the Advanced Configuration page.

00735905

The Cloud Infrastructure Monitoring workflow to add or edit cloud accounts was updated to avoid timeouts when polling AWS or Azure regions for data about cloud instances.

00791939, 00786700, 00804148, 00796666

Code was updated to resolve an AppInsight for Exchange issue that caused a "Method invocation failed" message if using Exchange 2013 or 16 with Windows Server 2012, and PowerShell 4.0 or earlier.

SolarWinds recommends using PowerShell 5.1 or later.

00827956, 00705000

Methods for publishing SolarWinds.Orion.ApiPoller.Service and SolarWinds.Credentials.Orion.WebApi packages were updated to improve support for Microsoft .NET Framework 4.8, memoryCache usage, and other factors.

00772579, 00565164, 00774690

For AppInsight for Active Directory, the latest subnet and site relationships for domain controllers appear in the Site Details widget.
To learn about fixed issues in the Orion Platform, see the Orion Platform 2020.2.6 release notes.

Known issues

Return to top

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 Orion Web Console pages and widgets for features introduced in SAM 2020.2 and later are not compatible with Internet Explorer 11. Use Chrome, Firefox, or Microsoft Edge instead.
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 the 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) application monitor polling fails if the 64-bit FailoverClusters module conflicts with PowerShell bitness. 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 plug-ins 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.

In SAM 2020.2.5 and later, an apiversion variable is required in PowerShell scripts for legacy Microsoft Office 365 Teams and Microsoft Office 365 OneDrive application monitor templates and related application monitors. If a "The remote server returned an error: (404) Not Found" message appears, add apiversion=v1.0 to scripts. Alternatively, switch to a Microsoft 365 API poller templates.
If you assign AppInsight to Exchange to a node after upgrading to SAM 2020.2.6, a "Failed to create powershell connections using provided information" message may appear.

Use this workaround:

  1. Open IIS Manager on the target server.
  2. Navigate to Sites > Default Web Site > PowerShell.
  3. Enable Windows Authentication for PowerShell.

After upgrading to SAM 2020.2.6, obsolete containers may continue to appear in AppStack and PerfStack.

Confirm that any container services added in SAM 2020.2.5 or earlier were updated, and then restart all Orion services.
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 Orion Web Console, click My Dashboards > Environment.
After upgrading to SAM 2020.2.6, Kubernetes orchestrators do not appear on the Container Services page. Related polling stops.

Add the Kubernetes API server back to the Orion Platform via the Container Services page.

When deploying Orion agents to CentOS VMs for Container Monitoring in Orion Platform 2020.2, this message appears: "ERROR on previous provisioning attempt: Agent connected to Agent Management Service but provisioning has failed, error code {0x8009001a}."

The container certificate store may be corrupt. Contact Technical Support.


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

Return to top

© 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.