MANUAL DE USUARIO JAVSTERISK

javsterisk free V 1.0

by codar4j

1
 TABLA DE CONTENIDO

1. INTRODUCCION .......................................................................................................... 3
2. LOGIN DE INGRESO .................................................................................................. 3
3. MDULOS DEL APLICATIVO ................................................................................... 3
3.1. Dashboard.................................................................................................................. 4
3.2. Administracin del Sistema ..................................................................................... 5
3.2.1. Usuarios .................................................................................................................. 6
3.2.1.1. Crear Usuario ..................................................................................................... 6
3.2.1.2. Editar Usuario .................................................................................................... 8
3.2.1.3. Eliminar Usuario ................................................................................................ 9
3.2.2. Preferencias ........................................................................................................... 9
3.2.3. Parmetros ........................................................................................................... 10
3.2.3.1. Editar Parmetros ............................................................................................ 11
3.2.4. Logs ....................................................................................................................... 11
3.2.5. Mdulo Asterisk ................................................................................................... 12
3.2.5.1. Reportes CDR .................................................................................................. 13
3.2.5.2. Terminal CLI (Command Line Interface) ..................................................... 13

2
1. INTRODUCCION

Javsterisk es una aplicacin que facilitar a los usuarios, expertos y principiantes, en la

administracin de Asterisk por medio de una interfaz amigable e intuitiva. Javsterisk
facilitar la administracin de la central IP sin necesidad de tener instalados servicios
innecesarios. Adis a las aplicaciones que vienen embebidos con soluciones para servidor de
correo, chat, etc.

2. LOGIN DE INGRESO

Al ingresar la url http://[ip_servidor]:8080/javsterisk automticamente se direccionar a

la pgina de login, en donde deber ingresar los siguientes campos:
Usuario.- Deber ingresar un usuario previamente registrado; y dependiendo del tipo
de usuario se tendr acceso total o de manera restringida.
Clave.- El usuario deber ingresar la clave previamente registrada.

3. MDULOS DEL APLICATIVO

Javsterisk tienes las opciones siguientes:

Dashboard.- Por medio de esta opcin se visualizar de manera grfica el estado de
los procesos de mayor relevancia para la central Asterisk as como el monitoreo del
estado del CPU, memoria RAM y Disco Duro del servidor Asterisk.
Administracin del Sistema.- Por medio de este mdulo se podr dar mantenimiento
a los usuarios de la aplicacin, configurar la interfaz del aplicativo, configuracin de
3
 parmetros para funcionamiento del aplicativo y visor de logs del sistema y de la
central Asterisk.
Asterisk.- Este mdulo permitir el mantenimiento de las extensiones, plan de
marcado, monitoreo de llamadas activas y visor de los dispositivos SIP que estn
registrados en la central Asterisk.

3.1. Dashboard
El mdulo de Dashboard es una representacin grfica de los principales indicadores que
intervienen en la consecucin del aplicativo, y que est orientado a la toma de decisiones
para optimizar los recursos siguientes:

Estado del servicio MySql.- Mostrar si el servicio de MySql esta iniciado.

Estado del servicio Asterisk.- Permitir conocer si el servicio de Asterisk est
ejecutndose o inactivo.
Estado del servicio Java.- El estado del servicio de Java indicar si el servidor de
aplicaciones est activo.
Estado de CPU.- Permitir conocer en tiempo real el uso del CPU en el servidor de
Asterisk y permitir detectar a tiempo si hay consumo innecesario del procesador.
Estado de RAM.- Mostrar la memoria RAM utilizada en el servidor de Asterisk, el
cual es un indicador muy importante para que el Administrador de la central tome los
correctivos necesarios en caso de que requiera realizar un upgrade de memoria RAM.
Estado de Disco Duro.- Mostrar grficamente el tamao total del disco duro, la
cantidad utilizada y el espacio libre.

La informacin que se presentar al usuario de manera grfica, podr ser constantemente

actualizada mediante un icono ubicado en la parte superior derecha.

4
3.2. Administracin del Sistema
Las opciones que tendr el mdulo de Administracin del Sistema, son las siguientes:
Seguridad:
Usuarios.
Preferencias:
Preferencias.
Parmetros.
Log:
Log del sistema.
Log de Asterisk.

5
3.2.1. Usuarios

El men usuarios permitir crear, editar y eliminar usuarios, los cuales permitir
acceder a la aplicacin.

3.2.2. Crear Usuario

Para la creacin del usuario deber ingresar de manera obligatoria los siguientes
campos:
Nombre.- Hace referencia al nombre de la persona para el cual se va crear
el usuario. Ejemplo: Alex Torres
Nombre Usuario.- Nombre identificador del usuario con el cual va a
ingresar al aplicativo. Ejemplo: atorres
Password.- Contrasea con la cual se autenticar el identificador de
usuario para ingresar al aplicativo.
Password 2.- Se le solicitar que confirme la contrasea con la finalidad
de asegurar que conozca la contrasea que est ingresando.
Email.- Todo usuario registrado en el sistema debe registrar un correo
electrnico.
Rol.- En este campo determinara el tipo de usuario con la finalidad de
establecer permisos sobre el aplicativo. Las opciones son:

6
 Usuario Administrador.- Tendr acceso a todos los mdulos del
aplicativo.
Usuario Estndar.- Va tener acceso a la opcin de preferencias para
cambiar el tema de la interfaz con la que va a trabajar y la opcin cdr,
en la cual solo visualizara el historial de llamadas de la extensin que
est asociada con su usuario.

Al ingresar un nuevo Usuario, se tomara en cuenta las siguientes validaciones:

Los campos que estn como requeridos no podrn quedar con valor nulo.
El nombre de usuario no debe estar registrado en la base de datos, en
caso de estar ya registrado se presentar un mensaje de error.
Existirn criterios para determinar si la contrasea ingresada se considera
como: dbil, normal o fuerte.
7
 Los datos ingresados en los campos Password y Password 2, debern ser
iguales.
El campo email se validara que este en el formato valido.
Se deber asociar un rol al usuario.
Se deber asociar el usuario con una extensin previamente creada.

3.2.2.1. Editar Usuario

Al editar un usuario, se tendr la opcin de modificar los datos que ingresados,

cabe indicar que para la edicin del usuario se tomar en consideracin
nuevamente las validaciones que fueron consideradas en la creacin del mismo.

8
 3.2.2.2. Eliminar Usuario

El proceso de eliminar usuarios, borrar de la base de datos los registros que

pertenecen al usuario seleccionado. Pero antes de procesar la accin de
eliminacin aparecer un mensaje de alerta consultando si est seguro proceder
con eliminar el usuario.

3.2.3. Preferencias

En la opcin de preferencias el usuario podr cambiar el tema de la interfaz grfica;

para aquello solo basta ver las opciones y escoger el tema que le agrade al usuario,
luego hacer click en el botn Guardar.

9
3.2.4. Parmetros

En esta opcin se actualizara los parmetros para el funcionamiento de la

aplicacin. Mediante la opcin de parmetros se podr definir las siguientes

caractersticas:

Host del Servidor de Asterisk.

Puerto de AMI.

Usuario de conexin para AMI.

Password de conexin para AMI.

Comando para apagar servidor.

Comando para reiniciar servidor.

Comando para detener el servicio de Asterisk.

Comando para iniciar el servicio de Asterisk.

Comando para reiniciar el servicio de Asterisk.

10
 3.2.4.1. Editar Parmetros

Para la edicin del parmetro, el usuario podr modificar lo siguiente:

Nombre del Parmetro.
Valor del Parmetro.
Descripcin de Parmetro.

3.2.5. Logs

En la opcin de Log tendr las siguientes caractersticas:

Log del Sistema: Se podr visualizar mediante la interfaz el log que se genera
en la consola del servidor de Aplicaciones.
11
 3.2.6. Mdulo Asterisk

El mdulo de Asterisk tiene como objetivo obtener informacin relevante del servicio de
Asterisk y realizar tareas bsicas para la administracin de la central, tales como crear
extensiones y configurar el plan de marcado. El mdulo de Asterisk contar con las
opciones siguientes:
Reportes CDR.
Terminal CLI.
Monitoreo de Llamadas.
Peers Monitor.
Catlogos:
Extensin
DialPlan.

12
 3.2.6.1. Reportes CDR

La opcin de reporte CDR permitir visualizar el historial de llamadas realizadas

desde la central Asterisk, permitiendo filtrar la informacin por fecha o extensin,
adems se podr descargar el reporte en formato csv o pdf.

3.2.6.2. Terminal CLI (Command Line Interface)

La opcin CLI permitir ejecutar desde la aplicacin comandos a la central Asterisk,

tal como si estuviera desde el servidor en la consola de Asterisk. Esta opcin est

pensada en los Administradores que prefieren trabajar por medio de comandos.

3.2.6.3. Monitoreo de llamadas

13
 Por medio de la opcin de monitoreo de llamadas podr visualizar las llamadas
activas en tiempo real que est procesando la central Asterisk. En la informacin
a mostrarse aparecer el nmero origen y destino de la llamada.

3.2.6.4. Peers Monitor

Se podr visualizar los dispositivos sip que estn registrados en la central Asterisk, la
informacin de acuerdo al estado cuando fue ejecutada la consulta, pero el usuario
podr actualizar la informacin con el objetivo de obtener informacin actualizada.

3.2.6.5. Extensin
Por medio del men extensin le ser posible crear, actualizar y eliminar
extensiones SIP, las cuales se utilizaran para que los dispositivos SIP que van a
conectarse a la central puedan registrase de manera exitosa.

14
3.2.6.5.1. Crear Extensin
Para la creacin de una extensin se deber ingresar de manera obligatoria los
siguientes campos:
Nombre.- Hace referencia al nmero de la extensin. Ejemplo: 2004.
Secret.- Contrasea para la extensin que se est creando, necesaria
para que los dispositivos SIP puedan autentificarse de manera exitosa
a la central Asterisk.
Host.- este campo se usar para especificar si la extensin solo se
conectara desde un ip en particular o desde cualquier ip, para indicar
que se puede conectar desde cualquier ip, se ingresa el valor
dynamic.
Type.- Pueden existir tres tipos de extensiones:
User: El tipo user se usa para autenticar llamadas entrantes.
Peers: Se usa para autenticar llamadas salientes.
Friend: Cumple las funciones de user y friend.

Para crear una extensin en Asterisk tambin es necesario ingresar datos en

campos como Context, Qualify y Nat. Para el proyecto javsterisk el campo
context tomara por defecto el valor de from-sip y yes para Qualify y Nat.

15
Al ingresar una nueva Extensin, para la validacin se tomara en cuenta las
siguientes observaciones:
Los campos que estn marcados como requeridos no deben quedar con
valor nulo.
El nombre de la extensin no se deber encontrar previamente registrado
en la base de datos, en caso de estar registrado se visualizar un mensaje
de error.

3.2.6.5.2. Editar Extensin

Al editar una extensin, se presentar la opcin de poder modificar todos los
campos que fueron ingresados en la creacin de la extensin y adems los
valores Default User (por defecto se toma el mismo valor con el que se ingres
el nombre) Context, Qualify y Nat. Se deber tomar en consideracin que para
la edicin aplicarn nuevamente las validaciones que fueron consideradas en
la creacin.

16
 3.2.6.5.3. Eliminar Extensin
Al eliminar uno o varias extensiones, se borrar de la base de datos los
registros que pertenecen a la extensin seleccionada. Pero antes de la
eliminacin le aparecer un mensaje de alerta preguntando si est seguro de
proceder con la eliminacin.

3.2.6.6. DialPlan
Por medio del men Dial Plan se podr crear, actualizar y eliminar las rutas del
Dial Plan. Se debe de tener claro que el Dialplan es el corazn de Asterisk, cada
dgito que se marque en un terminal recorrer el dialplan buscando qu hacer.
Para que tenga una idea podemos comparar el dial con una tabla de enrutado, ya
que el usuario marca un nmero y el dialplan contiene las acciones a realizar para
ese nmero que se ha marcado.

17
3.2.6.6.1. Creando DialPlan
Para la creacin de una ruta para el dialplan se deber ingresar de manera
obligatoria los campos siguientes:
Digito.- Ingresar el nmero con el que inicia el patrn de marcado.
Longitud.- Seleccionar cantidad de longitud que va tener el patrn
Record.- Escoger SI en caso de querer grabar las llamadas, NO en
caso de no desear grabar llamadas
Limit.- Seleccionar SI en caso que desee establecer un lmite de
tiempo en llamadas, para lo cual deber ingresar el tiempo en
milisegundos. Ejemplo para dos minutos el valor correcto a ingresar
es 120000. Caso contrario deber escoger NO
Wait.- Seleccionar SI en caso que desee establecer un lmite para que
una llamada sea contestada deber ingresar el tiempo en segundos.
Ejemplo 15. Caso contrario deber el usuario escoger NO.
Transfer.- Seleccionar SI en el caso de que desee que la llamada se
transfiera a otra extensin. Caso contrario deber escoger NO, hay que
especificar a qu extensin la llamada se transferir.

Para crear una ruta del dialplan en Asterisk tambin es necesario especificar
al contexto que pertenece la ruta. Para Javsterisk el contexto por defecto ser
from-sip.

18
3.2.6.6.2. Editar DialPlan
Al editar una ruta del dialplan, se tendr la opcin de poder modificar todos
los datos que fueron ingresados en la creacin de la ruta del dialplan.

19
3.2.6.6.3. Eliminando DialPlan
Al eliminar uno o varias rutas del dialplan, se borrara de la base de datos los
registros que pertenecen a la ruta seleccionada. Pero antes de la eliminacin
aparecer un mensaje de alerta en donde se consulta si el usuario est seguro
proceder con la eliminacin.

20