Anexo C. Guía de usuario, instalación y fundamentos

Transcripción

1 Anexo C Guía de usuario, instalación y fundamentos

2 En este anexo vamos a describir los pasos necesarios para desplegar el servicio partiendo del código ya compilado de ambos extremos, como haría un usuario, sin entrar en la programación. C.1 Desplegando el servicio Antes de detallar la tarea de desplegar el servicio debemos instalar un conjunto de herramientas necesarias para que funcione correctamente. Éstas son: - el software Java, - un contenedor de aplicaciones como Tomcat, - la implementación de SOAP, Axis, - el gestor de bases de datos MySQL y - el controlador JDBC. C.1.1 Preparando el entorno de ejecución Lo primero que debemos descargar e instalar es el software Java que puede obtenerse desde su página oficial ( A continuación instalamos el contenedor de aplicaciones y la implementación de SOAP para Java, Axis. Hemos elegido Tomcat como contenedor por pertenecer a la fundación Apache, que también desarrolla Axis, con lo que presumimos que ofrecerán buena compatibilidad. El proceso de descarga, instalación y ajustes es idéntico al seguido en el apartado 1.4 del Anexo B, por lo que obviamos repetirlo aquí. Por último debemos instalar el gestor de bases de datos MySQL y el controlador JDBC para que pueda comunicarse con el servicio en Java. Para conseguirlo tenemos que descargar los paquetes apropiados, instalarlos, inicializar las tablas de permisos de MySQL, comprobar que el gestor funciona y agregar la ruta donde hayamos instalado JDBC al CLASSPATH. Todos estos pasos comentados en detalle se reproducen en el apartado 1.4 del Anexo B, así que remitimos al lector a ese anexo. 2

3 C.1.2 La base de datos y el servicio Por un lado, el usuario debe crear la base de datos que utilizará el servicio e introducir los datos tanto de los usuarios registrados como de las empresas anunciantes y los mensajes a distribuir. Entramos en el gestor de bases de datos y creamos la base de datos y sus respectivas tablas (recordando que la primera se debe llamar servicio y las otras tres: clientes, empresas y mensajes ). Realizaremos este proceso de forma automática introduciendo datos de ejemplo. Primero entraremos en el gestor y después ejecutaremos el script. mysql p (para entrar como usuario root) source ruta_del_script.sql Debemos asegurarnos que los archivos de mensajes se encuentran dentro de la ruta marcada en la tabla mensajes por el campo Contenido para que así el servicio pueda recuperar los mensajes sin problemas. Una vez que tenemos la base de datos preparada debemos desplegar el servicio. Partimos de un fichero llamado acceso.jar y lo copiamos en la ruta concreta del contenedor de aplicaciones con la siguiente orden: mv acceso.jar $CATALINA_HOME/webapps/axis/WEB-INF/lib/ Ahora debemos reiniciar el servidor Tomcat para que tome conciencia de los cambios. $CATALINA_HOME/bin/shutdown.sh $CATALINA_HOME/bin/startup.sh Una vez que tengamos todo listo, sólo nos falta desplegar el servicio web. Esto es muy sencillo ya que Axis incorpora un servicio web para desplegar los servicios web, que se activa con la siguiente orden: java -cp $AXISCLASSPATH org.apache.axis.client.adminclient servidor/ws/deploy.wsdd 3

4 Para replegar el servicio sería de manera similar: java -cp $AXISCLASSPATH org.apache.axis.client.adminclient servidor/ws/undeploy.wsdd Y ya tenemos el servicio web disponible para los clientes. C.2 Ejecutando el Hotspot Para poder utilizar la aplicación del Hotspot y que funcione correctamente necesitamos instalar la implementación de Bluetooth para Linux, BlueZ, y la implementación de SOAP para C, gsoap. Los pasos de descarga, instalación y configuración de ambas herramientas se pueden seguir en el apartado 1.3 del Anexo B. No se van a repetir aquí por tratarse de exactamente el mismo proceso. Para ejecutar el Hotspot el usuario debe disponer de los siguientes archivos: - escaner.c - procesador.c - procesador.h - auxiliar.c - auxiliar.h - soapc.c - soaph.h - soapclient.c - soapstub.h - stdsoap2.c 4

5 - stdsoap2.h Suponemos que todos están en la misma ruta, así que nos ponemos en ese directorio y compilamos con la siguiente orden: gcc -o Hotspot escaner.c auxiliar.h auxiliar.c procesador.h procesador.c soaph.h soapc.c soapclient.c soapstub.h stdsoap2.h stdsoap2.c lbluetooth El último paso (o único si ya teníamos el archivo ejecutable Hotspot ) es arrancar el Hotspot, simplemente con:./hotspot Recordar que el servicio debe estar desplegado y el contenedor de aplicaciones en funcionamiento. 5