Organizing Network Components › Media Devices › Voice Gateways › Import Voice Gateway Definitions

Previous Topic: Manage Voice Gateways

Next Topic: Other Media Devices

Import Voice Gateway Definitions

When your network contains many voice gateways, use the import feature to add device definitions. Use this feature for the initial UC Monitor configuration and for subsequent additions of gateways.

Note: Only voice gateways that support SNMPv1 or SNMPv2C can be imported. You manually add gateways that support SNMPv3.

The import interface does not let you edit or delete gateways that are already in the system. After you import the definitions, you can edit and delete them from the Voice Gateway List.

For each SNMP community string that you supply, UC Monitor checks for the corresponding SNMP profile. If no corresponding profile is found, UC Monitor creates a profile for the community string.

For SNMP community strings not specified in the .csv file, the collector uses the default SNMP profile to contact the associated gateway. If you create SNMP profiles, you can set one of them as the default before importing the .csv file. Otherwise, the default profile for SNMP v1/2c is used. The default profile uses the “public” community string.

The monitoring status of imported voice gateways is always set to Enabled. Edit an imported definition to change the monitoring status.

IP domain definitions are not included in the supported syntax. IP domains are determined on a per-collector basis and are assigned to gateways as they are detected during monitoring. The IP Domain field lets you instruct the collector to associate voice gateways with a domain container. To expose the IP Domain field, define an IP domain in CA Performance Center.

The import procedure takes data from a file in comma-separated values (.csv) file format. Spreadsheet programs, such as Microsoft Excel, can save files into this format. The proper syntax is to separate items with commas (,) and no spaces. The required syntax for the data you want to import is described in the following table:

Data Type and Syntax

Notes and Examples

Voice gateway definition (complete):

Voice gateway name,IP address,SNMP community,Description,Traceroute

Use quotation marks to enclose strings that contain commas, double quotation marks, or other punctuation.

The voice gateway name can be different from its hostname.

Include the word “Traceroute” to enable the option to “Perform routine traceroutes for baseline.” To disable this option, do not include the word "Traceroute."

Examples:

  • Houston Data Center,10.12.34.56,private,"Data center, gateway router",Traceroute
  • HoustonDataCtr01,10.12.34.56,private,Data center gateway router
  • Austin_HQ_FXO,10.123.45.67,ultra5ecur3PW,VGW at HQ,Traceroute

Voice gateway definition
(no SNMP community, no description):

Voice gateway name,IP address,,,Traceroute

SNMP community, description, and traceroute are optional. The default SNMP profile is used.

Examples:

  • Houston Data Center,10.12.34.56,,,Traceroute
  • HoustonDataCtr01,10.12.34.56
  • Austin_HQ_FXO,10.123.45.67,,,Traceroute

Voice gateway definition (no description):

Voice gateway name,IP address,SNMP community,,Traceroute

Voice gateway description and traceroute are optional.

Examples:

  • Houston Data Center,10.12.34.56,private
  • HoustonDataCtr01,10.12.34.56,private,,Traceroute
  • Austin_HQ_FXO,10.123.45.67,ultra5ecur3PW,,Traceroute

Voice gateway definition (no SNMP community):

Voice gateway name,IP address,,Description,Traceroute

SNMP community string is optional. If no string is supplied, the collector uses the default SNMP profile.

Examples:

  • Houston Data Center,10.12.34.56,,"Data center, gateway router",Traceroute
  • HoustonDataCtr01,10.12.34.56,,Data center gateway router
  • Austin_HQ_FXO,10.123.45.67,,VGW at HQ,Traceroute

Follow these steps:

  1. Create a .csv file that contains your voice gateway definitions.
  2. Click Administration, Data Collection, Media Devices, Voice Gateways in the navigation bar.

    The Voice Gateway List opens.

  3. Click Import.

    The first page of the Import Voice Gateways wizard opens.

  4. (Optional) Select a custom domain for the IP Domain field. This field is available only when you define IP domains in CA Performance Center.
  5. Click Browse, and navigate to the .csv file that contains your gateway definitions.
  6. Click Next.

    UC Monitor analyzes the file and reports any syntax errors.

  7. Correct any errors in the file and save it. Then repeat Steps 5 and 6.

    When no errors are found, the import operation is finished. A confirmation page opens. The appropriate database objects are created.

  8. Click OK.

    The Voice Gateway List displays the new gateways.

More information:

What are IP Domains?