Starting in release 8.5.1, Genesys uses Net-SNMP instead of the Genesys SNMPA Master Agent component, to access SNMP functionality. Net-SNMP supports everything that Genesys SNMPA Master Agent does, but uses any SNMP master agent, whether supplied by Genesys or by a third-party.
Important
Genesys recommends that you switch to Net-SNMP with your release 8.5.1 software, or as soon as possible thereafter. However, if you still want to use the built-in SNMP functionality provided by Genesys SNMP Master Agent in release 8.5.0 or earlier, refer to the Framework 8.5.0 Deployment Guide and the Genesys 8.5.0 Management Layer User's Guide for instructions about deploying and using the Genesys SNMP Master Agents.
This topic describes how to install Net-SNMP on each host that will be running SNMP master agents, using the instructions appropriate for the operating system of the host.
To install and configure Net-SNMP on Windows 64-bit Platforms, use the following steps:
Run the downloaded file, making the following selections on the Choose Components screen of the Net-SNMP 5.5 Setup Wizard:
Expand Net-SNMP Agent Services and select With Windows Explorer
Net-SNMP Trap Services
Perl SNMP Modules
All binaries are created in the installed folder specified in the Choose Default Location screen of the setup wizard.
2. Register (or unregister, if required) the Net-SNMP Services by running the appropriate .bat file, all of which are located in the Net-SNMP installation folder. [+] Show files
:
To Do This ...
To This Service ...
Run this File
Register
Net-SNMP agent
registeragent.bat
Net-SNMP trap handler
registertrapd.bat
Unregister
Net-SNMP agent
unregisteragent.bat
Net-SNMP trap handler
unregistertrapd.bat
After registration, the files are located in the following locations: [+] Show file locations
Note: The file locations given in the table are by default, based on the default location specified in Step 1.
Files
Location
snmpd.conf
C:\usr\etc\snmp\snmpd.conf
snmpd.conf (persistent)
C:\usr\snmp\perisist\snmpd.conf
Is the folder actually called "perisist" or "persist"?
snmptrapd.conf
C:\usr\etc\snmp\snmptrapd.conf
Log files
C:\usr\log\snmpd.log
3. Modify the Net-SNMP configuration file, snmpd.conf to define system-specific parameters, as follows: [+] Show steps
To open the UDP port through which SCS can communicate with the SNMP master agent, add the following line to the configuration file:
agentaddress <transport>:<port_num>
where:
<transport> can be udp or tcp Shouldn't this just be set to udp, since the line above says you are opening the UDP port?
port_num is any valid port number. This port number must not be used by any other process.
You can check if the port has been opened successfully by running the following command:
C:\>netstat –aon | findstr <port_num>
If it shows the port, then the port is open.
To enable agentx functionality and open the agentX port, add the following lines to the configuration file:
<transport> can be udp or tcp. Should this just be set to a specific value too?
host_address is the IP address of the host on which Net-SNMP is running.
port_num is any valid port number. This port number must not be used by any other process.
Configure the SNMP version. Do one of the following:
For SNMP v1 or SNMP v2, add the following lines to the configuration file:
rocommunity public
rwcommunity private
These parameters are similar to the read_community and write_community configuration options in an SNMP master agent.
For SNMP v3, add the following lines to the configuration file:
# VACM configuration entries
rwuser username
# create and add a user
createUser username MD5 md5_password DES des_password
You can check if SNMP v3 has been configured successfully by running the following command:
C:\>snmpget -v3 -u <username> -n "" -l authNoPriv -a MD5 -A <md5_password> <localhost> sysUpTime.0
If any output is displayed, then SNMP v3 has been successfully configured.
You can also create another user based on the initial user by running the following command:
C:\>snmpusm -v3 <username> -u initial -n "" -l authNoPriv -a MD5 -A <md5_password> <localhost> create <newuser> initial
4. Configure the MIB Browser for the version of SNMP you are using. Do one of the following: [+] Show settings
Need list of field names in, or screen shots from, Genesys Administrator (or GAX if supported). Configuration Manager is no longer mentioned in this document.
For SNMP v1 or SNMP v2, set the following:
SNMP version
Port number, on which snmpd is running
For SNMP v3, set the following:
SNMP version
User profile name
Security user name
SNMP port number, the port on which on which snmpd is running
Authentication protocol
Privacy protocol
5. Modify the Net-SNMP configuration file, snmpd.conf, to define where SNMP traps are to be sent, as follows: [+] Show changes
For SNMP v1 traps, add the line:
trapsink <transport>:<host_address>:<port>
where:
<transport> can be udp or tcp.
Should this be set to one or the other, like way back in step 3?
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
For SNMP v2 traps, add the line:
trap2sink <transport>:<host_address>:<port>
where:
<transport> can be udp or tcp.
Should this be set to one or the other, like way back in step 3?
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
For SNMP v3 traps, add the line:
trapsess -v 3 –u <username> -l authNoPriv -Ci -a MD5 -A "<authentication_password>" <host_address>:<port>
where:
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
Prerequisites:
You must be logged in as root.
The Red Hat Package Manager (RPM) files (RPMs) must have execute permission. If you are unsure, give full permission by running the following command:
$chmod –R 777 *
To install and configure Net-SNMP on Linux 64-bit Platforms, use the following steps:
1. Download and install the RPM files, as follows: [+] Show steps
<transport> can be udp or tcp. Should this just be set to a specific value too?
host_address is the IP address of the host on which Net-SNMP is running.
port_num is any valid port number. This port number must not be used by any other process.
Configure the SNMP version. Do one of the following:
For SNMP v1 or SNMP v2, add the following lines to the configuration file:
rocommunity public
rwcommunity private
These parameters are similar to the read_community and write_community configuration options in an SNMP master agent.
For SNMP v3, add the following lines to the configuration file:
# VACM configuration entries
rwuser username
# create and add a user
createUser username MD5 md5_password DES des_password
You can check if SNMP v3 has been configured successfully by running the following command:
$snmpget -v3 -u <username> -n "" -l authNoPriv -a MD5 -A <md5_password> <localhost> sysUpTime.0
If any output is displayed, then SNMP v3 has been successfully configured.
You can also create another user based on the initial user by running the following command:
$snmpusm -v3 <username> -u initial -n "" -l authNoPriv -a MD5 -A <md5_password> <localhost> create <newuser> initial
3. Configure the MIB Browser for the version of SNMP you are using. Do one of the following: [+] Show settings
Need list of field names in, or screen shots from, Genesys Administrator (or GAX if supported). Usage of Configuration Manager is no longer mentioned in this document.
For SNMP v1 or SNMP v2, set the following:
SNMP version
Port number, on which snmpd is running
For SNMP v3, set the following:
SNMP version
User profile name
Security user name
SNMP port number, the port on which on which snmpd is running
Authentication protocol
Privacy protocol
4. Modify the Net-SNMP configuration file, snmpd.conf, to define where SNMP traps are to be sent, as follows: [+] Show changes
For SNMP v1 traps, add the line:
trapsink <transport>:<host_address>:<port>
where:
<transport> can be udp or tcp.
Should this be set to one or the other, like way back in step 3?
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
For SNMP v2 traps, add the line:
trap2sink <transport>:<host_address>:<port>
where:
<transport> can be udp or tcp.
Should this be set to one or the other, like way back in step 3?
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
For SNMP v3 traps, add the line:
trapsess -v3 –u <username> -l authNoPriv -Ci -a MD5 -A "<authentication_password>" <host_address>:<port>
where:
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
Prerequisites:
You must be logged in as root.
The Red Hat Package Manager files (RPMs) must have execute permission. If you are unsure, give full permission by running the following command:
$chmod –R 777 *
To install and configure Net-SNMP on AIX 64-bit Platforms, use the following steps:
1. Download and install the RPM files, as follows: [+] Show steps
<transport> can be udp or tcp. Should this just be set to a specific value too?
host_address is the IP address of the host on which Net-SNMP is running.
port_num is any valid port number. This port number must not be used by any other process.
Configure the SNMP version. Do one of the following:
For SNMP v1 or SNMP v2, add the following lines to the configuration file:
rocommunity public
rwcommunity private
These parameters are similar to the read_community and write_community configuration options in an SNMP master agent.
For SNMP v3, add the following lines to the configuration file:
# VACM configuration entries
rwuser username
# create and add a user
createUser username MD5 md5_password DES des_password
You can check if SNMP v3 has been configured successfully by running the following command:
$snmpget -v 3 -u <username> -n "" -l authNoPriv -a MD5 -A <md5_password> <localhost> sysUpTime.0
If any output is displayed, then SNMP v3 has been successfully configured.
You can also create another user based on the initial user by running the following command:
$snmpusm -v3 <username> -u initial -n "" -l authNoPriv -a MD5 -A <md5_password> <localhost> create <newuser> initial
4. Configure the MIB Browser for the version of SNMP you are using. Do one of the following: [+] Show settings
Need list of field names in, or screen shots from, Genesys Administrator (or GAX if supported). Configuration Manager is no longer mentioned in this document.
For SNMP v1 or SNMP v2, set the following:
SNMP version
Port number on which snmpd is running
For SNMP v3, set the following:
SNMP version
User profile name
Security user name
SNMP port number, the port on which on which snmpd is running
Authentication protocol
Privacy protocol
5. Modify the Net-SNMP configuration file, snmpd.conf, to define where SNMP traps are to be sent, as follows: [+] Show changes
For SNMP v1 traps, add the line:
trapsink <transport>:<host_address>:<port>
where:
<transport> can be udp or tcp.
Should this be set to one or the other, like way back in step 3?
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
For SNMP v2 traps, add the line:
trap2sink <transport>:<host_address>:<port>
where:
<transport> can be udp or tcp.
Should this be set to one or the other, like way back in step 3?
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
For SNMP v3 traps, add the line:
trapsess -v 3 –u <username> -l authNoPriv -Ci -a MD5 -A "<authentication_password>" <host_address>:<port>
where:
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
Prerequisites:
You must be logged in as root, with execute permission. If you are unsure, give full permission by running the following command:
$chmod –R 777 *
To install and configure Net-SNMP on Solaris 10 64-bit Platforms, do the following steps:
1. Download and install the Net-SNMP package files, as follows: [+] Show steps
<transport> can be udp or tcp. Should this just be set to a specific value too?
host_address is the IP address of the host on which Net-SNMP is running.
port_num is any valid port number. This port number must not be used by any other process.
Configure the SNMP version. Do one of the following:
For SNMP v1 or SNMP v2, add the following lines to the configuration file:
rocommunity public
rwcommunity private
These parameters are similar to the read_community and write_community configuration options in an SNMP master agent.
For SNMP v3, add the following lines to the configuration file:
# VACM configuration entries
rwuser username
# create and add a user
createUser username MD5 md5_password DES des_password
You can check if SNMP v3 has been configured successfully by running the following command:
$snmpget -v 3 -u <username> -n "" -l authNoPriv -a MD5 -A <md5_password> <localhost> sysUpTime.0
If any output is displayed, then SNMP v3 has been successfully configured.
You can also create another user based on the initial user by running the following command:
$snmpusm -v3 <username> -u initial -n "" -l authNoPriv -a MD5 -A <md5_password> <localhost> create <newuser> initial
4. Configure the MIB Browser for the version of SNMP you are using. Do one of the following: [+] Show settings
Need list of field names in, or screen shots from, Genesys Administrator (or GAX if supported). Configuration Manager is no longer mentioned in this document.
For SNMP v1 or SNMP v2, set the following:
SNMP version
Port number on which snmpd is running
For SNMP v3, set the following:
SNMP version
User profile name
Security user name
SNMP port number, the port on which on which snmpd is running
Authentication protocol
Privacy protocol
5. Modify the Net-SNMP configuration file, snmpd.conf, to define where SNMP traps are to be sent, as follows: [+] Show changes
For SNMP v1 traps, add the line:
trapsink <transport>:<host_address>:<port>
where:
<transport> can be udp or tcp.
Should this be set to one or the other, like way back in step 3?
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
For SNMP v2 traps, add the line:
trap2sink <transport>:<host_address>:<port>
where:
<transport> can be udp or tcp.
Should this be set to one or the other, like way back in step 3?
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
For SNMP v3 traps, add the line:
trapsess -v 3 –u <username> -l authNoPriv -Ci -a MD5 -A "<authentication_password>" <host_address>:<port>
where:
<host_address> is the IP address of the host to where SNMP traps are to be sent.
<port> is the SNMP port on which traps are to be received.
Comments or questions about this documentation? Contact us for support!
