Documentation forHybrid Cloud Observability Essentialsand Server & Application Monitor

Configure SNMP for Orion Platform agents on Linux/Unix and AIX systems in SAM

Orion Platform agents provide a secure, encrypted communication channel between the Orion server and Windows, Linux/Unix, or AIX systems, as an alternative to WMI or SNMP to gather data about key servers, processes, and applications in your environment.

This topic describes how to set up SNMP on Linux/Unix and AIX systems that use Orion Platform agents for:

In addition to an overview about Discovery, this topic describes tasks you may need to perform, depending on the environment, including:

How Discovery works for Linux/Unix and AIX systems

Depending on settings, Discovery can automatically configure SNMP on systems when it detects new or updated nodes. If a node is configured to support Orion Platform agents, the Discovery wizard completes the following tasks:

  • Checks for an SNMP daemon on the target system that binds to default port 161 and awaits requests from the Orion Platform
  • Verifies that SNMP credentials for the system match credentials for the related node, as configured in the Orion Platform.
  • Deploys an Orion Platform agent to the node.
  • Configures the snmpd agent to start automatically after the system reboots.
  • Scans the snmpd.conf file on the target system for an agent-owned community string on SNMPv1 or SNMPv2c nodes. If no string exists, a randomly generated community string is added and the SNMP service restarts.
    ### BEGIN SolarWinds Agent SNMP auto config
    rocommunity Community_String localhost
    ### END SolarWinds Agent SNMP auto config

    SNMPv3 communication is encrypted by default; no community strings are involved.

Note that if an snmpd.conf file changes (for example, to adjust access policies), the Orion Platform will block future updates to the file. That functionality protects any changes to the file, but it also impacts how the Orion Platform interacts with a target system in the future.

For example, suppose a Linux system is initially configured for agentless SNMP polling, but then you decide to collect Asset Inventory or Hardware Health from the node with an Orion Platform agent. SNMP polling continues but the Orion Platform agent will not function.

To resolve that issue, manually edit the snmpd.conf file to add a read-only community string.

rocommunity Your_Community_String localhost

To learn more about configuration files for snmpd agents, see:

Install SNMP daemons on Linux/Unix systems

As mentioned earlier, the Orion Platform can configure SNMP automatically during Discovery for Linux/Unix systems that host an enabled SNMP daemon called snmpd.

To install the snmpd daemon, use one of these commands, depending on your distribution type.

  • For Ubuntu: sudo apt-get -y install snmpd
  • For Red Hat/CentOS: yum -y install net-snmp
  • For SUSE: zypper -y install net-snmp

After installing the SNMP daemon, trigger auto-configuration by either:

If automated configuration still fails, try setting up the daemon manually. The following steps assume the target system is already configured to support Orion Platform agents.

  1. Install the SNMP daemon on the target system. Steps vary by Linux/Unix distribution type.
  2. For SNMPv1 or SNMPv2c, add a read-only community string to the snmpd.conf file.

    rocommunity Your_Community_String localhost

    SNMPv3 does not use community strings; it has built-in encryption.

  3. In the Orion Web Console, navigate to the Node Details page and click Edit Node. Under Polling Method, the "Windows and Unix/Linux Servers: Agent" option should be selected.
  4. Switch to the UNIX/LINUX tab and select Include SNMP Credentials.
  5. For SNMPv1 or SNMPv2c, add the Community String from step 2, as shown here.
    For SNMPv3, add credentials and specify authentication and encryption options.

  6. Click Submit.
  7. On the target system, restart the SNMP daemon.

To enable snpmd logging, start the daemon with parameters for maximum file size and debug level that vary based on snmpd version and Linux distribution. See your Linux/Unix documentation for details.

Configure SNMPv3 on Linux/Unix systems

SNMPv3 is a secure version of the SNMP protocol that includes authentication and encryption. When you add multiple nodes with Discovery or add a single node, you can specify SNMPv3 as the version and provide required details, such as credentials.

If the Orion Platform detects that SNMPv3 is already configured for a node, it won't modify the existing Orion Platform configuration automatically. You'll need to edit it manually, as described next.

  1. Navigate to the Node Details page and click Edit Node. Under Polling Method, the "Windows and Unix/Linux Servers: Agent" option should already be selected.
  2. Switch to the UNIX/LINUX tab and select the Include SNMP Credentials option.
  3. Select SNMPv3 as the SNMP Version.
  4. When SNMPv3-specific fields appear, provide credentials, an authentication method, a privacy/encryption method, and the Credential Set Library to use, as necessary.
  5. Click Submit.

Enable SNMP daemons on AIX systems

By default, AIX systems include an SNMP daemon, but it is not enabled. To support communication with the Orion Platform, enable the SNMP daemon, as described in Poll SNMP on AIX computers.

The proprietary IBM daemon does not support some key MIBs that expose details such as processes and resource consumption. Consider using NET-SNMP for AIX, available at www.net-snmp.org, as described in How to configure SNMP on Linux and Unix.

Learn more

As with other features shared by multiple Orion Platform modules, you can learn more about Orion Platform agents in the Orion Platform Administrator Guide, including:

See also: