voip Integration
cisco-gateway (en)


ServicePilot voip-cisco-gateway


# Cisco VoIP Gateway

Overview

The ServicePilot Manager Cisco Gateway package collects information for Cisco Gateways using SNMP.

Description

This package automatically configures the ServicePilot Manager to collect statistics from the Cisco Gateway on which SNMP Service has been configured. The statistics gathered in this way include:

  • Trunk Usage form ISDN or CAS Channel interface
  • ISDN Calls
  • ISDN Line status
  • Network Interface statistics

Requirements

  • SNMP must be configured and started on each Cisco Gateway (Security: SNMP v2c read-only access from the ServicePilot Manager IP address)

  • Network Flows - It is is necessary to ensure network connectivity between ServicePilot and the monitored device. In case of a network infrastructure using a firewall, the port below must be opened:

    • UDP/161 (SNMP): Between ServicePilot Manager and Cisco Gateway
    • ICMP/Echo Request (Ping): Between ServicePilot Manager and Cisco Gateway
    • UDP/162 (SNMP Trap): (Optional) Between Cisco Gateway and ServicePilot Agent
  • ServicePilot Requirements

    • ServicePilot Manager minimum version: 8.5

Installation

Before adding a resource to monitor, make certain that all pre-requisites are in place and if a ServicePilot Agent is required, that it is communicating correctly with the ServicePilot Manager. Resources can be added to ServicePilot configuration in a number of ways:

Add resource using Views Configuration web interface

  1. As an administrative user of ServicePilot, open the ServicePilot web interface.
  2. Navigate to Administration. The Configuration > Views web page will open.
  3. Click on the view in which to place the new resource in the Views hierarchy on the left of the interface. The View editor section will show the existing view contents.
  4. From the Packages list on the right of the interface, click and drag the voip-cisco-gateway package into the View editor and let go.
  5. The Package properties dialog box will open to allow resource configuration.
  6. Click OK to close the Package properties dialog box. Note that the dialog box will not close if required parameters are not set.
  7. Click Save to apply the new resource to ServicePilot configuration.

Add resource by changing servicepilot.conf configuration file

Resources can be added to ServicePilot configuration by directly editing the servicepilot.conf or other included YAML configuration files. The ServicePilot web interface can be used to make these changes and apply them to the running configuration.

  1. As an administrative user of ServicePilot, open the ServicePilot web interface.
  2. Navigate to Administration.
  3. Navigate to Configuration > Edit configuration.
  4. Expand the configuration to find the provisioning: and then packages: section of the view in which the new resource will be placed.
  5. Add the example package configuration line below.
  6. Click on the green - package: word to open then Package properties dialog box to allow resource configuration.
  7. Click OK to close the Package properties dialog box. Note that the dialog box will not close if required parameters are not set.
  8. Click Save to apply the new resource to ServicePilot configuration.

Example:

- package: "voip-cisco-gateway;;;;;;;;voip-cisco-gateway;;127.0.0.1;N;N;Y;Y;Y;N;N"

Key field notes

In the Monitoring Policies tab, specify the policy or policies to apply to the package

  1. Basic Parameters tab:

    1. IP address/FQDN: Specify the IP address, host name or FQDN for the Cisco Gateway, as resolvable by the machine on which ServicePilot Manager is running
  2. Network tab:

    1. ICMP Ping: tick to get ping (availability and response time) statistics for the Cisco Gateway
    2. Interfaces: tick to get statistics for all interfaces of the Cisco Gateway
  3. Monitoring Options tab:

    1. ISDN: tick to discover and monitor ISDN interfaces
    2. ISDN Calls: tick to get additional information (call type and calling numbers) for each call
    3. CAS Channel: tick to discover CAS Channel interfaces
    4. DS1 Lines: tick to get details about ISDN Signalling Status whether it is free or not
    5. DSP
voip cisco-gateway 0

voip cisco-gateway 1