Documentation forHybrid Cloud Observability Essentialsand Server & Application Monitor

SAM 2022.3 Release Notes

Release date: September 28, 2022

These release notes describe the new features, improvements, and fixed issues in Server & Application Monitor 2022.3. They also provide information about upgrades and describe workarounds for known issues.

Learn more

New features and improvements in SAM

Return to top

SAM 2022.3 offers new features and improvements compared to previous releases.

SAM 2022.3 is now built on the new SolarWinds Platform and installed with the new SolarWinds Installer.

Learn more about the new SolarWinds Platform.

See also the SolarWinds Platform 2022.3 Release Notes.

New SolarWinds Platform features and improvements

Return to top

SolarWinds Platform 2022.3 offers new features and improvements compared to previous releases.

Instant evaluation

You can now easily try SolarWinds Hybrid Cloud Advanced and Enterprise Scale, or other modules, for thirty days by activating an evaluation license in the SolarWinds Platform.

Learn more about evaluating SolarWinds Platform products.


New customer installation

Return to top

For information about installing SAM, see the SolarWinds Platform and Orion Platform Products Installation and Upgrade Guide. After installation, use the SAM Getting Started Guide to get started fast.

How to upgrade

Return to top

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

For information on upgrading SAM, see Install or Upgrade SAM.


Fixed issues in SAM 2022.3

Return to top

SAM 2022.3 fixes the following issues.

Case number Description
01012377 Adding new Windows group account to the server no longer returns an error.

01016374,

00691802

When applying an application template to multiple servers, the template no longer gets applied multiple times.
00520035 The graphical report for log parser now shows the correct information.
01060801 All Applications widget, in the Applications Summary page, is no longer showing duplicates for AppInsight for SQL monitors.

With this release, SAM now runs on the SolarWinds Platform. SAM 2022.3 contains all of the fixed issues since the SAM 2020.2.6 release, including all SAM 2020.2.6 hotfixes and fixes in SolarWinds Platform 2022.2 and 2022.3.

See also the SolarWinds Platform 2022.2 and 2022.3 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 SolarWinds Platform 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 SolarWindsPlatform 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.
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.

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 SolarWinds Platform services.
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 SolarWinds Platform via the Container Services page.

When deploying Orion agents to CentOS VMs for Container Monitoring, this message may appear: "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.

Monitoring of Azure Kubernetes Service (AKS) containers stops and the following messages appear in logs:

  • Docker registry: Cannot connect to Docker endpoint
  • Error doing controls for orionaggregator-service.orion.svc.cluster.local

AKS switched to Containerd instead of Docker for node pools (© 2021 Microsoft Corp, available at docs.microsoft.com). No workaround is currently available.

There are missing views with key, after running configuration wizard first time: CloudMonitoringCloudInstanceMapStaticSubview CloudMonitoringCloudInstanceAzureMapStaticSubview They appear after running the configuration wizard a second time.
JMX Bridge is installed into Services.msc on additional website.  
Error 500 on Direct Attached Storage Performance resource for AWS Cloud Instance Details  
When using the Add Node Wizard to add Windows nodes with IIS: WMI as the polling method, the IIS is not polled and a message appears stating, "The user name or password is incorrect.

As a workaround:

1. Find and open the following with notepad or other text editor (may need to run as administrator): Program Files\SolarWinds\Orion\SolarWinds.APM.Probes.dll.config

2. In line: <add key="UseLegacyPowerShellImpersonation" value="false" /> change value to <add key="UseLegacyPowerShellImpersonation" value="true" />.

The ‘SWIS PubSub Messages Queued’ component in 'Orion Observability - Main Polling Engine’ template is unknown because the path to ‘rabbitmqctl.bat’ has changed. This component is disabled by default, so you must enable it to see the issue.

As a workaround:

Edit the script to change the path FROM 'c:\Program Files (x86)\SolarWinds\Orion\RabbitMQ\sbin\rabbitmqctl.bat' TO 'c:\Program Files\SolarWinds\Orion\RabbitMQ\sbin\rabbitmqctl.bat'

Application credentials inheritance failed after upgrade from 2020.2.5.

As a workaround, use the switch to change behavior:

1. Find and open the following with notepad or other text editor (may need to run as administrator): Program Files\SolarWinds\Orion\SolarWinds.APM.Probes.dll.config

2. In line: <add key="UseLegacyPowerShellImpersonation" value="false" /> change value to <add key="UseLegacyPowerShellImpersonation" value="true" />.

After upgrading to 2022.3, SAM templates which utilize PowerShell (AppInsight, Custom Templates) show down/unknown status due to access denied errors.

As a workaround:

1. Find and open the following with notepad or other text editor (may need to run as administrator): Program Files\SolarWinds\Orion\SolarWinds.APM.Probes.dll.config

2. In line: <add key="UseLegacyPowerShellImpersonation" value="false" /> change value to <add key="UseLegacyPowerShellImpersonation" value="true" />.


End of support

Return to top

This version of SAM no longer supports the following platforms and features.

Type Details
Database SQL Server 2012 and SQL Server 2014 are no longer supported for use as the SolarWinds Platform or Orion Platform database.

Syslog and traps

Legacy Syslog and Traps functionality has been removed. During an upgrade, legacy syslog and trap rules are migrated to the Log Viewer. A few rule conditions are not currently supported in the new log functionality. Any rules that are not imported are listed in the Migration Report.

For information on upgrading SAM, see Install or Upgrade SAM.


End of life notices

Return to top

Version EoL Announcement EoE Effective Date EoL Effective Date
2019.4 July 27, 2022: End-of-Life (EoL) announcement - Customers on SAM version 2019.4 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 will no longer be actively supported by SolarWinds. August 26, 2023: End-of-Life (EoL) - SolarWinds will no longer provide technical support for SAM version 2019.4.
6.9.1 July 27, 2022: End-of-Life (EoL) announcement - Customers on SAM version 6.9.1 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 6.9.1 will no longer be actively supported by SolarWinds. August 26, 2023: End-of-Life (EoL) - SolarWinds will no longer provide technical support for SAM version 6.9.1.
6.9 July 27, 2022: End-of-Life (EoL) announcement - Customers on SAM version 6.9 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 6.9 will no longer be actively supported by SolarWinds. August 26, 2023: End-of-Life (EoL) - SolarWinds will no longer provide technical support for SAM version 6.9.

See the End of Life Policy for information about SolarWinds product lifecycle phases. For supported versions and EoL announcements for all SolarWinds products, see Currently supported software versions.


Legal notices

Return to top

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