Fundamentos de Telefonía y

Soporte de productos de Telefonía

IFX Networks

Agosto 2008
Investigación y Desarrollo
Sebastián Averbuj y Fernando Dorna
 Objetivo

• Adquirir el conocimiento relacionado con

todas las herramientas de administracion
y troubleshooting de V3.
 Agenda

● Interfaces de Administración.
● GUI V3. Backend TERAS.
● Provisioning Server. Equipos Homologados
● Arquitectura e Implementación de Servicios.
● VoissLogic. Consola. Mensajeria.
 Interfaces
de
Administracion

Agosto 2008
Investigación y Desarrollo
Sebastián Averbuj y Fernando Dorna
 GUI de Administración de V3
La plataforma de GENBAND ofrece una GUI de administración. Esta GUI es una interfaz JAVA que debe instalarse en una PC PIV,
con 256 MB de RAM mínimo, corriendo Windows 2000 o XP Profesional.

Desde allí se realizan todas las ABM sobre la base de datos. La GUI tiene varias vistas desde las que se pueden hacer altas, bajas,
modificaciones y también monitoreo y estado de las líneas,

• Se descarga desde el sitio:

http://<IP_del_DBA>/admin

• http://200.62.50.12/admin (PROD)

• http://200.73.70.204/admin (DEV)
 VISTAS
V-NET . Relacionado a las llamadas entrantes. Asignación de la numeración.
Wizards
POPs. Relacionado con las llamadas salientes, planes de marcación.

Vista desde la cual se ejecutan todas las ABM sobre la DB

Partitions. Cada partición es una agrupación de usuarios con características similares.

SIP Gateways. Gateways definidos para interactuar con el M6.

Templates. Características definidas para los endpoints.

Firewalls. Definición de los SBC o VPFs

SIP Registrar. Definición del Registrar del M6, puerto de registracion, Metodo, etc.

Components Number Plan. Componentes desde los que se verifica la asignación de números.

Outbound Dial. Plan de marcación, definición de rutas.

Vista desde la cual se manejan cambios menores y monitoreo
Route Point. Componente que usa la API para interactuar con lógicas externas.

Trunk Groups. Componente que indica contra que se conectara la llamada, in/out.

Line. Modificaciones sobre componentes específicos.

Phone. Permite verificar el status de la línea. IDLE/ACTIVE/OUT SERVICE.

 Flujo de Llamadas

Cliente Hosted PBX

PHONE LINE PHONE INTERNAL NUMBER

FEATURES PLAN

OUTBOUND TRUNK SIP

DIAL GROUP GATEWAY PSTN

Esta llamada genera un CDR en la plataforma V3 (Application Servers) que luego es levantado
por un proceso que corre a la noche (CDR Importer), tasado y asignado al cliente que
corresponde.

0| 0|00C0.95C9.F9B0.46EC.8D81.3421 |09/16/2007 01:57:21|09/16/2007 01:57:40|09/16/2007

01:57:54|OcLine: Impsat Colombia |OcPhoneSip: Impsat Colombia |5713693148 |Impsat
Colombia |OcTrunkGroup: Out-Terminacion-|OcSIPGateway: USMIANAP2821x1 |573006135845
| |900573006135845 | | |O| |Y|
14|00C0.95C9.F9B0.46EC.8D87.3890@172.16.5.10 | |9990805573006135845
| | 0|OcPartition: IFX DEMO - Colomb| |
 Flujo de Llamadas

Cliente Residencial

PHONE LINE PHONE

FEATURES

OUTBOUND TRUNK SIP

DIAL GROUP GATEWAY PSTN

Este tipo de llamadas son validadas antes de ser cursadas. El

componente que permite este control en V3 se denomina
ROUTEPOINT RoutePoint.
Cuando un cliente ha excedido su límite, la llamada no se cursa.
Las llamadas de los clientes de HPBX no son controladas de esta
forma ya que los datos que entrega la plataforma a la lógica de
control no permiten el control de los servicios por ejemplo de desvío
de llamada, conferencias, etc.
TERAS
Estas llamadas también generan CDRs y si ocurre algún problema
con la lógica, a la noche son imputadas al cliente que corresponda.
 TERAS/BACKEND
Como vimos anteriormente TERAS es el sistema de Rating Telefónico de IFX que permite autenticar y tasar servicios telefónicos de
valor agregado.

Para realizar la administración de los servicios, las listas de precios, los planes de marketing y otra información necesaria para el
funcionamiento y el cobro de las llamadas se utiliza la interfase grafica de usuario. Para esto el acceso se realiza a través del
Backend de administración.

Esta interfase de administración se compone de las siguientes secciones:

ABM
Backend
Currencies

ABMs sobre el Rating System Price Plans & Marketing Campaings

Accounts

Reports

Calls
 Arquitectura
La estructura de TERAS se desarrollo pensando en la posibilidad de brindar servicio no solo a clientes corporativos o
residenciales sino también contemplar la estructura de Partners que revendan el servicio. Es por esto que su arquitectura es en
forma de árbol del que dependen todos los servicios ofrecidos.

IFX
ROOT

IFX Corporate IFX Long Distance IFX Offices Partners IFX Residencial

Price Plans

Argentina Partner A Argentina

Argentina Colombia Chile USA
Accounts

Price Plans

Chile Chile
Partner B
Accounts

Price Plans
Colombia Colombia
Partner C
Accounts
Desde el Backend de TERAS se puede verificar si el estado de las cuentas es activo/suspendido, si el max balance se ha agotado y
si sobre el endpoint existe algún tipo de bloqueo entre otras cosas. El acceso al backend se realiza vía web a través del siguiente
link: http://200.62.50.41/backend

● TERAS corre en un servidor

Windows 2000 SP 4.

● ABM sobre todas los endpoints,

accounts, priceplans, marketing
campaigns etc.

● Troubleshooting sobre cada uno

de los componentes.

● Verificación de los CDRs con

causa de desconexión y remaining
balance.
 ACCOUNTS & SERVICES
Una vez que ingresamos en el backend, y dependiendo del perfil de usuario que tengamos podemos acceder a cualquiera de los
menús con los que contamos,

Estructura de Árbol

Endpoints

Price Plans
 PRICE PLANS & MARKETING CAMPAINGS

PricePlan - PriceList
SetupFee
BillIncrement
MinTime
Currency

Se definen los PricePlans que

integran el Marketing Campaign
 FRONTEND PARA CLIENTES
Cada uno de los clientes que existen en V3 tienen la posibilidad de acceder a un FrontEnd desde el cual puedan verificar el balance
de su cuenta como asi también los CDRs de cada una las llamadas que han realizado.
A este frontend se accede ingresando a: http://200.62.50.207

Desde esta herramienta el cliente puede

verificar el balance de su cuenta, los
planes que tiene contratados,etc.

Histórico de cada una de las llamadas

realizadas, filtros por día, mes, ANI.
 PROVISIONING SERVER
El Provisioning Server es, al igual que TERAS, un desarrollo inhouse que se creo con la necesidad de poder hacer mas flexible, útil
y rápida la configuración y aprovisionamiento de cada uno de los endpoints que se deben instalar.
Íntegramente desarrollado en .NET y utilizando una base de datos MS SQL Server, el Provisioning System nos da la flexibilidad
que necesitamos para poder hacer del aprovisionamiento un paso muy simple.

.NET + SQL Server

Provisioning Server

TP
HT
SIP

Web Administration

DB Prov Server
El login en el Provisioning Server se realiza desde: http://prov.telco-carrier.com , desde allí se puede hacer el autoaprovisionamiento
en forma automática, para ello debemos tener acceso web contra el endpoint y contra el provisioning server. Si el endpoint esta
dado de alta en forma correcta en el sistema, mediante un pedido HTTP el Provisioning le enviara la información de la configuración
al equipo validándose por la mac address del endpoint.
 ABMs en el Provisioning
El sistema cuenta con una estructura que nos permite poder realizar la configuracion de muchos parámetros en los endpoints,
desde usuario/password de registracion, hasta la activación de servicios avanzados, TOS, DTMF Method, etc.

Todos estos cambios se realizan en forma directa sobre “Templates” definidos en el sistema, es por ello que cada dispositivo
homologado posee un template en el Provisioning Server que hace referencia a distintas variables que se completan a mano por el
operador, estas variables son básicamente los datos de usuario/password de registracion de las líneas.
Descripción de las opciones y funciones en el Provisioning Server,

El sistema nos da la flexibilidad de poder configurar:

√ Servicios: Se define el nombre y el SIP Server contra el cual señalizaran los endpoints;
√ Clientes: Se define el cliente, es información pasiva, no hace al funcionamiento del servicio;
√ Reportes: Se pueden listar y exportar reportes de cada uno de los endpoints creados, por servicio y por cliente.
 Como funciona el dial-plan en los gateways
Como en todos los gateways de voip, el dial-plan hace referencia al modo de discado que se puede definir, la utilidad de esto es
acotar la posibilidad y disminuir el time-out a la hora de realizar una llamada.

La gran parte de los equipos de voip que están implementados en la plataforma V3 son Linksys/Sipura y estos equipos manejan un
dial-plan particular que se explicara a continuación.

El método que se usa es el de acotar los posibles números discados, por ejemplo,
√ Las llamadas locales en Santiago son del tipo:
2 - 9 + 6 dígitos Ejemplo: 2335000
Por lo que en el dial-plan esa entrada se contemplaría de la siguiente forma: [2-9]xxxxxx

√ Otro ejemplo es el discado a números móviles:

09 + 7,8,9 + 7 dígitos Ejemplo: 09 93214567
Por lo que en el dial-plan esa entrada se contemplaría de la siguiente forma: 09[789]xxxxxxx

√ Otra cosa importante a considerar es el uso de timers y otros caracteres especiales, por ejemplo:
* El uso de la , (coma) es para que el equipo genere un tono de discado directamente. Esto se usa para simular el tono que
entrega una PBX convencional luego de que se marca un digito para realizar una llamada saliente. Ej.:
9, 2335000
* El uso de caracteres como S tienen como función agregar o disminuir el time out que se generara para realizar la llamada, y el
motivo de su utilización es para diferenciar algunos strings que pueden llegar a ser similares. Ej: 9, 2xxxxxxS1
* Otros caracteres utilizados son:
* como *xx para el uso de *09 (acceso al voice mail)
|| son utilizados para separar cada una de los strings, Ej: (9, [2-9]xxxxxx|9, 09[789]xxxxxxx|0S0)
[ ] son utilizados para agrupar dígitos comunes. Ej: [789]xxxxxxx
( ) se utilizan en el inicio y fin de la cadena completa que forma parte del dial-plan.
 Arquitectura
e implementacion
de Servicios

Agosto 2008
Investigación y Desarrollo
Sebastián Averbuj y Fernando Dorna
 Servicios
La estructura de los servicios que se desarrolla en V3 esta dada por la asociación de componentes. Cada componente realiza un
acción particular y en forma conjunta se llega a una acción.

La implementación estándar para los servicios en V3 se detallara a continuación, mostraremos cada uno de los componentes por
los que pasa una llamada saliente para poder entender el funcionamiento interno de V3 y en base a eso poder hacer el
troubleshooting optimo,

● No se realiza un control Real-Time de las llamadas;

Hosted PBX
● Los consumos son insertados con 24 Hs de demora. Cada noche corre un proceso que analiza cada
CDR y actualiza los consumos de los clientes;

● La estructura es mucho mas simple que en los servicios residenciales;

● Se realiza un control Real-Time de las llamadas;

Residencial ● Los consumos y la actualización de los balances son insertados en el momento en que finaliza la
llamada;

● La estructura es mas compleja porque implica que V3 hable con una Lógica que a su vez se
comunica con el Rating System;

● Hay muchos Class 5 Features que nos son soportados en este escenario;
La estructura de un servicio de Hosted PBX es relativamente mas simple que en un servicio Residencial. Hosted PBX es el servicio
nativo de V3 y la configuración a la hora de la creación de una nueva PBX virtual es automática para todos los componentes.

Line

PhoneFeatures

CDR Importer Rating System

NumberPlan

OutgoingDial Local
Mobile
TrunkGroups Emergencia e Información
LongDistance
Los servicios residenciales hacen uso del componente ROUTE POINT, dicho componente es el punto de dialogo (API) con
sistemas externos que realiza otras funciones o controles sobre las llamadas. En nuestro caso este sistema externo es una lógica
denominada VoissLogic. Como se comento anteriormente esta lógica interactúa con V3 por un lado y por otro con un sistema de
Rating que nos permite controlar saldos, bloqueos, permisos, entre otras cosas.
Gracias a esta arquitectura es que IFX puede brindar el servicio de líneas residenciales en modalidades pos-pago, pre-pago y de
tarifa plana.
Line
Local
Mobile
TrunkGroups Emergencia e Información
LongDistance

PhoneFeatures

Service: VoissLogic

NumberPlan OutgoingDial

OutgoingDial NumberPlan

ROUTE POINT

Eventos en el Rating System Acciones a Realizar

Se valida la cuenta en TERAS.
NewCall
Validating Si posee saldo, se rutea la comunicación.
RatingSystem Validating
De acuerdo al destino la llamada conectada por el
Connecting determinado TrunkGroup.
Ringing
Connected
CallerEnd
Charging
CallerEnd
 VoissLogic. Mensajeria.
Como se menciono anteriormente VoissLogic habla a través de la API con V3, puntualmente con el componente ROUTE POINT y
por otro lado a través de WebServices contra el Rating System TERAS.
20:20:07|STATUS|00C0.95C9.F9B0.474D.CD76.0D4D|NewCall|541160918261|541155556899||
20:20:07|STATUS|00C0.95C9.F9B0.474D.CD76.0D4D|Validating|541160918261|541155556899|RatingSystem Validating
20:20:07|RATING|AAA.Autenticate(UID:541160918261,AID:541160918261,ANI:541160918261,DNIS:541155556899,11/28/2007 20:20:07) OK

<Result Account="Root/IFX Residential/Argentina/Bs As/NoemaLife/541160918261" Type="ENDPOINT" Destination="Argentina/Buenos Aires" UID="541160918261"

DNIS="541155556899" Prefix="" Direction="O" PlanType="Plain" MaxDuration="86400" RemBalance="1917.315" Currency="ARS" Announces="" Drop="False" />

20:20:07|STATUS|00C0.95C9.F9B0.474D.CD76.0D4D|Connecting|541160918261|541155556899|Routting, RattingTime=0.03, MaxDuration=86400s,

MaxBalance=1917.32, Announces=, Drop=0

20:20:12|EVENT|00C0.95C9.F9B0.474D.CD76.0D4D|541155556899|ALERTING|NONE|ROUTE_POINT(99999014)PASSIVE|PHONE(541160918261)ATTEMPTING|EXTER
NAL(541155556899)ALERTING|
20:20:12|STATUS|00C0.95C9.F9B0.474D.CD76.0D4D|Ringing|541160918261|541155556899|Ringing...
20:20:22|EVENT|00C0.95C9.F9B0.474D.CD76.0D4D|541155556899|ESTABLISHED|NONE|ROUTE_POINT(99999014)PASSIVE|PHONE(541160918261)ATTEMPTING|EX
TERNAL(541155556899)CONNECTED|

20:20:22|EVENT|00C0.95C9.F9B0.474D.CD76.0D4D|541160918261|ESTABLISHED|NONE|ROUTE_POINT(99999014)PASSIVE|PHONE(541160918261)CONNECTED|EXT
ERNAL(541155556899)CONNECTED|
20:20:22|STATUS|00C0.95C9.F9B0.474D.CD76.0D4D|Connected|541160918261|541155556899|Start Counting

20:22:15|EVENT|00C0.95C9.F9B0.474D.CD76.0D4D|541155556899|IDLED|NONE|ROUTE_POINT(99999014)PASSIVE|PHONE(541160918261)CONNECTED|EXTERNAL(
541155556899)IDLE|
20:22:15|STATUS|00C0.95C9.F9B0.474D.CD76.0D4D|CalledEnd|541160918261|541155556899|Elapsed=113s
20:22:15|STATUS|00C0.95C9.F9B0.474D.CD76.0D4D|Charging|541160918261|541155556899|Charging...
20:22:15|EVENT|00C0.95C9.F9B0.474D.CD76.0D4D|99999014|ALERTING|NONE|ROUTE_POINT(99999014)ALERTING|PHONE(541160918261)ATTEMPTING|

20:22:15|RATING|InsertUsage(541160918261,541155556899,11/28/2007 20:20:07) OK
<Result CallID="3085595" Destionation="Argentina/Buenos Aires" Elapsed="113" Price="0.05" Currency="ARS" />

20:22:15|EVENT|00C0.95C9.F9B0.474D.CD76.0D4D|541160918261|IDLED|NONE|ROUTE_POINT(99999014)ALERTING|PHONE(541160918261)IDLE|
20:22:15|EVENT|00C0.95C9.F9B0.474D.CD76.0D4D|99999014|IDLED|NONE|ROUTE_POINT(99999014)IDLE|
20:22:16|CALL|11/28/2007 20:22:15|00C0.95C9.F9B0.474D.CD76.0D4D|541160918261|541155556899|1m53s|Dropped|CalledEnd
 VoissLogic

Agosto 2008
Investigación y Desarrollo
Sebastián Averbuj y Fernando Dorna
Las lógicas de cada uno de los servicios residenciales corren como un servicio en Windows, instaladas en el servidor v3mw0
(200.62.50.41) es desde donde se controla toda la señalización contra V3 y contra el Rating.

Ante algún eventual reclamo, podemos verificar el estado de la lógica ingresando a la consola:

Desde allí podemos ver el estado de la lógica, ver si hay llamadas activas y activar debugs para analizar los eventos
contra V3 y la interacción contra el Rating System.
Asi como podemos verificar el estado de la lógica desde la consola de administracion, podemos verificar el estado del servicio
desde el servidor donde se encuentra instalada.

1º Ingresar por Remote Desktop al server v3mw0 (200.62.50.41)

2º Verificar si el servicio esta iniciado 3º Verificar, ingresando en propiedades si el servicio

desde la aplicación Process Explorer. esta traficando información (I/O Bytes)

4º Si existieran problemas con el servicio, se puede reiniciar el mismo desde el Process Explorer,
o reiniciando el mismo desde la administracion normal de Windows. Luego de hecho esto verificar
desde propiedades si se restableció la conexión con V3 y también desde la consola si existen
llamadas.
 ANEXO I
Console Voice Logic. Comandos Útiles.

status. Ver el estado de la Lógica. (OK, Not Monitoring)

list calls. Ver las llamadas actuales
hook all/unhook all. Debug que envía a la consola la información de eventos contra V3 y la interacción contra TERAS.
stats. Muestra información relativa a las estadisticas de las llamadas cursadas.
reconnect. Inicia la reconexión manual contra V3.
drop. Finaliza una llamada en forma manual sin que se tase.
hung. Finaliza una llamada en forma manual y esta es tasada por el Rating Sytem.
 Contactos

Fernando Dorna
Systems Engineer
fdorna@ifxcorp.com
+54 11 5031 2405

Sebastian Averbuj
Systems Engineer
saverbuj@ifxcorp.com
+54 11 5031 2422