3.4 pgsnmpd

Table of Contents Previous Next



pgsnmpd is an SNMP agent that can return hierarchical information about the current state of Advanced Server on a Linux system. pgsnmpd is distributed with and installed by the Advanced Server installer as part of the database server component. The pgsnmpd agent can operate as a stand-alone SNMP agent, as a pass-through sub-agent, or as an AgentX sub-agent.
After installing Advanced Server, you will need to update the LD_LIBRARY_PATH variable. Use the command:
This command does not persistently alter the value of LD_LIBRARY_PATH. Consult the documentation for your distribution of Linux for information about persistently setting the value of LD_LIBRARY_PATH.
The examples that follow demonstrate the simplest usage of pgsnmpd, implementing read only access. pgsnmpd is based on the net-snmp library; for more information about net-snmp, visit:
The pgsnmpd configuration file is named snmpd.conf. For information about the directives that you can specify in the configuration file, please review the snmpd.conf man page (man snmpd.conf).
You can create the configuration file by hand, or you can use the snmpconf perl script to create the configuration file. The perl script is distributed with net-snmp package.
When the configuration file wizard opens, it may prompt you to read in an existing configuration file. Enter none to generate a new configuration file (not based on a previously existing configuration file).
snmpconf is a menu-driven wizard. Select menu item 1: snmpd.conf to start the configuration wizard. As you select each top-level menu option displayed by snmpconf, the wizard walks through a series of questions, prompting you for information required to build the configuration file. When you have provided information in each of the category relevant to your system, enter Finished to generate a configuration file named snmpd.conf. Copy the file to:
By default, pgsnmpd listens on port 161. If the listener port is already being used by another service, you may receive the following error:
agentaddress $host_address:2000
The example instructs pgsnmpd to listen on UDP port 2000, where $host_address is the IP address of the server (e.g., 127.0.0.1).
Ensure that an instance of Advanced Server is up and running (pgsnmpd will connect to this server). Open a command line and assume superuser privileges, before invoking pgsnmpd with a command that takes the following form:
POSTGRES_INSTALL_HOME/bin/pgsnmpd -b
-c POSTGRES_INSTALL_HOME/share/snmpd.conf
Where POSTGRES_INSTALL_HOME specifies the Advanced Server installation directory.
Include the -b option to specify that pgsnmpd should run in the background.
Include the -c option, specifying the path and name of the pgsnmpd configuration file.
Include the --help option when invoking the pgsnmpd utility to view other pgsnmpd command line options:
You can use net-snmp commands to query the pgsnmpd service. For example:
-v 2c option instructs the snmpgetnext client to send the request in SNMP version 2c format.
-c public specifies the community name.
localhost indicates the host machine running the pgsnmpd server.
.1.3.6.1.4.1.5432.1.4.2.1.1.0 is the identity of the requested object. To see a list of all databases, increment the last digit by one (e.g. .1.1, .1.2, .1.3 etc.).


Table of Contents Previous Next