Redundant (HA) SNMP Master Agents

The Management Layer supports configuration with a redundant pair of SNMP master agents. Redundant configuration assumes the presence of two SNMP master agent applications, one primary and one backup. When Solution Control Server loses a connection with the primary SNMP master agent, SCS switches all NMS communications to the backup SNMP master agent.

If your SNMP master agent application can operate in a redundant mode (as does, for example, Genesys SNMP Master Agent), and you would like to deploy this configuration, follow the instructions in this section.

Redundancy

Redundant SNMP Master Agents support only the warm standby redundancy type.

Deploying Redundant SNMP Master Agents

This section describes how to install and set up redundant SNMP Master Agents.

Installation Recommendations

If you are installing the primary and backup SNMP Master Agents on the same host computer:

• Install them in different directories.
• Specify a different port number for each server.

Prerequisites

• Configuration Layer components are installed and running as described in Deploying Configuration Layer.
• Management Layer components are installed and running as described in Deploying Management Layer.
• The SNMP Master Agent to be designated as primary is deployed as described in Deploying SNMP Master Agent.
• You are logged into Genesys Administrator.

Installation and Configuration

Tip

(Optional) If the backup SNMP Master Agent is to reside on a remote Host, you can deploy it to that Host using Genesys Administrator Extension. Refer to ''Framework 8.1 Genesys Administrator Extension Help'' for instructions.

1. Configure an Application object for the backup SNMP Master Agent. [+] Show steps Configure an Application Object for the Backup SNMP Master Agent Go to Provisioning > Environment > Applications. If the Application object for this backup SNMP Master Agent does not already exist, click New to create it. In the General section of the Configuration tab: Enter a descriptive name in the Name text box. Select the appropriate template, as follows: Click the search icon in the Application Template field to open a Browse dialog box that lists the available application templates. If an SNMP Master Agent template file is not listed, close the dialog box and import the SNMP_Master_Agent_<current-version>.apd file from the Management Framework 8.5 product CD. In the Browse dialog box, select the SNMP Master Agent template file. Click OK. In the Server Info section of the Configuration tab, enter the following information, as required: In the Host field, click the magnifying glass icon to select the Host object on which this SNMP Master Agent is running. For each listening port that an application must use to connect to this SNMP Master Agent: In the Listening Ports field, click Add. Enter the port properties in the Port Info dialog box. Click OK. For the Working Directory, Command Line, and Command Line Arguments fields, do one of the following: Enter the appropriate information in each of the text boxes. For information about command-line parameters, see Starting a Backup SNMP Master Agent. Type a period (.) in the Working Directory and Command Line text boxes, and leave the Command Line Arguments text box blank. The information will be filled in automatically when you install SNMP Master Agent, but only if the Installation Package can connect to Configuration Server. Select the Auto-Restart check box. Click Save & Close in the toolbar to save the new object.

2. If you did not deploy the backup SNMP Master Agent to a remote site using Genesys Administrator Extension, install it now.

3. Modify the primary SNMP Master Agent Application object to work with the backup SNMP Master Agent. [+] Show steps Prerequisite The primary and backup SNMP Master Agent Application objects exist. Procedure Go to Provisioning > Environment > Applications, and double-click the primary SNMP Master Agent Application object to open its properties. In the Server Info section of the Configuration tab: Select the backup SNMP Master Agent Application object. Select Warm Standby as the redundancy type. Select Auto-Restart if required. Click Save and Close to save the configuration.

4. If you installed the backup SNMP Master Agent on UNIX, check the run.sh file and modify it, if necessary, so the application can be started properly. [+] Show steps In a text editor, open the run.sh file. Check if the following parameters are currently in the command line in the file, and if not, add them: -host <configuration server host> -port <configuration server port> -app <backup SNMP Master Agent application object name>

Starting the Backup SNMP Master Agent

Important

Once installed, the two SNMP Master Agents must be started from the same account.

When starting a backup SNMP Master Agent, be sure to use the following command-line options:

-host	The name of the host on which Configuration Server is running.
-port	The communication port that client applications must use to connect to Configuration Server.
-app	The exact name of the backup SNMP Master Agent Application object as configured in the Configuration Database.

For a description of the command-line parameters specific to SNMP Master Agent, refer to SNMP Master Agent.

Starting a Backup SNMP Master Agent on UNIX

Prerequisites

• The run.sh file has been modified accordingly. See Step 4, above.

Procedure

Do one of the following:

• To start from Genesys Administrator, refer to Starting and Stopping with the Management Layer.
• To start manually, go to the directory in which the backup SNMP Master Agent is installed, and do one of the following:
  • To use only the required command-line parameters, type the following command line:
    sh run.sh
  • To specify the command line yourself, or to use additional command-line parameters, type the following command line:
    gsnmpmasteragent -host <Configuration Server host> -port <Configuration Server port> -app <backup SNMP Master Agent Application> [<additional parameters and arguments as required>]

Starting the Backup SNMP Master Agent on Windows

Do one of the following:

• To start as a Windows Service, refer to Starting and Stopping with Windows Services Manager.
• To start from Genesys Administrator, refer to Starting and Stopping with the Management Layer.
• To start manually, do one of the following:
  • Use the Start > Programs menu.
  • To use only the required command-line parameters, go to the directory in which the backup SNMP Master Agent is installed, and double-click the file startServer.bat.
  • To specify the command line yourself, or to use additional command-line parameters, open the MS-DOS window, go to the directory in which the backup SNMP Master Agent is installed, and type the following command line:
    gsnmpmasteragent.exe -host <Configuration Server host> -port <Configuration Server port> -app <SNMP Master Agent Application> [<additional parameters and arguments as required>]