Table Of Contents

Managing the Event Listener

Introduction

Installing and Configuring the Event Listener

Configuring Multiple Event Listeners in Cisco ANA

Configuring an Event Listener on a Gateway

Configuring Event Listener for New VNEs

Using the RegTool Command

Example RegTool Command

Managing the Event Listener

---

This chapter describes the Cisco ANA Event Listener and configuring it to run on both a gateway and a unit. It includes the following sections:

•Introduction

•Installing and Configuring the Event Listener

•Configuring Multiple Event Listeners in Cisco ANA

•Using the RegTool Command

•Example RegTool Command

Introduction

Cisco ANA Event Listener is a Cisco ANA internal service which runs inside the AVM 100. The event listener listens to the SNMP traps and syslogs sent by the network elements and forwards the traps and syslogs to their corresponding VNEs. VNEs must register with an event listener to receive these SNMP traps and syslogs.

Each event listener has a Cisco ANA internal address, which is used by the VNEs for registration. When a VNE is initialized, the VNE reads the address of the event listener from the registry and registers with the event listener with its own IP address. After registration is performed, any trap or syslog arriving at the event listener that has the VNE-registered IP address as its source IP address is sent to that VNE.

After the VNE receives a SNMP trap or syslog from the event listener, it uses a framework to identify the event and operate upon it.

The Cisco ANA Event Listener can be configured to run on both a gateway and a unit. The system can also be configured to support multiple event listeners, up to one per unit or gateway. Each event listener has its own unique address, which is used for registration by the VNEs. Each VNE registers with a specific event listener to which its corresponding network element sends SNMP traps and syslogs.

Installing and Configuring the Event Listener

An AVM 100 containing the Cisco ANA Event Listener service is created by default during installation of a Cisco ANA gateway or unit. However, there is an important difference:

•On the gateway, AVM 100 is not loaded by default; that is, the admin state of AVM 100 is disabled after installation. To load the Cisco ANA Event Listener service on the gateway, AVM 100 must be started with Cisco ANA Manage.

•On a unit, AVM 100 is enabled by default, and thus the Cisco ANA Event Listener service on the unit is loaded by default.

After installation, any event listener configured on a gateway or unit has the internal address 1.2.3.4. By default, any VNE registered with the event listener uses this internal address.

When one event listener is deployed in the system, its AVM 100 should be enabled and the AVM 100s on all other gateways or units should be disabled. No configuration changes are required; that is, the default event listener internal address and VNE configuration can be used.

When multiple event listeners are deployed, each event listener must be configured with a unique internal address, as described Configuring Multiple Event Listeners in Cisco ANA.

---

Note Network elements must be configured to send SNMP traps and syslogs to the gateway or unit IP address on which the event listener is running. If the event listener is running on a unit that has a hot standby server, configure the network elements to send SNMP traps and syslogs to both the primary unit and to the hot standby server.

---

Configuring Multiple Event Listeners in Cisco ANA

This procedure describes how to configure multiple event listeners in Cisco ANA.

---

Note Before performing these procedures, make sure that:

•The Cisco ANA gateway and units are installed.

•The gateway is loaded.

•All units have been configured in the system using Cisco ANA Manage.

---

Configuring an Event Listener on a Gateway

Complete the following procedure for each event listener that needs to be configured:

---

Step 1 Choose a unique address for the event listener.

Step 2 Log into the gateway as user sheer, and change to the Main directory by entering the following command:

# cd Main 

Step 3 From the gateway, issue the following RegTool command:

# ./runRegTool.sh -gs 127.0.0.1 set server-ip "avm100/agents/trap/xidip" 
event-listener-address 

This command updates the Golden Source. The update is automatically propagated from the gateway to the relevant units.

Step 4 Start AVM 100 on the unit with Cisco ANA Manage.

---

Configuring Event Listener for New VNEs

---

Note Before performing the following procedure, verify that all VNEs are configured in the relevant units.

---

Complete the following procedure for each new VNE configured in any AVM on a unit:

---

Step 1 Choose the event listener that is to receive the traps and syslogs for that VNE.

Step 2 Locate the AVM on which this VNE resides.

Step 3 Log into the gateway as user sheer, and change to the Main directory by entering the following command:

# cd Main 

Step 4 Issue the following RegTool command:

# ./runRegTool.sh -gs 127.0.0.1 set server-ip "vne-avm/agents/da/vne-name/trap/ip" 
event-listener-address 

This command updates the Golden Source. The update is automatically propagated to the relevant units. For details on the command syntax, see Using the RegTool Command.

Step 5 Reload the VNE.

---

Using the RegTool Command

The RegTool command uses the following format:

./runRegTool.sh -gs 127.0.0.1 set server-ip "vne-avm/agents/da/vne-name/trap/ip" event-listener-address

The RegTool command accepts the following arguments:

Argument	Description
event-listener-address	The Cisco ANA internal IP address of the event listener. This address is used for communication between the VNEs and the event listener. For example, VNE registration is performed using this address. The format of the internal address is a standard IP address. The address must be unique in the system; the same address cannot be used by other VNEs or event listeners. Note A VNE uses its management IP address as the internal IP address.
server-ip	The IP address of the UNIX machine on which the gateway or unit resides. This IP address is defined during installation and configuration.
vne-avm	The AVM on which the VNE is configured.
vne-name	The name of the VNE in Cisco ANA.

Example RegTool Command

This example contains a gateway and two units:

•Gateway IP address: 192.168.10.1

•Unit 1 IP address: 192.168.10.2

–Contains AVM 100, which is an event listener with the address 1.1.1.1.

–Contains AVM 200, which is a VNE AVM.

•Unit 2 IP address: 192.168.10.3

–Contains AVM 100, which is an event listener with the address 1.1.1.2.

–Contains AVM 300, which is a VNE AVM.

In this example, two event listeners are configured, one on each unit. Each event listener handles the events (SNMP traps and syslogs) sent from the network elements that correspond to the VNEs it manages.

After installing the gateway and the two units, configure the event listeners and the VNEs:

---

Step 1 Log into the gateway as user sheer, and change to the Main directory by entering the following command:

# cd Main 

Step 2 Issue the following commands to configure the event listener addresses:

# ./runRegTool.sh -gs 127.0.0.1 set 192.168.10.2  "avm100/agents/trap/xidip" 1.1.1.1 

# ./runRegTool.sh -gs 127.0.0.1 set 192.168.10.3  "avm100/agents/trap/xidip" 1.1.1.2 

Step 3 Issue the following commands to configure the VNEs to register to their event listener:

•For each VNE configured to receive traps and syslogs from AVM 100 on Unit 1, use the following command:

# ./runRegTool.sh -gs 127.0.0.1 set 192.168.10.2 "avm200/agents/da/vne-name/trap/ip" 
1.1.1.1 

•For each VNE configured to receive traps and syslogs from AVM 100 on Unit 2, use the following command:

# ./runRegTool.sh -gs 127.0.0.1 set 192.168.10.3 "avm300/agents/da/vne-name/trap/ip" 
1.1.1.2 

---