Usuario... 1 Administración Instalación de jgsmsd 2 Ambiente de jgsmsd Archivos de configuración 2. Ejecución... 2 Logs...

Transcripción

1 Documentación de jgsmsd Usuario De como enviar SMS De Como recibir SMS Administración De la Instalación De los archivos de configuración Contents Documentación de jgsmsd 1 Usuario Administración Instalación de jgsmsd 2 Ambiente de jgsmsd Archivos de configuracion Ejecución Logs Archivos de configuración 2 jgsmsd.cfg sqlobject.dburi app.cfg test mode wsbaseurl smtpd.addr dispatcher Manejo de Mensajes Entrantes 3 Reglas de patrones entrantes Orden Expresión Regular Servicio Web Services en jgsmsd 4 Servicios en jgsmsd queuesms Servicios consumidos por jgsmsd

2 Instalación de jgsmsd Ambiente de jgsmsd Archivos de configuracion El archivo de configuración es fundamentalmente /etc/jgsmsd/jgsmsd.conf y sus parámetros configurables pueden consultarse en este link. Ejecución El servicio se inicia, detiene y reinicia utilizando el script standard /etc/init.d/jgsmsd. Los links SysV se crean en la instalación para los runlevels correspondientes (e.g. RedHat: 3, 4 y 5, Debian 2, 3) Para verificar si el proceso se encuentra corriendo, puede consultarse el pidfile /var/run/jgsmsd.pid o la existencia de un proceso python2.5 start-jgsmsd... (que obviamente puede aparecer con sus path, /usr/local/bin/python2.5...) Logs El servicio provee dos tipos de archivos de log: /var/log/jgsmsd/console.log consiste en la información de debug, errores y excepciones del programa /var/log/jgsmsd/server.log que registra los accesos web en un formato similar al access.log de Apache Archivos de configuración jgsmsd.cfg sqlobject.dburi El URI de conexión a la base de datos, siguiendo el formato definido por SQLObject. Para una base de datos mysql, sin transacciones, usuario jgsmsd en localhost, base jgsmsd se especifica sqlobject.dburi="notrans_mysql://jgsmsd@localhost/jgsmsd" app.cfg test mode Si el valor es 1 no se envian ni se reciben mensajes, es decir no se conectan los modems. 2

3 jgsmsd.test_mode = 1 wsbaseurl Para generar los WSDL es necesario tener la URL base. Debe terminar ser jgsmsd.wsbaseurl = " smtpd.addr Direccion y puerto del servidor SMTP. jgsmsd.smtpd.addr = "localhost:225" dispatcher smtp domain El dominio desde el que se envian los mensajes recibidos por SMS cuando son enviados por mail. La dirección se compone con el telefono que envió el sms + el dominio aqui especificado. jgsmsd.dispatcher.smtp_domain = sms.mycompany.com.ar smtp server El servidor de SMTP (SMTP Relay) para enviar s. jgsmsd.dispatcher.smtp_server = Nótese que configurado adecuadamente se pueden enviar y recibir s de modo transparente desde y hacia SMS. Solo es necesario configurar un dominio (e.g. sms.mycompany.com) en el SMTP principal de la compania. Manejo de Mensajes Entrantes Cuando un mensaje ingresa por cualquiera de los modems en el pool, este es contrastado con las reglas de patrones entrantes, en orden y la primera que se le aplica se utiliza. 3

4 Reglas de patrones entrantes La tabla de patrones entrantes se puede editar a traves de la web de administracion. La tabla esta ordenada siguiendo el orden numérico del campo orden, se evalúan primero las más bajas, y por último las que corresponden a valores más altos. Se recomienda que la última regla (la de número más alto) sea una suerte de default, puede introducirse con la expresión regular:.* Orden Un valór numérico, valores más bajos son evaluados primero Expresión Regular La expresión regular se contrasta contra el cuerpo del mensaje y los metadatos del mensaje. Cuando esta coincide se ejecuta el servicio de la regla. Para escribir expresiones regulares se puede consultar la Wikipedia: Expresiones Regulares o el sitio regular-expressions.info. Tener en cuenta especialmente que las expresiones son sensibles a mayúsculas y minúsculas y que se busca un match estricto. Servicio El servicio a ejecutar cuando la expresión regular se cumple puede ser diverso, actualmente están definidos: WSDL Utiliza un WebService, en valor hay que especificar el url del wsdl, luego el nombre de la función entre llaves. Por ejemplo, el valor puede ser Los parámetros que recibe la función son: PostSMS (sender, message, recibido, modemmeta) SMTP El mensaje se envía via SMTP a una casilla de correo. En valor hay que especificar la direccion de mail de destino. Por ejemplo, el valor puede especificar smsdef@gmail.com. El servidor de SMTP utilizado y la dirección de origen se especifican en los archivos de configuración (ver dispatcher). Web Services en jgsmsd Servicios en jgsmsd Los servicios estan descriptos en el siguiente WSDL: fundamentalmente existe una función para enviar un mensaje, llamada queuesms 4

5 queuesms Encola un mensaje SMS Los parámetros son: priority un entero, donde 0 es la prioridad por defecto, más alto significa más prioridad destination el número destinatario message el texto del mensaje que no debe exceder los 161 bytes user usuario al que imputar el gasto del envio del mensaje Devuelve 0 si todo salió bien. Servicios consumidos por jgsmsd Los mensajes entrantes pueden ser dirigidos a varios servicios, entre ellos a un WebService. Consultar la documentacion de las reglas de entrada para el formato en que se especifica el uso de las rutinas. 5