5

Manual Instalacin y Operacin Cliente Comunicaciones

Manual de Instalacin, Configuracin y
Uso del Cliente de comunicaciones
Fecha: 23-10-2012
5
Manual Instalacin y Operacin Cliente Comunicaciones

Contenido
...........................................................................................................................................2
1.Objetivo...........................................................................................................................3
2.Alcance............................................................................................................................3
3.Terminologa...................................................................................................................3
4.Instalacin........................................................................................................................3
4.1.Instalacin !el cliente !e com"nicaciones....................................................................3
4.1.1.Obtenien!o #ava .......................................................................................................3
4.2.$eri%ican!o los conteni!os !e la a&licacin ................................................................4
4.3.'on%ig"ran!o &ar(metros.)ml .....................................................................................*
4.3.1.Obtenien!o "n !river #+,' a!ec"a!o......................................................................*
4.3.2.'on%ig"ran!o la cone)in a s" ,ase !e !atos...........................................................-
4.3.3.'on%ig"racin &ara cone)in al servi!or './T0A1...............................................2
*.3tili4an!o la a&licacin...................................................................................................2
-.5obre la "bicacin !el a&licativo 6 &oltica !e "so.........................................................7
5
Manual Instalacin y Operacin Cliente Comunicaciones
Manual del agente de comunicaciones
1. Objetivo
Establecer y mantener un canal de comunicacin permanente entre las
diferentes empresas involucradas y el el centro principal donde residira la
informacin.
2. Alcance
Este manual y el software adjunto suponen que se dispone de acceso a un
sistema gestor de bases de datos que disponga de un driver jdbc y acceso a
interner permanente.
3. Terminologa
TCP/IP: 8rotocolo !e com"nicaciones !e alto nivel9 &rovee con%iabili!a! !e llega!a !e
!atos.
Java: &lata%orma !e !esarrollo !e so%t:are9 &rovee "na ma;"ina virt"al <#$=>9 ;"e
ejec"ta b6teco!e <c!igo inter&reta!o !e java> !e %orma ;"e este &"e!a ser ejec"ta!o en
c"al;"ier &lata%orma ;"e tenga "na ma;"ina virt"al !e java !is&onible.
XML: 5tan!ar! !e !oc"mento &ara estr"ct"racin !e !atos9 se "sa am&liamente como
interme!iario en sistemas !e com"nicacin
J!C: est(n!ar !e cone)in a !ata tab"lar <bases !e !atos> !es!e la &lata%orma java.
river J!C: es "na a&licacin &"ra hecha en java seg?n las es&eci%icaciones #+,'9 se
!istrib"6e como "n archivo .jar
4. Instalacin
4.1. Instalacin del cliente de comunicaciones
.l agente !e com"nicaciones %"e !esarrolla!o en java 1.-9 6 &or tanto se re;"iere !e
"na versin !e java9 ig"al o s"&erior9 &ara &o!er ejec"tarlo. #ava mantiene
com&atibili!a! con s"s versiones &osteriores9 &ero "na versin anterior a 1.- no &o!r(
ejec"tar la a&licacin.
4.1.1. Obteniendo Java
ara verificar si tiene java puede !acer lo siguiente desde la l"nea de
comando.
odr"a tener java instalado y sin embargo no poder ejecutar el anterior
comando# una manera m$s tradicional pero no tan segura seria verificar la
carpeta arc!ivos de programa%
5
Manual Instalacin y Operacin Cliente Comunicaciones
&i tiene las carpetas jre y jd'# es que instalo en alg(n momento java en su
sistema.
&i !a verificado que no tiene el jd' instalado puede obtenerlo de aqu"
htt&:@@:::.oracle.com@technet:orA@java@javase@!o:nloa!s@in!e).html al tiempo
de escribir esto la (ltima versin disponible es la ).*u+, pero cualquiera
).*.5 o superior basta%
El proceso de instalacin es directo y sin ning(n apartado digno de mencin.
4.2. eri!icando los contenidos de la a"licacin
-a aplicacin se distribuye en un comprimido que adem$s de este manual
contiene otro arc!ivo comprimido llamado ClienteCCM../ip esta es la
aplicacin en si# los contenidos deber"an ser como sigue%
0 1escomprimirla en una ruta sin espacios2# se interpretan los espacios
como cambio de nombre de carpeta y por tanto# se tendr"a problemas
para la deteccin de los recursos de la aplicacin.
Arc#ivo ClienteCC$%.jar este el arc!ivo principal al cual se puede !acer
doble clic' y ejecutarse.
Car"eta con!& contiene un arc!ivo de configuracin# llamado
arametros.3ml se detalla como alterarlo posteriormente. Es necesario
tener un arc!ivo en esta ruta relativa a el arc!ivo 4ar# esto es dentro de
una carpeta llamada con!# debe !aber un arc!ivo llamado
arametros.3ml
Car"eta 'ib% contiene un driver para una base de datos embedida que se
utili/a para loguear los env"os a central# adem$s recomendamos que
coloque aqu" el driver para su base de datos en particular.
5
Manual Instalacin y Operacin Cliente Comunicaciones
4.3. Con!igurando "ar(metros.)ml
5brir arametros.3ml con el editor de su preferencia
.n la imagen se ve "n ejem&lo ;"e "sa 5B1 server 200*.
4.3.1. Obteniendo un driver J*+C adecuado.
$irt"almente to!os los gestores !e bases !e !atos mo!ernos tienen "n !river #+,'9 &or
ejem&lo las sig"ientes &(ginas tienen los !river &ara Oracle 6 8ostgres;l
5
Manual Instalacin y Operacin Cliente Comunicaciones
Aseg?rese !e "sar la versin ig"al a s" base !e !atos <a"n;"e generalmente la "ltima
tambiCn %"nciona con versiones anteriores !e la base !e !atos> !is&onible &ara s" ,+.
+escarg"e el !river #+,' <este es "na archivo con la terminacin .jar>. +on!e obt"vo s"
!river tambiCn est( la !oc"mentacin ;"e e)&lica como armar la 301 6 la clase
&rinci&al necesitara esto en el "aso siguiente.
4.3.2. Con!igurando la cone)in a su +ase de datos
1.1. ,uta al disco al driver J*+C -"ar(metro *,I.,
*,I.,/'OCATIO0 en el 1$'2
Es la ruta absoluta al driver 416C que usara para conectarse a su base
de datos. Es el arc!ivo .jar que obtuvo en el paso anterior.
es la clase del driver jdbc #este par$metro se encuentra en la
documentacin del driver jdbc que est$ usando.
1.2. Clase "rinci"al del driver J*+C -*,I.,/C'A33 en el 1$'2
Es la clase principal del driver jdbc# se necesita para iniciali/ar el driver
jdbc.or ejemplo para todos los driver que acceden a postgres esto es%
org.postgresql.Driver
1.3. 4,' a la +ase de datos -+*/4,' en en 1$'2
7bicacin de su 61# seg(n el formato de su driver jdbc# como el
par$metro anterior depende enteramente del driver que use.8evise la
documentacin% por ejemplo la 78- para &9- server# todas las
versiones es asi%
jdbc:sqlserver://127.0.0.1\SQL2005:1433;dtbse!"e#pr$eb
).:. 43.,;7suario de su 61 que ejecutara una consulta como se
muestra abajo# &e recomienda crear un usuario con solo permisos de
lectura# y solo para las tablas que forman parte de la consulta 0 vea
par$metro 97E8< 2.
).5. 5A336O,*; clave del usuario anterior
1.7. %ormato de !ec#as - *AT./%O,$AT en 5arametros.)ml2
ej% =yyyy>MM>dd ??%mm%ss= formato de las fec!as de su base de datos#
lo anterior se traduce a por ejemplo% +@@A>@B>+* )+%:5%@@# si su base
de datos no acepta este formato por defecto puede configurarlo aqu"# la
5
Manual Instalacin y Operacin Cliente Comunicaciones
manera de como !acerlo se describe el la documentacin de
&imple1ate.ormater de java# puede encontrarse aqu"%
!ttp%CCjava.sun.comCjavaseC*CdocsCapiCjavaCte3tC&imple1ate.ormat.!
tml
1.8. alor indicativo de "(nico -5A0IC/A' en el 1$'2
Dalor que su base de datos usa para determinar que es un mensaje de
p$nico%
Ejemplos% E)F # EGF # EDF # E$nicoF# etc.% 0es tal como se muestra como
resultado de !acer la consulta 2.
).B. 94.,:% es una consulta &9-# la cual usted deber$ armar# la idea es
que se !ar$ una consulta con la frecuencia que requiera el ministerio.
&ea como fuere que armara esta consulta el resultado debe ser algo
como lo que sigue%
=============================================================
|Placa Longitud Latitud Rumbo Velocidad Fecha Pnico?|
============================================================
|AH1234|-!"123|-12!"123| 14 | " | 2""#-"$-"% 12&31&'%|1|
=============================================================
En cualquier caso los nombres que use en los campos no importan# pero
se depende de ese orden# as" que deber$ respetarlo e3actamente.
7nidades de los campos
C#MP$ U%I#
8laca $archar9 nvarchar9 o similar
1atit"!9 longit"! !ecimal
$eloci!a! 9 r"mbo &ntero
Fecha +ate <ver +AT.DFO0=AT>
8(nico '"al;"iera re&resentable como 5tring<ver
8A/I'D$A1>
Ejemplo de consulta 0 no funcionara sin modificarse2
&elect ve!iculos.-5C5# -OHIIG71# -5GIG71# 1I8ECCIOH# DE-OCI151#
.EC?5# JHICOK
.rom G56-5LMEH&54E& inner join G56-5LDE?IC7-O&
on G56-5LDE?IC7-O&.p' ; G56-5LMEH&54E&.uniLf'
M!ere .EC?5L16 N dateadd0minutes# >*@ #now02 2
Order by .EC?5L16 >> 7-GIM5 -IHE5 OCIOH5-
las ultimas + l"neas son importantes. &e establece dos comodines O# y P
que ser$n reempla/ados por fec!as enviadas desde el CCM.# pero
puede generalmente precindir completamente de ellos
-a ultima l"nea !ace un ordenamiento por fec!a# 0evitando desorden en la
informacin2
5
Manual Instalacin y Operacin Cliente Comunicaciones
0ota &lt es la manera de escapar el carcter < en XML que es el
formato con el que se almacena el archivo de configuracin, si
modifica esto desde un editor de texto tendr que marcar < como
&lt !
4.3.3. Con!iguracin "ara cone)in al servidor C.0T,A'
-os &iguientes par$metros deben editarse%
0O$+,.; 7n alias para su empresa# recomendamos usar un nombre
corto# por ejemplo EMiEmpresa1eMonitoreoI&F
I5/CC$%;=+@@.*@.):5.),@= Ip del CCM.# no deber"a cambiarse 0 es la I
publica contratada por el CCM.# solo se provee configurar esto en el
improbable caso que esta cambie
$3;/5O,T;=QQQ,= por defecto se le notificara de cualquier cambio que
!ubiera
<. 4tili=ando la a"licacin
5l iniciar el aplicativo se mostrara# la siguiente pantalla%
-uego de !acer modificaciones al aramentros.3ml reinicie el software y
verifique que los mensajes sean como lo siguiente%
2"11-ene-11 11&'%&3"
============= (one)ion e)ito*a con (+,-RAL ===============
2"11-ene-11 11&'%&3" .+,- =/ 01(R/
2"11-ene-11 11&'%&31 R+(V 0= get2d
2"11-ene-11 11&'%&31 .+,- =/ 01#"!1#1!1#2!122/
2"11-ene-11 11&'%&32 R+(V 0= 2"11-"1-11 11&''&"%32"11-"1-11 11&'%&"%
2"11-ene-11 11&'%&31 .+,- =/ 0A412343-"!1233-1$!'%4322"34'32"11-"1-11
11&""&""3,/
5
2"11-ene-11 11&'%&31 .+,- =/ 064"/
5
Manual Instalacin y Operacin Cliente Comunicaciones
Htese que al final se debe mostrar los registros que !a enviado y el total
de transmisiones.
1e lo contrario vera mensajes de error# verifique tenga acceso a internet y
si tiene un firewall !abilitado# podr"a ser necesario aRadir una regla para
permitir comunicaciones GC con la I que configuro antes esto es
+@@.*@.):5.),@.
Gambien es posible ejecutar el agente en modo te3to.
ara esto desde la consola ejecute el comando
java >jar ClienteCC$%.jar >te)t
7. 3obre la ubicacin del a"licativo ? "oltica de uso.
-a aplicacin puede Cerrarse simplemente con !acer clic' a la STU superior.
ero una ve/ iniciada debe asegurarse que siempre este ejecut$ndose#
informe al personal que utilice el servidor donde resida esta aplicacin
0debido a la caracter"stica de monitoreo +:CQC,*5 se necesita que la
aplicacin este activa siempre2 que no debe cerrar esta aplicacin.