MVTSII Quick Start Guide
MVTSII Quick Start Guide
COPYRIGHT INFORMATION
T he i n for ma t io n c o n tai ne d in t h is docu me nt i s t he pro per t y o f M er a S y s te ms I nc . No pa r t o f th is pu blica tio n ma y b e r epr oduc ed or c op ie d in any fo rm or b y an y mea ns - gr aph ic , elec tro n ic or mec han ica l includ ing ph o toc op yin g , r eco rd ing , t a pi ng , o r a n y o th er i n fo r ma t io n s to r ag e an d r e tr ie v al s ys te m - w i tho u t w r i t te n co nsen t o f Me ra Sys te ms Inc . No th ird par ty, org an iza tion or ind i vid ua l , is a u tho riz ed to gra nt s uch per mission .
Contents
1 2 3 4 5 6 7 8 9 INTRODUCTION .......................................................................................................... 4 ACCESSING TMNGR THROUGH WEB-SERVER ................................................. 4 WHAT YOU SEE ON THE SCREEN.......................................................................... 4 POP-UP MENU............................................................................................................... 5 BASIC TERMS AND CONFIGURATION SEQUENCE .......................................... 7 CASE STUDY ................................................................................................................. 9 CONFIGURING CUSTOMER/VENDOR RECORDS ............................................ 10 CONFIGURING CUSTOMER/VENDOR SETTLEMENT ACCOUNTS ............ 11 8.1 DEPOSITING FUNDS TO THE ACCOUNTS ...................................................................... 12 CONFIGURING CUSTOMER RATE PLANS......................................................... 13
10 CONFIGURING DESTINATIONS............................................................................ 14 11 CONFIGURING IP ZONES ....................................................................................... 14 12 CONFIGURING CODEC GROUPS .......................................................................... 15 13 CONFIGURING EQUIPMENT ................................................................................. 16 14 CONFIGURING DIAL PEERS .................................................................................. 17 15 CONFIGURING CUSTOMER AUTHENTICATION DATA ................................ 17 16 CALL SIMULATION .................................................................................................. 18
MVTS II
page 3 of 18
INTRODUCTION
This document explains how to set up MVTS II for initial use and how to begin using the System. The content of this document presumes that MVTS II has been properly installed and deployed on the user network.
Upon first log onto the web-interface use the admin login name and password. You will be displayed with the main window of the web-interface. Note: It is advisable to change the first-time logon credentials immediately after you have accessed the newly deployed system (Customers/Vendors > Administration > Web authentication). The login and password check in the system is case-sensitive.
MVTS II
page 4 of 18
Use the Rows on page combo box located above and below the tables to control the number of rows displayed in them (10, 25, 50 or 100). Use the buttons / to view the next (or previous) portion of data. Use the buttons / to go to the last or first view.
POP-UP MENU
Left-click a record of interest in the table you are working with to invoke a pop-up menu that offers record manipulation options. The contents of pop-up menus may differ from table to table and depend on your user permissions. The figure below presents an example of the pop-up menu that you invoke to work with the records of a table.
MVTS II
page 5 of 18
Typically a pop-up menu contains the following commands: Add this command enables you to add new records to the table; View opens a record viewing window. To return to the tabular view click the OK button; Edit opens a record editing dialog box. When you are through with editing the record parameters, click OK to confirm or Cancel to discard the changes; Delete use this command to delete the record you selected; Edit marked you can use this command to perform group editing of table records. Mark the records of interest and select Edit marked. You will be displayed with a dialog box similar to the one displayed by the Edit command but with additional check boxes in front each parameter record. Select the appropriate check box, enter the required changes and click OK. The changes will be applied to all the marked records. Delete marked this command allows you to delete marked records. To mark the records, select the respective check boxes in the leftmost column of the table. To mark all the records in the list simply select the checkbox in the header of the table. Edit all filtered - you can use this command to edit all the records at a time. In case the table data has been filtered, the changes will be applied only to the records matching the filtering criteria. Invoke the popup menu and select Edit marked. You will be displayed with a dialog box similar to the one displayed by the Edit command but with additional check boxes next to each parameter record. Select the appropriate check box, enter the required changes and click OK. The changes will be applied to all the records in the table or to all filtered records. Delete all filtered this command allows you to delete all the records form the table you are working with. In case the table data has been filtered, only the records matching the filtering criteria will be removed. Filter invokes a filter dialog box; Arrange columns enables you to arrange the table columns according to your preference; Export data use this command to unload data from the tables into CSV-files. Related tables a list of tables associated with the table you are working with. The table opened by this command contains information related only to the item selected in the source table. For example, left-click a
MVTS II
page 6 of 18
record of interest in the table System users and select Role assignments on the pop-up menu. The system will display the table Role assignments with information about the roles assigned to the selected user only.
Customer/Vendor companies
Customer a buyer, i.e. a carrier that buys termination services from the owner of MVTS II Vendor a seller, i.e. carrier from which the owner of MVTS II buys termination services
Accounts
Database records that keep information about how much toll money is due from the Customer for rendered service or how much toll money is due to the Vendor for traffic termination services bought from it.
Rate plans
Each rate plan is a specific DB record that embraces a number of destinations the rate plan covers. Rate plans are assigned to customers through their authentication records.
Destinations
A list of destinations identified by number prefixes and rates. In other words the list of destinations is a price list offered by the System owner to its customers. Each destination record is associated with a specific rate plan.
Zones
An IP zone is a set of connected networks characterized by configured routing between the IP addresses of the comprising networks and the absence of connectivity restricting devices (for example, firewalls, NAT routers etc.) within the zone.
MVTS II
page 7 of 18
Codec groups
Equipment
Collective name for network devices (VoIP gateways, softswitches, session border controllers or user endpoints) that can originate and/or terminate VoIP traffic
Routing groups
A routing group is a collection of dial peers (see below) grouped by some criterion, for example, high QoS or ASR values. In our configuration example we will skip this step and use the Default routing group already configured in the DB.
Dial peers
In terms of MVTS II a dial peer is a complex notion denoting a termination option characterized by destination prefixes and per minute rates. In other words the list of dial peers is a price list offered to the System owner by its termination partners, i.e. vendors.
DB records that contain data by which the System identifies Customers that originate calls. A customer record also provide information about: Customers authentication data rate plan assigned to the customers, i.e. about the prices they will be charged routing groups, i.e. about dial peer groups that will be used for termination of calls arriving from the customer.
MVTS II
page 8 of 18
CASE STUDY
To start configuring the System, consider the following example that will be used throughout the manual. Suppose that you have 6 partner carriers. Let us call them: UsTel (USA Telecom) RuTel (Russia Telecom) ItaTel (Italia Telecom) InTel (India Telecom) BraTel (Brazil Telecom) ChiTel (China Telecom) Each of these companies offer you termination services to their native countries, i.e. act as Vendors. And you, in your turn, as a reseller offer them termination services to the rest of the countries. For example, the US provider will be able to place calls to Russia, Italy, India, Brazil and China; the Russian provider will call to the USA, Italy, India, Brazil and China and so on. In this case they will act as Customers, each of them having its own rate plan. Now let us analyze what we have: six vendors offering termination services to six countries, i.e. six* dial peers six customers and six rate plans each of them covering 5 destinations (see the figure below).
MVTS II
page 9 of 18
Note: To simplify our example we will consider that the vendors offer one and the same rate for the whole country without any differentiation between different country areas and cities
But prior to configuring the dial peers and rate plans we will have to add some other essential data to the DB in the order described in section 5.
Fig. 7 Table of Customers/Vendors Open the table Customer/Vendors by clicking the required item in the same- name object category. Add a record for UsTel. For this, left-click the mouse over the table to invoke the pop-up menu and select Add.
MVTS II
page 10 of 18
In the displayed dialog box define the following parameters: Enabled select the checkbox to make the record active; *Customer/Vendor enter the name of the origination/termination partner (the * next to the field name means that the field is mandatory); Description in this field you can enter any descriptive information about the record you are adding, however it is not necessary; Vendor/Customer select these check boxes to indicate that the carrier acts both as Vendor and Customer. Allow proxy for originated calls this check box is selected by default. It enables the media-proxy function for calls originated by this carrier. Leave the check box selected or uncheck it to disable the media-proxy function. Click OK to add the record to the table. Repeat the above steps and add five more records for the rest of the carriers. Note: The configuration examples given in this manual provide information only about the most essential parameters. For information about the intent of the rest of parameters refer to MVTS II Operators Manual.
MVTS II
page 11 of 18
In the displayed dialog box define the following parameters: *Account type enter the name of the account *Customer/Vendor select UsTel from the drop-down list of this combo box *Account type select the vendor account option *Currency let us make US dollars a common currency for all the carriers *Active till the account expiration date will be automatically set to January 1, 2099. If necessary, you can change this date. Min. balance the default value of this parameter is 0. It means that once the customer balance reaches 0, the account will be blocked. If necessary, you can change this value. Click OK to add the record to the table. Repeat the procedure and create a record for the UsTel customer account. Then create account records for the rest of the carriers. As a result we should have 6 vendor and 6 customer accounts.
8.1
MVTS II
page 12 of 18
Fig. 10 Adding a payment entry Repeat these steps to deposit funds to the rest of the 6 customer accounts.
Fig. 11 Adding a rate plan In the invoked dialog define the following parameters:
MVTS II
page 13 of 18
*Affiliated to select the option Your company *Rate plan enter the name of the new rate plan *Status select the In effect option from the drop-down list of this combo box *Currency - select USD. When done, click the OK button to add the record to the table. Add five more rate plans for the rest of the customers.
10
CONFIGURING DESTINATIONS
Your next step is to configure the destination each of the 6 rate plans cover. In our case it is 5 destinations per rate plan. So in total you are to create 30 destination records. Switch to the table of destinations found in the category of objects Origination. Configure a record for the destination China for the UsTel rate plan. For this invoke the pop-up menu and select Add
Fig. 12 Adding a destination record In the invoked dialog define the Rate plan, the destination prefix (for China it is 86) and the per minute rate. When done, click OK. Repeat these steps to configure the rest of the destination records.
11
CONFIGURING IP ZONES
At this step we will create an IP zone record. This is required to be able to assign IP zones when configuring equipment records. Switch to the table Zones found in the category of objects Equipment and invoke the add-record dialog.
MVTS II
page 14 of 18
Fig. 13 Adding an IP zone record Type in the name of the IP zone from the configuration of Traffic Switch and click OK to submit the records. For more detailed information about IP zones refer to MVTS II Operators Manual.
12
Your next step is to define codecs that make up the group. Switch to the object Codec group setup found in the same object category. Invoke the add-record dialog box and configure the G.723 codec (see the figure below).
Fig. 15 Configuring codecs When done, click OK to submit the record. Repeat the procedure for the rest of the codecs.
MVTS II
page 15 of 18
13
CONFIGURING EQUIPMENT
At this step we will configure equipment records. According to our example we have six gateways that act both as originators and terminators. Switch to the object Equipment found in the same-name object category and invoke the add-record dialog box.
Fig. 16 Adding a gateway record In the displayed dialog box define the following essential parameters for the UsTel gateway: Enabled select this check box to make the record active Name enter the name of the device Customer/Vendor - define the device owner IP address define the IP address the device Zone select the name of the IP zone that we have already configured Protocol - select the protocol supported by the device Media proxy mode - select the Force proxy option Codec group - select the Test group option Click OK to add the record to the table. Repeat the procedure and configure the remaining five gateways.
MVTS II
page 16 of 18
14
Fig. 17 Adding a gateway record In the displayed dialog box define the following essential parameters for the UsTel dial peer: Enabled select this check box to make the record active Affiliated to select UsTel from the drop-down list of this combo box Routing group select Default Routing Group Prefix enter the US country code *Rate (vendors currency) - enter the per minute rate Equipment select UsTel GW from the drop-down list of this combo box *Payables account select UsTel vendor account When done, click OK to submit the record. Repeat the procedure to add the rest 5 dial peer records.
15
MVTS II
page 17 of 18
The System can authenticate Customers by: login password IP address and network mask technical prefix source or destination numbers or any combination of the above criteria. Assume that the gateway will be authenticated by the IP address and network mask. We will also need to define the following parameters: Enabled select this check box to make the record active Affiliated to select UsTel from the drop-down list of this combo box Equipment select the equipment record that we have configure for the UsTel gateway Rate plan select the rate plan configured for UsTel Chargeable account - select the UsTel customer account When done, click OK to submit the record. Congratulations! The System is ready to start handling traffic, but before it we will make a couple of tests to make sure that the System is properly configured.
16
CALL SIMULATION
Switch over to the object Call simulation found in the category of objects Debugging. This object allows the operator to make test calls and check the System for correctness of configuration. In the displayed dialog box define: the IP address of the origination device; source and destination phone numbers; the IP zone. When done, click OK to initiate call simulation.
Fig. 18 Call simulation results You will be displayed with the results of the simulation procedure in the lower part of the dialog box. In case of errors found (see the figure above), check the respective configuration settings. Repeat the procedure for the rest of the gateways.
MVTS II
page 18 of 18