Está en la página 1de 30

Guía de instalación y documentación

Indice
Guía de instalación y documentación...................................................................................................1 Introducción.....................................................................................................................................2 Preparación inicial de entorno.........................................................................................................2 Nodo de procesamiento. Versión Java........................................................................................2 Entorno de desarrollo.............................................................................................................2 Máquina virtual......................................................................................................................2 Código fuente.........................................................................................................................2 Librerías necesarias................................................................................................................2 Builpath del proyecto.............................................................................................................4 Librerías en la JVM................................................................................................................5 Nodo de almacenamiento............................................................................................................6 Aplicación WEB.........................................................................................................................6 Servidor..................................................................................................................................6 Joomla....................................................................................................................................6 Librería SMS..........................................................................................................................7 Módulos Joomla.....................................................................................................................7 Secciones Joomla...................................................................................................................7 Categorías Joomla..................................................................................................................7 Artículos Joomla.....................................................................................................................8 Menú Joomla..........................................................................................................................8 Configuración Joomla..........................................................................................................12 Dentro de la solapa 'Servidor' deben configurarse los datos requeridos para el servidor, por ejemplo localmente se ha trabajado con los siguientes datos:..............................................15 Extensiones Joomla..............................................................................................................16 Para el usuario medico tenemos las siguientes configuraciones de permisos:....................23 Documentación..............................................................................................................................30 Nodo de procesamiento. Versión Java......................................................................................30 Estructura de la solución......................................................................................................30 Procesamiento de medición..................................................................................................31 Procesamiento de nueva novedad.........................................................................................32 Procesamiento de respuesta..................................................................................................32 Nodo de almacenamiento.....................................................................................................34 Aplicación WEB.......................................................................................................................37

Introducción

Se describirán cuestiones relativas a la preparación de los ambientes de desarrollo, tratando por separado las cuatro principales unidades implementadas, nodo de procesamiento, nodo de almacenamiento y entorno de las aplicaciones web. Finalizando con un sección de documentación en texto estructurado y UML, de las arquitectura y flujos de ejecución de los nodos mencionados.

Preparación inicial de entorno
Nodo de procesamiento. Versión Java.

Entorno de desarrollo

Para poder comenzar a desarrollar sobre la versión Java implementada se debe descargar Eclipse Galileo o superior desde el sitio http://www.eclipse.org/galileo/. Descomprimirlo en una carpeta local. • Máquina virtual

Tener instalado en el sistema operativo la máquina virtual de Java versión 1.6 o superior desde http://www.java.com. • Código fuente

Descargar el código fuente Java desde la URL presente en http://code.google.com/p/smstesis/source/checkout, sitio de Google Code donde se encuentra alojado el sistema. El código que se utiliza para el proyecto Java es el que se encuentra bajo el directorio SMSJava. Se debe crear un proyecto Java con dicho código en nuestro entorno Eclipse. • Librerías necesarias

Descargar las siguientes librerías e instalar en el entorno de desarrollo o máquina virtual. Para aquellas librerías que se indique instalar en el entorno, se debe copiar la librería en cuestión en el builpath del workspace con el que se trabaje, que preparamos en el paso anterior. Postgre JDBC Ingresar a http://jdbc.postgresql.org. En la sección 'Download' descargar la versión JBDC4 que trabaja con versiones 1.6x de Java. Instalar en el buildpath del proyecto. SMSLib Estas librerías son las que nos permiten el envío y recepción de mensajes de texto a través de la manipulación del módem.

Ingresar al sitio http://smslib.org/ y seguir las instrucciones presentes en la sección 'Download' del menú. Se debe descargar la versión SMSLib para Java. Esta librería requiere de la instalación de componentes adicionales, los cuales se encuentran mencionados en URL http://smslib.org/doc/installation/. Algunas de estas librerías deben ser instaladas en el directorio donde se encuentra la máquina virtual que estemos utilizando y otras deben estar presentes en el buildpath del proyecto. JDOM Para el acceso a los archivos XML y su manipulación se utiliza JDOM. Se debe descarga desde http://www.jdom.org/ y colocar tanto en el buildpath. LOG4J Descargar Log4J versión 1.2.x desde http://logging.apache.org/log4j/1.2/download.html. Instalar en el buildpath del proyecto. La configuración de los loggers utilizados puede modificarse desde el archivo log4j.properties presente en el proyecto bajo el directorio /src. Existen tres categorías de loggers utilizados a demás del logger root por defecto. Logger de eventos relacionados a la inicialización y configuración del sistema, logger que registra eventos de base de datos y el logger para registro de eventos bajo el paquete de clases sms. Veamos un ejemplo de configuración de uno de estos loggers, donde se ha utilizado una política de rotación por tamaño.
# Set log configurations parameters for configuration events and classes log4j.logger.config=DEBUG, config log4j.appender.config=org.apache.log4j.DailyRollingFileAppender log4j.appender.config.File=c:\\SMSHealthMonitoringLOGS\\SMSConfig.log log4j.appender.config.MaxFileSize=500KB log4j.appender.config.layout=org.apache.log4j.PatternLayout log4j.appender.config.MaxBackupIndex=80 log4j.appender.config.layout.ConversionPattern=%d{ISO8601} %-4r [%t] %-5p %c %x %m%n

JETM Para control de tiempos de ejecución se utiliza JETM (Java™ Execution Time Measurement Library). Se debe descargar desde http://jetm.void.fm/ y configurar en el buildpath. JUnit Para poder correr y compilar los casos de test presentes en cada paquete junto a cada una de las clases se requiere tener instalado Junit. Este framework puede descargarse desde http://www.junit.org/. Debiendo incluir en el entorno y el buildpath la librería. Actualmente se trabaja con la versión 4.8.2 de la misma. • Builpath del proyecto

De modo que al finalizar de instalar las librerías deberemos asegurarnos de tener configurado el buildpath de nuestro proyecto de la siguiente manera. • Librerías en la JVM La máquina virtual con la que estemos trabajando debe poseer los siguientes archivos en la carpeta de librerías externas. .

Instalar contenidos de ejemplo!.html. Quinta pantalla: Configuración de FTP.x. Se debe crear una base de datos vacía desde la interfaz de MySQL. • Joomla Instalar Joomla 1. correo del administrador.5. Sexta pantalla: Configuración principal. teniendo en cuent el usuario.apachefriends. las contraseña. Buscar el script de carga bajo el directorio /basededatos. su configuración y los contenidos que deben ser creados dentro de la instalación a realizar. Luego de esta descripción en detalles de cada componente se explica una segunda opción de instalación del entorno web donde no se detallan los componentes sino que se migra directamente el sitio. Debe darse el nombre 'SistemaMonitoreo' al nuevo sitio a crear. Durante la instalación seleccionar: • • • Primera pantalla: Idioma español. Se puede descargar XAMPP desde http://www.joomla.4 de Postgre que puede descargarse desde http://www. Séptima pantalla. En el caso del proyecto en particular se instaló XAMPP debido a su capacidad de rápida configuración y a que integra en una instalación PHP. Aplicación WEB Se describen los componentes necesarios para realizar la instalación de la aplicación web.org/download/. Cuarta pantalla: configuración de base de datos. Nombre del sitio. MySQL y Apache. • Servidor Instalar algún servidor web Apache con soporte para PHP5 donde pueda correr el manejador de contenidos Joomla.xml. Luego de instalar PostgreSQL debe ejecutarse el script de creación y carga inicial de la base de datos descargándolo desde el SVN del proyecto mencionado anteriormente. Se debe colocar una contraseña al usuario administrador.org/es/xampp. Segunda y tercera pantalla: siguiente / aceptar condiciones. descargando desde http://www. Finalizar eliminando la carpeta instalación desde el directorio • • • . puerto de conexión del servidor e IP del mismo. entre otros datos. Iniciar el servidor y el servicio de base de datos. Una vez creada la base de datos debemos configurar el acceso y conexión a la misma desde el proyecto Java o C++ cuyo entorno hayamos preparado. Se describirán los componentes individuales. Desde ambas versiones debe configurarse el acceso a la base en el archivo /src/config/config. No habilitar.org/. e instalar los contenidos de ejemplo ya que crearemos nuestra propia estructura a partir de ellos.postgresql.te. Debe contarse con una base de datos MySQL junto con el servidor.Nodo de almacenamiento Se requiere instalar la versión 8.

desde el SVN SMSJoomla\extensiones\code\user en Ajustar las rutas de configuración necesarias desde \libraries\joomla\sms\conf. Sección Home Sección médica Sección pacientes Sección general Descripción Dejar sección Home default Contenidos relativos a los médicos Contenidos para los pacientes Contenidos del público en general Se pueden crear manualmente o ejecutando sobre la base de datos MySQL correspondiente a la instalación de Joomla.php desde \SMSJoomla\extensiones\code\modules\mod_mainmenu_noix hacia \modules\mod_mainmenu_noix.Copiar el archivo helper. Ir a la opción del menú 'Extensions/Module Manager'. el script presente en el directorio /SMSJoomla/contenidos con el nombre jos_sections. ingresar los datos del usuario configurados. • Librería SMS Instalar la librería SMS bajo el directorio libraries/joomla de instalación del sitio. • Módulos Joomla Ir a la opción de administración (arriba – derecha). Copiar el archivo default. El nombre de usuario suele ser admin y la contraseña es la que hayamos indicado.php de la registración desde el SVN SMSJoomla\extensiones\registracion en \components\com_alpharegistration\views\register\tmpl. Copiar la carpeta sms en el directorio indicado. • Categorías Joomla Crear las siguientes categorías.php \libraries\joomla\user. Copiar el archivo default. Copiar los fuentes factory y conf desde el SVN SMSJoomla\extensiones\code en la ruta de instalación del sitio \libraries\joomla. Tomar la librería desde el SVN 'SMSJoomla/sms'. • Secciones Joomla Crear las siguiente secciones. (El módulo NOIX debe estar instalado – ver instrucciones en numerales siguientes). Deben quedar desactivados todos los módulos excepto Footer.sql.donde instalamos el sitio.php del login desde SVN SMSJoomla\extensiones\login en \modules\mod_login\tmpl. Copiar user. . Login y Menú (Main y User).

sql Si se desea ejecutar el script deben borrarse las categorías creadas automáticamente cuando se instalaron los contenidos de ejemplo. el script presente en el directorio /SMSJoomla/contenidos el script jos_categories. el script presente en el directorio /SMSJoomla/contenidos con nombre jos_content. Se pueden crear manualmente o ejecutando sobre la base de datos MySQL correspondiente a la instalación de Joomla. Esto se puede hacer desde la opción del menú 'Content / Category Manager'.sql • Menú Joomla Deben quedar creados dos menús ingresando a la opción 'Menús/Administrador de menús'. Deben borrarse los menúes extras y sólo dejar los menú 'Main Menú' y 'User Menú'. así como también deben borrarse los contenidos creados automáticamente desde 'Content / Article Manager'.xls dentro del directorio /SMSJoomla/contenidos/articulos/. . • Artículos Joomla Crear los artículos que se mencionan en la planilla de cálculo articulos.Categoría Bienvenida Página inicial Campañas listado Campañas registración Administración de campañas Listado de mediciones Administrar mediciones Datos personales Procesamientos Novedades Listado de mediciones Administrar mediciones Datos personales Procesamientos Home Sección Sección general Sección general Sección general Sección médica Sección médica Sección médica Sección médica Sección médica Sección médica Sección pacientes Sección pacientes Sección pacientes Sección pacientes Se pueden crear manualmente o ejecutando sobre la base de datos MySQL correspondiente a la instalación de Joomla.

Este nuevo item de menú principal debe seleccionarse como item por defecto y borrar el item anterior 'Home'. médicos y pacientes. desde la opción 'Parameters Basic / Select Article'. donde estabamos ubicados. . presionando la opción NEW. Se debe cambiar el tipo de menú al menú 'User Menú' de modo de que quede registrado como 'menuregistrado'. desde los items del menú Main Menu. Ingresar a los items de Main Menú y borrar todos excepto el indicado como por defecto 'Home'.Un menú corresponde a usuarios no registrados y el otro menú a los usuarios registrados. Ahora crearemos nuestro propio items 'Home'. Colocamos el título bienvenida y seleccionamos el artículo Bienvenidos para enlazarlo. Seleccionando el tipo de menú 'Internal Link / Article / Article Layout '.

.

Listado de campañas Listado de campañas Administrar campañas . Listado de mediciones Administrar mediciones Listado de mediciones Administrar mediciones . Actualizar información Actualizar datos Ayuda Ayuda Tipo Artículos » Artículo Artículos » Artículo separator Artículos » Artículo Artículos » Categoría Artículos » Artículo Artículos » Categoría separator Artículos » Artículo Artículos » Artículo Artículos » Categoría separator separator Artículos » Artículo Artículos » Artículo Artículos » Artículo Artículos » Artículo Actualizar información médico Actualizar información paciente Ayuda médico Ayuda paciente Listado para médicos Listado para pacientes Artículo para asociarse Sección médica / Administración de campañas Listado mediciones médico Sección médica mediciones / Administrar Artículo enlazado Página inicial de médico Página inicial de paciente Listado mediciones paciente Sección pacientes / Administrar mediciones Asociarse a una campaña Artículos » Artículo • Configuración Joomla Dentro del Panel de control sección 'Configuración global' se deben colocar las siguientes configuraciones de parámetros. Previamente borrar los items creados por defecto excepto LOGOUT. Se puede optar por ejecutar el script jos_menu.Ingresando al menú registrado se deben crear los siguientes items. Título Página inicial Página inicial . . Dentro de las configuraciones globales de la solapa 'Sitio': . Borrarlos también de la papelera o Trash.sql para crearlos automáticamente. Las que no se mencionan es porque no cambian respecto a los valores por defecto al realizar la instalación.

solapa 'Sistema': .Dentro de la sección de configuraciones globales.

Dentro de la solapa 'Servidor' deben configurarse los datos requeridos para el servidor. Template Desde la opción del menú 'Extensions / Install / Uninstall'. temas y lenguajes que deben instalarse. módulos. Descargar e instalar el template JuliaDynamic desde el SVN en el directorio /SMSJoomla/extensiones/template/julia. . por ejemplo localmente se ha trabajado con los siguientes datos: • Extensiones Joomla Se describen los componentes.

html? func=fileinfo&id=22 o bien desde /SMSJoomla/extensiones/registracion.ini en la ruta de instalación de Joomla bajo el directorio \Joomla\language. tanto para la sección administrativa como para el front-end de la aplicación. Allí encontraremos dos paquetes de idioma uno para cada sección. .alphaplug. Componente de registración Alpha Para poder customizar la registración de los usuarios se utiliza el componente de registración Alpha que puede descargarse desde http://www. Una vez incluído en Joomla se debe activar el componente desde el menú de 'Extensiones/Administrador de Plugins'. Lenguaje Descargar e instalar el pack de lenguaje español.Se debe activar el uso de este template desde la opción del menú 'Extensions / Template Manager'. Una vez instalados los paquetes de lenguaje español. Las configuraciones de este componente son las siguientes. donde encontraremos el plugin bajo el nombre DirectPHP. debido a que contiene customizaciones para la plantilla de registración de usuarios (previamente debe haberse instalado el componente de registración alpha detallado más adelante). Módulo PHP Para poder insertar PHP en los artículos se debe instala el módulo DirectPHP.joomla. descargándolo desde /SMSJoomla/extensiones/php o bien desde http://extensions. se debe copiar el archivo esES.com/downloads. El pack de idioma puede descargarse desde el SVN bajo el directorio /SMSJoomla/extensiones/lenguaje/. Estos módulos de lenguaje se deben activar desde la opción del menú 'Extensions / Language Manager'.org/extensions/edition/custom-code-in-content/4470.com_alpharegistration.

.

.

ini desde SVN en \SMSJoomla\extensiones\lenguaje hacia del directorio de instalación del sitio \language\es-ES.joomla. Como puntos importantes se detalla que el sufijo de la clase debe ser alpha de modo de tomar los estilos necesarios.net de modo de poder utilizar el servicio. Instalar primero el componente (com).org/extensions/access-a-security/backend-a-fullaccess-control/7010.Las claves públicas y privadas que se han utilizado para el sitio de desarrollo y prueba son: • • Public Key 6LeQ1LoSAAAAAD75hA5WbQ_YC-tuXn2SFP7-_CxJ Private Key 6LeQ1LoSAAAAADtCPNhk1mlk0V_EEXp5OdpNThJp El código configurado para las claves públicas y privadas debe obtenerse registrando el sitio en htpp://recaptcha. Se puede descargar desde el SVN 'extensiones/acceso/'.com_alpharegistration. luego el módulo del menú (mod) y luego los adapters. ya que depende del host donde esté instalado el sitio la habilitación del servicio. . Copiar el archivo es-ES. Control de acceso Para poder crear grupos de usuarios se utilizó el componente NoixACL que puede descargase desde http://extensions.

El grupo SMSAdmin se asocia a administrador. Esto se realiza desde la opción del menú 'Componentes/Access Control'. Los grupos medico y paciente se asocian al nivel de acceso registrado. . Primero deben crearse los grupos de usuarios marcados a continuación. Se detallan los valores en las siguientes figuras.Deben quedar habilitados los plugins y los adapters mientras se configuran los grupos y niveles de acceso. Posterior a la instalación deben crearse los grupos paciente y medico con los permisos necesarios por ítem del menú y por artículo. Luego se determinan los niveles de acceso.

ni Site. Adapter content: dar permisos para los contenidos de las sección médica y general del frontend. menú registrado los siguientes permisos: . Previo a lo cual deben habilitarse los adaptadores desde la solapa 'Adapters'. Para el frontend. ni General). Adapter menú: ningún permiso en backend.Para por último establecer los permisos por grupos de usuarios. Ingresando a la solapa 'Manage Groups' vamos seleccionando los grupos medico y paciente y le asignamos los permisos para los contenidos e items del menú que pertenezcan a las secciones y categorías a las cuales puedan acceder. Para el usuario medico tenemos las siguientes configuraciones de permisos: • • • Adapter access: ningún permiso habilitado (ni Administrador.

ningún permiso para menúes del backend.Para el usuario paciente ningún permiso para el adapter access. permisos para las secciónes pacientes y general del adapter content para el frontend y los siguientes permisos para el menú registrado del frontend: .

Para el usuario SMSAdmin. ningún permiso para menúes y los siguientes permisos para el adapter access: .

Crear un nuevo módulo de tipo Menú NOIX. colocarle título Menú y nivel de acceso registrado. Documentación Se presentarán diagramas y adjuntos de documentación por nodos de los componentes. Debe quedar habilitado este nuevo menú.Ir al administrador de módulos y deshabilitar los módulos Menú y User Menú de tipo mod_mainmenu. Deshabilitar si existe algún otro menú de tipo NOIX. . En los parámetros básicos seleccionar el menú registrado y el tipo de vista lista. Ingresar al módulo LOGIN y asociarlos a todos los items creados en la sección de asignación de menúes. asignando todos los items del menú en la sección Asignación de Menú.

• Procesamiento de medición Al llegar al módem un mensaje de texto con la medición enviada por un usuario se producen las siguientes acciones en el sistema. • Estructura de la solución Observamos un diagrama de clases. Se presenta un diagrama estructural y diagramas de secuencia para representar el sistema en ejecución. .Nodo de procesamiento. estructuradas por paquetes de la solución implementada en Java. Versión Java.

se producen las siguientes acciones desde el nodo de procesamiento. • Procesamiento de respuesta .• Procesamiento de nueva novedad Cuando un usuario médico ha ingresado una nueva novedad desde la interfaz web.

Cuando el usuario médico ha ingresado un respuesta para el paciente. desde la interfaz web se producen las siguientes acciones en el nodo de procesamiento. .

• Nodo de almacenamiento La estructura de la base de datos se representa en el siguiente diagrama de entidad y relación. .

.Adicionalmente se demuestra con los siguientes diagramas de actividad cómo se comporta la base de datos ante la llegada de una nueva respuesta o novedad.

.

.Aplicación WEB Para detallar el funcionamiento de la aplicación web adoptaremos un enfoque hacia la funcionalidad brindada al usuario presentando varios diagramas de caso de uso para demostrar las acciones que los dos actores principales (pacientes y médicos) de esta parte del sistema pueden ejecutar.