Area de Operaciones

M(o)b.id 1

Aprovisionamiento de Entel
Area de Operaciones

M(o)b.id 2



1. NDICE

Pag

1. ndice ............................................................................................................................................................ 2
2. Introduccin. ................................................................................................................................................ 3
3. Datos relevantes. .......................................................................................................................................... 3
4. Conexin. ...................................................................................................................................................... 3
5. Procedimiento. ............................................................................................................................................. 5
6. Validacin en Base de datos. ........................................................................................................................ 7
7. Tabla retornos CGI Entel. ............................................................................................................................ 11

































Area de Operaciones

M(o)b.id 3


2. INTRODUCCIN.

En este procedimiento aprenders como aprovisionar o desaprovicionar manualmente un mvil
perteneciente a la operadora Entel. Con este procedimiento podrs bloquear la entrega de mensaje a un
determinado nmero corto o campaa, vale decir, que depender de que este o no inscrito en algn numero
corto o campaa para que este reciba o no el SMS.

Por una parte existe nuestro aprovisionamiento o desaprovisionamiento que realizamos nosotros como
compaa y la que realiza el operador (Entel) de forma interna cuando el usuario final requiera de dicho
cambio.

3. DATOS RELEVANTES.

Maquina: Albatroz
Ip: 192.168.0.35
Usuario: appatiaxa
Contrasea: app_alb-inter
Directorio de trabajo: /home/apptiaxa/tmp/pasl/prov

4. CONEXIN.

En primer lugar debe conectarse al servidor donde se encuentra el proceso que utilizara en este manual, para
que se conecte al servidor debe hacerlo via ssh como lo hace con todos, ya sea de forma directa o desde
otro servidor. Si se conectara de forma directa debe abrir su cliente SSH (programa) el cual le solicitara el
servidor que este puede ser por nombre de host o bien por IP. Esta vez utilizaremos el PuTTy (Cliente SSH)
para explicar estos pasos de conexin;

Si se fija en la imagen anterior el PuTTY le solicita las especificaciones de destino para la conexin, vale decir,
el servidor de destino u IP ya que como se dijo antes ambas son vlidas y puerto que en este caso es el
puerto 22 (puerto de ssh).



Area de Operaciones

M(o)b.id 4


Una vez que la conexin acepte estos datos, se le solicitara el usuario y la contrasea los cuales son los que
ya se estipularon, aparecer algo como esto;

login as: apptiaxa
apptiaxa@Albatroz's password:

Si se encuentra en otra mquina existe la forma de saltar desde la mquina que ya se encuentra a la que
quiere trabajar, esta mquina se debe encontrar en la misma sub red. Para esta conexin existen dos
situaciones que son las siguientes;

Salto con el mismo usuario iniciado en la conexin de la maquina actual.
Salto con un usuario distinto al iniciado en la conexin de la maquina actual.

Si est utilizando el mismo usuario para ambas maquinas, ya sea en la que ya est conectado y a la cual se
desea conectar solo debe escribir el siguiente comando en cualquiera sea el directorio en que se encuentre;

$ ssh albatroz

Luego presiona la tecla enter y la conexin le pedir la contrasea para acceder a dicho equipo, solo debe
escribir la contrasea ya estipulada y presionas la tecla enter y ya estar dentro del servidor como se
muestra en la siguiente imagen;

$ ssh albatroz
apptiaxa@albatroz's password:

Por otro lado si est utilizando otro usuario distinto al usuario de la mquina que se desea conectar
independiente tambin en el directorio de trabajo en que se encuentre debe hacerlo de la siguiente forma;

$ ssh apptiaxa@albatroz

De esta forma le estar entregando no solo la maquina si no tambin el usuario, pero tal cual como el
anterior (mismo usuario) tambin te solicitara la contrasea de ingreso luego presionar la tecla enter;

$ ssh apptiaxa@albatroz
apptiaxa@albatroz's password:

De esta forma ya estar conectado para trabajar.





Area de Operaciones

M(o)b.id 5


5. PROCEDIMIENTO.

Una vez que ya est conectado a nuestro servidor debe dirigirte al directorio de trabajo estipulado, con el
siguiente comando;

$ cd /home/apptiaxa/tmp/pasl/prov

Luego debe presionar la tecla enter, una vez all en ese directorio puede listar las carpetas, archivos o
directorios que esta contiene con el siguiente comando;

$ ls -ltr

Este paso le ayudar para saber si existe el proceso que ocupara para aprovisionar o desaprovisionar los
mviles, este proceso tiene un nombre igual a este prov.pl el cual el cual con una serie de datos de entrada
mandara a inscribir o desinscribir de una compaa o nmero cort en particular. La estructura para
ejecutar el proceso es la siguiente;

$ perl prov.pl <numero de telefono> <numero corto> <accin>

El comando perl es el comando ejecutable de todos los archivos que estn configurados y que contienen
cdigo y lenguaje perl para ser ejecutado dentro de la mquina. Como primer dato de entrada debe
ingresar el mvil al cual le realizaras la accin, luego el nmero corto o campaa y por ltimo la accin, que
es este caso pueden ser;

Desaprovisionar: desinscribir
Aprovisionar: inscribir

Como ejemplo el comando que emplearas para realizar la accin que se desee en su momento ser de esta
forma;

$ perl prov.pl 56966666617 21406 inscribir

Se recuerda que siempre el nmero de telfono al realizar el comando de aprovisionamiento debe contener
el prefijo nacional 569. Luego presionas la tecla enter para enviar a aprovisionar, para que se valide el
perfecto proceso de aprovisionamiento aparecer algo como esto;

Celular a aprovisionar: 56966666617
url http://gw.vas.entelpcs.cl/cgi-
php/PMP_publicidad.php/accion=inscribir&campanaid=21406&clave=tiaxa&movil=56966666617&maxsms=0
Respuesta desde Entel: 000 56966666617 inscripcion exitosa

Area de Operaciones

M(o)b.id 6


Si se fija en la respuesta del operador es exitosa, si realizas la accin contraria, que en este caso es
desinscribir;

$ perl prov.pl 56966666617 21406 desinscribir

Deber retornar lo siguiente;

Celular a aprovisionar: 56966666617
url http://gw.vas.entelpcs.cl/cgi-
php/PMP_publicidad.php/accion=desinscribir&campanaid=21406&clave=tiaxa&movil=56966666617&maxsms=0
Respuesta desde Entel: 000 56966666617 : desinscripcion exitosa

De esta manera no debe tener problema para desarrollar esta actividad, de todas formas si se equivoca en la
realizacin del comando puede obtener la respuesta errnea parte de CGI de Entel. A continuacin le
pondremos en varios casos errneos;

Supongamos que el mvil al cual va a realizar el aprovisionamiento no pertenece al operador, deber
aparecer lo siguiente como respuesta;

Celular a aprovisionar: 56989330107
url http://gw.vas.entelpcs.cl/cgi-
php/PMP_publicidad.php/accion=inscribir&campanaid=21406&clave=tiaxa&movil=56989330107&maxsms=0
Respuesta desde Entel: 005 56989330107 Movil invalido

Tambin podemos suponer que se puedes equivocar en el orden de los datos de entrada del comando, como
por ejemplo de esta forma;

$ perl prov.pl 21406 56966666617 desinscribir

Deber aparecer esto como respuesta;

Celular a aprovisionar: 21406
url http://gw.vas.entelpcs.cl/cgi-
php/PMP_publicidad.php/accion=desinscribir&campanaid=56966666617&clave=tiaxa&movil=21406&maxsms=0
Respuesta desde Entel: 001 21406

Si se fija en la respuesta de parte del operador 001 parmetros invlidos (ver tabla del punto 7 retornos
plataforma CGI de Entel) es porque los datos el numero corto y el mvil fueron ingresados errneamente en
el orden que el proceso los captura para realizar el aprovisionamiento.





Area de Operaciones

M(o)b.id 7


6. VALIDACIN EN BASE DE DATOS.

Cada accin de aprovisionamiento que se realiza tanto manualmente como a nivel de aplicacin sobre el
aprovisionamiento de los mviles de Entel quedan registrados en nuestra base de datos;

Url: http://interactivo.tiaxa.com/interactivo/sqladmin/index.php
Usuario web: tiaxa
Contrasea web: mob20cuervo13
Maquina: Buho
Base de datos: provisioning_ENTEL
Tabla: user

En primer lugar deber ingresar a la url descrita anteriormente desde nuestro buscador o navegador de
internet, como se muestra en la siguiente imagen;


Al presionar la tecla enter inmediatamente el buscador o navegador le pedir que ingrese el usuario y la
contrasea descritos anteriormente;

Con el buscador o navegador que quieras utilizar todos te solicitaran dichos datos.




Area de Operaciones

M(o)b.id 8


Una vez que ests dentro de la pgina donde podemos administrar nuestra base de datos deber aparecer
algo como esto;



Luego donde dice Eleccin de Server seleccionara el servidor que fue destacado anteriormente, para que
logres esto solo debemos hacer clic sobre el combo donde se alojan los servidores, como se muestra en
esta imagen;













Area de Operaciones

M(o)b.id 9



Luego de que selecciona el servidor le da clic al botn siga que se encuentra al lado del servidor
seleccionado, al realizar esta accin cambiaran las bases de datos, le mostrara los del servidor seleccionado,
una vez que identifiques la base de datos y tambin la tabla donde se almacenan dichos registros sobre
aprovisionamiento deber seleccionarlos.

Como se dijo, en la zona izquierda estn las bases que contiene dicho servidor, solo deber seleccionar la
base y la tabla haciendo clic sobre sus nombres;

Una vez que haya seleccionado la tabla puede verificar su estructura y puede realizar filtros de datos ms
rpidamente por este medio, para poder realizar este filtro con la tabla ya seleccionada, al lado derecho
aparecern unas opciones;

En este caso debe hacer clic en seleccionar y filtrara por el mvil al cual le realizo anteriormente el
aprovisionamiento. Las aplicaciones que aprovisionan, trabajan insertando los registros de los mviles que
aprovisionan y consultaran en esta tabla si es necesario realizar el aprovisionamiento nuevamente. Una vez
que est dentro podr realizar el filtro correspondiente;

Area de Operaciones

M(o)b.id 10



Si puede agregar ms filtro (como el numero corto) le entregara mucho ms rpido los registros, con esto
podr saber el historial de los nmeros que se envan a aprovisionar.

Tambin podr hacer este filtro de forma totalmente manual (para decirlo de alguna forma) es ejecutando
la query que realiza esta seleccin de la siguiente forma;

SELECT <campos>
FROM <nombre_tabla>
WHERE <condicin_1>
AND <condicin_2>
AND <condicin_N>;

Donde <campos> sern todas las columnas de la tabla que quiera mostrar respecto al filtro, y donde
aparecen las condiciones deben ser los filtros segn tu criterio. Le servir para encontrar tu respuesta o lo
que necesita ms rpidamente.

A continuacin te mostrare el mismo filtro que realizamos anteriormente pero bajo una query;

SELECT phone, service, status, datetime, code
FROM users
WHERE phone LIKE '%66666617'
AND service = 21405
AND datetime >= '2013-01-01%'

Si se fija cuando le describe a la query que deseas saber la informacin sobre algn nmero de telfono en
particular, debe anteponer un signo % que significa no que importa lo que este de all hacia el lado
izquierdo o derecho (segn donde lo coloque, ntese la fecha) de todas formas lo mostrar.

Para que esta query trabaje debe volver a seleccionar la tabla de la parte izquierda de la pgina de la base
de datos;













Area de Operaciones

M(o)b.id 11


Una vez que escribas la query en el cuadro blanco para ejecutarla, debes presionar la tecla Siga y deber
aparecer algo como esto;



Si te fijas mostrara nuevamente nuestra query empleada y con los campos seleccionados.
7. TABLA RETORNOS CGI ENTEL.

Para todas las acciones que se realizan en el aprovisionamiento de los nmeros a las campaas, la plataforma
de aprovisionamiento de Entel (CGI) responder con un cdigo de retornos, la cual te mostrare a
continuacin;

Cdigo Descripcin Cdigo Descripcin
000 Accin aceptada 007 Max sms invlido
001 Parmetros invlidos 008 Mvil ya inscrito en campaa
002 Accin invlida 009 Mvil no inscrito en campaa
003 Usuario en lista negra 010 Rechazado por spam
004 Campaa invlida 011 Campaa expirada o fuera de plazo
005 Mvil invlido 012 CGI ocupada, reintente ms tarde
006 Contrasea invlida