Release

Search

Setting up emergency services with Intrado

Link copied to clipboard

Overview

Link copied to clipboard

Intrado Inc. is the largest E911 service provider operating throughout the US and Canada.

Once an end user connects with Intrado, fills in their address information in PortaBilling (on the account self-care interface or via the online web signup form) and submits it to enable E911 services on their account, the information is sent to Intrado using the API. Then the user’s location information is checked and verified in Intrado’s database. Users must have valid US or Canadian numbers for this to function properly. Once that verification is successful, PortaBilling receives notification of it and the E911 services are enabled for the user’s account.

This connection is handled by the special Porta::E911:Intrado plugin. The sections below demonstrate the steps required to set up and configure E911 service provisioning using Intrado.

Checklist

Link copied to clipboard

Use this checklist to check off the operations you have completed while performing the system setup according to the instructions in this chapter. Please be sure to perform all of the operations in the order designated (all of the boxes should be checked), otherwise, the service will not work.

The checklist below assumes that you have already configured the basic SIP service according to the instructions provided in the Basic Residential VoIP Service handbook.

Operation

Done

Preliminary steps

Obtain the NENA ID

Sign a contract and apply for an account with Intrado. Download the Intrado VUI digital certificate

Export the digital certificate to the web server

General configuration

Enable the Emergency Module on the Configuration server web interface

Create the destination 911 for emergency calls

Rating configuration (Vendor)

Create a tariff (that will be referred to as tariff A later on), that describes your termination costs to Intrado

Enter rates for the 911 destination to tariff A

Create a vendor to handle emergency calls that arrive from your network

Create a connection for this vendor using tariff A

Rating configuration (Customer)

Add 911 destination rates to the tariff to use for charging your subscribers (referred to as tariff B later on)

Account provisioning

Check that a retail SIP service customer has already been created according to the instructions provided in previous chapters

Fill in the address information for the customer’s account

Enable E911 for the customer’s account

Obtain the NENA ID

Link copied to clipboard

Before setting up Intrado E911 services in PortaBilling, it is necessary to obtain a National Emergency Number Association Company Identifier (NENA ID). This is a three- to five-character code that allows 911 centers to quickly identify the telephone company or access infrastructure provider responsible for a particular telephone number.

The NENA ID is obtained by filling in an online Company Identifier Data Base Update Form and submitting it through the NENA website (http://www.nena.org).

Download a VUI digital certificate from Intrado

Link copied to clipboard

You will need to obtain a digital certificate from Intrado.

Intrado’s Validation and Update Interface (VUI) uses this certificate to verify that the user location information provided is real.

  1. Sign a contract with Intrado Inc. (http://www.intrado.com/). You will receive a VUI account ID, username, enrollment passphrase and confirmation number from Intrado’s Product Support. You will also be provided with a URL link to Intrado’s VUI interface. This link will be used to receive user information validation requests.
  2. Download your digital certificate following Intrado’s guidelines.
    The digital certificate has an activation date. It will not be activated prior to this date.

Export the VUI certificate to the web server

Link copied to clipboard

It is necessary to upload the VUI certificate to the PortaSwitch web server.

  1. Check that the certificate is decrypted. Otherwise, decrypt it.
  2. Log in to your web server using ssh.
  3. Copy the certificate using the following command:
    sudo scp user@remote.host:/full_path_to_certificate/ITSP_VUI.p12
    /home/porta-admin/
    
    user@remote.host password:
    
    ITSP_VUI.p12 100% 0 0.0KB/s 00:00

Enable the emergency module on the Configuration server web interface

Link copied to clipboard
  1. Clone the active configuration.

    Configure E911 parameters

  2. Select the E911 group and specify the following information:
    • EmergencyPlugin – select Porta::E911::Intrado.

      image006

  3. Select the Intrado group and specify the following information acquired from Intrado:
    • VUI_ACCOUNT – type the VUI account ID provided by Intrado.
    • VUI_CPF – type your NENA ID here.
    • VUI_PKCS12 – type the full local path to the digital certificate provided by Intrado.
    • VUI_URL – type the URL provided by Intrado.
  4. Click the Save button and then the check_apply Verify button.
  5. Verify the new configuration and click the check_apply Check/Apply button. Note that the Apache service will need to be restarted, so consider applying the configuration during off-peak time.

Create a destination

Link copied to clipboard

Now it is necessary to create the destination that will be used to charge for emergency services.

  1. On the Navigation menu select Service catalog, select Rate codes and click Destinations.
  2. On the Create a destination panel, fill in the required information.

    Create a destination

  3. Click the Save button.

Create a vendor tariff

Link copied to clipboard

The tariff is a single price list for calling services or termination costs. A tariff combines:

  • conditions that are applicable for each call, regardless of the destination called;
  • per destination rates.
  1. On the Create tariff panel, fill in the tariff details:
    • Name – a short name for the tariff object; this is the name you will see in the select menus.
    • Currency – choose the currency in which the vendor charges you.
      The currency for the tariff may be chosen only once, and cannot be changed later.
    • Service – choose Voice calls here.
    • Applied to – choose Vendor in the Applied to list.
    • Routing – enable the Routing option for this tariff. Create a vendor tariff
  2. Click Save.

Enter rates

Link copied to clipboard

Now add the rate for the 911 destination to the tariff.

  1. On the vendor tariff’s panel (Intrado emergency calls), click Rates.
  2. On the Add rate panel, fill in the rate details:
    • Destination – select a destination prefix from the list or type it in directly.
      Make sure you have created the entry for the 911 prefix in the Destinations register before creating a rate for it in the tariff.
    • Rating mode – select Flat rate here.
    • Price – specify the per-minute price for this destination.
    • Leave default values in all other fields. Enter rates
  3. Click Save.

Create Intrado vendor

Link copied to clipboard
  1. On the navigation menu, select Infrastructure, then select Vendors.
  2. On the Create vendor panel, fill in the vendor details:
    • Name – type a short name for the vendor object.
    • Currency – choose the currency in which this vendor charges you.
    • Opening balance – this indicates a starting balance for the vendor; the default is zero.
    • Billing period – split period for vendor statistics.
  3. Click Save.

    Create Intrado vendor

Define connections

Link copied to clipboard

This connection represents the point from which calls leave or enter your network and are directed to or from vendors where charges are incurred.

  1. On your vendor’s panel (Intrado), click Connections.
  2. On the Create connection panel, fill in the connection details:
    • Description – type a descriptive name for this connection. It will be displayed in the list of connections.
    • Service type – select Voice calls.
    • Type of connections – select SIP.
    • Direction – select To vendor.
    • Tariff – choose the tariff that defines your termination costs for this connection/vendor.
    • Active – use the slider to set this connection as active.
    • Identify gateway by – choose how to identify the gateway: IP, gateway ID or both. Specify the IP address and/or ID of the vendor’s gateway or switch.
  3. Click Save.

    Intrado Termination

Modify customer tariff

Link copied to clipboard
  1. On the tariff’s panel, click Rates.
  2. On the Add rate panel, fill in the rate details:
    • Destination – select a destination prefix from the list or type it in directly.
    • Rating mode – select Flat rate here.
    • Price – specify 0 price for this destination.
    • Leave default values in all other fields.

      Add a rate

  3. Click Save.

Fill in address information for an account

Link copied to clipboard
  1. On the Customer panel, select Accounts.
  2. Open the account and click Personal info, then select General info and fill in the account details.
  3. On the Address info panel, specify the account’s location information.

    Fill in the address information

  4. Click Save.

Enable E911 for an account

Link copied to clipboard
  1. On the Account panel, select Services, then Service configuration and click on Voice calls.
  2. On the Voice calls configuration panel, select the Outgoing calls section and enable the E911 option.
  3. Click Save.

    Enable E911 for an account

On this page

Release
What's new
Admin manuals
Handbooks
API
UI help
Search