MANUAL INSTALACIÓN

APLICACIÓN CARGUE AUTOMÁTICO DE

INFORMACIÓN EN SISAIRE

> EMPRESA: FONADE, MAVDT, IDEAM

> PROYECTO: Portal WEB

SISAIRE

(SISTEMA DE INFORMACIÓN DE CALIDAD DEL AIRE)

Manual del WebserviceOctubre 2010

> AUTOR: Ing. Miguel Camilo Páez P.> COAUTOR: AXESNET

Versión 1.3

Control de Versiones del Documento

Versión Fecha Descripción Cambio

1.0 20/Ago/2009 Versión inicial suministrada a Autoridades Ambientales.

1.1 28/Sep/2009 Versión definitiva de entrega al cliente, con ajustes después de

pruebas cliente.

1.2 15/Oct/2009 Correcciones del documento a solicitud del IDEAM.

Se agrego Objetivo, alcance, descripción, proceso y flujo de

datos, descripción del componente que envía la información y

descripción de los archivos de la aplicación.

1.3 12/Oct/2010 Se adiciono las validaciones y puntos a tener en cuenta en el

momento de la configuración de la vista para un cargue

satisfactorio de datos por medio del Webservice.

Contenido del Documento

CONTROL DE VERSIONES DEL DOCUMENTO............................................... 2

1. INTRODUCCION ..................................................................................... 4

1.1 OBJETIVO ...................................................................................................... 41.2 ALCANCE ....................................................................................................... 4

2. DESCRIPCION ......................................................................................... 5

3. PROCESO Y FLUJO DE DATOS ................................................................ 6

4. DESCRIPCION TÉCNICA DEL COMPONENTE QUE ENVIA LAINFORMACION .............................................................................................. 8

5. REQUERIMIENTOS PRE-INSTALACIÓN................................................. 9

5.1. REQUERIMIENTOS DE SOFTWARE ................................................................ 95.1.1. JAVA RUNTIME ENVIRONMENT ............................................................. 95.1.2 BASE DE DATOS ................................................................................. 12

5.2 REQUERIMIENTOS DE HARDWARE: ..................................................................... 12

6. INSTALACIÓN DEL SOFTWARE ............................................................ 13

6.1. INSTALACIÓN................................................................................................ 136.2. CONFIGURACIÓN DE BASE DE DATOS FUENTE (AUTORIDAD AMBIENTAL) ...................... 146.2.1. CONFIGURACIÓN Y VALIDACIONES DE LA APLICACIÓN EN LA VISTA ............................ 176.3. CONFIGURACIÓN DE LA APLICACIÓN .................................................................... 206.4. CONFIGURACIÓN DE TAREA PROGRAMADA ............................................................ 23

7. DESCRIPCION ARCHIVOS DE LA APLICACIÓN .................................. 24

1. INTRODUCCION

1.1 Objetivo

El objetivo principal de este manual es ofrecer a las personas encargadas de configurar

y operar la aplicación cliente del Web Service los suficientes detalles técnicos de la

aplicación para su instalación y para verificar y solucionar cualquier problema con

respecto a la configuración y parametrización de la aplicación para su correcto

funcionamiento.

1.2 Alcance

La idea principal es suministrar la suficiente información para la correcta instalación y

configuración general de la aplicación.

El presente manual sustenta los pasos que se deben seguir para la verificación de los

prerrequisitos para la instalación del componente dentro del sistema, configuración

inicial y operación general del sistema.

2. DESCRIPCION

SISAIRE está en capacidad de efectuar cargue automático de información demediciones de calidad de aire para aquellas corporaciones ambientales que poseansistemas capaces de centralizar la información reportada por las estaciones.

El funcionamiento consiste en la creación de una vista con la estructura que se defineen el numeral 3.3, en esta vista tendremos la información de la mediciones de aquellasestaciones que posean equipos capaces de reportar automáticamente la información alsistema ya sea de equipos que midan variables de calidad de aire o de meteorología.

La aplicación del cliente del Web Service está desarrollada completamente entecnología java obteniendo las ventajas que trae consigo esta tecnología, esmultiplataforma y lo único que difiere entre diferentes sistemas es la configuración de lamisma sin la necesidad de cambiar el código fuente de la aplicación.

Para su operación se debe configurar una tarea programada para la ejecución de lamisma y automáticamente enviara información al SISAIRE de los nuevos datosreportados a partir de la última sincronización con el servidor.

3. PROCESO Y FLUJO DE DATOS

Flujo de información de datos de Mediciones

El proceso anterior es el flujo de datos que tendrán los datos de las estacionesautomáticas para reportar su información al SISAIRE por medio del mecanismo quedescribe este manual (Web Service).

Descripción del proceso:

1. Las estaciones que posean equipos automáticos con la capacidad de leerinformación de manera horaria capturan información de mediciones de calidadde aire y de meteorología.

2. Los datos capturados por los equipos son enviados y centralizados en una basede datos de la red o corporación ambiental, en esta etapa los datos pueden o noser confiables, por lo tanto son declarados como no validados.

3. La información de mediciones de calidad de aire se almacenan en la base dedatos y entran en un proceso de validación para asegurar su confiabilidad, esteproceso es llevado a cabo por la entidad ambiental mediante el uso de diversastécnicas, por lo tanto es responsabilidad de la entidad ambiental la calidad deldato que se reporta.

4. La información validada y confiable es puesta en una vista con la estructuradefinida en el numeral 3.3, debe única y exclusivamente con esta estructura conel fin de estandarizar este mecanismo para todas las corporaciones ambientales.

5. La aplicación o el componente lee la información de la vista única yexclusivamente de los datos que han tenido una fecha de modificación posteriora la última actualización.

Entiéndase por fecha de modificación cuando el dato cambia de estado no validoa valido o cuando su concentración es cambiada por alguna razón y de estamanera realizar una actualización en el SISAIRE.

6. La información es enviada al SISAIRE usando tecnología por medio de Internet,el servidor captura, valida y la ingresa o actualiza en el sistema.

4. DESCRIPCION TÉCNICA DEL COMPONENTE QUE ENVIA LAINFORMACION

El cliente del web service es una aplicación basada en tecnología java con las ventajas

que ofrece, es multiplataforma.

Contiene los drivers o controladores de conexión que permiten el soporte de las bases

de datos más comunes con el fin de que la aplicación sea estándar para cualquier

plataforma y varias fuentes de datos, de esta manera con una debida configuración se

pude utilizar el cliente sin necesidad de recompilar las clases.

Para el envío de los datos capturados la aplicación se basa en tecnología RMI

(Invocación Remota de Métodos), esto permite un objeto que se está ejecutando en

una Máquina Virtual Java (VM) llamar a métodos de otro objeto que está en otra VM

diferente. Teniendo en cuenta lo anterior el cliente del WebService agrupa una lista de

objetos con la información capturada de la vista de la base de datos de la corporación

ambiental, posteriormente se ejecuta un método remoto enviando como parámetro la

lista de objetos utilizando RMI a través de la red de internet y ejecutando el llamado a la

url de SISAIRE(Otra máquina virtual), en esta instancia la responsabilidad del proceso

corre por cuenta del servidor de SISARE quien se encarga de analizar el paquete,

validar su integridad, su formato y realizar el proceso de modificación o inserción según

sea el caso.

5. REQUERIMIENTOS PRE-INSTALACIÓN

5.1. REQUERIMIENTOS DE SOFTWARE

5.1.1. JAVA RUNTIME ENVIRONMENT

La máquina destino debe tener instalado el “Java Runtime Environment – JRE” versión1.5.0 o superior. Para verificar que Java esté instalado y la versión corresponda,ejecute en una ventana de comandos (o consola en máquinas Unix-Linux) java –version. El sistema debe responder con un mensaje similar a:

java version "1.5.0_09"Java(TM) 2 Runtime Environment, Standard Edition (build1.5.0_09-b03)Java HotSpot(TM) Client VM (build 1.5.0_09-b03, mixed mode)

Si Java no está instalado en la máquina, diríjase al enlace de Sun Microsystemshttp://java.sun.com/javase/downloads/index_jdk5.jsp desde donde podrá descargar einstalar la versión de java 1.5.0 Runtime Environment correspondiente a su sistemaoperativo.

NOTA: Si usted está seguro que en la máquina se encuentra instalado el JRE, pero alejecutar el comando java –version el sistema reporta que no se encuentrainstalado, es necesario que se configure la variable de entorno del sistema operativoJAVA-HOME. Para ello es necesario:

- En Máquinas Windows: Diríjase a las propiedades del computador.

- ubique la pestaña “Avanzadas” y en ésta seleccione la opción “Variables deEntorno”.

- En esta nueva ventana, bajo el título de “Variables de Sistema” adicione unanueva variable seleccionando el botón “Nueva” y en el ingreso de los datos, enNombre coloque JAVA-HOME y en Valor coloque la ruta donde se encuentra eldirectorio de instalación de Java.

- Acepte los cambios realizados.- En máquinas Unix – Linux: Ingrese al sistema con privilegios de

administración(root). Luego, haciendo uso de cualquier editor de texto (pare elcaso de este ejemplo se usará Vi) edite el archivo /etc/bash.bashrc :# vi /etc/profile

- En el editor, adicione las siguientes líneas (debe tener cuidado de cambiar laruta a la correspondiente a su instalación de Java, si no conoce el path deinstalación ejecute el comando which java):export PATH=$PATH:/usr/java/jdk1.5.0_07/binexport PATH=$PATH:/usr/java/jdk1.5.0_07/bin

- Guarde y cierre el archivo.

NOTA: Es probable que se utilice un paquete de instalación de acuerdo a la distribuciónde Linux que se tenga instalada. Cuando se instala Java a partir de uno de estospaquetes, el programa de instalación genera y ejecuta los comandos necesarios paraestablecer las variables de entorno necesarias, en cuyo caso las anterioresinstrucciones no deben ser ejecutadas.La configuración en Unix –Linux se debe realizar con el usuario root, debido a que sedeben editar archivos en carpetas del sistema y se debe tener permisos de acceso,modificación y ejecución.

5.1.2 BASE DE DATOS

El cliente que se va a instalar obtiene la información necesaria a enviar al SistemaSisaire a partir de una base de datos que almacene la información correspondiente alas mediciones.

Inicialmente, ésta aplicación ofrecerá soporte a las siguientes bases de datos:

- Microsoft SQLServer 2000 / 2008- Oracle 10g (o inferiores)- MySql- PostgreSQL

5.2 Requerimientos de Hardware:

Técnicamente la maquina encargada de ejecutar el cliente del WebService debe tenercomo mínimo los siguientes requerimientos de hardware

Memoria: 256 Mb Ram

Procesador: Cualquier marca pero es importante que sea a mas de 1 Ghz

Conectividad o acceso via LAN al servidor de Base de Datos donde se ha creado lavista.

Acceso a Internet como mínimo con un canal de 128 Kb de subida para el envío dela información.

La aplicación ha sido diseñada para ocupar el mínimo espacio posible dealmacenamiento en su sistema y aprovechar al máximo los recursos de procesamientoy conectividad. No obstante, el sistema guarda un Log de los envíos realizados, el cualcrecerá en la medida que se configure el tiempo de envío de información a través de latarea programada en su sistema. No obstante, se prevé un crecimiento no mayor a5Mb /mes del archivo de Log, periodo en el cual es conveniente hacer una copia deseguridad de este archivo y eliminarlo del sistema (el archivo se crea automáticamentela siguiente vez que se lance el programa).

Igualmente, es necesario que la máquina en que sea instalada la aplicación tengaconectividad a internet y a su red interna, ya que el propósito de éste software es elenvío de información hacia un Web Service programado en modo escucha en el

Sistema Central mediante la consulta de la información a una base de datos, de la cualobtendrá la información necesaria para reportar.

6. Instalación del Software

6.1. Instalación

El cliente viene distribuido en 2 carpetas de acuerdo al sistema operativo destino. Laprimera carpeta, marcada Windows, contiene la aplicación y las librerías necesariaspara ejecutar el cliente en máquinas con sistemas operativos Microsoft Windows (XP,Vista 32, Vista 64, Server 2000 y Server 2003) y la segunda carpeta, marcadaUnixLinux, contiene la aplicación y las librerías necesarias para ejecutar el cliente enmáquinas con sistemas operativos Unix y Linux.

El proceso de instalación de la aplicación se debe llevar a cabo de acuerdo a lossiguientes pasos:

- Ingrese a la máquina destino con permisos de administrador.- Cree una carpeta nueva (el nombre no es arbitrario, pero se recomienda

ReporteSisaire) en su disco duro (o en cualquier partición en Linux. Serecomienda usar la partición /opt).

- Copie el contenido de la carpeta de instalación de acuerdo a su sistemaoperativo en la carpeta que se creó en el paso anterior.

SoftwareCliente Web

ServiceBase

deDatos

Log

InternetLan

Acceso Local

Maquina Entidad AmbientalSERVIDOR

WEB SISAIRE

SISAIRE

6.2. Configuración de Base de Datos Fuente (Autoridad Ambiental)

Como se apuntó en el numeral anterior, el cliente obtiene la información a reportar apartir de una base de datos, por lo que es necesario que se ejecuten algunas tareas deconfiguración en ella para que la obtención de la información resulte en un procesoexitoso.

La aplicación se conectará a la base de datos y buscará una vista, la cual consultará yobtendrá los datos, que serán encapsulados en un paquete y los enviará al sistemaSisaire para su procesamiento. La vista debe ser creada teniendo en cuenta lossiguientes aspectos:

- La vista puede ser nombrada arbitrariamente, y como se verá en el numeralsiguiente, el nombre que se coloque a ésta vista deberá ser pasado comoparámetro a la aplicación.

- Se debe tener especial cuidado en el manejo de los campos de fecha. ParaSQLServer se recomienda el uso de DateTime, en MySql Date y en postgres yOracle TimeStamp.

- Los campos que deberá tener ésta vista son:o NombreEstación (Alfanumérico)o Variable (Alfanumérico)o Unidad (Alfanumérico)o FechaInicio (Fecha)o FechaFin (Fecha)o FechaModificacion (Fecha)o Concentracion (Numérico [Double - Float])o MSFLCode (Alfanumérico, ver numeral 3 respecto a datos y validación)

- Es importante que los tipos de datos sean los aquí indicados. Si es necesario,ejecute los castings o conversiones necesarias en la creación de la vista paraque correspondan con el listado.

A continuación se envía pantallazo del cómo debe estar configurada la vista, paramotores de base de datos Oracle y Sql Server.

VISTA ORACLE

Un punto importante para la configuración de la vista son las fechas, las cuales debenestar con el formato que se muestra en la imagen.

El sistema también aceptará el tipo de fecha en Oracle como se ve a continuación.

VISTA SQL SERVER

Los tipos de fecha deben llevar el siguiente formato que se muestra en la imagen.

6.2.1. Configuración y validaciones de la aplicación en la vista

Como se deben reportar las variables de Calidad del Aire:

Se adjunta tabla en la que se pueden ver claramente dos columnas, en la primeracolumna “VARIABLE” veremos la variable que debe ir en la vista, del mismo modo en lacolumna “NOMBRE”, veremos lo que quiere decir cada sigla. Se debe tener en cuentaque la variable en la vista debe ir tal cual se ve en la columna “VARIABLE” para que elcargue por medio del webservice sea correcto.

VARIABLE NOMBRE

1 C2H4O Acetaldehído

2 H2S Acido Sulfhidrico

3 C4H8O2 Acido butírico

4 AMON Amoniaco

5 C6H12 Benceno

6 C4H10S ButÍl mercaptano

7 Cd CADMIO

8 C2H5CLO Clorofenol

9 S2CL2 Dicloruro de azufre

10 C8H8 Estireno

11 C2H5SH EtÍl mercaptano

12 C5H8O2 EÌÍl acrilato

13 TPH Hidrocarburos totales

14 PST MATERIAL PARTICULADO

15 MRC MERCURIO

16 CO MONOXIDO DE CARBONO

17 CH3SH MetÍl mercaptano

18 CH5N MonometÌl amina

19 NO Monóxido de nitrógeno

20 C6H5NO2 Nitrobenceno

21 SO2 OXIDOS DE AZUFRE

22 NO2 OXIDOS DE NITROGENO

23 NOx Oxidos Nitrosos

24 OZONO Ozono

25 Pb PLOMO

26 PM10 PM10

27 PM2.5 Partículas suspendidas menores a 2,5 micras

28 C3H8S PropÍl mercaptano

29 C2H6S Sulfuro de dimetilo

30 TLN Tolueno

31 V VANADIO

Se debe tener presente, que como se ve en la imagen cuando se reportan variables decalidad del aire, el campo llamado MSFLCODE, en la vista debe estar con null, de locontrario el cargue por medio del webservice generará errores. Las unidades en que sereportarán las variables deben estar en minúscula, los tipo de unidades válidos serán(ppm, ppb, g/m3).

Como se deben reportar las variables Meteorológicas:

Se adjunta tabla en la que se pueden ver claramente dos columnas, en la primeracolumna “VARIABLE” veremos la variable que debe ir en la vista, del mismo modo en lacolumna “NOMBRE”, veremos lo que quiere decir cada sigla. Se debe tener en cuentaque la variable en la vista debe ir tal cual se ve en la columna “VARIABLE” para que elcargue por medio del webservice sea correcto.

MSFL_CODE MSFL_NAME

1 BrS_SSR Brillo Solar

2 DViento_SSR Dirección del viento

3 Evap_SSR Evaporación

4 HAire10_SSR Humedad del aire a 10 m

5 HAire2_SSR Humedad del aire a 2 m

6 HAire?h_SSR Humedad del aire a diferente altura

7 HSuelo10_SSR Humedad del suelo a 10 cms

8 HSuelo30_SSR Humedad del suelo a 30 cms

9 HSuelo50_SSR Humedad del suelo a 50 cms

10 HAire10_VTO_SSR Humedad del viento a 10 m

11 HAire2_VTO_SSR Humedad del viento a 2 m

12 PLiquida_SSR Precipitación liquida

13 PSolida_SSR Precipitación sólida

14 P_SSR Presión atmosférica

15 RDif_SSR Radiación difusa

16 RGlobal_SSR Radiación Global

17 RUVb_SSR Radiación ultravioleta

18 RVisible_SSR Radiación visible

19 TCM_SSR Temperatura de Capa de Mezclado

20 TSuelo_SSR Temperatura del suelo

21 TAire10_SSR Temperatura del aire a 10 m

22 TAire2_SSR Temperatura del aire a 2 m

23 TAire?h _SSR Temperatura del viento a diferente altura

24 TSuelo10_SSR Temperatura del suelo a 10 cms

25 TSuelo30_SSR Temperatura del suelo a 30 cms

26 TSuelo50_SSR Temperatura del suelo a 50 cms

27 TAire10_VTO_SSR Temperatura del viento a 10 m

28 TAire2_VTO_SSR Temperatura del viento a 2 m

29 VViento_SSR Velocidad del viento

En caso de querer reportar por medio del webservice variables meteorológicas, esnecesario que en el campo MSFLCODE, se ingrese la variable que se quiere reportar(Cualquiera descrita en la tabla anterior), en el caso de la imagen adjunta se reportarála variable “Taire2_SSR = Temperatura del aire a 2 metros”, como nos podemos darcuenta, los campos llamados “VARIABLE” y “UNIDAD” en los registros 4 y 5 de laimagen, deben ir en null, para que el cargue por medio del webservice no genereningún tipo de error.

Validaciones generales sin importar tipo de variable

1. Las FECHAINICIO debe ser menor a la FECHAFIN.2. En el caso de cargues por medio del webservice, la diferencia entre

FECHAINICIO y FECHAFIN, es de 1 hora, lo óptimo es que sean horascompletas, por ejemplo de (“01:00:00 p.m. – 02:00:00 p.m.”, “02:00:00p.pm. –03:00:00 p.m.”).

3. El formato de las fechas (FECHAINICIO, FECHAFIN, FECHAMODIFICACION)debe ser “dd/mm/yyyy hh:mm:ss a.m.” o “dd/mm/yyyy hh:mm:ss p.m.”,dependiendo la hora del día que este reportando.

4. El nombre de la estación que se muestra en la vista debe estar escrita tal cualestá escrita en el SISAIRE, por ejemplo, no es lo mismo Estación a estación, encaso de que se reportara algo parecido no encontrará sencillamente la estacióny la aplicación presentará errores.

6.3. Configuración de la aplicación

Una vez que la aplicación ha sido instalada, es necesario configurar una serie deparámetros en el software para permitir la conectividad con el Web Service y con laBase de Datos.

Inicialmente, en el directorio de instalación del software, ubique el archivoconfig.properties y edítelo con su editor de textos favorito. En este archivo encontrará 7secciones identificadas por sus respectivos títulos, sobre las cuales vamos a realizarlos cambios necesarios para afinar el software:

- En Datos Generales: Coloque en el valor NombreCliente el nombre de suentidad, en Mayúscula sostenida. En el valor NitCliente coloque su númerode Nit sin código de verificación. En Red, coloque el número de la Red a la cualpertenece su entidad (Si usted es una Red, coloque aquí su númerocorrespondiente). Si no poseen o no conocen éste número, comuníquese con elIDEAM mediante la cuenta de correo administradorsisaire@ideam.gov.co, através de esta se le orientará respecto a este dato. Finalmente en el campoCorreoElectronico, coloque una dirección de correo válida, la cual seráutilizada por el Web Service para reportar posibles errores o problemasencontrados en la validación o cargue de la información.

- En configuración de la Base de Datos: en el valor Database coloque el valorcorrespondiente a su base de datos, teniendo cuidado de tomar éste valor de lalista allí indicada o de 1=Oracle, 2=Postgres, 3=Sybase, 4=MySql, 5=SQLServer.

- En datos de Conexión: Se debe modificar la URL correspondiente de acuerdo ala selección efectuada en el ítem anterior. Los cambios que se deben realizarson:

o url_db_oracle=jdbc\:oracle\:thin\:@10.10.0.1\:1521\:BaseDatos :Cambie el valor de la IP 10.10.0.1 por la IP correspondiente a su servidor de Base deDatos. Si ha modificado el puerto de escucha en el servidor de base de datos, esnecesario modificar este valor reemplazando el dato 1521 por el correspondiente (si noconoce esta configuración, es necesario que se comunique con su DBA). Finalmente,cambie el valor BaseDatos por el correspondiente a la instancia a la que se deseaconectar.

o url_db_postgres=jdbc\:postgresql\://localhost/BaseDatos : Cambie elvalor localhost por el correspondiente a su servidor de base de datos (puede ser una IP).Cambie el valor BaseDatos por el nombre de la base de datos a la que se deseaconectar.

o url_db_sqlserver=jdbc\:sqlserver\://localhost:1433;databaseName=BaseDatos; : Se debe cambiar el valor de Localhost por el correspondiente al servidorde base de datos (e instancia si el servidor tiene configurada mas de una instancia).Igualmente debe verificar que el puerto de escucha corresponda al 1433, o modificareste valor por el correspondiente (si no conoce esta configuración, es necesario que secomunique con su DBA). Modifique el valor BaseDatos por el nombre de la base dedatos a la que se desea conectar.

o url_db_mysql=jdbc\:mysql\://localhost/BaseDatos : Cambie el valorlocalhost por el correspondiente a su servidor de base de datos (puede ser una IP).Cambie el valor BaseDatos por el nombre de la base de datos a la que se deseaconectar.

- En Drivers de Conexión: No modifique nada.- En Información de Base de Datos: En el valor DatabaseName coloque el

nombre de la base de datos en la cual se encuentra almacenada la informacióna reportar. En los campos DatabaseUser y DatabasePwd coloque el Login y el

Password de un usuario con privilegio de consulta en la base de datos. En elvalor VistaName, coloque el nombre de la vista que creó en el numeral 2.1.

- En Ruta de Acceso al Web Service: No modifique nada. Si en un futuro el puertode escucha es modificado, se le informará oportunamente para que ejecute elcambio correspondiente en éste valor.

- Ruta de Acceso al Log: modifique el valor de LogPath por el correspondiente alsitio en el cual desea almacenar el Log (Este valor preferiblemente debe serconfigurado con el valor correspondiente al directorio de instalación delsoftware).

- Guarde los cambios y cierre el archivo.

Una vez que haya finalizado con la ejecución de estas tareas, debe proceder aconfigurar el registro de control de envíos. Para ello, edite el archivoconfigVolatile.properties y modifique el valor de LastUpdateDate a la fecha de suúltimo reporte de información deseada (El sistema buscara datos a partir de la fecha aliprogramada). El campo que se encuentra junto a la fecha corresponde a la hora del díaen que se envió la información. Preferiblemente coloque este valor en formato militar:00 a 23 (Por ejemplo, si su último envío de información fue ejecutado el 24 denoviembre de 2008 a las 2 de la tarde, este valor debe quedar 2008-11-24 14). Una vezfinalice con las modificaciones, guarde y cierre el archivo (NOTA: este archivo debe sermodificado solo en la instalación. Una vez que el sistema haya sido configurado y hayainiciado su proceso de envío de información, este archivo no debe ser abierto nimodificado).

El último paso en la configuración del software corresponde a la configuración de laruta de ejecución en el archivo Reporte.bat (o Reporte.sh). Para iniciar, edite estearchivo con su editor de textos favorito y modifique las rutas de acceso a los archivosconfig.properties y configVolatile.properties que allí aparecen al directorio de instalacióndel software. Por ejemplo, si usted instaló el software en una máquina con sistemaoperativo Windows (cualquier versión) en la carpeta C:\Sisaire\Software, deberíamodificar las rutas quedando java -Dconfig.properties= C:\Sisaire\Software\config.properties -DconfigVolatile.properties=C:\Sisaire\Software\configVolatile.properties -jar ReporteSisaire.jar .

Si usted instaló en una máquina con sistema operativo Unix o Linux, es necesario queasigne permisos de ejecución al archivo Reporte.sh. Para ello, en una ventana deconsola, como administrador, digite el comando chmod a+x path/to/Reporte.sh,teniendo cuidado de cambiar el valor path/to/ por la ruta donde se encuentra el archivoReporte.sh.

6.4. Configuración de Tarea Programada

El sistema una vez instalado requiere que una persona lo ejecute cada vez que secumpla el tiempo previsto para el reporte. Para evitar esto, es necesario crear unprocedimiento que permita que el sistema ejecute automáticamente el software en unlapso de tiempo determinado. Para ello se deben seguir los siguientes pasos:

- En máquinas Windows: Ubique la aplicación “Schedule Tasks” o “Programadorde Tareas”

- En el programador de tareas seleccione la opción Nueva Tarea, la cual iniciaráun wizard de configuración.

- Acepte el mensaje de la primera ventana. En la nueva ventana que se abre,ubique el archivo reporte.bat que quedó almacenado en la carpeta de instalacióny seleccione “Siguiente”.

- Seleccione la periodicidad con la cual se debe ejecutar el envío de información yseleccione “Siguiente”.

- Configure la hora de envío y la fecha a partir de la cual desea que se ejecute yseleccione “Siguiente”.

- Ingrese los datos del administrador para que la tarea se ejecute sin intervenciónde un usuario, seleccione “Siguiente”, verifique en el resumen la información yfinalice.

NOTA: Si desea que la tarea se ejecute a nivel de horas, es necesario que ingrese a latarea creada y configure los datos necesarios.

- En máquinas Linux: Es necesario que ejecute el comando crontab –e y añadauna línea de acuerdo al siguiente esquema: [minutos] [hora] [día] [mes] [día desemana] [comando]. Si alguno de los datos no va, se llena su lugar con unasterisco (*).

- Puede añadir una línea de comentario iniciando ésta con el carácter #.

- Recuerde que el comando que se debe ejecutar es Reporte.sh.

- Ejemplo:

# Envio todos los dias a las 6:00 AM

0 6 * * 1-7 exec /opt/ReporteSisaire/Reporte.sh

- Una vez finalice con la edición del crontab, guarde los cambios y reinicie elsistema

7. DESCRIPCION ARCHIVOS DE LA APLICACIÓN

La aplicación cliente del Webservice de SISAIRE consta de varios archivos deejecución y de configuración para su correcto funcionamiento. La aplicación seencuentra contenida dentro de la carpeta “Cliente Web service” dentro de la carpeta“Capa Desktop” de los “recursos de la aplicación”.

Internamente se encuentran 2 carpetas, una carpeta llamada “UnixLinux” y otra llamada“Windows” según el sistema operativo donde se desee ejecutar la aplicación, cabeaclarar que el contenido de ambas carpetas y básicamente el mismo y solo difiere en elarchivo que lanza la aplicación que en el caso de Windows es llamado “Reporte.bat” yen unix o Linux “Reporte.sh” y sus el código interno difiere debido a la estructura dedirectorios de cada Sistema Operativo.

La descripción de cada uno de los archivos y carpetas de la aplicación se describe acontinuación:

Carpeta “Lib” En esta carpeta se encuentran las librerías de la aplicación(archivos *.jar) que son los encargados de dotar la aplicación defuncionalidad adicional como acceso a diferentes bases de datos,lógica de negocio del acceso a datos, soporte para el webservice,librería para la lectura de archivos de propiedades, entre otros.

ReporteSisaire.jar Esta archivo es la aplicación encargada de leer la vista que hacreado la corporación ambiental con el fin de leer los últimos datosreportados con el fin de sincronizar los datos con el Sisaire, haceuso de las librerías para obtener al acceso a datos, al webservice ya los archivos de propiedades, podría ser considerada como laaplicación principal y la encargada de realizar el proceso delectura, validación y envío de las mediciones reportadas por laestaciones.

config.properties Este archivo es el encargado de almacenar la configuración de laaplicación, según su motor de base de datos, información deaccesos a la misma, mail de notificación, entre otros parámetros,para más información ver Numeral 6.3.

configVolatile.properties Este archivo es el encargado de almacenar la fechade la última actualización, este archivo solo se debe editar en elprimer uso de la aplicación, después de puesta en marcha no esrecomendable editarlo ya el archivo se va auto escribiendo. Paramás información ver Numeral 6.3.

Reporte.bat(Windows) o Reporte.sh(Linux)

Este archivo es el encargado de lanzar la aplicación y enviar losparámetros correspondientes a la maquina virtual de java para sucorrecta ejecución.

Un ejemplo del contenido de este archivo es el siguiente:

En el caso WINDOWS:

java -Dconfig.properties=C:\ReporteSisaire\config.properties -DconfigVolatile.properties=C:\ReporteSisaire\configVolatile.properties -jar ReporteSisaire.jar

En este caso los archivos de propiedades se encuentran dentro deldirectorio ReporteSisaire en el disco local “D:\”, y se asume que elarchivo ReporteSisaire.jar se encuentra en el mismo directorio queel archivo Reporte.bat.

Nota: Si los directorios o archivos no existen la aplicación nofuncionara. La configuración anterior estará por defecto en laaplicación.

En el caso LINUX:

java -Dconfig.properties=/opt/ReporteSisaire/config.properties -DconfigVolatile.properties=/opt/ReporteSisaire/configVolatile.properties -jar /opt/ReporteSisaire/ReporteSisaire.jar

En este caso la única diferencia es la estructura de los directoriosde la aplicación, que en Linux se interpreta desde la raíz.

Para más información ver Numeral 6.3.