Wholesale Termination via a Gateway

Typical Business Case

Setting up Your Network Components

Checklist

Initial Configuration of PortaSwitch®

Create Destinations

Create Nodes

Create Route Categories

Create a Vendor Tariff

Enter Rates in Tariffs with Routing Extensions

Create Vendors

Define Connections

Create Customer Tariffs

Enter Rates

Create a Routing Plan

Create a Product

Create a Customer Class

Create a Customer

Create Accounts

 

Wholesale voice is a growth market, with service providers building new capacities and launching new services. The primary wholesale service is long-distance transport and aggregation, with the key advantage being that country-specific features and domestic calling regulations are not required. The principal beneficiaries are developing countries, where, in many cases, the quality of VoIP is superior to that of traditional PSTN services.

Typical Business Case

Central to the delivery of wholesale voice services are voice points-of-presence (POPs), which are interconnected to other service providers. The Minutes Aggregation and Resale service (including ASP Termination) allows wholesale network providers to collect traffic from multiple originating providers, then aggregate and deliver it to the termination providers they select.

 

wholesale_example

 

The provider in this scenario is the owner of termination node (POP) gw‑example. This is a typical example of a VoIP network where customers pay the provider to terminate traffic at point (A), while the provider himself pays the vendor for traffic at point (B). The provider makes his profit on the difference between:

·       the tariff he charges his customer (A1 or A2), and

·       the tariff he is being charged by the vendor (B).

 

The following configuration assumes that the service is provided using only PortaBilling® and a termination gateway. Please consult the Setting up a Wholesale Traffic Exchange section for an example of advanced wholesale VoIP services using PortaSIP®.

Setting up Your Network Components

Configuring Gateway

1. Basic router configuration

It is highly recommended to use the latest telephony IOS and DSP firmware, and that the hostname be the same as the h323-id.

 

hostname <h323_id>

ip domain name <default domain>

NOTE: VSA h323-gw-id=“hostname.domain”

2. NTP

NOTE: It is very important to have reliable time services.

ntp server <name/IP>

…….

ntp server <name/IP>

ntp master 5

clock timezone <your time zone> 1

clock summer-time <your summer time zone> recurring <your rules>

NOTE: It is important that you only use well-known time zone abbreviations which are supported by the billing engine. If unsure, use the UTC time zone.

3. AAA

aaa new-model

aaa authentication login h323 group radius

aaa authorization exec h323 group radius

aaa accounting connection h323 stop-only group radius

4. VoIP interface

interface <your interface to the world>

 h323-gateway voip interface

 h323-gateway voip id <gatekeeper id> ipaddr <IP> <port>

 h323-gateway voip h323-id <h323_id>

 

NOTE: If you want to use a virtual interface then add the line:

h323-gateway voip bind srcaddr <IP>

5. Enable gateway functionality

gateway

6. Enable gateway accounting

For older IOS versions:

gw-accounting h323 vsa

For newer IOS versions (12.2T or 12.3):

gw-accounting aaa

  acct-template callhistory-detail

NOTE: VSA does not work for all platforms.

7. Radius

IMPORTANT NOTE: Ports 1645 / 1646 are the traditional Radius ports used by many vendors without obtaining an official IANA assignment. The official assignment is now ports 1812 / 1813, and users are encouraged to migrate to these new ports when possible.

Cisco notes:

§   “radius-server” commands will be available only after issuing “aaa new-model” command.

§   UDP port for RADIUS accounting server - default is 1646 (see note above)

§   UDP port for RADIUS authentication server - default is 1645 (see note above)

Keep in mind:

§   Default ports for Cisco are 1645 / 1646

§   Defaults in /etc/ services are 1812 / 1813

radius-server host <name / IP> auth-port 1812 acct-port 1813

radius-server key <key>

radius-server vsa send accounting

radius-server vsa send authentication

8.   Voice-card

9.   Controller

10. Voice-port

Depends on your hardware configuration

11. Call application voice & dial-peers

 

call application voice remote_ip ftp://…./app_remote_authenticate.tcl

call application voice remote_ip authenticate-by ip

call application voice remote_ip authorize yes

 

 

!

dial-peer voice 10 pots

 destination-pattern .

 port 0:D

!

dial-peer voice 11 voip

 application remote_ip

 incoming called-number .

Checklist

Print the following page and use it 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.

 

 

Operation

 

Done

Network configuration

 

Create a node for your gateway

[     ]

Configure your gateway

[     ]

Rating configuration (Vendor)

 

Create route categories

[     ]

Create a tariff A, which describes your termination costs

[     ]

Insert rates in tariff A for destinations you will terminate to PSTN

[     ]

Create a vendor

[     ]

Create a connection for this vendor using tariff A

[     ]

Rating configuration (Customer)

 

Create a tariff B, which will apply to customers who send you traffic for termination

[     ]

Insert rates in tariff B for destinations which will be covered by your termination service

[     ]

Create a wholesale product

[     ]

Create one rating entry for this product, using the node you created and tariff B

[     ]

Account provisioning

 

Create a customer class which will apply to your customers.

[     ]

Create a retail customer who owns the accounts representing remote gateways

[     ]

Create an account for each of this customer’s remote gateways.

[     ]

Assign the routing plan to the account

[     ]

Testing

 

Try to make a test call

[     ]

 

Initial Configuration of PortaSwitch®

If you have just installed the PortaSwitch® software or dedicated a new billing environment to configure the services described in this handbook, make sure to first perform the initial configuration of PortaSwitch®. To do this, use the Initial Configuration of PortaSwitch handbook.

Create Destinations

Please refer to the Create Destinations chapter of the Initial Configuration of PortaSwitch section for detailed instruction on how to insert new destinations into the system.

Create Nodes

This step is only required if you have not entered your gateways into the system before. In this case, you must enter your gateways as nodes. PortaBilling® requires some key information about your network equipment such as IP address, Node ID, Radius shared secret, etc.

NOTE: Only your own gateways have to be entered as nodes. Remote gateways which belong to the customer, or ones which legally belong to you but are used solely by your customer(s), are not considered nodes.

Add a node

 

Fill in the node information

 

Check the node added

 

1.     In the Networking section of the Admin-Index page, choose Nodes.

2.     In the Node management window, click the add Add icon.

3.     Fill in the New Node form:

o   Node Name – A short descriptive name for this node (that will be used in the select menus).

o   Manufacturer – Select Cisco or Quintum.

o   Type – VoIP node type; select VOIP-GW.

o   Node ID – h323-id (recommended hostname.domainname)

o   NAS-IP-Address – IP address of the gateway.

o   RTP Proxying – Leave the default selection (Optimal); for more details regarding NAT traversal, see the PortaSIP Administrator Guide.

o   Client Protocol – Select RADIUS to enable the gateway (node) to communicate with PortaBilling® via RADIUS.

o   RADIUS Key – Enter the RADIUS secret key you have specified in the configuration of the gateway.

o   RADIUS Source IP – Unless your gateway has multiple network interfaces, the value here should be the same as the NAS‑IP‑Address.

4.     Click save_close Save & Close.

5.     Repeat steps 2-4 until all of your nodes have been entered.

Create Route Categories

Please refer to the Create Route Categories chapter of the Setting up a Wholesale Traffic Exchange section for a detailed description of the route categories creation.

Create a Vendor Tariff

The tariff is a price list for your termination costs.

 

Create a vendor tariff

 

Add a vendor tariff

 

1.     In the Rating section of the Admin-Index page, choose Tariffs.

2.     On the Tariff Management page, choose add Add.

3.     Fill in the Add Tariff form:

o   Name – A short name for the tariff object; this is the name you will see in the select menus.

o   Currency – Indicates the currency in which the vendor charges you.

NOTE: The currency for the tariff may be chosen only once, and cannot be changed later.

o   Applied To – Choose Vendor, as this tariff describes your vendor’s termination costs.

o   Routing – Leave the box Routing checked, as this tariff will be used not only to calculate termination costs, but also to route SIP calls.

4.     Click save Save.

Enter Rates in Tariffs with Routing Extensions

Rates define how a call to a specific destination will be charged (e.g. what the price per minute is, how to round off the total call duration, etc.). Please refer to the Call Billing Parameters section in the PortaBilling Administrator Guide for more details on available parameters for rating voice calls.

Managing Rates Online

Enter rates in tariffs with routing extensions

 

1.     On the Tariff Management page you will see a list of available tariffs. Click the editRate Rates icon in front of the name of the tariff.

2.     In the Edit Rates screen, click add Add.

3.     Fill in the required information (please refer to the Enter Rates in Tariffs with Routing Extensions chapter of the Setting up a Wholesale Traffic Exchange section for a detailed description of the available rate attributes).

4.     Click the save Save button in the toolbar, or the save_add Save icon on the left end of the row.

5.     Repeat these steps if you need to enter more rates.

Importing Rates from a File

You also can upload rates from a .csv or .xls file – please refer to the description of this process in the Rate Import section.

 

timesaver Perform the Create Tariff and Enter Rates steps until you have created a tariff with termination costs for each termination partner you have.

Create Vendors

Vendors are your termination partners, i.e. companies you send calls to.

1.     In the Participants section of the Admin interface, choose Vendors.

2.     On the Vendor Management page, choose add Add.

 

Create a vendor

 

Fill in the vendor information

 

4.     Click save_close Save & Close.

5.     Repeat steps 2–4 to add all of your vendors.

Define Connections

Connections represent the point from which calls leave or enter a network and are directed to or from vendors where charges are incurred.

1.     In the Participants section of the admin interface, choose Vendors.

2.     Click on the Connections icon next to the vendor name.

 

NOTE: To set up the configuration, access the Connections group on the configuration server. By default, the ShowPSTNConnectionType feature is off; to activate it, select “Yes” in the corresponding field.

 

Define connections

 

Add a connection

 

Configure the connection

 

Configure the connection load

 

Check the connection added

 

3.     Press add Add to add a new connection.

4.     Fill in the connection information. Choose the type of connection (Calls to Vendor via PSTN in our example) and enter the remote gateway ID (the domain name of the vendor’s gateway or SIP server). Choose the tariff that defines your termination costs for this connection / vendor.

5.     On Connection Load tab define Capacity value for this connection.

6.     Click save_close Save & Close.

7.     Repeat steps 3-5 to add more connections to the same vendor, then click Close to exit to the Vendor Management screen.

8.     Repeat steps 2-6 to add connections for other vendors.

Create Customer Tariffs

Normally you need a separate tariff for each of your customers.

1.     In the Rating section of Admin-Index, choose Tariffs.

2.     On the Tariff Management page, choose add Add.

 

Create a customer tariff

 

Configure the customer tariff

 

3.     Fill in the Add Tariff form (please refer to the Create Customer Tariffs chapter of the Setting up a Wholesale Traffic Exchange section for a detailed description of the available tariff attributes).

4.     Click save Save.

Enter Rates

1.     While on the Edit Tariff page, click the editRate Rates icon in the toolbar.

 

Add rates to the customer tariff

 

Add rates

 

Specify the rate data

 

Check the rate added

 

2.     In the Edit Rates screen, click add Add.

3.     Fill in the required information (please refer to the Enter Rates chapter of the Setting up a Wholesale Traffic Exchange section for a detailed description of the available rate attributes):

o   Effective From – If you want this rate to take effect sometime in the future, you can either type in a date manually, or use the calendar (click the DD-MM-YYYY link). Otherwise, the rate is effective immediately.

NOTE: When using the calendar, you can specify that the date you are entering is in a different time zone than your current one. PortaBilling® will then automatically adjust the time.

Spesify effective from data

 

4.     Click the save Save button in the toolbar, or the save_add Save icon on the left end of the row.

5.     Repeat these steps if you need to enter more rates.

 

timesaver Perform the Create Tariff and Enter Rates steps described in the Setting up a Wholesale Traffic Exchange section until you have created a tariff for each account’s billing scheme. For example, if you plan to have two types of service packages (Termination-Easy and Termination-Gold) with different rates, you will need to create two separate tariffs.

Create a Routing Plan

A routing plan allows you to apply individual routing methods to certain customers, i.e. blocking them from using certain carriers for termination, or, conversely, only allowing them to use certain carriers in a specific order. If you do not define any custom routing plans, the system default routing plan will be used, allowing access to all available carriers.

 

Create a routing plan

 

Fill in the routing plan information

 

Edit the routing plan

 

1.     In the Routing section of the Admin-Index page, choose Routing Plans.

2.     On the Routing Plans Management page, choose add Add.

3.     Fill in the “Add Routing Plan” form (please refer to the Create Routing Plans chapter of the Setting up a Wholesale Traffic Exchange section for a detailed description of available parameters).

4.     Click save Save.

Create a Product

1.     In the Rating section of the Admin-Index page, choose Products.

2.     On the Product management page, click the add Add icon.

3.     Fill in the “New Product” form (please refer to the Create a Product chapter of the Setting up a Wholesale Traffic Exchange section for a detailed description of the available product attributes).

4.     Click save Save.

5.     Click on the Usage Charges tab to edit this product’s rating list.

 

Create a product

 

Fill in the product information

Create Rating Entries for the Product

For incoming VoIP traffic we normally do not really need different rating entries, as just one row with “ANY” node and tariff should be enough. However, if, for example, you want to let a customer send traffic to your gateway A but not gateway B, this can be achieved by using rating entries.

 

Configure usage charges

 

Add usage charges

 

Check usage charges added

 

1.     When the Usage Charges tab is selected, click on theadd Add icon.

2.     Choose Voice Calls in the Service select menu.

3.     In the Node menu select the node that you previously created.

4.     The Access Code should be left empty.

5.     In the Tariff menu, select the tariff with which you want to bill your customer.

6.     Click Update.

7.     Click save Save to save this rating entry.

Create a Customer Class

Customer class provides the ability to define a group of parameters in a centralized way, then apply those parameters to many customers at once.

1.     In the Billing section of the Admin interface, choose Customer Classes.

2.     On the Customer Class Management page, click add Add.

3.     Fill in the customer class general parameters:

 

Create a customer class

 

·       Name – Provide a short name for this customer class.

·       Business Model – Select which customers this customer class will apply. Select SIP Trunking.

·       Currency – Specify the currency in which you want to set the Collection Threshold. When specified, this customer class can only be assigned to customers with the same currency. Once the currency selection is saved, it cannot be changed.

·       Description – Your comments about the intended use of this customer class.

·       Taxation Method – Specify the taxation method to be applied to your customers.

·       ConfigureStatistics parameters:

o   Generate Statistics – Select On to generate statistics for customers.

o   Send Statistics via email – Define how you will provide statistics to your customers.

·       Invoices:

o   Generate Regular Invoices – Select On to generate regular invoices for customers that belong to this customer class.

o   Allow Out-of-Turn Invoices (optional) – Select On to be able to generate out-of-turn invoices (to cover specific items) on demand for customers that belong to this customer class.

·       Billing period is closed – Select Automatically.

·       Suspend On Insufficient Funds For Subscriptions – Specify whether PortaBilling® should check that the customer has sufficient funds for his / her subscription charges. 

·       Description – Your comments about the intended use of this customer class.

 

4.     On the Regular Invoices tab specify the invoicing parameters for the customer class:

 

Configure regular invoices

 

·       Generate invoice PDF – Select At the end of billing period to generate the .pdf files once the billing period ends.

·       Invoice Template – Select the appropriate template which will be used to create a .pdf file with the invoice for your SIP customers (e.g. Wholesale customers invoice template).

·       Send Invoices via email – Check the box to automatically send an invoice to a customer at the end of the billing period.

·       Configure Payment Terms and Payment Collection parameters for customers.

 

Please consult the PortaBilling Help for a description of parameters available here.

 

5.     On the Out-of-Turn Invoices tab specify the invoicing parameters for out-of-turn invoices.

6.     On the Taxation tab, specify the taxation parameters for the selected taxation method.

7.     Click save_close Save & Close.

Create a Customer

1.     In the Participants section of Admin-Index, choose Customers.

2.     On the Customer Management page, choose add Add Customer.

3.     Fill in the New Customer form (please refer to the Create a Customer chapter of the Setting up a Wholesale Traffic Exchange section for a detailed description of the available fields).

 

Create a customer

 

Add a customer

 

Fill in the customer information

 

4.     Click save Save.

Create Accounts

1.     Go to the Customers screen (the screen which contains a list of customers).

2.     Next to the customer name, click on the accounts icon (the one in the Accounts column), which will take you to the account management for that customer.

 

Create an account

 

Add an account

 

Fill in the account information

 

Check the account added

 

3.     Now click on add Add.

4.     Fill in the Add account form:

o   Account Role – Select IPv4 address from the list.

o   Account ID – Identification of the account (value to be sent in the User-Name attribute). For an account which represents a remote gateway, this is normally an IP address.

o   Main Product – Choose the main product, which you would like your account to have.

Account Info tab

o   Type – Account type; select credit for postpaid and debit for prepaid service.

o   Balance Control – Choose the way the balance of the account is controlled. Subordinate – the balance will directly depend on the customer’s balance (only the customer tops up the balance); Individual Credit Limit – this account may have its own balance and credit limit (the customer credit limit still applies.) Choose Subordinate in this field.

o   E-mail – Enter the account owner’s email address here. If he ever forgets his password for the web self-care pages, he will be able to reset it, and a new password will be sent to this email address. You can also just leave this field empty.

Web Self-Care tab

o   Login – Account login to web self-care pages. Can be the same as account ID.

o   Password – Password for the web self-care pages.

o   Time Zone – The time zone for the account self-care interface.

o   Web Interface Language – The language to be used on the account self-care web interface.

Additional Info tab

o   Auto-Provisioning – Leave None (manual provisioning) selected.

Life Cycle tab

o   Activation Date – The date from which the account is usable.

o    Specific Date – Identifies the date that the account expires.

o   ____days after First Use – Defines the number of days the account remains active after its first use or recharge.

o   ____days after Last Use – Defines the number of days the account remains active after its last use or recharge.

Since we are setting up a postpaid service, which should function for a long time, leave Expiration Date fields blank.

 

5.     Click save_close Save & Close; a confirmation screen will indicate that the account has been created.

6.     Repeat steps 3-5 if the customer has more than one remote gateway.

Assign the Routing Plan to the Account

1.     Go to the Customers screen (the one containing a list of customers).

2.     Next to the customer name, click the accounts icon (the one in the Accounts column) to enter account management for this customer.

3.     Perform an account search and, when the required account is displayed, click on the account ID.

 

Assign the routing plan to the account

 

4.     Go to the Service Configuration tab of the account.

5.     Select Enabled from the Routing Plan list in the Outgoing Calls section.

6.     Select the routing plan for this account from the list.

7.     Click save_close Save & Close.