UNIVERSIDAD DE GUAYAQUIL

Transcripción

1 UNIVERSIDAD DE GUAYAQUIL FACULTAD DE CIENCIAS MATEMÁTICAS Y FÍSICAS CARRERA DE INGENIERÍA EN SISTEMAS COMPUTACIONALES IMPLEMENTACIÓN DE UN IVR PARA ATENCIÓN TELEFÓNICA A ESTUDIANTES EN LA CARRERA DE INGENIERÍA EN SISTEMAS COMPUTACIONALES DE LA UNIVERSIDAD DE GUAYAQUIL TESIS DE GRADO MANUAL TÉCNICO Previa a la obtención del Título de: INGENIERO EN SISTEMAS COMPUTACIONALES AUTORES: EMILIA ESTEFANIA RAMÍREZ SAVERIO FREDDY ANDRES NOBOA ORRALA TUTOR: ING. DAVID BENAVIDES GUAYAQUIL ECUADOR 2011

2 1 Contenido 1. ARQUITECTURA DE LA SOLUCIÓN ARQUITECTURA DEL DESARROLLO Tecnologías de la Solución El Asterisk Lenguaje de Programación Asterisk - Java Diseño AGI del paquete ASTERISK-JAVA JasperReports IReports JavaMail SoftPhone (WebPhone MIZU) Base de Datos del Sistema Servidor de Aplicaciones Servidor TTS GUI DICCIONARIO DE LIBRERIAS INFORMACION GENERAL INFORMACION FUNCIONES CISCAGI-AGI CISCAGI-AMI CISCAGIVIEWER CISCAGILIBRARY ModuloIVR DIAGRAMAS DE LA APLICACIÓN Diagrama de desarrollo CISCAGI Diagrama general de secuencia CISACAGI IVR

3 Diagrama general de secuencia CISACAGI administrador Diagramas UML UML AGISCRIPT UML CISCAGI AMI UML CISCAGI AMI INSTALACIONES Y CONFIGURACIONES Instalación Asterisk (Distribución Elastix) Instalación Festival. (TTS [Conversor de texto a voz]) Instalación Cacti (Monitorizador de Servidores) Configurando Apache Configurando Mysql Instalando Cacti Creación de base de datos MYSQL para datos de cacti Asignando permisos necesarios Graficando la Red Viendo las graficas Configuration AMI (Asterisk Manager Interface) Configuración CDR Campos del CDR Configurando Asterisk para guardar los registros del CDR en MySQL Configuración FAST-AGI ARCHIVO EXTENSIONS.CONF ARCHIVO FASTAGI-MAPING.PROPERTIES ARCHIVO CISCAGIROUTER:XML Configuración de la Base de seguridad CISCAGISEGU... 96

4 3 1. ARQUITECTURA DE LA SOLUCIÓN La Arquitectura propuesta contará de tres elementos: El servidor Asterisk El servidor de aplicaciones La Base de Datos El servidor de aplicaciones se encargará de hacer las conexiones a base de datos y de recibir la información de entrada que dará el usuario al sistema IVR así como también procesar la información para brindar una respuesta adecuada, albergando el script del IVR mismo. El servidor de aplicaciones se encargará también de alojar el sistema web y requerimiento de información de la base de datos. El servidor Asterisk será el encargado de contener la central telefónica y todas sus bondades, contendrá el TTS (Festival) para las conversiones de texto a voz, también CACTI (Monitorización de servidores para verificar el estado del servidor), el AGI para la comunicación con las aplicaciones, también el CDR para reportes sobre la central telefónica. La base de datos el cual contendrá la información de los estudiantes de la carrera.

5 4 2. ARQUITECTURA DEL DESARROLLO 2.1. Tecnologías de la Solución A continuación se detallarán las herramientas para el diseño e implementación del sistema, indicando la justificación de la debida elección El Asterisk Asterisk soporta muchos protocolos de VoIP, presenta capacidades que anteriormente sólo eran encontradas en equipos propietarios, llevadas a cabo por medio de implementaciones en software y arquitecturas funcionales. Para el desarrollo del proyecto de tesis, se utilizará Asterisk en su versión dada la capacidad de esta versión de interactuar con paquetes de software como Asterisk Java, ha ser descritos posteriormente Lenguaje de Programación El lenguaje de programación elegido es Java. Se ha convertido en un lenguaje de programación muy popular dada su robustez, simple sintaxis e interoperabilidad. Entre las características principales de Java tenemos: Lenguaje de programación Orientado a objetos (POO) que permite la reutilización de código, agilizando el desarrollo de software en la creación de sistemas de mayor complejidad. Lenguaje multiplataforma: Funciona de manera similar en diferentes sistemas operativos.

6 5 Esto se debe a la interpretación del lenguaje realizado por la máquina virtual Java JVM; dado que normalmente un lenguaje compilado es traducido y adaptado a un archivo ejecutable para una determinada plataforma. Tiene capacidades de extender funcionalidades de un servidor web Asterisk - Java El API Asterisk Java ofrece un conjunto de clases que permite la creación de aplicaciones que puedan controlar y monitorear centrales PBX basadas en Asterisk 1.0, 1.2 y trabajos futuros en gestión de la versión 1.4. Actualmente este paquete está en su versión 0.3 y está registrado bajo licencia Apache Versión 2.0. El paquete Asterisk Java está desarrollado mediante el protocolo FastAGI, por lo que se permite poner en funcionamiento un servidor de requerimientos que recibirá y mandará comandos por un socket TCP. Para esto será necesaria la configuración del archivo extensions.conf ubicado en /etc/asterisk del servidor PBX. A continuación se describirá el diseño del soporte de FastAGI del API Asterisk-Java en su paquete org.asteriskjava.fastagi. Éste se basa en tres importantes interfaces: AgiServer, AgiScript y MappingStrategy. La interfaz AgiServer tiene como responsabilidad escuchar los requerimientos AGI provenientes de un servidor Asterisk y luego elegir el proceso para ese requerimiento, invocarlos para proveer los medios para enviar comandos a Asterisk y recibir la

7 6 respuesta correspondiente. El API Asterisk-Java incluye ya la implementación de esta interfaz en DefaultAgiServer. (Método utilizado en el proyecto) AgiServer usa una estrategia de mapeo (MappingStrategy) para la selección del proceso, y esto se basa en la lectura del recurso y verificando la URL, esto es llamado ResourceBundleMappingStrategy Diseño AGI del paquete ASTERISK-JAVA La tercera interfaz es el AgiScript, el cual se refiere al código mismo invocado para atender un requerimiento. AgiScript es para Asterisk-Java lo que un servlet es para un contenedor de servlets (servlet container). La interfaz AgiScript es bastante simple, usa un método llamado service () al cual se le pasan el AgiRequest y el AgiChannel, permitiendo enviar comandos Agi hacia Asterisk. Para el desarrollo del presente proyecto se utilizarán principalmente los métodos definidos en la clase BaseAgiScript, la cual nos ofrece control sobre acciones de la propia central para pedir y brindar información necesaria para la implementación del sistema IVR. Esta clase está ubicada en org.asteriskjava.fastagi y sus método son el reflejo de los comandos AGI como métodos de una clase extensible en Java, lo que nos permitirá ya en este ambiente generar otras clases necesarias para la interacción con la base de datos. Algunos de los métodos de la clase BASEAGISCIPT

8 7 Tipo Nombre Descripción Void Answer() Contesta el canal Int Exec(String aplicacion) Ejecuta un comando de una aplicación dada. String getdata(string archivo) Reproduce y espera datos para almacenar. Void StreamFile(String archivo) Reproduce un archivo dado Void saydigits(string cadena) Reproduce una cadena de digitos JasperReports JasperReports es una fuente abierta de Java de presentación de informes herramienta que puede escribir en la pantalla, una impresora o en PDF,HTML, Microsoft Excel, RTF, ODT, valores separados por comas y XML archivos. Puede ser utilizado en aplicaciones Java habilitado, incluyendo Java EE o aplicaciones Web, para generar contenido dinámico. Se lee las instrucciones de un XML o archivo. Jaspe IReports La herramienta ireport es un constructor / diseñador de informes visual, poderoso, intuitivo y fácil de usar para JasperReports escrito en Java. Este instrumento permite que los usuarios corrijan visualmente informes complejos con cartas, imágenes, sub informes, etc. ireport está además integrado con JFreeChart, una de la biblioteca gráficas Open Source más difundida para Java. Los datos para imprimir pueden ser

9 8 recuperados por varios caminos incluso múltiples uniones JDBC, TableModels, JavaBeans, XML, etc. Características de ireport La lista siguiente describe algunas de las características importantes de ireport: 100% escrito en JAVA y además OPENSOURCE y gratuito. Maneja el 98% de las etiquetas de JasperReports Permite diseñar con sus propias herramientas: rectángulos, líneas, elipses, campos de los textfields, cartas, subreportes (subreportes). Soporta internacionalización nativamente. Browser de la estructura del documento. Recopilador y exportador integrados. Soporta JDBC. Soporta JavaBeans como orígenes de datos (éstos deben implementar la interface JRDataSource). Incluye Wizard s (asistentes) para crear automáticamente informes. Tiene asistentes para generar los subreportes Tiene asistentes para las plantillas. Facilidad de instalación.

10 JavaMail JavaMail es una expansión de Java que facilita el envío y recepción de desde código java. El JavaMail API no es parte del núcleo de Java SE, sino una extensión opcional. Además, se requiere en Java Enterprise Edition. Los paquetes de JavaMail se puede acceder de dos maneras: mediante la colocación de j2ee.jar en la ruta de clases o, mediante la colocación de dos mail.jar y activation.jar en la ruta de clases El javax.mail API utiliza un archivo de propiedades para los nombres de servidor de lectura y de configuración relacionados. Esta configuración anula cualquier defecto del sistema. Por otra parte, la configuración se puede ajustar directamente en el código, usando la API JavaMail SoftPhone (WebPhone MIZU) El Mizu-Teléfono Web es un peso ligero estándar de VoIP de teléfono basado en software que puede ser ejecutado desde páginas web. Basado en el estándar SIP protocolo de la industria, es compatible con todos los dispositivos de VoIP y servicios. Se puede llamar a cualquier otro teléfono SIP suave / teléfono IP (para la carga gratis) o cualquier teléfono fijo y número de teléfono móvil a través de un proveedor de servicios de VoIP de su elección.

11 10 El teléfono se implementa como un applet de Java o la aplicación y es totalmente independiente de la plataforma que se ejecutan en cualquier navegador habilitado para Java en todos los sistemas operativos (Windows, MAC, Linux, Solaris). Puede ser utilizado como un softphone normal de funcionamiento en su sitio web o como-como los botones de Skype (Haga clic aquí para llamar). La persona que llama puede aceptar la llamada en un dispositivo VoIP (softphone, teléfono IP, aplicaciones de call-centers) o puede ser contactado directamente a su teléfono fijo o móvil. Todas las llamadas habituales características de enrutamiento se puede habilitar (desvío de llamadas, transferencia de llamadas, etc) Con Mizu-Teléfono Web puede agregar rápidamente las capacidades de VoIP para su sitio web. (Página web, blog, foro, soporte / página de las ventas, sitio de redes sociales, call center, etc.) El resto depende de tu imaginación. Características WebPhone SIP y RTP pila (compatible con cualquier servidor de VoIP o un dispositivo como Cisco, Astérix, softphone, ATA y otros) Norma applet de Java (no requiere instalación de software, se ejecuta directamente desde todos los navegadores) Las llamadas de VoIP con auto QoS Protocolos de transporte: UDP, TCP, TLS, HTTP túnel

12 11 NAT / Firewall de apoyo, estable SIP y los puertos de RTP, la luz del protocolo STUN y configuración automática Protocolos de los medios de comunicación: mensajería instantánea (chat) y capacidad de presencia RFC: 2543, 3261, 2976, 3892, 2778, 2779, 3428, 3265, 3515, 3311, 3911, 3581, 3842, 1889, 2327, 3550, 3960, 4028, 3824, 3966, 2663, 3022 métodos compatibles: INVITE, ACK, PRACK, BYE, CANCELAR, UPDATE MENSAJE, INFO, OPCIONES, suscribir, NOTIFICAR, CONSULTE Codec: PCMU, PCMA, G.729, GSM, Speex, ilbc Banda ancha y banda ultra-ancha codec y salida estéreo DTMF (método INFO en la señalización) Volver a marcar, llamada espera, silencio y la transferencia (con operador y automáticas) Conferencia de llamadas (integrado en el mezclador RTP) Llame al parque y recogida Unlimited líneas Balance de la pantalla, temporizador de llamadas Grabación de voz (local y / o ftp upload) Señalización y los medios de comunicación cifrado Haga clic para llamar

13 12 Servidor de integración lado usando PHP,. NET, J2EE, etc JavaScript API Construido con su propia marca Personalizable interfaz gráfica de usuario e idiomas Funciones personalizadas Base de Datos del Sistema La base de datos elegida para el sistema IVR es Mysql, sistema de base de datos relacional orientado a funcionar más en sincronía con las necesidades del Internet; por lo que es el sistema preferido por las empresas dada su robustez y fidelidad. Para la interacción con la base de datos desde los Scripts generados en Java para el funcionamiento del Sistema IVR y su interacción con el sistema de base de datos se utilizará el paquete mysql-conector-java jar de MySQL compatible con JDK. Para una mejor organización de las sentencias SQL (Structured Query Language) se utilizarán paquetes y procedimientos almacenados en el mismo servidor de base de datos con el fin de poder hacer transacciones para el desarrollo del sistema Servidor de Aplicaciones El servidor de aplicaciones elegido para albergar la aplicación web de inscripción inicial del flujo del servicio IVR es el BlazeDS que no es más que un Tomcat , el cual se encuentra bajo licencia Open Source (Código Abierto) y fue creado en conjunto por

14 13 Apache Software Foundation y Sun Microsystems y que permite interactuar con aplicaciones Flex y AIR enviando las consultas mediante protocolos AMF. Una de las ventajas del uso de BlazeDS es que al estar desarrollado en Java, sólo requerirá de una máquina virtual Java JVM para funcionar correctamente indistintamente de la plataforma operativa en la que se encuentre Servidor TTS Como parte de la tecnología anexa usada en los sistemas IVR, descritos en el capítulo anterior, se ha visto necesaria la inclusión de un servidor TTS (Text to Speech) en el desarrollo del presente proyecto. Para esto se ha elegido el sistema Festival, desarrollado por el CSTR (The Centre for Speech Technology Research) de la Universidad de Edimburgo, Inglaterra. Festival es un marco de trabajo que permite construir sistemas de síntesis de voz. La versión actual de este sistema es el 2.0 y que está disponible para descarga, ofreciendo soporte tanto en inglés americano y británico así también como en español GUI El diseño de la interfaz gráfica del aplicativo web que acompaña al servicio telefónico es un juego de páginas en FLEX - AIR dada la sencillez de este lenguaje y la necesidad de

15 14 tan sólo un navegador web el único requerimiento seria que estas navegadores soporten flash. La arquitectura MVC o Modelo-Vista-Controlador se encarga de separar la presentación, la lógica de control y el estado de la aplicación con el objetivo de hacer el sistema modular; es decir, una parte puede ser cambiada sin alterar la otra. El controlador será el encargado de recibir los requerimientos y es el responsable de tomar acciones apropiadas en respuesta a cada requerimiento. El modelo está referido a la representación del estado de la aplicación en la base de datos y los DAOS; Finalmente la vista tomará la información provista por el controlador y el modelo y la presenta al usuario. Cabe notar que la vista del proyecto está formada por un modelo Factory method el cual nos permite crear pantallas genéricas de manera sencilla y sin tener que crear clases lo hace dinámicamente obteniendo la forma de las pantallas de una plantilla XML guardada en una base de datos.

16 15 3. DICCIONARIO DE LIBRERIAS INFORMACION GENERAL Documentación técnica de las funciones del servidor java de conexiones AMI y AGI. Para esto tenemos dos proyectos: CISCAGI AMI: encargado de conectarse con el manager de Asterisk e interactuar con las diversas líneas de comando y con los archivos de configuración. CISCAGI AGI: Encargado de mantener levantado un servidor AGI para que este reciba las reciba y envié procesos por voz siendo este un Dial Plan INFORMACION FUNCIONES CISCAGI-AGI Class Summary Clase encargada levantar un servidor fastagi Constructor Detail CiscAgiScriptIVR CiscAgiScriptIVR public CiscAgiScriptIVR() Method Detail ivrrespuesta public java.lang.string ivrrespuesta(java.lang.string routersoundsivr,

17 16 org.asteriskjava.fastagi.agichannel channel, long time, int maximonumerodigits) throws java.lang.exception Ivr de bienvenidas estos archivos de sonido no pueden ser interrunpidos hasta que se termine el audio. Parameters: routersoundsivr - channel - Throws: java.lang.exception candado public java.lang.string candado(java.lang.string routersoundsivr, java.lang.long time, int maximonumdigits) throws java.lang.exception Candado de seguridad [ingreso de cedula]

18 17 Returns: Throws: java.lang.exception readaccion public void readaccion(java.lang.string accion, org.asteriskjava.fastagi.agichannel channel, java.lang.string modo) throws java.lang.exception Throws: java.lang.exception cerrarllamada public void cerrarllamada() throws org.asteriskjava.fastagi.agiexception Throws: org.asteriskjava.fastagi.agiexception inicializador public int inicializador()

19 18 ivrsininterrupcion public boolean ivrsininterrupcion() ivrconinterrupciontiempo public boolean ivrconinterrupciontiempo() verificasitienecandado public boolean verificasitienecandado() verificadtmftienedata public boolean verificadtmftienedata() verificaaccionenopcion public boolean verificaaccionenopcion() service public void service(org.asteriskjava.fastagi.agirequest request, org.asteriskjava.fastagi.agichannel channel)

20 19 Clase encargada de manejar las distintas funciones e interpretarlas para la clase agiscript encargada de retornar el IVR (dialplan) Methods inherited from class com.ciscagi.dao.securydao consultaitem, consultaitems, consultaopciones, getlogon, proce dimientoalmacenado, procedimientoalmacenadoitems,procedi mientoalmacenadoitemspormenu, procedimientoalmacenadoo pcionespormenuitems FuncionalidadesAgi Script Methods inherited from class com.ciscagi.utilitarios.utils anidarxml, convertstring, diferenciadias, differencetime, esce dulavalida, fechahoraactual, formarformasxml,formarjournalx ml, formarsignxml, generardate, generarhora, generarnumero ConCeros, getversion, leerdocdom, loadxml, main,messagex ml, messagexml, messagexml1, messagexmlprinter, obtenercan tidaddigitos, obtenerfechadeformateoespecial,readdocdom, readnodosxml, redondeodecimaldouble, validarnulo, verificar Cedula, verificarxml

21 20 Methods inherited from class com.ciscagi.utilitarios.formateador fechastringvalue, generardatesql, generardatetimeutil, genera rdateutil Methods inherited from class java.lang.object equals, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait Field Detail items public int items privates **************************** ivr public java.lang.string ivr timeout public java.lang.long timeout

22 21 digits public int digits candado public java.lang.string candado digitslock public int digitslock opc public int opc ivrlock public java.lang.string ivrlock idopc public int idopc idivr

23 22 public int idivr accion public java.lang.string accion send public java.lang.string send avanza public boolean avanza mailestud public java.lang.string mailestud Method Detail getidopc public int getidopc() setidopc public void setidopc(int idopc)

24 23 getidivr public int getidivr() setidivr public void setidivr(int idivr) getaccion public java.lang.string getaccion() setaccion public void setaccion(java.lang.string accion) getsend public java.lang.string getsend() setsend public void setsend(java.lang.string send) getivrlock public java.lang.string getivrlock()

25 24 setivrlock public void setivrlock(java.lang.string ivrlock) getitems public int getitems() setitems public void setitems(int items) getivr public java.lang.string getivr() setivr public void setivr(java.lang.string ivr) gettimeout public java.lang.long gettimeout() settimeout

26 25 public void settimeout(java.lang.long timeout) getdigits public int getdigits() setdigits public void setdigits(int digits) getcandado public java.lang.string getcandado() setcandado public void setcandado(java.lang.string candado) getdigitslock public int getdigitslock() getdigitslock public void getdigitslock(int digitslock)

27 26 getopc public int getopc() setopc public void setopc(int opc) items public void items(readxmlivr readm) throws java.lang.exception Throws: java.lang.exception opcion public void opcion(readxmlivr readm, int opc) nextitemsivr public void nextitemsivr(int it, ReadXMLIVR readm) Determina el siguiente items

28 27 Parameters: items - readm - Throws: java.lang.exception saytts public void saytts(java.lang.string string, org.asteriskjava.fastagi.agichannel channel) throws java.lang.exception Función encargada de transformar texto a voz en español usando tts festival Parameters: string - channel - Throws: java.lang.exception enviomail public int enviomail(java.lang.string messages,

29 28 java.lang.string destinatario, java.lang.string cedula) stringconvertsounds public java.lang.string stringconvertsounds(java.lang.string string, org.asteriskjava.fastagi.agichannel channel) throws java.lang.exception Funcion encargada de convertir una determinada cadena a un archivo de sonido devolviendo su ubicacion y nombre Parameters: string - channel - Returns: String (ubicacion y nombre del archivo) Throws: java.lang.exception eliminarulaw

30 29 public void eliminarulaw(java.lang.string ruta, org.asteriskjava.fastagi.agichannel channel) throws java.lang.exception Elimina los archivos de audio creados por el tts y despues reproducidos en la llamada esperando un digito de respuesta para acceder una respuesta IVR Parameters: ruta - channel - Throws: java.lang.exception verificadatacandado public boolean verificadatacandado(java.lang.string candado, org.asteriskjava.fastagi.agichannel channel) ReadXMLConsulta Constructor Detail

31 30 ReadXMLConsulta public ReadXMLConsulta(java.lang.String archivo) cosntructor **************************** Method Detail GetOpcionesMS public java.util.list<java.util.vector> getopcionesms() getters and setters **************************** setopcionesms public void setopcionesms(java.util.list<java.util.vector> opcionesms) getopcionests public java.util.list<java.util.vector> getopcionests() setopcionests public void setopcionests(java.util.list<java.util.vector> opcionests)

32 31 getopcioneshc public java.util.list<java.util.vector> getopcioneshc() setopcioneshc public void setopcioneshc(java.util.list<java.util.vector> opcioneshc) creardocdom public org.w3c.dom.document creardocdom(java.lang.string fichero) Busca file dentro de repositorio Parameters: fichero - Returns: Document leerdocdom public void leerdocdom(org.w3c.dom.document docdom) Lee file tipo Document el debe tener un xml y es recorrido uno a uno sus nodos para setear campos de conexion

33 32 Parameters: docdom - Constructor Detail ReadXMLIVR public ReadXMLIVR(java.lang.String archivo) cosntructor **************************** Method Detail GetItems public java.util.list<java.util.vector> getitems() ReadXMLIVR getters and setters **************************** setitems public void setitems(java.util.list<java.util.vector> items) getopciones public java.util.list<java.util.vector> getopciones() setopciones

34 33 public void setopciones(java.util.list<java.util.vector> opciones) creardocdom public org.w3c.dom.document creardocdom(java.lang.string fichero) Busca file dentro de repositorio Parameters: fichero - Returns: Document leerdocdom public void leerdocdom(org.w3c.dom.document docdom) Lee file tipo Document el debe tener un xml y es recorrido uno a uno sus nodos para setear campos de conexion Parameters: docdom -

35 CISCAGI-AMI Class Summary Clase que permite la comunicacion con la base de datos. Constructor Summary BaseDatosManager() Constructor que permite iniciar la comunicaciã³n con la base de datos. Method Summary BaseDatosManage r java.lang.string[] listarextensiones() Permite obtener una lista de las extensiones asignadas a usuarios en la base de datos. static void main(java.lang.string[] args) Methods inherited from class java.lang.object equals, getclass, hashcode, notify, notifyall, tostring, wait, wait,

36 35 wait Constructor Detail BaseDatosManager public BaseDatosManager() Constructor que permite iniciar la comunicaciã³n con la base de datos. Method Detail listarextensiones public java.lang.string[] listarextensiones() Permite obtener una lista de las extensiones asignadas a usuarios en la base de datos. Returns: El array con las extensiones Clase que permite establecer y terminar una conexión con la API ConexionManager Manager de Asterisk. Field Summary

37 36 org.asteriskjava.manager.managerconnect ion managerconnectio n Identificador lara la conexión con la API Manager que se establecerá Constructor Summary ConexionManager() Permite crear la ManagerConnection necesaria para conectarse a la API Manager. Method Summary void finalizarconexion() Finaliza la conexión a la API Manager. void iniciarconexion() Inicia la conexión a la API Manager.

38 37 Methods inherited from class org.asteriskjava.manager.abstractmanagereventlistener OnManagerEvent Methods inherited from class java.lang.object equals, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait Field Detail managerconnection public org.asteriskjava.manager.managerconnection managerconnection Identificador lara la conexión con la API Manager que se establecerá Constructor Detail ConexionManager public ConexionManager() throws java.io.ioexception Permite crear la ManagerConnection necesaria para

39 38 conectarse a la API Manager. Throws: java.io.ioexception - Si la conexión de red falla Method Detail iniciarconexion public void iniciarconexion() throws java.io.ioexception, org.asteriskjava.manager.authenticationfailedexception, org.asteriskjava.manager.timeoutexception Inicia la conexión a la API Manager. Throws: java.io.ioexception - Si la conexión de red falla org.asteriskjava.manager.authenticationfailedexception - Si falla la autenticación en Asterisk org.asteriskjava.manager.timeoutexception - Si se excede del Timeout finalizarconexion public void finalizarconexion()

40 39 Finaliza la conexión a la API Manager. Clase que permite leer y escribir en los archivos de configuración de la centralita PBX Asterisk. Constructor Detail ConfiguracionFicheros public ConfiguracionFicheros(java.lang.String file) throws java.io.ioexception, ConfiguracionFich eros org.asteriskjava.manager.authenticationfailedexception, org.asteriskjava.manager.timeoutexception Constructor que permite inicializar la conexión a la API Manager de Asterisk, así como los campos de la clase. Parameters: file - Nombre del archivo de configuración a leer/escribir Throws: java.io.ioexception - Si la conexión de red falla org.asteriskjava.manager.authenticationfailedexception - Si falla la autenticación en Asterisk

41 40 org.asteriskjava.manager.timeoutexception - Si se excede del Timeout ConfiguracionFicheros public ConfiguracionFicheros(java.lang.String file, ConexionManager con) throws java.io.ioexception, org.asteriskjava.manager.authenticationfailedexception, org.asteriskjava.manager.timeoutexception Constructor que permite asociar este servicio a una conexión a la API Manager de Asterisk ya creada e inicializada. Parameters: file - Nombre del archivo de configuración a leer/escribir con - ConexionManager ya inicializada Throws: java.io.ioexception - Si la conexión de red falla org.asteriskjava.manager.authenticationfailedexception - Si falla la autenticación en Asterisk

42 41 org.asteriskjava.manager.timeoutexception - Si se excede del Timeout Method Detail listarcategorias public void listarcategorias() Permite lanzar la acción GetConfigAction para el archivo de configuración cuyo nombre sea el que figura en el campo archivo. Además, después obtiene una lista de las categorías disponibles y la almacena en el campo cat. Throws: java.io.ioexception - Si la conexión de red falla org.asteriskjava.manager.timeoutexception - Si se excede del Timeout buscarcategoria public int buscarcategoria(java.lang.string categ) Permite buscar una categoría determinada dentro de un archivo de configuración de Asterisk.

43 42 Previamente debe haberse ejecutado el código listarcategorias(). Parameters: categ - El nombre de la categoría a buscar Returns: -1 si no lo encontró. Un valor mayor que 0 indicará la posición que ocupa la categoría en la variable cat See Also: org.yournamehere.server.configuracionficheros#listarcate gorias() listarcaracteristicas public java.lang.string[][] listarcaracteristicas(int index) Obtiene las características de una categoría concreta, indicada con su índice (lugar que ocupa en el campo cat. Si no se conociera el índice del mismo, pero sí el nombre de la categoría, hay que usar primero el código buscarcategoria(string), el cual devolverá el índice deseado. Parameters:

44 43 index - El índice que ocupa la categoría de la que queremos extraer las características Returns: La lista de características, separando en la primera columna el nombre de la característica y en la segunda el valor de la misma. Por filas, las diferentes características See Also: org.tutatisk.server.configuracionficheros#buscarcategoria (java.lang.string) buscarcaracteristica public int buscarcaracteristica(java.lang.string[][] lista, java.lang.string carac) Permite buscar una característica determinada dentro del array de características pasado como argumento. Previamente se recomienda haber ejecutado el código listarcaracteristicas(int) para obtener el array que pasar como argumento. Parameters: carac - El nombre de la característica a buscar

45 44 Returns: -1 si no lo encontró. Un valor mayor que 0 indicará la posición que ocupa la característica en la variable lista See Also: org.yournamehere.server.configuracionficheros#listarcara cteristicas(int) crearaccionescritura public MyUpdateConfigAction crearaccionescritura() Permite crear la acción MyUpdateConfigAction para poder realizar la escritura en los archivos de configuración de Asterisk. Posteriormente a este código, habrá que añadir los comandos a enviar y enviar la acción. Para ello ver incluircomandos(string[], String[], String[], String[], String[], MyUpdateConfigAction) y enviaraccionescritura(myupda teconfigaction). Returns: La acción MyUpdateConfigAction creada

46 45 incluircomandos public void incluircomandos(java.lang.string[] com, java.lang.string[] cat, java.lang.string[] var, java.lang.string[] val, java.lang.string[] mat, MyUpdateConfigAction accion) Permite añadir a una acción MyUpdateConfigAction múltiples comandos para escribir.cada comando completo estará formado por un elemento de cada array de String pasado como argumento. Por ejemplo, para enviar dos comandos, cada uno de esos 5 arrays tendrá una longitud de 2, y en el índice 0 estará el primer comando y en el índice 1 estará el segundo. Parameters: com - Array con todos los comandos a enviar sucesivamente. Para ello, ver los comandos en los campos estáticos de MyUpdateConfigAction cat - Array con todas las categorías a las que se referirán

47 46 cada uno de los comandos anteriores var - Array con las variables para cada comando val - Array con los valores de las variables anteriores mat - Array con los valores match para los anteriores comandos accion - Acción MyUpdateConfigAction sobre la que añadir los comandos enviaraccionescritura public void enviaraccionescritura(myupdateconfigaction accion) throws java.io.ioexception, org.asteriskjava.manager.timeoutexception Permite enviar la acción ya completa MyUpdateConfigAction a la conexión a la API Manager. Parameters: accion - La acción MyUpdateConfigAction a enviar Throws: java.io.ioexception - Si la conexión de red falla org.asteriskjava.manager.timeoutexception - Si se excede

48 47 del Timeout getarchivo public java.lang.string getarchivo() Devuelve el campo archivo Returns: El nombre del archivo de configuración a leer/escribir setarchivo public void setarchivo(java.lang.string arc) Modifica el campo archivo Parameters: arc - El nombre del archivo de configuración a leer/escribir Clase que permite gestionar todo lo relacionado con usuarios: Registro Modificación de datos Eliminación de usuario GestionUsuarios Constructor Detail GestionUsuarios public GestionUsuarios(java.lang.String usuario,

49 48 java.lang.string password, java.lang.string dni, java.lang.string extension, java.lang.string nombre, java.lang.string apellido1, java.lang.string apellido2, java.lang.string , java.lang.string telefono, java.lang.string tipo, BaseDatosManager bbdd) Inicializa un objeto. Inicializa el usuario. Se le pasa como argumento la manager de la base de datos. Parameters: usuario - El nick de usuario password - La contraseña para el acceso web dni - El DNI de la persona en formato A. A su vez, la clave por defecto para la conexión SIP será el DNI sin la letra, en este caso, (al querer que sea numérico) extension - La extensión escogida por el usuario

50 49 nombre - El nombre del usuario apellido1 - El primer apellido apellido2 - El segundo apellido - El telefono - El teléfono de contacto del usuario (ajeno al sistema) tipo - El tipo de usuario que es. Hay tres disponibles: Alumno, Profesor y Administrador bbdd - La manager de la base de datos Method Detail Registrar public java.lang.string registrar() Permite registrar un usuario en el sistema, tanto en la base de datos como en la centralita asterisk. Returns: Mensaje de à xito/fracaso al registrar usuario setusuario public void setusuario(usuario us)

51 50 Modifica el usuario sobre el que se realiza la gestiã³n Parameters: us - CiscagiUsuario a gestionar eliminar public java.lang.string eliminar() Permite eliminar un usuario en el sistema, tanto en la base de datos como en la centralita asterisk. Returns: Mensaje de à xito/fracaso al eliminar usuario modificar public java.lang.string modificar(usuario us, java.lang.string passasterisk) Permite modificar los datos de un usuario ya registrado. Ademà s, da la opciã³n de que la contraseã±a web sea diferente de la contraseã±a de la extensiã³n del usuario y de su buzã³n de voz. Al crear el usuario, por defecto se habã an cogido los nãºmeros del DNI (la letra no). Parameters:

52 51 us - Los datos del nuevo usuario, dentro de un objeto de la clase CiscagiUsuario passasterisk - La contraseã±a que queremos poner a la extensiã³n y buzã³n de voz Returns: Mensaje de à xito/fracaso al modificar usuario Clase encargada de ejecutar las distinas acciones con el AMI Constructor Detail MyUpdateConfigAction public MyUpdateConfigAction() MyUpdateConfig Action MyUpdateConfigAction public MyUpdateConfigAction(java.lang.String srcfilename, java.lang.string dstfilename, boolean reload) Method Detail addcommand public void addcommand(java.lang.string action,

53 52 java.lang.string cat, java.lang.string var, java.lang.string value, java.lang.string match) Overrides: addcommand in class org.asteriskjava.manager.action.updateconfigaction ghostactionstring public java.lang.string ghostactionstring() getreload public java.lang.string getreload() Overrides: getreload in class org.asteriskjava.manager.action.updateconfigaction Documentación técnico de clases de cliente Flex y sus distintas paqueterías. En el aplicativo cliente AIR/Flex esta dividido en tres proyectos:

54 53 CISCAGI VIEWER : Proyecto AIR/Flex encargado de proveer la interfaz grafica y principal del proyecto. CISCAGI LIBRARY: Proyecto tipo Modules encargado de proveer las diferentes librerías y clases utilitarios para el resto del proyecto. ModuloIVR: Modulo encargado de generar interfaz grafica para consulta de menú IVR estas no se generan de manera genérica ya que su i nterfaz en un poco más compleja pero el proyecto AIR/Flex permite generar formas genéricas así también permite el ingreso de módulos de extensión swf. Estos ingresos si son de manera fácil solo bastaría con ingresarlo dentro de la base objetos CISCAGIVIEWER Packages src.default src.assets Contiene las distintos utilitarios utilizados tales como definiciones de hojas de estilo, imágenes, skins, fonts. Contiene paquetes tales como: src.com ciscagi: Contiene clases principales del proyecto tales como: Clases de conexiones a SQL Lite Clases de conexiones via com.

55 54 Clases de mapeo para los distintos eventos. Clases de manejo de interfaces GUI genéricas, objeto abierto y modules de extensión swf. flexmdi: Contiene clases actiosnscripts para los manejo de diseños de las distintas GUI, tales como el uso de reflejos, manejo de las hojas de estilo y skins CISCAGILIBRARY Packages assets.images Contiene las distintos utilitarios utilizados tales como definiciones de hojas de estilo, imágenes. Contiene paquetes tales como: Constants:Contiene el definiciones de contantes utilizados en los proyectos. alexsoft.common Controls: Contiene clases actiosnscripts para los distintos controles generales de las GUI. Log :Contiene las constantes de clase Logs. Utilis: Contiene los distintos clases que ayudaran con utilitarios

56 55 básicos tales como las diferentes validaciones tanto de identificación, fechas, formatos etc. alexsoft.events alexsoft.vo Contiene las distintas clases de manejo de eventos para las diferentes formas. Contiene las clases tipo entidades para el manejo de objetos predeterminados para este proyecto ModuloIVR Packages Contiene la clase: Class moduloivr.mxml src.default See Also: Clase encargada de presentar la GUI principal que invocara a los distintos mxml para funciones de consulta de totales y de transacciones. src.modules Contiene paquetes tales como:

57 56 events: Contiene la definiciones manejo de eventos. maps: Contiene las rutas de los eventos sucitados en el proyecto GUI. model :Contiene las clases manejadoras de funciones trascendentales para el modulo. ui: Contiene los distintos clases GUI para transacciones y consulta de totales.

58 57 4. DIAGRAMAS DE LA APLICACIÓN 4.1. Diagrama de desarrollo CISCAGI Fuente: Datos de la Investigación Elaborado: Autores de la Tesis

59 Diagrama general de secuencia CISACAGI IVR. Fuente: Datos de la Investigación Elaborado: Autores de la Tesis

60 Diagrama general de secuencia CISACAGI administrador. Fuente: Datos de la Investigación Elaborado: Autores de la Tesis

61 Diagramas UML UML AGISCRIPT. Fuente: Datos de la Investigación Elaborado: Autores de la Tesis

62 UML CISCAGI AMI1 Fuente: Datos de la Investigación Elaborado: Autores de la Tesis

63 UML CISCAGI AMI2 Fuente: Datos de la Investigación Elaborado: Autores de la Tesis

64 63 5. INSTALACIONES Y CONFIGURACIONES Instalación Asterisk (Distribución Elastix). Inserte el CD de instalación de Elastix al momento de encender su máquina. Una vez hecho esto aparecerá una pantalla como la siguiente: Si usted es un usuario experto puede ingresar en modo avanzado digitando el comando: advanced Caso contrario espere, el CD de instalación iniciará la instalación automáticamente ó presione enter. Proceda a escoger el tipo de teclado de acuerdo al idioma. Si su teclado es de idioma español seleccione la opción es:

65 64 Seleccione la hora zona horaria de su región: Digite la contraseña que será usada por el administrador de Elastix. Recuerde que esta es una parte crítica para la seguridad del sistema.

66 65 Nota: Los procedimientos a continuación los realizará el CD de instalación de manera automática. Primero se buscará las dependencias necesarias para la instalación:

67 66 Luego se procede con la instalación, inicialmente usted verá algo como esto: Imagen del proceso de instalación por finalizar: Una vez se realice la instalación completa, se procede a reiniciar el sistema. Luego de reiniciar el sistema usted podrá escoger entre las opciones de boot la distro de Elastix. Ingrese como usuario root y la contraseña digitada al momento de la instalación.

68 Instalación Festival. (TTS [Conversor de texto a voz]). Una vez instalado Asterisk, se procederá a la instalación de los paquetes adicionales para el funcionamiento del sistema e iniciaremos con el Festival, software usado para las funciones del TTS. Para esto se ejecutamos en el promt del root el comando yum install festival, esta sentencia descargará, descomprimirá e instalará el paquete festival que de manera predeterminada viene en inglés, así que ahora procedemos a instalar el paquete de español disponible en [FES2007], descargando el archivo de extensión.tar.gz y descomprimiéndolo para un mejor desempeño en nuestro entorno. Para programar el lenguaje a ser utilizado, alteraremos el archivo festival.scm, ubicado en /usr/share/festival, al cual le agregaremos el siguiente script para usar por defecto el lenguaje español en modo servidor: ARCHIVO FESTIVAL.SCM LENGUAJE ESPAÑOL (language_spanish) (set! voice_default 'voice_pc_diphone) Una vez hecho esto, agregaremos un script en el mismo archivo que permitirá que Asterisk interactúe directamente con Festival, el cual define la forma en que Asterisk pasará las cadenas de texto a ser reproducidas: ARCHIVO FESTIVAL.SCM INTERACCION ASTERISK ;; Command for Asterisk begin

69 68 (define (tts_textasterisk string mode) "(tts_textasterisk STRING MODE) Apply tts to STRING. This function is specifically designed for use in server mode so a single function call may synthesize the string. This function name may be added to the server safe functions." (utt.send.wave.client (utt.wave.resample (utt.wave.rescale (utt.synth (eval (list 'Utterance 'Text string))) 5) 8000))) ;;; Command for Asterisk end Finalmente se crea un usuario en el archivo festival.conf ubicado en /etc/asterisk en el cual indicaremos las características de la conexión entre Asterisk y Festival, indicando la ubicación del host Festival, en el caso de este proyecto encontrándose juntos: el puerto y el comando, entre otros: ARCHIVO /ETC/ASTERISK/FESTIVAL.CONF [general] host=localhost port=1314 usecache=yes cachedir=/var/cache/asterisk/festival/ festivalcommand=(tts_textasterisk "%s" 'file)(quit)\n

70 Instalación Cacti (Monitorizador de Servidores). Esta herramienta gráfica de red que extrae los datos desde el snmp para poder monitorizar de manera gráficas los recursos de nuestros servidores y otros equipos en la red. Dependencias a instalar: MySQL: Almacenar datos cacti. Servidor de NET-SNMP - SNMP (Simple Network Management Protocol). PHP con el módulo Net-SNMP - SNMP de datos de Access mediante PHP. Apache / lighttpd / ngnix servidor web: servidor web para mostrar gráficos creados con PHP y RRDtool. Luego de instaladas estas dependencias, ejecutamos el comando php m less para verificar que PHP tenga los siguientes módulos externos: -mysql -snmp -xml -session -sockets El siguiente paso será editar el archivo de configuración /etc/php.ini y modificar el siguiente parámetro: extensión_dir = /etc/php.d

71 70 En ese directorio se encuentran mayormente las librerías necesarias, pero en caso de CentOs y otras distribuciones, estas librerías se encuentran en /usr/lib/php/modules así que necesitaremos copiar las librerías ubicadas en ese directorio y copiarlas a /etc/php.d, con el siguiente comando lo hacemos: cp /usr/lib/php/modules/* /etc/php.d/ Y verificamos, modificamos o creamos los siguientes archivos del directorio /etc/php.d/ En /etc/php.d/mysql.ini ; Enable mysql extension module extension=mysql.so En /etc/php.d/snmp.ini ; Enable snmp extension module extension=snmp.so Luego de verificar que este todo correcto hasta el momento, debemos modificar el archivo /etc/php.ini, verificando que este parámetro este de la siguiente manera: file_upload = on ::: Para permitir la importación de plantillas :::

72 71 Configurando Apache Editamos el archivo de configuración /etc/httpd/conf.d/php.conf y verificamos que los siguientes parámetros estén de la siguiente manera: LoadModule php5_module modules/libphp5.so AddHandler php5-script.php AddType text/html.php DirectoryIndex index.php Configurando Mysql Subimos el servicio de mysql, con el comando ''service mysqld start'' Le damos una password a root: mysqladmin -user=root password contraseña Instalando Cacti Para instalar cacti en CentOS es necesario tener los repositorios RPMforge, para su instalación: Descargamos los repositorios dependiendo de su arquitectura: X86: wget

73 72 X86_64: Wget Importamos las llaves Públicas: rpm --import Instalamos el paquete: rpm i rpmforge-release-xxx.xxx.xxx.rpm Y verificamos que se instalaron los repositorios con: yum check-update Luego podemos instalar Cacti, con todas las dependencias necesarias. yum install cacti Entre las dependencias que se instalaran están: -rrdtool -perl-rrdtool

74 73 Cuando finalice la instalación, podemos verificar que Cacti se instalo en /var/www/cacti, y que creó un alias en /etc/http/conf.d/ llamado cacti.conf Creación de base de datos MYSQL para datos de cacti Nos ubicamos en /var/www/cacti, y usamos mysql para crear nuestra base de datos para cacti. Shell>mysqladmin -user=root p create cacti shell> mysql --user=root -p cacti < cacti.sql shell> mysql --user=root -p mysql mysql> GRANT ALL ON cacti.* TO cacti@localhost IDENTIFIED BY Contraseña ; mysql> flush privileges; mysql> exit Editamos el archivo /var/www/cacti/include/config.php, y verificamos que los siguientes parámetros estén de la siguiente manera: $database_type = "mysql"; $database_default = "cacti"; $database_hostname = " ";

75 74 $database_username = "cacti"; $database_password = "contraseña"; Asignando permisos necesarios Nos ubicamos en el directorio /var/www/, y le cambiamos el propietario a la carpeta cacti, le ponemos como propietario a apache. chown R apache.apache cacti/ Entramos al directorio cacti, y le cambiamos el usuario a las carpetas rra y log. chown R cacti rra/ log/ Agregamos a /etc/crontab, lo siguiente: */5 * * * * cacti php /var/www/html/cacti/poller.php > /dev/null 2>&1 Reiniciamos los servicios service httpd restart service snmpd restart service mysqld restart

76 75 Y entramos desde nuestro explorador a htto://localhost/cacti/ Elegimos nueva instalación

77 76 3er Paso Confirmamos todas las rutas En caso de falta de paquetes, instalar net-snmp-utils 4to Paso Ingresar a Cacti El UserName y el Password son admin, luego nos pedirá que escribamos la nueva contraseña.

78 77 Graficando la Red El primer paso para crear gráficas de la red es agregando un host por cada host en la red que se desea crear gráficas. Un host especifica detalles importantes como el nombre del host, parámetros SNMP y el tipo de host. Para manejar equipos dentro de Cacti, haga click en Devices en el menú de la izquierda. Luego haga click en Add para llenar el formulario de una nuevo equipo. Los primeros dos campos, Description y Hostname son los únicos campos que requieren entrada más allá de las por defecto. Si su tipo de host está definido bajo el menú desplegable, asegúrese de seleccionar este en el menú. Usted siempre puede elegir Generic SNMPenables host si solo va a graficar tráfico o None si no está seguro. Ahora que ha creado nuevos equipos, es tiempo de crear gráficas para el mismo. Para hacer esto, selección del menú de la izquierda la opción New Graphs. Si aun está en la

79 78 pantalla de editar el equipo, seleccione Create Graphs for this Host para ver una pantalla similar a la siguiente imagen mostrada mas abajo. El menú desplegable que contiene cada equipo debe ser usado para seleccionar el equipo al cual usted quiere crear nuevas gráficas. El concepto básico en esta página es simple, seleccione el cuadro de verificación en cada columna que usted quiere crear una grafica y haga click en Create. Si usted está creando gráficas dentro de la caja Data Query, hay algunas cosas adicionales para tener en mente. Primero es que se puede encontrar con la situación mostrada en la grafica mostrada más arriba con la consulta de datos SNMP Interface Statistics. Si esto ocurre usted quizás quiera consultar la sección en consultas de datos en depuración para ver porque su consulta de datos no está retornando ningún resultado. También, usted quiera ver el menú desplegable debajo de algunas cajas de consulta de datos. Cambiando el valor de este menú afecta cual tipo de grafica Cacti construirá