Operating Environment Prerequisites

Hardware and Networking

Genesys recommends that you or your IT specialist assign host computers to Genesys software before you start Genesys installation.

If you are considering using IPv6 for some or all connections, make sure that you first review the information in IPv6.

Refer to Network Locations for Framework Components for recommendations on server locations.

Software

Refer to the Genesys Supported Operating Environment Reference Guide for the list of operating systems and database systems supported in Genesys releases. Refer to the Genesys Supported Media Interfaces Reference Guide for the list of supported switch and PBX versions.

For UNIX operating systems, also review the list of patches Genesys uses for software product builds and upgrade your patch configuration if necessary. A description of patch configuration is linked to the Readme files for the Genesys applications that operate on UNIX.

New section starts here

Starting in release 8.5.1, Genesys uses Net-SNMP to access SNMP functionality, instead of the Genesys SNMPA Master Agent component. Net-SNMP supports everything that Genesys SNMPA Master Agent does. If you will be using SNMP, you must install and configure Net-SNMP.

Installing Net-SNMP

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:

1. Download and run Net-SNMP as follows: [+] Show steps In a web browser, go to http://sourceforge.net/projects/net-snmp/files/net-snmp%20binaries/5.5-binaries/ and download net-snmp-5.5.0-2.x64.exe. 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, 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: Master agentX Agentxsocket transport:host_address:port_num where: <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, as follows: [+] Show settings Field SNMP Version SNMP v1 SNMP v2 SNMP v3 SNMP Protocol Version SNMPv1 SNMPv2 SNMPv3

To install and configure Net-SNMP on Linux 64-bit Platforms, use the following steps:

1. Download the following Red Hat Package Manager (RPM) files from http://rpmfind.net: net-snmp-libs-5.3.2.2-9.el5 net-snmp-5.3.2.2-9.el5 Ensure that you are logged in as root, and that the rpms have execute permission. If you are unsure, give full permission by entering the following: $chmod –R 777 *

2. Install the rpm files using the command: $rpm –ivh <rpm file name> The installation places the Net-SNMP files in the following locations, unless otherwise specified during the installation: Files Location snmpd.conf /usr/local/etc/snmp/snmpd.conf snmpd.conf (persistent) /var/net-snmp/snmpd.conf snmptrapd.conf /var/net-snmp/snmptrapd.conf Log file /var/log/snmpd.log Snmpd.exe (application) Do this file and the next one have a "." (dot) between the filename and the extension? /usr/local/sbin/snmpd Snmpd.exe (application) Should this file be "snmptrapd"? /usr/local/sbin/snmptrapd Init.d script required for running snmpd and snmptrapd /etc/init.d/snmpd

New section ends here

Internet Browsers

To view all elements of Genesys Administrator, you need any combination of Internet Explorer and and/or Mozilla Firefox internet browsers.

Refer to the Framework Genesys Administrator Deployment Guide for information about supported browser versions, and requirements for the Genesys Administrator web server.