Manual de Instalación y OpenGTS Configuracion

18/6/2015
ManualdeInstalacinyOpenGTSConfiguracion
Pgina1
OpenGTS
InstalacinyConfiguracin
Manual
Copyright20072014SolucionesGeoTelematic,Inc.
Todoslosderechosreservados
ConfiguracinOpenGTSyManualdeinstalacin
Pgina1de62
Pgina2
https://translate.googleusercontent.com/translate_f
1/51
18/6/2015
HistorialderevisionesManual
Revolucin
Fecha
Cambiado
Autor
0.0.1 25/03/2007Versininicial
MDF
0.0.2 30/03/2007Seagreginformacinparalaadministracintabla"Usuario"
MDF
0.0.3 22/04/2007Objetivosdehormigasdenivelsuperiormodificadosparaelevento,Mologogo,ylapistadeservletconstruye.
MDF
0.0.4 05/06/2007NotasaadidasparalosusuariosdeWindows.
CambiosdetipodeMenores,yloscambiosdeformatodeprrafo/pgina..
MDF
Todalalneadecomandossolicitaencursiva..AadidonotasobreelregistrodeunaclavedeGoogleMap.
0.0.5 25/05/2007NotasrelativasAadidosoporteparaMicrosoftVirtualEarth.
MDF
0.0.6 06/03/2007ActualizadoenlacesdedescargadeMySQL.IncluirAntenlacesdedescargav1.7.0.
NotasaadidasparalosusuariosdeWindowsenrelacinconelestablecimientodelasvariablesdeentornoacininstal.
MDF
0.0.7 13/06/2007Aadidodocumentacindeadministracindebasededatosadicional.
MDF
SeagregunanotaenrelacinconinstalingunintrpretedePerlenWindows.Errorestipogrficosmenoresfijos.
0.0.8 06/30/2007AadidoenlaceadicionalparasudescargaMySQLWinXP.
MDF
0.0.9 14/07/2007ComentariosadicionalessobreJavaBeansActivationFrameworkcambiosdenotasmenores.MDF
"Track.war".Cambiadoelnombredelcomando"server_mysql.*"Para"server_dmtp.*".
Comentariosadicionalessobrelaredesplieguede
0.0.10 27/07/2007Eliminadareferenciaalacreacindelacuentapordefecto"opendmtp",dispositivo"mvil",alinicializarlabasededatoscon"initdb".
MDF
quesonequivalentesacorrer"initdb".
ComandosAadido
0.0.11 08/09/2007Aadidoalgunoscomentariosadicionalessobreelservlet'Eventos'.
Aadidocomentariosrespectoalapersonalizacindelarchivoconfiguationtiempodeejecucindeservlets"webapp.conf".
MDF
<Tabla>...".ScriptdearranquedelservidorDMTPcambiadoa"runserver.shsgtsdmtp".
Tablacomandosdeadministracincambide"bin/admin<Tabla>.sh..."a"admin.sh
0.0.12 16/09/2007AadidocomentariosacercadelusodearchivosporlotesenWindows.
MDF
0.1.1 30/11/2007Aadidonotaadicionalsobreeluso'dbAdmin.pl"paraaadirquefaltancolumnasdelatabla.Cambiosdetextomenoreshicieron.
NotasAadidorespectoalusode'plantilla'y'GPRMC'paracrearservidoresdedispositivospersonalizada..
MDF
0.1.2 06/02/2008ComentarioaadidoderequisitospreviosencuantoalainflacininstaldeTomcatenLinux.MDF
0.1.3 17/02/2008SeagregunaseccindeInternacionalizacin/localizacin.
MDF
0.1.4 20/02/2008AadidocomentariosadicionalesdeconfiguracinregardindeTomcatenDebian/Ubuntu
Seagreginformacinsobrelaimplementacindeservidoresdecomunicacionesdeldispositivo.
MDF
0.1.5 03/28/2008JavaSDK5.0ahoraserequiereparaconstruirOpenGTS.
MDF
0.1.6 11/04/2008Sehaaadidounaseccinsobrelaspruebasacininstal
MDF
0.1.7 14/05/2008Seccin"Compilar"Actualizacinparaincluir"hormigatodos".AadidocomentariosadicionalesalaseccinLocalizacin..
MDF
0.1.8 20/06/2008Actualizadoubicacindelarchivo'private.xml'.Actualizadalainformacindeenlacededescargaparalosvariosmdulos.
MDF
0.1.9 08/07/2008ComentariosadicionalesconrespectoalaconstruccinAadidoelejemplodelservidor'plantilla'.
MDF
0.1.10 07/27/2008Aadidonotaconrespectoa'bindbConfig.bat\'comandodisponibleparausuariosdeWindows.
MDF
SeagreginformacinrespectoalapersonalizacindelmapaPasadores..
0.1.11 10/16/2008Varioscambiosmenores
MDF
0.1.12 01/12/2008Actualizadoseccin"Administracindebasededatos'
MDF
0.1.13 12/16/2008ActualizacindeApacheTomcatURLdedescarga
MDF
0.1.14 01/02/2009ActualizacionesVarios
MDF
0.2.0 02/04/2009AgregadoMacOSXinformacindeconfiguracin.Captulosreorganizado.
MDF
0.2.1 05/24/2009InicioAadidoadicional'dispositivoservidordecomunicaciones'/paradainformacin.
SeagregunaseccineninstalingMotoDMTP
MDF
0.3.0 01/07/2009Aadidonotasrelativasalapoyo"events.war"paraexportarloseventosconformatoGPX. MDF
enlavalidacindearchivosLocalStrings.
Seagregunaseccinde"Creacin/ModificacindeInformes".NotasAadido
0.3.1 02/08/2009Comentariosadicionalesaadidosconrespectoaluso"events.war"demapadeGoogleEarth,actualizacionesnotaconrespectoalapersonalizacind
MDF
0.3.2 08/23/2009Aadidocomentariosrespectoacorrer"runserver.bat"enWindows.ActualizadoTomcatversin5.5.28a.
MDF
0.3.3 30/10/2009Aadidoopcin'sendMail'almandatodeCheckInstall'.
MDF
0.3.4 06/18/2010Informatonactualizadasobre'runserver',iniciar/detenerlosservidoresdecomunicacionesdedispositivosyelusode'psjava'.
MDF
comunicacindeldispositivoficherodeconfiguracindeservidoresdetiempodeejecucin"dcservers.xml".
Seagreginformacinconrespectoala
0.3.5 08/07/2010AgregadoGTSseccindearquitecturadelsistema.Actualizadodiferentesenlacesprerequisitos.Actualizadopartida/paradaDCS.
MDF
0.3.6 10/09/2010Aadido"dispositivo"opcionesdeadministracinadicionales.Aadido"Columnasdelatablaopcionales"
MDF
0.4.1 08/03/2011ColocadodePrerrequisitosyOpenGTSinstalacionesencaptulosseparados.Captulosrenumerado.
MDF
basadoservidordecomunicacionesdeldispositivo.
Aadidoinformacinadicionalsobreel"GPRMC"http
0.4.2 04/01/2011AgregadoTrackstickCSVinformacindeimportacindedatos(v2.3.2).Errorestipogrficosmenoresfijos,etc.
MDF
0.4.3 21/08/2011Varioscambios.AgregadoJSONformatodearchivoaladescripcindel"events.war".ActualizacinJavaMaildescargaVersin/URL.
MDF
MduloTK10xDCS.
Aadidoinformacinsobrecmoiniciarla
0.4.4 12/27/2012MesaIncluidonombresdecampoopcionales.
MDF
0.4.5 11.20.13 Actualizarvnculos.
MDF
Pgina2de62
Page3
OpenGTSInstalacin/Configuracin
Contenidos:
1.Introduccin
1.1Plataformascompatibles
1.2ArquitecturadelSistema
1.3MejorasPlanificadas
1.4Convencionesdeldocumento
2Cargadelosmdulosderequisitosprevios
2.1JavaCompiler
2.2ApoyoJavaMail
2.3Apache"Ant"ConstruirHerramienta
2.4Apache"Tomcat"contenedorservlet
2.5BasededatosMySQLProveedor
2.6deMySQLcontroladorJDBC
3Instalacin/CompilacindelFuenteOpenGTS
3.1Descomprimir/InstalacindelaFuenteOpenGTS
2/51
18/6/2015
3.2Configuracindelasvariablesdeentorno
3.3CompilarelapoyoGTSBibliotecaArchivos
4deinicializacinypruebasdeinstalacin
4.1InicializandolastablasdebasesdedatosSQL
4.2Pruebadelainstalacin
4.3Cargadelosdatosdeejemplo
4.4CreacindelaCuenta"sysadmin"
5Instalacin"track.war"
5.1Configuracindelarchivo"webapp.conf"
5.2ConfiguracindelInformesdisponibles
5.3ConfiguracindelaPrivateLabelLookandFeel
5.4Compilar/Instalacindelservlet"track.war"
5.5Pruebadelainstalacin
5.6Instalacindevariasversionesde"track.war"
6Instalacin"events.war"
6.1Configurarelarchivo"webapp.conf"
6.2Compilar/Instalacindel"events.war"JavaServlet
6.3Comprobacindelainstalacin
Administracindebasesdedatos7
7.1Creacindecuentas/Edicin
7.2Creacin/EdicindeUsuarios
7.3Creacin/EdicindeDispositivos
7.4BasedeDatosGeneraldeFuncionesAdministrativas
8Instalacin/PuestaenmarchadelOpenDMTP,TK10xyMdulosAspicoreDCS
8.1Configuracindelarchivo"dcservers.xml"
8.2Iniciodelservidordecomunicacindedispositivos
8.3Detencindelservidordecomunicacindedispositivos
8.4Adicindeunnuevoregistrodedispositivos
9CreacindesupropioComunicacinDeviceServer
9.1Servidoresdecomunicacindedispositivosbasados
enHTTP(utilizandoelservlet"GPRMC")
9.1.1Configuracindelservlet"GPRMC"
9.1.2Configuracinpredeterminada"GPRMC"
9.1.3Construccindelservlet"GPRMC"
9.2RawSocketBasadoComunicacinDeviceServer
9.2.1Iniciodelservidordecomunicacindedispositivos
9.2.2Detencindelservidordecomunicacindedispositivos
ArchivodeconfiguracinXML9.3Runtime
Pgina3de62
Pgina4
OpenGTSInstalacin/Configuracin
Contenido:(continuacin)
10Internacionalizacin/Localizacin
10.1Apoyarunnuevoidioma
10.2Cambiodelidiomavisualizado
11Creacin/ModificacindeInformes
11.1InformedeDiseo.
11.2InformedeDatosIterator
11.3DefinicindelinformeXML
11.4DisponibleinformeEspecificaciones
Apndice:
A)SoporteparaMicrosoftSQLServer
B)ApoyoaMologogomvilesconcapacidad
C)TablaColumnasopcionales
D)InstalacinMotoDMTP
E)LaimportacindeGPSEventosdelTrackstickMini
3/51
18/6/2015
Pgina4de62
Pgina5
1.Introduccin
OpenGTS(OpenSourceGPSTestanterasSistema)tienelaintencindeofrecerunserviciobasadoenlawebdeserviciosdefondogenricopara
consultayvisualizacindedatosGPSrelacionados.SedesginedparaoperardeformaindependientedecualquierdispositivoderastreoGPSespecficoo
protocolo,perovieneconsoporteparavariosformatosdeprotocolodeldispositivo(comoOpenDMTPAbrirdispositivofuente
MonitoreoySeguimientoProtocolohttp://www.opendmtp.org).
EstdiseadoespecficamenteparasuusoenpequeasymedianasempresascomercialesquedeseentomarventajadeGPS
seguimientopara"flotas"devehculos.Sinembargo,OpenGTSesaltamenteconfigurableyescalableparaempresasmsgrandestambin.
Enelladodelservidor,OpenGTSestdiseadoparasereldispositivoyelprotocoloindependiente.Parautilizarlascaractersticasde
OpenGTS,necesitarunservidordecomunicacionesdeldispositivo/protocoloespecficoparaseraplicadoparacomunicarseconel
dispositivoremotoycolocarlosdatosenlabasededatosSQL.OpenGTSbarcosconsoporteparaOpenDMTP
(http://www.opendmtp.org)DemodoquelosdispositivoscompatiblesconOpenDMTPestarlistoparautilizarinmediatamentelosserviciosde
OpenGTS.Unservidordecomunicacionesdispositivopersonalizadotambinsepuedeimplementarutilizandolafuentedeservidordeejemploincluido
cdigo.Consulteelcaptulotitulado"CreacindesupropioComunicacinDeviceServer"paraobtenermsinformacin.
Porelladodelainterfazweb,lapresentacindeusuarioesfcilmentepersonalizableparaadaptarsealapersonadeseadamotivo.Opcionesdemen
ylascaractersticastambinsonfcilmentepersonalizableparaadaptarsealosrequisitosespecficos.
ElcdigofuenteparaelproyectoOpenGTSpuededescargardesdeSourceForgeenelsiguienteenlace:
https://sourceforge.net/projects/opengts/files/
(ConlicenciabajolaLicenciaApacheVersin2:http://www.apache.org/licenses/LICENSE2.0)
Exencinderesponsabilidad:
OpenGTS/OpenDMTPnodebenserutilizadosparacualquieractividadilegal.Losproveedoresdeesteproyectonoasumen
responsibityparacualquieractividadilegalquepuedenllevarseacaboporlosusuariosdeestesoftware.
1.1) Plataformascompatibles
OpenGTSseimplementacompletamenteenJavaydebefuncionarbienencualquiersistemaqueestotalmentecompatibleconelJavaRuntime
MedioAmbiente.Sinembargo,estaaplicacinrequiereunservidordebasededatosSQL,yporlotantoselimitatambina
sistemasenlosquesubasededatosSQLelegidoejecuta.VisiteelsitiowebdesoportedebasededatosSQLcorrespondienteparasu
sistemascompatibles(esdecir.paraMySQLver"http://www.mysql.org"QuehasidoprobadoconOpenGTSenLinux,Mac
OSX,FreeBSD,OpenBSD,ylasplataformas/Vista/WindowsXP20xx).
1.2) ArquitecturadelSistema
4/51
18/6/2015
EstegrficodescribelaarquitecturadelsistemabsicodelsistemadeOpenGTS.Losdiversoscomunicacindeldispositivo
servidores(losmdulosdelosqueescuchanparalosdatosentrantesdelosdispositivosdelocalizacinGPSremotos)seejecutancomoprocesosseparados
enlapartesuperiordeJava.ElservletTrack(esdecir.Lainterfazweb),ascomootrosservlets(incluyendocualquierdispositivobasadoenhttp
servidordecomunicaciones),ejecutedentrodeuncontenedorservlet,comoApacheTomcat.
Pgina5de62
Page6
1.3) MejorasPlanificadas
OpenGTSsiempreestevolucionando,ylasnuevascaractersticascontinuamenteseestnhaciendodisponibles.stossonalgunosgenerales
categorasdelascaractersticasqueseencuentranenlaetapadeplanificacinoimplementacin:
CaractersticasdelmapaAdicionales.
Informesadicionales.
GTSEnterprisefueconstruidosobreOpenGTSytienevariascaractersticasadicionalesdisponibles,as(msinformacin
conrespectoalaGTSempresase
puedeencontraren"http://www.geotelematic.com/gts.html"):
Soporteparavarios"usocomercial"proveedoresdeserviciosdemapeo.
SoporteparamuchosdispositivosdelocalizacinGPSadistanciaadicionales.
Lasopcionesadicionalesdepresentacindeinformes.
Motorsimple'Reglas'paraenviarnotificacionessobrelabasedecriteriosdeloseventosentrantes(mejoradolanotificacindeeventos
Reglasdelmotortambinestdisponible).
Pngaseencontactoconnosotrosconrespectoaladisponibilidaddeestasyotrascaractersticasal"opengts@geotelematic.com".
1.4) Convencionesdeldocumento
Conelfindeproporcionarundocumentodeinstalacin/configuracingenricaqueabarcadiversostiposdesistemas(esdecir.DeWindowsXP,
MacOSX,ylasdistintasdistribucionesdeLinux),ydelasdiversasversionesdelsistemaOpenGTS,lasiguiente
convencionesysupuestossehanadoptadoenestedocumento:
1)EstedocumentoseasumequeelsistemaoperativodedestinoestbasadoenLinux.Paraotrostiposdesistemasoperativos,
elseparadoresderutayespecificacionesdedirectorioapropiadotendrqueserutilizadoquecoincidanconlosrequisitosde
susistemaoperativoespecfico.MedioAmbienteespecificacinvariabletambinpuedevariarentresistemasoperativos.
Porejemplo,paradesreferenciaelentornoJAVA_HOMEvairable,"%JAVA_HOME%"seespecificaenun
SistemadeWindows,mientrasque"$JAVA_HOME"seespecificaenLinuxyMacOSX.
2)EstedocumentoseasumequeeldirectorioenelqueseinstalarnOpenGTSes"/usr/local/".Sisequiere
debeinstalarOpenGTSenundirectoriodiferente,ustedtendrquereemplazarlasreferenciasdedirectorioenestedocumento
aldirectorioenelqueseinstalOpenGTS.
3)OpenGTStieneuncalendariodelanzamientosfrecuentes.Paramantenerlacoherencia,estedocumentoasumequelaversinde
OpenGTSainstalares"OpenGTS_1.2.3".Asquelasreferenciasa"OpenGTS_1.2.3"dentrodeestedocumento
debeserreemplazadoporelnombrerealylaversindelOpenGTSquevaainstalar.
4)Endiversosejemplosdelneadecomandos,puedeverlaespecificacindedirectorio"/zzz".Estaespecificacines
simplementeunnombredemarcadordeposicinquerepresentaalgndirectorioactualenelsistema,ynounnombrededirectorioliteral
existenteenelsistema.
5)Envarioslugaresdentrodeestedocumento,lasopcionesdelneadecomandosseespecificancomo"argName=valor",donde
"ArgName"eselnombredeunargumentodelneadecomandos,yel"valor"eselvalorqueseasignaralmandamiento
argumentoine.AlintroducircomandosdeWindowsenunsmbolodelsistemaDOS(comocuandoseutilizael
".bat"versindeloscomandos),comandoargumentoscomorootUser=rootDEBENbienestarencerrados
entrecomillas,comoen"rootUser=root",oespecificarsecondospuntosenlugardeunsignoigual,comoen
rootUser:root(preferido).
6)Envarioslugaresdentrodeestedocumento,lasopcionesdelneadecomandosquesemuestranpuedenincluirvaloresdeejemploque
debensersustituidosporvaloresespecficosasusnecesidades.Porejemplo,unaopcindelneadecomandosqueindicaun
cuentapuedeserespecificadocomo"Cuenta=myaccount"ocomo"Cuenta=<myaccount>".Enestecasoel
nombredeargumento"Cuenta="puedesertomadoliteralmente,mientras"myaccount"o"<myaccount>"indicaunvalor
quedebeserreemplazadoconunvalorespecficoquecumplasusrequisitos.
7)Envarioslugaresdentrodeestedocumento,lasopcionesdelneadecomandosquesemuestranpuedenmandarlneaparmetros
quesonopcionales(slotienenqueserincluidosaparaalgunasaplicaciones,oparacambiarelcomportamientopordefecto).
Estosparmetrosopcionalessemostrarndentrodecuadradoscorchetes'['...']"(porejemplo".[dir=/Tmp/gts]")Estos
cuadradossoporteindicarqueelparmetroespecificadodentrodeloscorchetesesopcional,dependiendodela
requisitosdecomando.Loscuadradossoportesensnosonparaserincluidosenlaordenintroducida.
Pgina6de62
5/51
18/6/2015
Pgina7
2) Cargandolospaquetesderequisitosprevios
NotaImportante:
LainstalacindelosmdulosOpenGTSrequisitoprevionorequierenporlomenosunconocimientointermediodecmoinstalary
configurarserviciosdesistemastalescomoelcompiladorJava,ApacheAnt,MySQL(uotroservidordebasededatosSQL),Apache
Tomcat(uotrocontenedordeservlets),yotrastecnologasrelacionadas.
CompilarOpenGTSrequierequeseinstalarnlossiguientespaquetesoaplicaciones,configurar,yseejecutaenel
sistemalocal:
2.1)JavaCompiler
Paquete:JavaSEJDK8
Descargar:http://www.java.com/en/download/manual.jsp
Notas:
descargarsloelJDK(JREyaestincluidaenelJDK)
Nota:
ParaevitarposiblesdoloresdecabezatratandodeobtenerelcdigoOpenGTScompilar,asegresedequeestutilizandoel"Sun
Microsystems"versindelcompiladordeJava.Lasversionesde"otros"tienenproblemasalcompilarelcdigo.
DespusdeinstalarelcompiladordeJava,compruebesuversinconelsiguientecomando:
javaversion
Asegresedequedice"Java(TM)"y"JavaHotSpot(TM)ClientVM".
Nota:
AsegresedequeeldirectoriodeinstalacindeJavaSDK'bin'sehaaadidoalavariabledeentornoPATH(vermsabajo).
Nohacerlopuededarlugaraerroresdecompilacin.
NOTAIMPORTANTE:
SloinstalarelcomponenteJDK,noinstaleelcomponenteseparadoJRE.ElJDKyacontieneunJRE
componenteyelJDKesnecesarioparacompilarelcdigoJava.DespusdehaberinstaladotantoenelJDKyJREensu
sistema,puedeprovocarciertaconfusinalahoradecompilaryejecutarlaaplicacin.
2.1.a)alosusuariosdeMacOSX:
Elv1.6.0JavaJDKesprobablequeyainstaladoenelsistemaMacOSX,porloqueesposiblequenoserianecesario
descargarotracopiadelJDKdeJava.SuversininstaladadelV.1.6.0JavaJDKpuedeestarenel
siguientedirectorio:
/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home
2.1.b)usuariosdeFedora/CentOSLinux:
ElFedora/CentOSJava"OpenJDKDevelopmentEnvironment"sepuedeinstalaryutilizarenlugarde
descargarlaJDK8directamentedeSunMicrosystems.ElcomandoparainstalareldesarrolladordeJava1.8.0
medioambienteenFedora/CentOSeselsiguiente(debeser'root'parainstalar):
#Yuminstalljava1.8.0openjdkdevel
LavariabledeentornoJAVA_HOMEentoncessedebeestablecerenlasiguiente:
#ExportJAVA_HOME=/usr/lib/jvm/java1.8.0openjdk
(Asegresedeque"/usr/lib/jvm/java1.8.0openjdk"coincideconelnombredelainstalacindeJavaJDK
directorio)
Serecomiendacreartambinun"java"enlacesimblicoeneldirectorio"/usr/local/"directorioqueapuntaala
JavaJDKinstalacin,comosigue:
#Cd/usr/local
#Lns$JAVA_HOMEjava
Pgina7de62
Pgina8
2.1.c)losusuariosdeWindows:
ElprocesodeinstalacindeJavaenWindowsesprobablequesigaadelanteunainstalacintantolosdirectoriosJDKyJRE
(InclusosielJREnofueseleccionadoduranteelprocesodeinstalacin).Lainstalacinpredeterminadainstalarel
siguientesdirectorios:
C:\Archivosdeprograma\Java\jdk1.8.0_40\
C:\Archivosdeprograma\Java\jre1.8.0_40\
Apache"hormiga"yotrosprogramasJavanofuncionanbienconunavariabledeentornoJAVA_HOMEquecontiene
espaciosincrustados(como"C:\Archivosdeprograma\Java\jdk1.8.0_40").ParaevitarestoOracletiene
creadounsubdirectorioen"C:\Datosdeprograma\Oracle\Java\javapath\"paracontenerlinksadiversosJava
ejecutablessinespaciosincrustados,sinembargo,poralgunaraznsehaomitidoelcompiladorJDKdesde
estalista.Paracorregiresto,necesitamoscrearundirectoriodeenlacesimblicoadicionalalainstalacindelJDK.Ir
6/51
18/6/2015
almen"Inicio"yseleccione"Todoslosprogramas",luego"Accesorios",acontinuacin,hagaclicen"Smbolodelsistema"y
seleccione"EjecutarcomoAdministrador".Estoproporcionaralosprivilegiosadecuadosparacrearelenlacesimblico,utilizandoel
siguientescomandos:
cdC:\Datosdeprograma\Oracle\Java\javapath\
MKLINK/DJDK"C:\Archivosdeprograma\Java\jdk1.8.0_40"
LavariabledeentornoJAVA_HOMESistemaentoncessepuedeajustaralasiguiente(sinespaciosincrustados):
JAVA_HOME==>C:\Datosdeprograma\Oracle\Java\javapath\JDK
Eleditordevariabledeentornosepuedeaccederdesdeelmen"Inicio",hagaclicen"Paneldecontrol"y,acontinuacin
"Sistema",luego"Configuracinavanzadadelsistema",luego"Variablesdeentorno".
LavariabledeentornoPATHdelsistemadebeentoncesserprefijadoconlasiguiente
%JAVA_HOME%\bin
Losdiversosarchivosjarbibliotecarequerida(esdecir."Javax.mail.jar",etc)necesitarnsercopiadotantoala
directoriosdebibliotecasextensasenlasinstalacionesdeJDKyJRE.Estosdirectoriosseenumeranacontinuacin:
C:\Archivosdeprograma\Java\jdk1.8.0_40\jre\lib\ext\
C:\Archivosdeprograma\Java\jre1.8.0_40\lib\ext\
NOTA:Losarchivosjarbibliotecaadicionalesdebencopiarseusandoarrastrar/soltardesdelaconsoladeWindows.Attemping
copiarlosdesdeunaventanadelsmbolodelsistemapuedeaparecercomohancopiadoconxito,sinembargo,estos
archivosjardelabibliotecaannopuedenseraccesiblesporeltiempodeejecucindeJava.
Pgina8de62
Page9
2.2)SoporteJavaMail
Paquete:APISunJavaMail(v1.5.2+)
URL:
https://java.net/projects/javamail/pages/Home
CdigoPostal:
javax.mail.jar
Elarchivojar"javax.main.jar"deestearchivodescargasedebeinstalareneldirectoriodeJavaextendibibliotecacomo
siguiente(acceso"root"requiere):
#Cd/tmp/
#Javax.mail.jarcp$JAVA_HOME/jre/lib/ext/.
(Donde"/tmp/"eseldirectoriodonde"javax.mail.jar"fuedescomprimido)
EnMacOSX,eldirectoriodelabibliotecaampliadadeJavapuedeserenlasiguienteubicacin:
$JAVA_HOME/lib/ext
2.2.b)losusuariosdeWindows:
NecesitarEstearchivojarquesecopiarnenlosdirectoriosAMBOSbibliotecaextendidosenlasinstalacionesdeJDKyJRE:
NOTA:Estearchivojardebesercopiadoatravsdearrastrar/soltardesdelaconsoladeWindows.Attempingcopiarlosdesdeuna
smbolodelsistemapuedeparecerquesehancopiadoconxito,sinembargo,estosarchivosjardelabibliotecapuedennoser
accesibleporeltiempodeejecucindeJava.
EstopermitirqueelconductorJavaMailestdisponibleparatodoelcdigoJavaqueseejecuta,yentornosdeservletsTomcat.
(Notaimportante:asegurarsedequelospermisosdelosarchivosdelabibliotecatarrosonlegiblesmundo)
7/51
18/6/2015
2.3)Apache"Ant"ConstruirHerramienta
Paquete:v1.9.4Ant+
Descargar:http://ant.apache.org/bindownload.cgi
CdigoPostal:
http://archive.apache.org/dist/ant/binaries/apacheant1.9.4bin.zip
Nota:
Asegresedequeeldirectoriodelainstalacindelahormiga'bin'sehaaadidoalavariabledeentornoPATH(vermsabajo).
LaltimaversindelahormigaesprobablequeyainstaladoenelsistemaMacOSX,porloqueesposiblequenoserianecesario
descargarotracopiadelApacheAnt.SuversininstaladadeApacheAntpuedeestarenlasiguiente
directorio:
/Usr/share/ant
2.3.b)usuariosdeFedora/CentOSLinux:
ElFedora/CentOSApache"Hormiga"sepuedeinstalaryutilizarenlugardeladescargadelainstalacin"Ant"
directamentedeApache.Elcomandoparainstalarel"Hormiga"crearambienteenFedora/CentOSeselsiguiente
(Debeser'root'parainstalar):
#Yuminstallant
Pgina9de62
Pgina10
2.4)Apache"Tomcat"contenedorservlet
Paquete:ApacheTomcatV7.xcontenedordeservlets
URL:
http://tomcat.apache.org/download70.cgi
CdigoPostal:
http://www.apache.org/dist/tomcat/tomcat7/v7.0.59/bin/apachetomcat7.0.59.zip
Notas:
NoinstaleTomcatv8,yaquecontienealgunasincompatibilidadesAPIconversionesanterioresdecdigoservlet.
SisuversindeladistribucinLinuxyavieneconunaversindeTomcatinstalada,todavaesmuyrecomendable
queseiniciaconunaversindeTomcatdescargardirectamentedesdelapginawebdeApache.Estoeliminaroreducircualquier
permisosoproblemasclasspathquesepuedenencontrar.Luego,cuandotodoestenmarchayfuncionandocorrectamente,si
optarporhacerlo,sepuedevolveratrseinstalarOpenGTSenlaversindeApacheTomcatqueseenvi/instalacon
sudistribucindeLinux.
2.4.a)losusuariosdeLinuxqueinstalaneldescargadoApacheTomcat:
SerecomiendaquelainstalacindeTomcatmanualdeinstalarseenel"/usr/local/"directorio('root'
Serequiereaccesoparainstalarenestedirectorio).
LavariabledeentornoCATALINA_HOMEentoncessedebeestablecerenlasiguiente:
$CATALINA_HOMEexportacin=/usr/local/apachetomcatx.xx.xxlocales
Donde"/usr/local/apachetomcatx.xx.xx"coincideconelnombredeldirectoriodeinstalacindeTomcat.
Serecomiendacreartambinun"gato"enlacesimblicoeneldirectorio"/usr/local/"directorioqueapuntaala
InstalacindeTomcat,comosigue:
#Cd/usr/local
#Lns$CATALINA_HOMEtomcat
DentrodeldirectoriodeinstalacindeTomcat'bin'(esdecir."$CATALINA_HOME/bin"),asegresedequelaejecucinde
Permisosbitseestableceentodoslosarchivos".sh".Sinoseestableceelsiguientecomandoestablecerelbitdeejecucin:
$Cd$CATALINA_HOME/bin
$Chmoda+x*.sh
Sielbitdeejecucinnoseencuentraenestosarchivos,Tomcat"startup.sh"ycomandos"shutdown.sh"puedennoser
capazdeejecutar.
2.4.b)usuariosdeDebian/UbuntuutilizandounpreinstaladoApacheTomcat:
LerecomendamosdescargarlaversindeTomcatdirectamentedeApache,sinembargo,siustedtodavavaautilizarel
Debian/UbuntuinstaladolaversindeTomcat,ylosarchivosderegistrodeTomcatestnllenandode
Mensajes"java.security.AccessControlException"alintentaraccederalaspropiedadesdelsistema,entoncesusted
puedesernecesarioparacrear/editarunarchivodepolticadeTomcateneldirectorio"/etc/tomcat6/policy.d"quecontieneel
informacinsiguiente(osimilar):
concedercodeBase"file:${catalina.home}/webapps/pista/WEBINF/"{
java.util.PropertyPermissionpermiso"*","leer,escribir"
java.security.AllPermissionpermiso
}
concedercodeBase"file:${catalina.home}/webapps/eventos/WEBINF/"{
8/51
18/6/2015
}
conceder"file:${catalina.home}/webapps/Mologogo/WEBINF/"codeBase{
}
Asegresedequelosvaloresanterioressonadecuadosparasuinstalacin.
Pgina10de62
Pgina11
2.5)ProveedordebasededatosMySQL
Paquete:MySQLv5.xx
URL:
http://dev.mysql.com/downloads/mysql/
2.5.a)losusuariosdeWindows:
EnWindows,descargar/instalarelsiguientearchivo:
mysqlesencial5.X.XXm2win64.msi
Donde"mysqlesenciales5.X.XXm2win64.msi"eselnombredelainstalacindeMySQLmsrecientepara
DeWindows.
2.5.b)alosusuariosdeMacOSX:
MySQLsepuededescargarenelformatodepaqueteOSXdesdelasiguienteubicacin::
http://dev.mysql.com/downloads/mysql/5.5.html#downloads
2.5.c)usuariosdeFedora/CentOSLinux:
ElFedora/CentOS"MySQL"sepuedeinstalaryutilizarenlugardeladescargadelainstalacin"MySQL"
directamentedesdeMySQL.Elcomandoparainstalar"MySQL"enFedora/CentOSeselsiguiente(debeser'root'para
instalar):
#Yuminstallmysqlmysqlserver
Nota:
AsegresedequeeldirectoriodeinstalacindeMySQL"bin"sehaaadidoalavariabledeentornoPATH.
Pgina11de62
9/51
18/6/2015
Pgina12
2.6)MySQLcontroladorJDBC
Paquete:controladorMySQLConnector/Jv5.1.XXJDBC
URL:
http://dev.mysql.com/downloads/connector/j/
CdigoPostal:
mysqlconnectorjava5.1.XX.zip
Nota:
Connector/JsedistribuyebajolicenciaGPL.
2.6.a)usuariosdeFedora/CentOSLinux:
ElconductorFedora/CentOSMySQLJDBCsepuedeinstalaryutilizarenlugardedescargarelJDBCdeMySQL
instalacindelcontroladordirectamentedesdeMySQL.Elcomandoparainstalar"MySQL"enFedora/CentOSeselsiguiente
(Debeser'root'parainstalar):
#Yuminstallmysqlconnectorjava
El"mysqlconnectorjava5.1XX.jar."Archivojaracontinuacinsepuedeencontrarenlasiguienteubicacin:
/usr/share/java/mysqlconnectorjava5.1.XX.jar
(Donde"mysqlconnectorjava5.1.XX.jar"coincideconelnombredelarchivojarinstalar)
Elarchivojar"mysqlconnectorjava5.1.XX.jar"deestearchivozipdescargadodebeinstalarseenelJava
directoriodelabibliotecaampliadadelasiguientemanera(acceso"root"esnecesario):
#CdXXXXXXXX
#Cpmysqlconnectorjava5.1.10bin.jar$JAVA_HOME/jre/lib/ext/.
(Donde"XXXXXXXX"eseldirectorioenelcontroladorJDBCdeMySQLfuedescomprimido)
2.6.b)alosusuariosdeMacOSX:
EnMacOSX,eldirectoriodelabibliotecaampliadadeJavapuedeserenlasiguienteubicacin:
$JAVA_HOME/lib/ext
2.6.c)losusuariosdeWindows:
NecesitarEstearchivojarquesecopiarnenlosdirectoriosAMBOSbibliotecaextendidosenlasinstalacionesdeJDKyJRE:
NOTA:Estearchivojardebesercopiadoatravsdearrastrar/soltardesdelaconsoladeWindows.Attempingcopiarlosdesdeuna
smbolodelsistemapuedeparecerquesehancopiadoconxito,sinembargo,estosarchivosjardelabibliotecapuedennoser
accesibleporeltiempodeejecucindeJava.
EstopermitirqueelcontroladorJDBCestdisponibleparatodoelcdigoJavaqueseejecuta,yentornosdeservletsTomcat.
(Notaimportante:asegurarsedequelospermisosdelosarchivosdelabibliotecatarrosonlegiblesmundo)
Pgina12de62
Pgina13
3)Instalacin/ CompilacindelaFuenteOpenGTS
NotaImportante:
LainstalacindelascaractersticasOpenGTSapoyadosrequierealmenosunconocimientointermediodecmoinstalary
configurarserviciosdesistemastalescomoelcompiladorJava,ApacheAnt,MySQL(uotroservidordebasededatosSQL),Apache
Tomcat(uotrocontenedordeservlets),yotrastecnologasrelacionadas.
10/51
18/6/2015
3.1)Descomprimir/InstalacindelaFuenteOpenGTS
EnlossistemasLinux,serecomiendaquelosOpenGTSarchivozipsedescomprimenyseinstalaneneldirectorio"/usr/local/"
directorio.EnWindows,sepuedeinstalarencualquierdirectorioconveniente,comoenlaparticinrazde"C:\".
Alosefectosdeestedocumento,vamosasuponerqueelsistemaoperativodedestinosebasaenLinux,yquelaubicacin
dondeseinstalarn/descomprimidoOpenGTSes"/usr/local/OpenGTS_1.2.3/"(Nota:esposiblequetengaqueelegir
otrodirectoriodeinstalacinsinotieneacceso"root"enelsistemadedestino).Ajustelosseparadoresarchivo/rutay
comandossegnseanecesarioparasusistemaoperativoparticular,ydirectoriodeinstalacinelegido.
InstalarelcdigofuenteOpenGTS:
DescomprimirelpaqueteOpenGTSen"/usr/local/"(estotendrquehacersecomoelusuario"root"),uotroconveniente
directorio(enWindows,elijaundirectoriodondelegustaraestepaqueteparasercolocadopreferiblementeuncaminoque
nocontieneespaciosincrustados).Porejemplo,sielpaqueteOpenGTSqueseinstalares
"OpenGTS_1.2.3.zip",elcomandoparadescomprimirelpaquetesera:
/Zzz>cd/usr/local
/>Razusr/localDo
/usr/local#descomprimir/tmp/OpenGTS_1.2.3.zip
/Usuariousr/localR#chown:GrupoOpenGTS_1.2.3
/#Exitusr/local
/Usr/local>GTS_HOMEexportacin=/usr/local/OpenGTS_1.2.3
(ElanteriorsuponequeOpenGTS_1.2.3.zipsedescarga"//tmp".SilosOpenGTSziparchivosedescarg
enundirectoriodiferente,modificarlaubicacindeldirectorioanterioryelnombredelarchivodescargadoenconsecuencia.Tambin,reemplaceel
Nombredeusuario"usuario"yelnombredelgrupo"grupo",anteriormenteconelnombredelusuario:grupoqueusteddeseatenerdueosdela
InstalacinOpenGTS).
(Tambintengaencuentaqueel"
/Zzz "Nombredeldirectorioanterioresslounnombredemarcadordeposicinquerepresentacualquierdirectorioactualque
puedeser,enefecto,antesdeemitirelcomando"cd").
3.2)Configuracindelasvariablesdeentorno
Lasiguientevariabledeentornodebeestablecerseeneldirectoriodeinstalacindelpaquetecorrespondienteo
aplicacin:
JAVA_HOMEElJavaJDK(noelJRE)directoriodeinstalacin.
ANT_HOMEEldirectoriodeinstalacindeApacheAnt.
CATALINA_HOMEEldirectoriodeinstalacindeApacheTomcat.
GTS_HOMEEldirectoriodeinstalacinOpenGTS.
Pgina13de62
Pgina14
3.2.a)losusuariosdeWindows:
Laubicacindelainstalacindedirectorios'bin'paraelSDKdeJava,Hormiga,ylasinstalacionesdeservidordebasededatosSQL,
necesitaseraadidoalavariabledeentornoPATHejecucindecomandos(sielprocesodeinstalacinnotiene
yalesaadealavariablePATH).
Lasvariablesdeentornosepuedenconfigurardeformamanualenunsmbolodelsistemaconelcomando"set",comoenelsiguiente
ejemplo:
C:\>setGTS_HOME=C:\OpenGTS_1.2.3
(Alestablecerlasvariablesdeentorno,lascitasnodebenserutilizadosparaencerrarundirectoriodeinstalacin,inclusosila
directoriocontieneespaciosincrustados)
Lasvariablesdeentornosonreferenciadosporencerrndolosen'%'.Porejemplo,despusdeestablecerelentorno
JAVA_HOMEvariableenpuntoasudirectoriodeinstalacindeJDK,estavariabledeentornosera
desreferenciadocomo"%JAVA_HOME%".
Elseparadorderutadelarchivoeselcarcterdebackslash"\".As,mientrasqueenLinuxpodrahacerreferenciaaundirectorio/archivo
como"$JAVA_HOME/jre/libext//.",enWindowssehacereferenciaaestemismodirectorioque"%JAVA_HOME
%\Jre\lib\ext\".
Lasvariablesdeentornopuedenajustarseparaserdefinidoautomticamentealiniciarunsmbolodelsistema
atravsdelaventana"Propiedadesdelsistema"delasiguientemanera:
Hagaclicderechosobre"MiPC"yseleccione"Propiedades",laventana"Propiedadesdelsistema"mostrar.
Seleccionelapestaa"Avanzado"yluegopresioneelbotn"Variablesdeentorno".
Enlaseccin"Variablesdelsistema",aadelassiguientesvariables:
Nombredelavariable:JAVA_HOME(necesarioparalaconstruccindeOpenGTS,ycorriendoTomcat)
11/51
18/6/2015
Valor:(LaubicacindesuJavaSDKcarpetadeinstalacin,NOJRE)
Nombredelavariable:ANT_HOME
Valor:(LaubicacindesucarpetadeinstalacinAnt)
Nombredelavariable:CATALINA_HOME(necesarioparaOpenGTSconstruccin)
Valor:(LaubicacindesucarpetadeinstalacinApachTomcat)
Nombredelavariable:GTS_HOME
Valor:(LaubicacindesucarpetadeinstalacinOpenGTS)
(PresupuestosdeberanNOpuedenusarparaencerrarundirectoriodeinstalacindestosvariabledeentorno
especificaciones,inclusosieldirectoriocontieneespaciosincrustados)
Prefijolosiguienteala"Rutadelavariabledeentorno"enel"Variablesdesistema"seccin(crearunanueva
"Caminovariable"siunonoexisteya):
.%JAVA_HOME%\bin%MYSQL_HOME%\bin%ANT_HOME%\bin
(CotizacionespuedenaadirsealavariablePATHsiesnecesario)
Hagaclicen"Aceptar"enla"variabledeentorno"ventana.
3.2.b)losusuariosdeLinux:
Serecomiendaquelossiguientesenlacessimblicossecrearndentrodela"/usr/local/"directoriocuyopunto
asudirectorios'home'correspondiente(saltarunenlacesimblicodadosiyasehacreado):
#Cd/usr/local
#Lns$JAVA_HOMEjava
#Lns$CATALINA_HOMEtomcat
#Lns$GTS_HOMEgts
Pgina14de62
Pgina15
3.3)CompilarelapoyoGTSBibliotecaArchivos.
3.3a)VersionesprecompiladosdeGTS:
SiustedharecibidounaversinprecompiladadelpaqueteGTS,enestaseccinsepuedeomitir(sinembargousted
puedereconstruirlosdiversosservletsyarchivosjarsidesearealizarningncambioenlaconfiguracindeejecucin
antesdelaimplementacin.
CompilarlabibliotecaOpenGTSservletarchivos.war""".jar"y:
'Cd'enelOpenGTSdirectoriodeinstalacinycompilarlosarchivosjaryservletarchivosdeguerra,utilizandolahormigasuministrado
"Build.xml"script:
/Usrlocales>/cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>anttodo
Estoconstruirvariosarchivosjaryarchivosdeguerra,eneldirectorio"$GTS_HOME/build/",incluyendo:
"Lib/gtsutils.jar"Estefrascocontienelasutilidadesdebaseyherramientasdeaccesodb.
"Lib/gtsdb.jar"Estefrascocontienelasutilidadesdeaccesoalabasededatosydefinicindelatabla.
"Lib/gtsdmtp.jar"EstefrascocontienelasenvolturasdelalmacndedatosSQLdbtodoelOpenDMTPservidor.
"Lib/tools.jar"Estefrascocontienecomprobacindelsistemadevariosyherramientasadministrativas.
"Track.war"Estearchivo"guerra"(webarchivo)contienelainterfazwebservlet'Track'.
"Events.war"Estearchivo"guerra"contieneelaccesowebdeaccesoEventDataservlet.
"Mologogo.war"Estearchivo"guerra"contieneelservletdispositivoMologogo.
"Gc101.war"Estearchivo"guerra"incluyesoporteparaeldispositivoSanavGC101.
"Gprmc.war"Estearchivo"guerra"contieneunservidordesoportedeservletsparaunservidordedispositivobasadoenhttpgenrico.
(Nota:estoesslounalistaparcialOtrosmdulossecrearntambin.).
Laconstruccindebecompletarnormalmente.Puedehaberalgunasadvertenciasquesemuestran,sinembargo,silaadvertenciaodeerrorpuedenser
ignorado,tambinhabrunmensajequeindicaqueesteladodelaadvertencia/error(oenunalneajustodebajodelaadvertencia/error).
12/51
18/6/2015
Pgina15de62
Pgina16
4) InicializacineInstalacindePruebas
AntesdeutilizarOpenGTS,primerosedebeinicializar.Enestaseccinsedescribenlospasosnecesariosparalainicializacinypruebas.
4.1)InicializandolastablasdebasesdedatosSQL
AntesdeguardarlosdatosenlabasededatosSQL,primerosedebeinicializarlastablasutilizadasporOpenGTS.Estopuedeser
logradoconelcomando"bin/init.sh"delasiguientemanera:
/Zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>bin/initdb.shrootUser=<rootUser>rootPass=<rootPass>
Donde<rootUser>eselusuarioconaccesorootenelservidorSQL,y<rootPass>eslacontraseadelusuarioroot(mayo
seropcionaldependiendodelaconfiguracindesuservidorSQL).[NOTA:Estenoeselmismoqueelusuario"root"Linux]
4.1.a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:
Loscomandosqueterminanen".sh"o".bat"DEBENserejecutadosdesdeelOpenGTSdirectoriodeinstalacin.
Elintentodeejecutarestoscomandosdesdeotrodirectoriopuederesultarenuna"ClassNotFoundException"o
Error"NoClassDefFoundError",osimilar.(Estosignificaqueusteddebecd$GTS_HOME,acontinuacin,ejecutarel
comandocomo"<bin/comando>")losusuariosdeWindowspuedendesearinstalarunintrpretedePerlensumquinaen
ParautilizarlasversionesdePerl(".pl")delosscriptsdelneadecomandosquenorequierenqueseejecutan
DelOpenGTSdirectoriodeinstalacin.MsinformacinsobrelasposiblesdistribucionesdePerldisponiblesenWin32
plataformassepuedenencontrarenestelugar:"http://win32.perl.org/wiki/index.php?title=Win32_Distributions"
4.1.b)NotaimportanteparalosusuariosdeWindows:
Alutilizarlaversin".bat"deloscomandosenunaventanadeDOS,argumentosdecomandoscomo
rootUser=rootobiendebeirentrecomillas,comoen"rootUser=root",oespecificarsecondospuntos
enlugardeunsignoigual,comoenrootUser:root.Porlotanto,enWindows,elcomandoes:
bin\initdb.bat"rootUser:userName""rootPass:userpass"
Donde'userName'y'userpass'debensustituirseporelusuariorootylacontraseacorrespondiente.
Elcomando"initdb.sh"realizalassiguientesfuncionesalinicializarelOpenGTSbasededatos:
Creaunabasededatosllamada"gts".
Crea/Concede"usuariogts"con"contraseaOpenGTS"conaccesoala"gtsbasededatos".
Crealassiguientestablasdela"gtsbasededatos"(estoesslounalistaparcial):
TabladeTitulardelacuenta
Cuenta
Mesadeusuario
Usuario
AccesoControlListadeusuariostabla
UserAcl
Tabladeinformacindedispositivos
Dispositivo
LosdatosdeeventosRecibido
EventData
definicionesGeozona/Geofence
Geozona
Plantillasdepaquetesdeeventospersonalizados(DMTPsolamente)
EventTemplate
Lospaquetesenesperadetransmisinaldispositivo(sloDMTP)
PendingPacket
etctera
Elcomando"initdb.sh"realizalasmismasfuncionesquelasiguientesecuenciadecomandos:
/Zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plcreateDBuser=<rootUser>
/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plGrantuser=<rootUser>
/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plmesas=ca
13/51
18/6/2015
Pgina16de62
Pgina17
NotaparalosusuariosdeWindows:
"Bin/dbAdmin.pl"sloestdisponibleparalosusuariosdeLinux,ylosusuariosdeWindowsqueseejecutadentrodeunCygwin
medioambiente."Bin\dbConfig.bat"proporcionaunsubconjuntodelasfuncionesdisponiblesen"bin/dbAdmin.pl"quesedesarrollar
desdeunsmbolodelsistemadeWindows.
4.2)Pruebadelainstalacin
4.2.a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:
comandocomo"<bin/comando>")
Elsiguientecomandosehaincluidoparaayudarenelcontroldelainstalacindelsistemaylavisualizacindecualquier
inconsistenciasquepodrancausarproblemasentiempodeejecucin:
/Zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>bin/checkInstall.sh
O,enWindows:
C:\>cd%GTS_HOME%
C:\OpenGTS_1.2.3>bin\checkInstall.bat
Estecomandomostrardiversosdirectoriosconfiguradosyvariablesdeentorno.Sisemuestranloserrores,que
debesercorregido(oalmenosentiende)antesdecontinuarlaimplementacindelsistema.
SerequiereconfiguracinSMTPparaadmitircaractersticascomoelenvodenotificacionesporcorreoelectrnicoolvidados,emailinginformes,etc.
LaspropiedadesrequeridasparaSMTPpuedenconfigurarseenunodelosarchivosdeconfiguracindetiempodeejecucin".conf"(tpicamente
"Custom.conf").SideseaprobarlaconfiguracindecorreoelectrnicoSMTP,puedeaadirlaopcin"sendMail
<EmailAddress>",queintentarenviarunmensajedepruebaaladireccindecorreoelectrnicoespecificada:
/usr/local/OpenGTS_1.2.3>bin/checkInstall.shsendMailmyemailaddress@example.com
(Tengaencuentaquehayunespacioentrelaopcin'sendMail'yladireccindecorreoelectrnico)
O,enWindows:
C:\OpenGTS_1.2.3>bin\checkInstall.batsendMail:myemailaddress@example.com
(Tengaencuentaquehayesun":"entrelaopcin'sendMail'yladireccindecorreoelectrnicoparalaversinWindowsdelcomando)
Reemplazar"myemailaddress@example.com"conladireccindecorreoelectrnicoquedeseaquerecibaelcorreoelectrnicodeprueba.
4.3)Cargandolosdatosdeejemplo
AlgunosdatosdelamuestrasehaproporcionadoconelOpenGTSinstalacinquepuedesercargadoyconsiderarseenelWeb
interfaz.Porfavor,consulteeldocumentoen"sampleData/README.txt"dentrodelOpenGTSdirectoriodeinstalacinpara
informacinsobrecmocargarlosdatosdelamuestra.
Pgina17de62
Pgina18
4.4)LacreacindelaCuenta"sysadmin"
(Lafuncinde"sysadmin"sloestdisponibleconlaversin2.2.7OpenGTSysuperior)
Alentrarala"sysadmin"cuentaunanueva'ficha'menestardisponible,connuevasseleccioneswebpgina,quepermiten
14/51
18/6/2015
lacreacindenuevascuentas.Elsiguientecomandosepuedeutilizarparacrearlacuentade"administradordesistemas":
/usr/local/OpenGTS_1.2.3>bin/CuentaCuentaadmin.sh=sysadminpass=contraseacreate
O,enWindows:
C:\OpenGTS_1.2.3>bin\Cuentaadmin.batCuenta:sysadminpass:contraseacreate
Vuelvaacolocarlaanteriorespecificacin"contrasea"conunacontraseasegura.
Acontinuacin,deberasercapazdeiniciarsesinenlacuentade"sysadmin"paraverlanuevapestaa"SystemAdmin".
Pgina18de62
Pgina19
5) Instalacin"track.war"
El"track.war"(
)SeejecutaenuncontenedordeservletsJavaytrabajaconelalmacndedatosSQLDBparaproporcionaruncompleto
WEBARcebolleta
interfazwebofrecidoalosdatosdelocalizacinGPScapturadosenlabasededatosSQLdesdedispositivosremotos.Elmapeo
asistenciautilizaactualmenteOpenLayers/OpenStreetMap,peropuedeserconfiguradoparautilizarotroserviciodemapascomercial
proveedores.
5.1)Configuracindelarchivo"webapp.conf"
Elarchivodeconfiguracindeejecucinpordefecto"webapp.conf"incluyeelarchivo"common.conf",queincluyeasuvez
"System.conf"y"custom.conf".Paralamayoradelasinstalaciones,losvalorespredeterminadosespecificadosenestearchivosepuededejarcomoest.
Sinembargo,algunoselementos,talescomolasespecificacionesdesuservidorSMTP,debenconfigurarseparaadaptarsealosrequisitosdelsistema.
5.2)Configuracindelosinformesdisponibles
Variosdetalleyresumenlosinformessepuedendefinirmedianteelarchivo"reports.xml",quesepuedeencontraren
"$GTS_HOME/reports.xml".
15/51
18/6/2015
Msinformacindetalladasepuedeencontrarenelarchivodearriba"reports.xml",yenestedocumentoenotroslugares.Esteesun
Resumendelascaractersticasdisponiblesenelarchivo"reports.xml"(experienciaenelformatogeneralylaedicindearchivosXML
sernecesario).
"ReportLayout"defineelformatoderegistroesperadoylascolumnasdisponiblesparaelinformedefinido.Laespecfica
diseodelinformesedefineporlaclaseJavaespecificaday2diseosdeinformessehanproporcionado:
org.opengts.war.report.event.EventDataLayoutEstadisposicinprevparamostrarregistrosEventData
yespecificalascolumnasdisponiblesenfuncindeloscamposdisponiblesenelregistroEventData.
org.opengts.war.report.field.FieldLayoutEstadisposicinprevmostrargenrico"fielddata"
registrosyespecificadiversostipoquesepuedeutilizarparamostrarlosdatospertinentescolumnasdisponibles.
El"Informe"etiquetaespecificaunaclaseJavaqueestunidoaunReportLayoutespecfico.El"Informe"tambinespecifica
laformaenquesevaapresentaralusuario(esdecir.laopcindemen),ttulodelinforme,quesemuestracolumnasycriteriosdeseleccindeinforme.
5.3)Configuracindelaetiquetaprivadalook&feel
Laconfiguracinypersonalizacindelainterfazdeusuariodelawebsepuedenespecificarenelarchivo"$GTS_HOME/private.xml"
(O"$GTS_HOME/private/private_common.xml"paraelGTSEmpresa).Estearchivocontrolalassiguientesopciones
queestndisponiblesenbaseaun"dominio"(elnombrededominiodelaURLdereferenciavisitarelservidor):
Lafecha/Formatosdetiempo,ysemuestraTimeZones.
ElMapProviderutilizado(esdecir.GoogleMaps,MicrosoftVirtualEarth,Mapstraction,OpenLayers,etc).Incluyendolo
iconospasadorsevanamostrarenelmapa.
LosReverseGeocodeProvidersutilizanparaconvertirlosvaloresdelatitud/longitudenunadireccindelacalle(Geonames,etc.).
ElGeocodeProviderutilizaparaconvertirdireccionesdecallesenunalatitud/longitud(siestdisponible).
Lasopcionesdisponiblesdemen,laspginaswebyarchivosJSPdepersonalizacin.
Opcionesdeinformedisponibles.
AccessControlList(ACL)definiciones.
Ymucho,muchoms...
Porfavorrefirasealasobservacionescontenidasenel"private.xml"(o"private_common.xml")dearchivosparaobtenerms
informacin.
Pgina19de62
Pgina20
OpenGTSincluyesoportedemapeoparaOpenLayers/OpenStreetMap,GoogleMaps,MicrosoftVirtualEarth,y
Mapstraction(quepuedesoportarvariosotrosproveedoresdeserviciosdemapeotambin).Pngaseencontactoconnosotrosenrelacinconelapoyoa
otrosproveedoresdeserviciosdemapeocomerciales.SiustedvaautilizarGoogleMapsparasuproveedordemapas,tambindebe
registrarseparaobtenerunaclavedeGoogleMap(asegresedequeustedcumplaconsustrminosdeservicio)ycoloquelallavederegresarenel
(O"private_common.xml")archivo"private.xml"enellugarindicado(esdecir.Reemplazar"***PlaceGoogleMaps
ClaveAqu***"consuclavecitado).Paracambiarelvalorpordefectoaparecemapachinchetas,puedecrearsupropio
Seccin"Pasadores"dentrodesuMapProviderelegido.Vealaseccindearchivos'private.xml'Pasadores(enel
"OpenLayers"seccinMapProvider)paraobtenermsinformacinsobrelapersonalizacindeiconospasador.
Consulteloscontenidosdelarchivodeetiquetaprivadaproporcionadaen"$GTS_HOME/private.xml"paraobtenermsinformacinsobreespecfica
personalizaciones(experianciaenelformatogeneral,edicinysintaxisdelosarchivosXMLsernecesario).
5.3.a)MantenersintaxisXMLadecuadoalmodificar"private.xml"o"reports.xml"
Asegresedequeloscambiosenelarchivo'private.xml'todavacumplenconsintaxisXMLadecuado.XMLesmuy
enparticularacercadelasintaxiscorrecta,ylaintroduccindeunerrordesintaxisXMLmenudoresultaenunmensajedeerrorsimilaral
elsiguientealintentarverlapginadeiniciodesesinenunnavegadorweb:
Configuracinnovlida'private.xml',porfavorpngaseencontactoconeladministradordelsistema
Ejecutar"bin/checkInstall.sh"paraayudaradiagnosticarloserroresdesintaxisXMLquepuedenhabersidointroducidas.
EllookandfeelgeneraldelainterfazwebtambinsepuedencambiarmodificandoelarchivoJSP
"$GTS_HOME/guerra/pista/jsp/loginSession.jsp"ylosdiferentesarchivosCSSeneldirectorio
"$GTS_HOME/guerra/pista/css/".Busquelaseccindeetiqueta"pginasweb"enelarchivo"private.xml"paraadicional
informacinsobrelapersonalizacindelarchivo"loginSession.jsp".
5.3.b)IMPORTANTE:Vuelvaaimplementartodoslosservletsdespusdemodificarcualquierarchivodeconfiguracindeejecucin
Cambiosencualquierade"private.xml","reports.xml","webapp.conf","common.conf","system.conf",o
archivos"custom.conf"(uotro".xml"oarchivo".conf"),sernecesarioqueel"track.war"(aligualquelaotra
servletsarchivo)serreconstruidoyredesplegado.
5.4)Compilar/Instalacindel"track.war"ServletJava
Paragenerarelarchivo"track.war",ejecuteelcomandodeconstruccinAntdelasiguientemanera:
/Zzz>cd$GTS_HOME
16/51
18/6/2015
/usr/local/OpenGTS_1.2.3>pistahormiga
(Nota,la"hormigatodos"realizadoanteriormentetambinsebasaenelarchivo"track.war")
La"pista"dedestinoesuncontenedorparatareasant"track.compile"y"track.war".El"track.compile"objetivo
compilatodaslasclasesnecesariasyarchivosdeconfiguracineneldirectoriodeconstruccin"$GTS_HOME/build/pista".Elobjetivo
"Track.war"yluegocreaelarchivo'archivoweb'"$GTS_HOME/build/track.war".Sialgunodelostiempodeejecucin
archivosdeconfiguracinhancambiado,comoarchivos"common.conf""private.xml","reports.xml","webapp.conf",o
(Oposiblementecualquierotro"*.conf"del"*.xml"archivo),acontinuacin,elarchivo"track.war"debeserreconstruidoyredistribuido.Unaccesodirecto
parareconstruirelarchivo"track.war",sitodoslosmdulosdeorigenyasehancompilado,esemitirlasiguiente
comando:
/Zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>hormigatrack.war
Estosimplementevolveraempaquetarelarchivo"track.war"delosmdulosdeorigenpreconstruidos,ylaconfiguracindetiempodeejecucincambiada
archivos.Sitodoloqueyahasidocompilado,estecomandotomanormalmenteslounossegundosencompletarse.
Pgina20de62
Pgina21
Instaleelarchivocreado"track.war"segnlasinstruccionesdeinstalacin/configuracindeApacheTomcat.Tpicamente,estosignifica
copiarelarchivo"track.war"aldirectorio"$CATALINA_HOME/webapps/.":
/usr/local/OpenGTS_1.2.3>cpbuild/track.war$CATALINA_HOME/webapps/.
Obien,elsiguienteobjetivo"hormiga"tambinsepuedeutilizar:
/usr/local/OpenGTS_1.2.3>track.deployhormiga
ElmtodoanteriorparaeldesplieguesuponequeTomcatestconfiguradopara'AutoDeploy="true".Siloscambiosno
aparecendespusdereconstruiryvolveradesplegarelarchivo"track.war",entoncespuedesernecesarioforzarTomcatparaactualizarel
"Track.war"servletsiguiendoestospasos:
")
PararTomcat(esdecir".
$CATALINA_HOME/bin/shutdown.sh
")
Eliminarelservlet"pista"existente(esdecir,".
rmrf$CATALINA_HOME/webapps/seguimiento*
")
Implementarelnuevoservlet"pista"(esdecir".
cp$GTS_HOME/build/track.war$CATALINA_HOME/webapps/.
")
ReinicieTomcat(esdecir".
$CATALINA_HOME/bin/startup.sh
5.5.a)deaccesowebseguro:
Configuracinyusode"https"(esdecir.SSL)esmuyrecomendablequelaURLincluyelacontraseadelacuenta
yserencriptadaatravsde'https',perosernenviadosenelclarosiplain'http'seutiliza.Instruccionespara
configurarTomcatparasoportarSSLsepuedeencontrarenelsitiowebdeApacheTomcat.
Despusdelaconstruccin/desplegar'track.war',usteddeberasercapazdeverlapginadeiniciodesesinconunaURLsimilaralasiguiente:
http://localhost:8080/pista/Pista
(Sustituir"'localhost:8080"consupropionombrededominiodonde'seinstaltrack.war'.)
TengaencuentaquelaespecificacinparaeldirectorioURL"/pista/Pista"essensibleamaysculas.
Serviciosdeapoyoparalageocodificacininversa(girandounalatitud/longitudenunadireccin),utilizandocomoGeonames
(http://geonames.org)YGoogle,tambinsehaincluido.Busquelos"ReverseGeocodeProvideretiquetas"enel
Archivo'private.xml'paramsinformacin.
5.5.b)Compatibilidaddelnavegador:
LapginadelmapadelocalizacinporGPSenlainterfazwebhaceunusointensivodeformateoJavaScriptyHTML.
Firefoxv3.xx,Chrome8.0.x,ySafari5.0.X,sonlasplataformasdirigidas,perotambinparecefuncionarbien
(Conalgunasdiferenciasmenores)enMicrosoftInternetExplorer6.0/7.0/8.0(algunasanomalasvisualeshansidoreportadoscon
versionesanterioresdeIE).Otrosnavegadoresnosehanprobadocompletamente.
5.6)Instalacindevariasversionesde"track.war"
LaURLparaaccederalapginadeiniciodesesinesnormalmentedelasiguientemanera:
http://localhost:8080/pista/Pista
Elnombrede"pista"queaparecemsarribaderivasunombredelnombreparaelarchivodelaguerra,enestecaso"pista.war".Este
significaqueustedpuedeinstalarmltiples/diferentescopiasdela"pistaarchivo.war",siempreycuandoelnombredelarchivodelaguerraes
cambiadodurantelacopia.Porejemplo,sicopiael"trackarchivo.war"paraTomcatdelasiguientemanera:
17/51
18/6/2015
/usr/local/OpenGTS_1.2.3>acumulacincp/
pista .war$CATALINA_HOME/webapps/
pista1 .war
Acontinuacin,puedeaccederaestaversininstaladaconlasiguienteURL:
http://localhost:8080/pista1/Pista
Pgina21de62
Pgina22
6) Instalacin"events.war"
El"events.war"(
)SeejecutaenuncontenedordeservletsJavaytrabajaconelalmacndedatosSQLDBparapermitir
WEBARcebolleta
descargarporcionesseleccionadasdeunasecuenciadeeventosatravsdeInternet.Estosepuedeutilizarconelmapeobasadoenlaweb
aplicacionesparaproporcionarseguimientocasientiemporealdeunvehculoounapersona.Elservlet'"events.war"apoyaactualmente
larecuperacindedatosenKML,XML,CSV,TXT,GPX,oformatosdearchivoJSON,ysepuedeutilizarenlosprogramasdemapeocomo
GoogleEarth,oMSMapPoints.
6.1)Configuracindelarchivo"webapp.conf"
Elarchivodeconfiguracindeejecucinpordefecto"webapp.conf"incluyeelarchivo"common.conf",queincluyeasuvez
"System.conf"y"custom.conf".Paralamayoradelasinstalaciones,losvalorespredeterminadosespecificadosenestearchivosepuededejarcomoest.
Sinembargo,algunoselementos,talescomolasespecificacionesdesuservidorSMTP,debenconfigurarseparaadaptarsealosrequisitosdelsistema.
Sideseapersonalizarelarchivo"webapp.conf"especficamenteparaelservlet"events.war",copiarestearchivoala
directorio"$GTS_HOME/guerra/eventos/WEBINF/"ymodificarestacopia.
6.2)Compilar/Instalacindel"events.war"JavaServlet
Paragenerarelarchivo"events.war",ejecuteelcomandodeconstruccinAntdelasiguientemanera:
/ zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>eventosdehormigas
(Nota,la"hormigatodos"realizadoanteriormentetambinsebasaenelarchivo"events.war")
Los"eventos"dedestinoesuncontenedorparatareasant"events.compile"y"events.war".Elobjetivo
"Events.compile"recopilatodaslasclasesnecesariasyarchivosdeconfiguracineneldirectoriodeconstruccin
"$GTS_HOME/build/eventos".El"events.war"objetivocontinuacin,creaelarchivo'archivoweb'
"$GTS_HOME/build/events.war".
Instaleelarchivo"events.war"segnlasinstruccionesdeinstalacin/configuracindeApacheTomcat.Tpicamente,estosimplemente
implicacopiarelarchivo"events.war"aldirectorio"$CATALINA_HOME/webapps/.".(Elmtodoanteriorpara
desplieguesuponequeTomcatestconfiguradopara'AutoDeploy="true"')
AccedaalosdatosalmacenadosenlabasededatosSQLatravsdelawebconlasiguienteURLconstruida:
http[s]://localhost:8080/eventos/<archivo>{kml|XML|csv|txt|gpx|json}.?
un[UENTA]=<cuenta>elnombredelacuenta
&U[Ser]=<usuario>elnombredeusuario
&P[assword]=<contrasea>lacuenta/contraseadeusuario
+D[evice]=<dispositivo>elnombredeldispositivo
&G[rupo]=<grupo>elnombredelgrupodedispositivos(opcional)
[&Rf=<fromtime>]opcional'de'rangodedatos.
[&Rt=<totime>]opcional"a"rangodedatos.
[&L[imit]=<lmite>]opcionalnmerode"lmite"deloseventosdevueltos.
Donde"localhost:8080"debeserreemplazadoconelnombrededominiorealyelpuertoutilizadoparaaccederalApache
ServidorwebTomcat.[Nota:porencimadeobjetoscolocadosencuadradoscorchetessonopcionales.Lasopcionescolocadosentrellaves
indicanqueunadelasopcionesdentrodelasllavesdebenserseleccionados].
Pgina22de62
Pgina23
Nota:El'rf'y(nmerodesegundosintervalosdefechas'rt'puedenespecificarseenformatodehora'UnixEpoch'desdelamedianocheEne
18/51
18/6/2015
1,1970)oen"aaaa/mm/dd/HH:MM:SS"formato.Sinoseespecifica,sedevolvernlosltimos100eventos.
6.3.a)Notasobreelaccesowebseguro:
Configuracinyusode"https"(esdecir.SSL)esmuyrecomendablequelaURLincluyelacontraseadelacuenta
yserencriptadaatravsde'https',perosernenviadosenelclarosiplain'http'seutiliza.Instruccionespara
configurarTomcatparasoportarSSLsepuedeencontrarenelsitiowebdeApacheTomcat.
Algunosejemplos:
https://localhost:8080/eventos/data.csva=opendmtp&p=mypass+D=mvil
DevolucindeunarchivoCSVconformatodedatos('data.csv')quecontieneelltimoregistro100eventosparaeldispositivo
'opendmtp'/'mvil'.LosdatossedevuelvenatravsdeunaconexinHTTPSSL.(Nota:sustituirmypass'con
lacontraseacorrecta)
http://localhost:8080/eventos/data.jsona=Demo&p=mypass+D=Demo
DevolucindeunarchivoconformatoJSONdedatos('data.json')quecontieneelltimoregistrode100eventosparaeldispositivo
'Demo'/'Demo'.(Nota:sustituirmypass'conlacontraseacorrecta)
http://localhost:8080/eventos/data.kmlungts=&p=mypass+D=devyrf=1145776000yrt=1145777000
DevolverunKML(XML)archivodedatosfomatted('data.kml')conlosprimeros100eventosdentrodelaespecificada
rangoparaeldispositivo"gts/dev".
http://localhost:8080/eventos/data.gpxa=gts&p=mypass+D=devyrf=1145776000yrt=1145777000
DevuelveunaGPX(XML)archivodedatosfomatted('data.gpx')conlosprimeros100eventosdentrodelaespecificada
alcanceparaeldispositivo"gts/dev"(vase"http://www.topografix.com/gpx.asp"Paraobtenerinformacinconrespectoala
FormatodedatosGPX).
GoogleEarthtienelacapacidaddeformaautomticadatosdelasencuestasdeesteURLaintervalosespecificados.A
configurarGoogleEarthparaleerlospuntosdedatosdeeventosdelservidor,hagaclicen"Aadir"enlabarrademenprincipal,luego
seleccione"RedEnlace".AadirlaURLrecuperacindeKMLalservidoryhagaclicen"ParmetrosRefresh"parapoder
entrarentiemposdeactualizacinperidica.ParamostrarsiemprelosacontecimientosmsrecientesdentrodeGoogleEarth,omitalafecha
opcindegama("rf"y"ta")yensulugarespecificarlaopcinde"lmite"parahacerquelalistadevueltaparasiempre
incluirlaltimaseriedeeventos.
http://localhost:8080/eventos/data.kmla=gts&p=mypass+D=devylmite=100?
DevolverunKML(XML)archivodedatosfomatted('data.kml')conlosltimos100eventosdisponiblesparael
dispositivo"gts/dev".
http://localhost:8080/eventos/data.kmla=gts&p=mypass+D=devylmite=1?
DevolverunKML(XML)fomattedarchivodedatos('data.kml')consloelltimo(msreciente)deeventosparael
dispositivo"gts/dev".
Pgina23de62
Pgina24
7) Administracindebasesdedatos
7.a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:
Loscomandosqueterminanen".sh"o".bat"DEBENserejecutadosdesdeelOpenGTSdirectoriodeinstalacin.Intentando
paraejecutarestoscomandosdesdeotrodirectoriopuederesultarenun"ClassNotFoundException"o
7.b)NotaimportanteparalosusuariosdeWindows:
rootUser=rootobiendebeirentrecomillas,comoen"rootUser=root",oespecificarsecondospuntos
enlugardeunsignoigual,comoenrootUser:root.
19/51
18/6/2015
Lamayorpartedeadministracindebasededatos(cuentas,usuariosydispositivos,etc)sepuederealizaryaseaatravsdelalneadecomandos
serviciospblicosoatravsdelainterfazweb.LosejemplosdeedicinejemploCuenta/usuario/dispositivoquesemuestraacontinuacindescribensolamente
algunosdelosposiblescamposencadaunadeestastablas.Elarchivo'Schema.txt',incluidoenelOpenGTSpaquete,
contieneunalistadelastablasactuales,yloscamposencadaunadelasmesasdisponibles.
Unalistadelastablasyloscamposdefinidosenlaactualidadtambinsepuedegenerarconelsiguientecomando:
/Zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plschema
O,enWindows:
C:\zzz>cd%GTS_HOME%
C:\OpenGTS_1.2.3>bin\dbAConfig.batschema
7.1)Creacindecuentas/Edicin
Elcomando"bin/Cuentaadmin.sh"apoyamuchasfuncionesadministrativasqueactansobrela"Cuenta"SQL
mesa.Estassonalgunasdelasfuncionesquesepuedenrealizaratravsdel"bin/Cuentaadmin.sh"comando:
Creacindeunacuenta:
/usr/local/OpenGTS_1.2.3>bin/Cuentaadmin.shCuenta=<CUENTA>create
Estocrealacuentaespecificadaconlosvalorespordefecto(sustituir"<CUENTA>"conelidentificadordecuentaquedeseacrear).
Edicindeunacuenta:
/usr/local/OpenGTS_1.2.3>bin/Cuentaadmin.shCuenta=<CUENTA>edit
EstecomandomuestrauneditordecampoCuentadelneadecomandos,deformasimilaralosiguiente:
Pgina24de62
Pgina25
(NOTA:LasiguienteesslounejemploSuaplicacincontienedefinicionesdecampoaddtionalfavor..
revisarelarchivo'Schema.txt'enelpaqueteOpenGTSparaobtenerunalistadelasposiblesdefinicionesdecampo.)
Clave:opendmtp
0)Contrasea:"demo"
1)Descripcin:"CuentaEjemplo"
2)estactivo:"true"
3)Nombredecontacto:""
4)Telfonodecontacto:""
5)ContactoDireccindecorreoelectrnico:""
6)Zonahoraria:"EE.UU./Hawaii"
7)Unidadesdevelocidad:"0"
8)Unidadesdedistancia:"0"
9)ModoGeocoder:"0"
10)NombrePrivateLabel:"*"
Introduzcaelnmerodecampo[o'conservar','salida']:
Paraseleccionarunvalordecampodecambiar,introduzcaelnmerodecampo,luegopulsaenter.Despusdecambiarelvalordelcampo,pulsaenter
denuevo.Guardeloscambiosporfinentraren"Guardar".
Aquestunadescripcindealgunosdeloscamposdecuenta(porfavorver'Schema.txt'paraunadescripcindeotrocampoposible
definiciones):
ContraseaLacontraseadelacuentadeiniciodesesin.Aliniciarlasesin,siexisteelusuario"admin",acontinuacin,lacontrasea"admin"
sernutilizados,enlugardeestacontrasea,paraautenticaralusuario.
DescripcinLadescripcindelacuenta(utilizadoenlosinformes,etc).
EsactivoEstevalores"true"silaCuentaseconsideratodavaenservicio.If"falsos",entoncestodaslasconexionesportodo
dispositivosdepropiedadsernrechazadas.
NombredeContactoElnombredelapersonadecontactoparalaCuenta.
Telfonodecontactoelnmerodetelfonodelapersonadecontacto.
ContactoDireccindecorreoelectrnicoaddrescorreoelectrnicodelapersonadecontacto.
ZonaHorariaLazonahorariapreferidaparalaCuenta.
UnidadesdevelocidadLasunidadesdevelocidadpreferidosparalaCuenta.Losvaloresvlidosson:0=mph,1=kph,2=nudos.
20/51
18/6/2015
UnidadesdedistancialasunidadesdedistanciapreferidosparalaCuenta.Valorvaloresson:0=Miles,1=kilmetros,2=nudos.
ModoGeocoderEsteeselmodoinversogeocodificacinutilizadoparaestacuenta.Losvaloresvlidosson:0=Noinversa
geocodificacinrealizado,solamente1=Geozonabsqueda,2=Reversegeocodificacindecdigosdeestadodealtaprioridadslo,
3=Reversegeocodetodo(serequiereunserviciodegeocodificacininversadisponible).
PrivateLabelNombreEsteeselnombredel'dominio'enelarchivo'private.xml'alosqueestacuentadebeser
asignado.Sihaymsdeun"dominio"sedefineenelarchivo'private.xml',acontinuacin,estopermiteelusode
recursosdiferentesinversageocodificacin,ycartografaparadiferentescuentas.
Listadodecuentasexistentes:
/usr/local/OpenGTS_1.2.3>bin/listCuentaadmin.sh
Estalistadetodaslascuentasydispositivosdepropiedad.
Pgina25de62
Pgina26
7.2)Creacin/EdicindeUsuarios
Elcomando"bin/Usuarioadmin.sh"soportavariasfuncionesadministrativasqueactansobrelatabladeSQL"Usuario".
Estassonalgunasdelasfuncionesquesepuedenrealizarconelcomando"bin/Usuarioadmin.sh":
Creacindeunusuario:
/usr/local/OpenGTS_1.2.3>bin/admin.shusuarioCuenta=<CUENTA>user=<usuario>create
Estocreaelusuarioespecificadoconvalorespordefecto(sustituir"<usuario>"conelidentificadordeusuarioquedeseacrear).Elusuario
nombre"admin"estreservadoparasuusoporeladministradordelacuenta.Cuandoeladministradordelacuentaregistraen(dejandoel
campodenombredeusuarioenblancoenelregistroenlapantalla),entonceselregistroenelprocesosecompruebasiexisteelusuario"admin".Siesto
elnombredeusuarionoexiste,entonceslacontraseaydecontroldeaccesoasignadoalusuario"admin"seutilizarparalaCuenta
administrador(Nota:elusuariopredeterminadodeiniciodesesinsepuedecambiarenlapginawebAdministracindecuentas,oenlaCuenta
delneadecomandosdeedicin).
Edicindeunusuario:
/usr/local/OpenGTS_1.2.3>bin/admin.shusuarioCuenta=<CUENTA>user=<usuario>edit
Estecomandomuestrauneditordecampodeusuariodelneadecomandos,deformasimilaralosiguiente:
revisarelarchivo'Schema.txt'enelpaqueteOpenGTSparaobtenerunalistadelasposiblesdefinicionesdecampo.)
Clave:opendmtp,elusuario
0)Contrasea:""
1)Descripcin:"UsuarioNuevo"
2)estactivo:"true"
3)Nombredecontacto:""
4)Telfonodecontacto:""
5)ContactoDireccindecorreoelectrnico:""
6)Zonahoraria:""
Introduzcaelnmerodecampo[o'conservar','salida']
Heaquunadescripcindetalladadealgunosdeloscamposdeusuario(consulte"Schema.txt"paraunadescripcindeotrosposibles
definicionesdecampo):
ContraseaLacontraseadeiniciodesesindelusuario.Dejandoelarchivodecontraseasvacoimpedirqueelusuarioiniciesesin.Si
deseapermitirqueelusuarioiniciesesinsintenerqueintroducirunacontrasea,acontinuacin,debeestablecerelcampodecontraseapara
laprueba"*blanco*"(maysculasyminsculas,ysinlascomillasporsupuesto).
DescripcinLadescripcindelusuario(utilizadoenlosinformes,etc).
EsactivoEstevalores"true"sielusuariotodavaseconsideraenservicio.If"falsos",todoslosintentosdeconexindeeste
Usuarioserrechazada.
21/51
18/6/2015
NombredeContactoElnombredelapersonadecontactodelusuario.
Telfonodecontactoelnmerodetelfonodelapersonadecontacto.
ContactoDireccindecorreoelectrnicoaddrescorreoelectrnicodelapersonadecontacto.
ZonaHorariaLazonahorariapreferidaparaelusuario
Pgina26de62
Pgina27
7.3)Creacin/EdicindeDispositivos
Elcomando"Dispositivobin/admin.sh"apoyamuchasfuncionesadministrativasqueactansobreel"dispositivo"SQL
mesa.Estassonalgunasdelasfuncionesquesepuedenrealizarconelcomando"bin/Dispositivoadmin.sh":
Creacindeundispositivo:
/usr/local/OpenGTS_1.2.3>bin/admin.shDispositivoCuenta=<CUENTA>device=<dev>create
Estocreaeldispositivoespecificadoconvalorespordefecto(sustituir"<dev>"conelidentificadordedispositivoquedeseacrear).
Edicindeundispositivo:
/usr/local/OpenGTS_1.2.3>bin/admin.shDispositivoCuenta=<CUENTA>device=<dev>edit
Estecomandomuestrauneditordecampodeusuariodelneadecomandos,deformasimilaralosiguiente:
revisarelarchivo"Schema.txt"enelpaqueteOpenGTSparaobtenerunalistadelasposiblesdefinicionesdecampo.)
Clave:opendmtp,mvil
0)Descripcin:"Nuevodispositivo"
1)estactiva:"true"
2)LasdireccionesIPvlidas:""
Codificaciones3)soportados:"7"
4)ContabilidadtiempodeintervaloMinutos:"60"
5)Nmeromximodeeventosporintervalo:"21"
6)MaxTotaldeconexionesporIntervalo:"10"
7)MaxTotaldeconexionesporminuto:"2"
8)ConexionesMaxDplexporIntervalo:"6"
9)ConexionesMaxdplexporminuto:"1"
Introduzcaelnmerodecampo[o'conservar','salida']:
Heaquunadescripcindetalladadealgunosdeloscamposdedispositivo(consulte"Schema.txt"paraunadescripcindeotra
posiblesdefinicionesdecampo):
DescripcinLadescripcindeldispositivo(utilizadoenlosinformes,etc).
Estactivo"true"siestedispositivoseconsideratodavaenservicio.Si"false",todaslasconexionesdeestedispositivosern
negado.
LasdireccionesIPvlidasLadireccinIPdeldispositivoenunaconexinentrantesecompruebacontraestaespecificada
bloquededireccionesIPvlidas,ysenegsiladireccinIPnocoincide.UnvalorenblancoaceptatodoIPentrante
direcciones.
CodificacionessoportadasEsteesunOpenDMTPparmetrosdelprotocolo,yporlogeneraldebesersiempre"7".Veael
EspecificacindelprotocoloOpenDMTPparamsinformacin.
ContabilidadtiempodeintervaloMinutos(OpenDMTPsolamente)Estevalorseutilizaparaevitarquelosclientesdefueradecontrol
elconsumoexcesivodeanchodebanda.Elvaloraquespecificaelnmerodeminutosduranteloscualeslossiguientes"Max"
seimponenlmitesdevalor.Unvalorde"0"desactivalacontabilidaddeconexin.
NmeromximodeeventosporIntervalo(OpenDMTPsolamente)Elnmeromximodeeventospermitidosduranteelanteriorespecifica
intervalo.
MaxTotaldeconexionesporIntervalo(OpenDMTPsolamente)EsteeselnmeromximodeTCPoUDP
conexionesquesepermitenduranteelintervaloespecificadoanteriormente.
Pgina27de62
22/51
18/6/2015
Pgina28
MaxTotaldeconexionesporminuto(OpenDMTPsolamente)EsteeselnmeromximodeTCPoUDP
conexionesquesepermitenduranteunintervalode60segundos.
ConexionesMaxDplexporIntervalo(OpenDMTPsolamente)EsteeselnmeromximodeconexionesTCPque
sepermiteduranteelintervaloespecificadoanteriormente.
ConexionesMaxdplexporminuto(OpenDMTPsolamente)EsteeselnmeromximodeconexionesTCPque
selespermiteduranteunintervalode60segundos.
RecuperandoDispositivosEventosatravsdelalneadecomandos:
/usr/local/OpenGTS_1.2.3>bin/admin.shDispositivoCuenta=<CUENTA>device=<dev>Eventos
EstecomandodevuelvelosltimosacontecimientosenformatoCSV.
Fecha,Hora,Cdigo,Latitud,Longitud,velocidad,rumbo,altitud,direccin
2007/03/07,23:13:21,InMotion,29.57241,142.78869,103.9,178.3,287.0","
2007/03/07,23:15:23,InMotion,29.57241,142.78869,103.9,178.3,287.0","
2007/03/07,23:17:23,InMotion,29.57241,142.78869,103.9,178.3,287.0","
2007/03/07,23:19:23,InMotion,29.57241,142.78869,103.9,178.3,287.0","
2007/03/07,23:21:25,InMotion,29.57241,142.78869,103.9,178.3,287.0","
2007/03/07,23:23:27,InMotion,29.57241,142.78869,103.9,178.3,287.0","
Eliminacindeeventos"futuro"paraundispositivodeterminado:
DevezencuandoundispositivoderastreoGPSemitirunafechaGPS/tiempoqueestenelfuturo,avecesmuchotiempoenel
futuro.Paramostrarelnmerodeeventosactualesqueestnenelfuturomsde5minutos,introduzcalasiguiente
comando:
... >bin/admin.shDispositivoCuenta=<CUENTA>device=<dev>countFutureEvents=300
Paraeliminarestoseventos"futuro":
... >bin/admin.shDispositivoCuenta=<CUENTA>device=<dev>deleteFutureEvents=300
Eliminacindeeventos"viejos"paraundispositivodeterminado:
Comoeventosseacumulanenlabasededatos,puedesertilenalgnmomentopararecortareventosantiguosdelsistema.Lasiguiente
comandocontarelnmerodeeventosantesdehace90das:
... >bin/admin.shDispositivoCuenta=<CUENTA>device=<dev>countOldEvents=90d
Paraeliminarestoseventos"viejos":
... >bin/admin.shDispositivoCuenta=<CUENTA>device=<dev>deleteOldEvents=90d
Elvalordeargumentoparalos"countOldEvents"y"deleteOldEvents"sepuedeespecificarelusodeuntiemporelativo,tales
como"120d",indicandoeventosmayoresdehace120das,oconunaespecificacindetiempoespecfico,comoporejemplo
"2010/03/12,13:15:00,GMT",indicandoeventosexistentesantesde12demarzo201013:15GMT.
ADVERTENCIA:LaeliminacindeeventosantiguosdelamesaEventDataesdefinitiva.Unavezquesehaneliminadolosacontecimientos,
nosepuederecuperar.
Pgina28de62
Pgina29
7.4)Funcionesadministrativasdebasededatosgeneral
El"dbAdmin.pl"comando(sloestdisponiblecomounscriptdePerl)puederealizarvariasfuncionesadministrativasenelSQL
basededatos(Nota:elcomando"bin\dbConfig.bat'seproporcionaparalosusuariosdeWindows,yrealizaunsubconjuntodela
operacionesdisponiblesparaelcomando"dbAdmin.pl").Estassonalgunasdelasfuncionesquesepuedenrealizarutilizandoel
Comando"dbAdmin.pl":
Verifiquecolumnasdetabla/Actualizar:
/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plmesas
EstecomandocomprobarlaconfiguracindecolumnadetodosOpenGTStablaseinformarsobrelascolumnasquefaltan,uotro
23/51
18/6/2015
anomalas.SiunOpenGTSnoexistelatabla,secrear.
/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plmesas=c
AlactualizaraunaversinmsrecientedeOpenGTSenquelasnuevascolumnassehanaadidovariastablas,loanterior
comandoemitirlarequerida"ALTERTABLE"comandosparalastablascomoseanecesarioconelfindeagregarcualquiernuevatabla
lascolumnas.Siun"tipo"especficacolumnahacambiado,elusode"mesas=ca"harquelostiposdelascolumnasparaseralterados.
O,enWindows:
C:\>OpenGTS_1.2.3mesasbin\dbConfig.bat:ca
EstecomandosedebeutilizarsiemprelaactualizacinaunaversinmsrecientedeOpenGTS.
Volcarlastablaseneldisco:
/usr/local/OpenGTS_1.2.3>bin/dbAdmin.pldumpdir=/tmp/gts
EstecomandovolcartodosOpenGTStablaseneldirectorioespecificadoporelargumento"dir"("/tmp/gts"esel
destinopordefectosinoseespecificalaopcin"dir").SiesrequeridoporlainstalacindeMySQL,esposiblequetambintengaque
especifiqueelusuariorootdebasededatos(esdecir.,comoen"rootUser=<usuario>").Mesasindividualespueden,posteriormente,volveracargarconel"
=<table>opcindecarga".
(NotaparalosusuariosdeLinux:EnalgunasversionesdeLinuxqueempleanSELinux,puederecibirunerrorqueindicaque
MySQLnoestpermitidoescribireneldirectorioespecificado.Enestoscasos,puedequetengaqueespecificarundirectorio
queMySQLestpermitidoescribiren,ocambiarlaconfiguracindeseguridaddeSELinuxparaproporcionarMySQLconautorizacinparaescribir
eneldirectorio"/tmp".)
Tablasdecargadedisco:
/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plload=<table>dir=/tmp/gts
Estecomandosecargalatablaespecificadadesdeelarchivopreviamentecreadoporelargumento"dump".Durantelamesa
carga,secorrespondenenloposiblecolumnas.Siunacolumnaestpresenteenelarchivode'dumping',perosehaeliminadoenel
tablaactualGTS,segenerarunaadvertenciadequelacolumnasehacado.Estecomandoestilcuandopequea
cambiosdelatabladebenserrealizadosenlaestructuradelacolumna.[Nota:loscorchetesespecificadosanteriormenteindicanquela
opcindentrodeloscorchetesesopcional.Loscorchetesnodebenespecificarseliteralmenteenlalneadecomandossiel
argumentoopcionaldentrodeloscorchetesseutiliza].
Pgina29de62
Pgina30
8) Instalacin/PuestaenmarchadelOpenDMTP,TK10xymdulosDCSAspicore
Enestaseccinsedescribecmoiniciarydetenerel"gtsdmtp","tk10x",yelservidordecomunicacindeldispositivo"Aspicore"
Mdulos(DCS),sinembargoestasinstruccionestambinsonaplicablesaotrosservidoresdecomunicacionesdedispositivosquepuedentambin
serinstaladoopuestoenprctica.
MsinformacinsobrelaOpenDMTPproyectosepuedeencontrarenelvnculo"http://www.opendmtp.org".Apoyopara
OpenDMTPdispositivoscompatiblesseincluyenenOpenGTSconelservidordecomunicacindeldispositivo"gtsdmtp"(DCS).
ElmduloDCS"tk10x"escompatiblecondispositivoscompatiblesTK102/TK103protocolomscomn(Nota:algunosfabricantes
produccindeundispositivoTK102/TK103puedeserelusodesupropiavarianteprotocolopersonalizadoquenoescompatibleconel
TK102comn/protocoloTK103).
AspicoreofrecesoftwaredeltelfonodelclienteparaelseguimientodelosdiferentestelfonosNokia,SamsungySonyEricsson.La
AspicoreDCSdentrodelpaqueteOpenGTSestdiseadoparatrabajarconelTCPoUDPmtododetransportededatosquepuede
configurarsedentrodelaaplicacindetelfonodelclienteAspicore.Paraobtenermsinformacinsobresustelfonoscompatibles,ypara
obtenersusoftwarecliente,vistitsusitioweben"http://www.aspicore.com/en/tuotteet_tracker.asp?tab=2&sub=1".
8.1)Configuracindelarchivo"dcservers.xml"
Elarchivo"dcservers.xml"contienealgunaspropiedadesconfigurablesqueafectanalaejecucindelaOpenDMTP
("Gtsdmtp")yAspicore("")Aspicoreservidores.Lamayoradelosvaloresdelaspropiedadessedebedejarcomosuvalorpordefecto,
perolosvaloressiguientespropiedadessepuedenajustaralaspropiasdesuentornooperativo:
OpenDMTP:
tcpport="31000"
UDPport="31000"
24/51
18/6/2015
TK10X:
tcpport="31272"
UDPport="31272"
Aspicore:
tcpport="31265"
UDPport="31265"
Estospuertosseespecificanenlaetiqueta"ListenPorts"parasurespectiva"DCServer",ysonlospuertospredeterminadosen
queestosservidoresescuchanparalasconexionesentrantesdelosdispositivosremotos.Puedecambiarestepuertoalcambiarla
valorenesteatributodeetiqueta.Tambinpuedeindicarvariospuertosespecificandoconseparadoresdecoma.(Esdecir.
'Tcpport="31000,31100"').
8.2)Iniciodelservidordecomunicacindedispositivos
El"gtsdmtp","tk10x",oservidor"Aspicore"sepuedeiniciarlasiguientemanera:
/Zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>bin/runserver.shsservidor
Donde"servidor"debesustituirseporelnombreespecficodelservidorparaempezar(esdecir."gtsdmtp","tk10x",o
"Aspicore").
Pgina30de62
Pgina31
8.2a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:
Obien,laversindePerldeestecomandosepuedeutilizarsinnecesidaddeestarenelOpenGTSdirectoriodeinstalacin:
/Zzz>$GTS_HOME/bin/runserver.plsservidor
EnWindows,elcomandosepuedeomitirlos"s"ypuedeserintroducidadelasiguientemanera:
C:\>cd\OpenGTS_1.2.3
C:\OpenGTS_1.2.3\>\bin\runserver.batservidor
Elservidorinicializaryempezaraescucharenelpuerto(s)especificadoporel"ListenPorts"etiquetaenel"dcservers.xml"
presentarparalaespecficadenominadaDCServer.Paracambiarelpuertoenlalneadecomandosescucha,sepuedeaadirunargumento"port"
comosigue:
/Zzz>$GTS_HOME/bin/runserver.plsservidorport31123
OenWindows:
C:\OpenGTS_1.2.3\>\bin\runserver.batservidorport:31123
Paraestablecerescuchandoenelpuerto"31123".
Tambinpuedeagregarlalneadecomandosopcin"debugMode"parahabilitarelregistrodeniveldedepuracin.
Mientrasseejecutaenmodode"fondo",losregistrosdesalidaseguardanenelarchivo"$GTS_HOME/logs/
servidor.log".(Elarchivo
"servidor.out"tambinsecrepor"runserver.pl"paracapturarlasalidaastdout/stderr,peroloharnormalmentepermanecervaco).
Cuandoseprueba/depuracin,tambinpuedeiniciarunservidor"interactiva".Esdecir,elservidorseejecutaenelprimerplano(esdecir.No
'Segundoplano'),ytodaslassalidasderegistroseenvaalaconsolaenlugardelarchivoderegistro.Parainiciarunservidor"interactiva",agrega
laopcin"i"paralalneadecomandos,delasiguientemanera:
/Zzz>$GTS_HOME/bin/runserver.plsservidori
(Paradetenerelservidorenestemodo,slotienequepulsar'ControlC')
8.3)Detenerelservidordecomunicacionesdedispositivos
Cuandoseiniciaenmodode"fondo"(esdecir.Sinlaopcin"i"),secreaunarchivo"IdentificacindeProcesos"(PID)en
"$GTS_HOME/logs/
servidor.pid",quecontieneelprocesodeidentificacindelatareaensegundoplano.Estearchivoseutilizaparadetenerla
25/51
18/6/2015
servidorconelcomando:
/Zzz>$GTS_HOME/bin/runserver.plsservidorkill
Donde"servidor"debesustituirseporelnombreespecficodelservidorparaempezar(esdecir."gtsdmtp","tk10x",o
"Aspicore").
Pgina31de62
Pgina32
EnlossistemasLinux,elcomandoPerl"psjava ",IncluidoconOpenGTS,sepuedeutilizarparamostrarinformacinsobre
quservidoresdecomunicacindedispositivosActualmenterunningr:
/Zzz>$GTS_HOME/bin/psjava
PIDPadresLUsuarioclaseJava/jar
215(1)1OpenGTSorg.apache.catalina.startup.Bootstrap
8115(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/gtsdmtp.jar
8120(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/tk10x.jar
8123(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/aspicore.jar
8129(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/template.jar
EstecomandoenumeratodoslosconocidosprocesosenejecucindeJava,consuPIDasociado(procesoid),padrePID,usuarioy
ClaseJavaounarchivojarqueseestejecutandoactualmente.El"
"Procesoindica
org.apache.catalina.startup.Bootstrap
ApacheTomcatqueseestejecutandoconelPIDindicada."
gtsdmtp "," tk10x ","Aspicore",y"
plantilla "Indicarsu
respectivosservidoresdecomunicacindeldispositivoenfuncionamiento.
8.4)Adicindeunnuevoregistrodedispositivos
Unavezqueelservidordecomunicacionesdispositivoadecuado(DCS)estenejecucin,iniciesesinenunacuentaquedeseatenerlapropia
dispositivo/telfonoqueserelseguimientoyagregarunnuevoregistrodedispositivos/vehculoenlapgina"Admindispositivos".
OpenDMTP:
DispositivosOpenDMTPsuelenutilizarla"cuenta"realyde"dispositivo"deidentificacin.Enestecaso,asegresedequelacuentayeldispositivo
IdentificacindelprogramadoeneldispositivocompatibleconOpenDMTPcoincideconlamismacuentaydispositivodeIdentificacincreadodentrodela
SistemaOpenGTS.
TK10x:
DispositivosTK102/TK103normalmentereportansuinformacindeidentificacinnicamedianteelnmeroIMEIdelmdem.Enel
"Dispositivodeadministracin"delapgina,configurarel"SteamIDcampo"alvalordeIMEIenelformato[tk_12345679012345],donde
"123456789012345"eselnmeroIMEIdeltelfono(El"tk_prefijo"seutilizaparaayudaraidentificareltipodedispositivo
servidordecomunicacionesutilizadoparaanalizarlosdatosenestecasoTK102/TK103).
Aspicore:
ElsoftwaredeclienteAspicoreinformadelainformacindeidentificacinnicautilizandoelnmeroIMEIdeltelfono.Enel
"Dispositivodeadministracin"delapgina,configurarel"SteamIDcampo"alvalordeIMEIenelformato[s60_12345679012345],donde
"123456789012345"eselnmeroIMEIdeltelfono(El"s60_prefijo"seutilizaparaayudaraidentificareltipodedispositivo
servidordecomunicacionesutilizadoparaanalizarlosdatosenestecasoAspicore).
Pgina32de62
26/51
18/6/2015
Pgina33
9) Creacindesupropioservidordecomunicacindedispositivos
ParaqueOpenGTSpararecibirdatosdeundispositivo,unpersonalizado"ComunicacinDeviceServer"tendrqueser
implementadoqueentiendeelprotocoloutilizadoparacomunicarseconeldispositivoremoto,yelinsertorecibieventosen
labasededatosSQL.Enestaseccinseofreceunabrevedescripcindelejemploservidores'plantilla'provistoOpenGTS
paralaimplementacindesupropioservidordecomunicacionesdispositivoremoto.
Elmtodoutilizadopordispositivosremotosparaeltransportedeeventosalservidorvaraengranmedidaconelfabricantedeldispositivo.
AlgunosdatosdetransporteaunservidoratravsdemensajesSMS,algunosusanuntransportedecorreoelectrnicoSMTPparaenviardatosaunservidor,algunos
utilizarunprotocolobasadoenHTTPquecodificanlosdatosenlasolicitudalservidor,ymuchosutilizanalgunaformadeprimasocket
comunicacinbasadaen(atravsdeTCP/UDP)paraconectarseaunoyenteenelservidorparatransmitirdatos.Conelfindecrearundispositivo
servidordecomunicacionesqueescapazdeanalizarlosdatosdeentradadeundispositivo,unacomprensinntimadelascaractersticasespecficasde
Serequiereelprotocoloutilizadoporelfabricantedeldispositivo.OpenGTSincluyeejemplosparaservidoresbasados
enHTTP,y
losservidoresbasados
enbrutosockets(soporteTCPyUDP),sinembargo,yaquecadafabricantedeldispositivotienenormalmentesu
propioprotocoloymododetransportededatos,estosservidoresejemplo,nosepuedesuponerquesoloeltrabajoconcualquier/todos
dispositivo.Dependiendodeldispositivoparticularelegido,puedehaberunacantidadsignificativaysustancialdetrabajo
necesarioparaapoyareldispositivodehardwareelegido.
Elprimero,ymsimportante,elpasoalcomenzaraimplementarunservidordecomunicacionesdedispositivoparaunhardwareelegido
dispositivoesobteneryentendercompletamenteladocumentacindelprotocolodelfabricantedeldispositivo.Mientrashttp
comunicacinbasadaamenudopuedeseringenierainversadelaobservacindelosdatosquelleganalservidor,elintentode
ingenierainversadeunprotocolobasadoenbrutosocketspuederesultarextremadamentedifcil,sinoimposible,sinprotocoloadecuado
documentacin.
9.a)NotaimportanteconrespectoalaIMPLEMENTACINdeunservidordecomunicacionesdeldispositivo:
Laimplementacindeunservidordecomunicacionesdedispositivoparaundispositivodadopuedetomarunacantidadsignificativaysustancial
detrabajodeprogramacinparallevaracabo,dependiendodelprotocolodedispositivo.Paraimplementarunservidor,esprobableque
necesitaunacomprensinenprofundidaddelacomunicacinbasadaenTCP/UDP,yunabuenacomprensindeJava
tcnicasdeprogramacin,incluidalacomunicacinzcalo,multithreadingymanipulacinposiblementebitabit
tcnicasparalaextraccindeloscamposdebitsdedatosbinarios(incluyendosabersieldispositivodeseguimientoenvadatos
enformatosgrandesendianolittleendian).SiseutilizaunprotocolobasadoenHTTP,esposiblequetengaunacomprensinde
cmolosservletsseconstruyen,ycmofuncionandentrodeuncontenedordeservlets,comoApacheTomcat.
Pgina33de62
Pgina34
9.1)ServidoresdeComunicacindispositivobasadoenHTTP(utilizandoelservlet"GPRMC")
[Habilidadesnecesarias:Java,servlets,protocolosbasados
enHTTP]
LacomunicacinbasadaenHTTPestpicamenteelmsfcildeimplementar.Sisudispositivoderastreoremotoenvamensajesala
servidorusandounprotocolodecomunicacinHTTPbase,entonceselservidordeejemplo'GPRMC'puedesermodificadoparaanalizar
recibidodatoseinsertarloenlabasededatosSQL.Lasfuentesparaelservidor'GPRMC'(elnombredelacifrarcordde$GPRMC
enelprotocoloNMEA0183)sepuedeencontrarenelOpenGTSdirectoriodeorigen"src/org/OpenGTS/guerra/GPRMC"y
correcomounservletenuncontenedordeservletscomoApacheTomcat(yusalosmismospuertosdeaccesoconfiguradaspara
27/51
18/6/2015
Tomcat).
9.1.1)Configuracindelservlet"GPRMC":
Estemdulohaincorporadomuchasopcionesconfigurablesyslopuedetenerpropiedadesespecialesdepersonalizacinquepuedenser
especificadoenelarchivo"webapp.conf".Lasiguienteesunalistadepropiedadesconfigurablesdisponiblesparael"GPRMC"http
basadoservidordecomunicacionesdeldispositivo:
Formatodedatos/valorClavesdelapropiedad:
gprmc.logName
Registrodenombredesalida.
Valorpordefecto:GPRMC
gprmc.uniquePrefix
PrefijoUniqueID,utilizacuandolasoperacionesdebsquedaDispositivo.
Valorespredeterminadosdevalor:(igualque"gprmc.logName"valordelapropiedad)
gprmc.defaultAccountID
IDdelacuentapordefecto.
gprmc.minimumSpeedKPH
Velocidadmnimaaceptable(aceleramenosdeestevalorseestableceen'0')
Valorpordefecto:0.0
gprmc.estimateOdometer
Desercierto,secalcularunodmetroGPSbasado.
Valorpordefecto:falso
gprmc.simulateGeozones
Siesverdad,unallegadaGeozona/salidasserdetectadoysecrearloseventosadicionalesoportunas.
Valorpordefecto:falso
gprmc.dateFormat
Formatodefechaparaelparmetro'fecha'.
Valoresvlidos:NINGUNO,EPOCH,AMD,DMY,MDY
Valorpordefecto:AMD
gprmc.response.ok
Respuestavolvialdispositivoenlarecepcindedatosconxito.
Valorpordefecto:(nadavolvi)
gprmc.response.error
Respuestaderegresadispositivoenelxito(deerror)larecepcindedatos.
Valorpordefecto:(nadavolvi)
Pgina34de62
Pgina35
URLdeparmetrosTeclasdelapropiedad:
gprmc.parm.unique
URLdeparmetrosclave:UniqueID
Valorpordefecto:Identificacin
gprmc.parm.account
URLdeparmetrosclave:CuentaID
Valorpordefecto:ctas
gprmc.parm.device
URLdeparmetrosclave:DispositivoID
dev
Valorpordefecto:
gprmc.parm.auth
URLdeparmetrosclave:Aut/contrasea(noseutiliza)
Valorpordefecto:(enblanco)
gprmc.parm.status
URLdeparmetrosclave:StatusCode
Valorpordefecto:cdigo
gprmc.parm.gprmc
URLdeparmetrosclave:GPRMC
(SeesperaqueelNMEA0183rcorddeGPRMCparaestevalordeesteparmetro)
gprmc.parm.date
URLdeparmetrosclave:Fecha(ignorasi'gprmc.parm.gprmcseespecifica')
Valorpordefecto:fecha
gprmc.parm.time
28/51
18/6/2015
URLdeparmetrosclave:Tiempo(ignoradosi"gprmc.parm.gprmcseespecifica')
Valorpordefecto:eltiempo
gprmc.parm.latitude
URLdeparmetrosclave:Latitud(ignorasi'gprmc.parm.gprmcseespecifica')
Valorpordefecto:lat
gprmc.parm.longitude
URLdeparmetrosclave:Longitud(ignorasi'gprmc.parm.gprmcseespecifica')
Valorpordefecto:lon
gprmc.parm.speed
URLdeparmetrosclave:clavedeparmetrosdevelocidad(kph)(ignorasi'gprmc.parm.gprmcseespecifica')
Valorpordefecto:velocidad
gprmc.parm.heading
URLdeparmetrosclave:Titulo(grados)(ignorasi'gprmc.parm.gprmcseespecifica')
Valorpordefecto:lacabeza
gprmc.parm.altitude
URLdeparmetrosclave:Altitud(metros)
Valorpordefecto:alt
gprmc.parm.odometer
URLdeparmetrosclave:cuentakilmetros(kilmetros)
Valorpordefecto:odom
gprmc.parm.address
URLdeparmetrosclave:DireccingeocodificadasInvertir
Valorpordefecto:dir
gprmc.parm.driver
URLdeparmetrosclave:DriverID
Valorpordefecto:drv
gprmc.parm.message
URLdeparmetrosclave:Mensaje
Valorpordefecto:msg
Pgina35de62
Pgina36
9.1.2)Incumplimiento"GPRMC"Configuracin:
Elcofigurationdefecto"GPRMC"(sincambiosdeconfiguracinespecialesrealizadosenelarchivo"webapp.conf")esperaun
httpbasaURLsiguienteformato:(laURLacontinuacinmuestralosdiferentescamposenlneasseparadas,peroseenvanormalmente
alservidorcomounanicaURLtodoenunasolalnea):
http://example.com:8080/gprmc/Data?
id=123456789012345y
code=0xF020y
GPRMC=$GPRMC,080.701,00,A,3128,7540,N,14257.6714,W,000.0,000.0,180707,,,A*1C
Donde
http://example.com:8080/gprmc/Data?
Representaelanfitrin:("?/GPRMC/Data")puerto("example.com:8080")y"gprmc.war"ubicacinservlet
123456789012345
RepresentaelIDdemvilnicodeldispositivo(talcomoelIMEI#).(Estevalordebeintroducirseenel"Administradordedispositivos"
Pginadecampo"SteamID"enelformato"gprmc_123456789012345").
0xF020
Representaelcdigodeestadoseutilizaparaidentificarelmotivodelevento.Elcdigodeestadoseutilizaaqudebecoincidirconelmaleficio,o
valordecimaldeuncdigodeestadoqueapareceenlaseccin"Cdigosdeestadoydescripciones"manualenlasiguienteubicacin:
http://www.geotelematic.com/docs/StatusCodes.pdf
Ademsdeunodeloscdigosdeestadoanterioreshexagonales/decimales,cualquieradelossiguientesnombresenclavedetextotambinsepuedeusar,locualloh
automticamenteseconvertirnenEscorrespondientecdigodeestadobasadoenhexagonalcuandoseintroduceenlatablaEventData:GPS,
PNICO,Waymark,etc,(verfuenteGPRMCmdulo"Data.java"paraobtenerunalistaactual).
$GPRMC,080.701,00,A,3128,7540,N,14257.6714,W,000.0,000.0,180707,,,A*1C
RepresentaelNMEA0183$GPRMCcosasclarasdesdeelreceptorGPS.
9.1.3)Laconstruccindelservlet"GPRMC":
Elarchivo"gprmc.war"seconstruyeautomticamenteporlosOpenGTS"hormigatodo"decomandos,perotambinpuedeserconstruidoespecficamentecon
elsiguientecomando:
GPRMChormiga
Despusdehacerloscambiosdeconfiguracinenlaspropiedadesanteriores,elarchivo"gprmc.war"debeserreconstruidoyreubicen
Paraqueloscambiosdeconfiguracinsurtanefecto.
Sinecesitarealizarcambiosenestemdulodefuenteparaapoyareldispositivo,serecomiendaquecopielafuente
archivosaundirectorionuevo(recuerdequecambiarelnombredelpaquetedeJava,ytambincopiar/modificarlainformacin"web.xml"
29/51
18/6/2015
encontrarenla"guerra/GPRMC/WEBINF/web.xml"),acontinuacin,modificarlasfuentescopiadasconloscambiosespecficosrequeridosporsu
dispositivorastreador.
NecesitarEstemduloparaserconfiguradoeinstaladoenuncontenedordeservlets,similaralprocesodeinstalacinseutilizapara
otrosservletsenestadocumentacin.
Consulteelcdigofuentedelservidor'GPRMC'directamenteparaobtenerinformacinadicional.(Elcdigofuentedeestemdulosepuedenencontraren
eldirectorio"src/org/OpenGTS/guerra/GPRMC/").
Pgina36de62
Pgina37
9.2)RawSocketServerBasedComunicacinDispositivo
[Habilidadesnecesarias:Java,lacomunicacinTCP/UDPsocket,multithreading,manipulacinbitabit,clientegenerales/servidor
protocolos]
Sisudispositivoderastreoremotoenvamensajesalservidormedianteunprotocolodecomunicacinbasadoenlatomadecorriente,entoncesel
ejemploservidor'plantilla'sepuedemodificarparaanalizarlosdatosrecibidosylainsertaenlabasededatosSQL.Lasfuentespara
elservidor'plantilla'sepuedeencontrarenelOpenGTSdirectoriodeorigen"src/org/OpenGTS/servidores/plantilla".
EstetipodeservidorseejecutacomounprocesoindependientequeescuchaenunpuertodesocketseleccionadoparalasconexionesTCP/UDPentrantes.
Esprobablequetengaquehaceralgunoscambiossignificativosenelcdigofuenteparaapoyarasudispositivoenparticular.Es
recomiendaquecopielosarchivosdeorigenaundirectorionuevo(recuerdequedebecambiarelnombredelpaqueteJava),acontinuacin,
modificarlasfuentescopiadasconloscambiosespecficosrequeridosporeldispositivodeseguimiento.
stossonalgunosdelosprincipalesatributosdelprotocoloquedebendeterminarseantesdecomenzaraimplementarunaredTCP/UDP
socketbasadoservidordecomunicacionesdeldispositivo:
SonlospaquetesdeprotocolotransmitidasenASCII,binario,oambos?
Cmoeslalongitudrealdeunpaquetedeclientedeterminado(estoesextremadamenteimportante)?
Culessonlosdiversostiposyelcontenidodelospaquetesrecibidosdesdeelcliente?
Paralospaquetesbinarios,soncamposenteroscodificadosenformatobigendianolittleendian?
Qupaquetesderespuesta,silahay,eselclienteesperarecibirdelservidor?
ServidorElejemplo'plantilla'contienelossiguientesmdulosdefuente:
Constants.javaEstemduloconstainsmayoradelasopcionesconfigurablespersonalizadosutilizadosparaapoyarsu
protocolodedispositivoremotoespecfico.Talescomolostiemposdeespera,longitudesmnimay/omximadepaquetes,ASCII/codificacinbinaria,
etc.Lainformacinbsicasobreeltipodeprotocolosedebeestablecerenestemdulo.
Main.javaEsteeselprincipalpuntodeentradaparaelservidoryprobablementenotendrquesermodificado.
TrackClientPacketHandler.javaElobjetivodeestemduloescomprendelascaractersticasespecficas
delprotocolodecomunicacinparaeldispositivoremoto,yrequerirlamayorpartedelapersonalizacinsignificativa
necesariaparaapoyareldispositivoremoto.Aquesdondeseidentificanlospaquetesdeclientesentrantes,losdatosseanalizay
insertanenlastablas,ylasrespuestasrequeridassedevuelvenaldispositivocliente.
TrackServer.javaEstaesunaenvoltura/controladorparaun/sesinUDPTCPylosdelegadosmscontrolala
ClaseTrackClientPacketHandler.
Esteentornodeservidor/marcomanejalaescuchadeconexionesentrantesymultithreadingparausted(esteservidor
puedemanejarmltiplesconexionessimultneasentrantes),ascomolamayoramanejodeerrores.
Cuandoseutilizaelejemplodeservidor"plantilla"comobaseparasupropioservidordecomunicacindeldispositivo,serecomienda
quecopielosarchivosde'plantilla'enunacarpetanueva(yportantounnuevopaquetedeJava)elnombredesuelegido
dispositivodelocalizacin/telemtica(esdecir.,talescomo"acme1000").Elarchivo"build.xml"tambindebesermodificadoparaincluirun"objetivo"
paraelnombredelservidorelegido.Paraconstruirelejemplodelservidor'plantilla',elobjetivodelahormiga'plantilla'sepuedeutilizarcomo
delasiguientemanera:
>Plantilladelahormiga
Esteobjetivo'plantilla'en'build.xml'sepuedecopiarparacrearsupropioobjetivoespecficoacumulacindehormigasparasudispositivoelegido
Nombredelservidordecomunicaciones.
Consulteelcdigofuentedelservidor'plantilla'directamenteparaobtenerinformacinadicionaldepersonalizacin.
El"icare"servidortambinestdisponible(eneldirectoriodeorigen"src/org/OpenGTS/servidores/Icare/"),queapoya
eldispositivoICareG3300.Estemdulodeservidordecomunicacionesdispositivotambinpuedeserexaminadoenbuscadeayudaenlacreacindesupropio
personalizadoservidordecomunicacionesdeldispositivo.
30/51
18/6/2015
Pgina37de62
Pgina38
9.2.1)Iniciodelservidordecomunicacindedispositivos
Unavezquesuarchivojarservidorsehacreado,puedeutilizarelcomando"bin/runserver.sh"(o" runserver.bat
Windows)parainiciarelservidordecomunicacindeldispositivodelasiguientemanera:
"Enla
/Zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>bin/plantillarunserver.shs
9.2.1.a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:
Loscomandosqueterminanen".sh"o".bat"DEBENserejecutadosdesdeelOpenGTSdirectoriodeinstalacin.Intentando
paraejecutarestoscomandosdesdeotrodirectoriopuederesultarenun"ClassNotFoundException"o
Obien,laversindePerldeestecomandosepuedeutilizarsinnecesidaddeestarenelOpenGTSdirectoriodeinstalacin:
/Zzz>$GTS_HOME/bin/runserver.plsplantilla
EnWindows,elcomandosepuedeomitirlos"s"ypuedeserintroducidadelasiguientemanera:
C:\>cd\OpenGTS_1.2.3
C:\OpenGTS_1.2.3\>\bin\templaterunserver.bat
Elservidorinicializaryempezaraescucharenelpuerto(s)especificadoenelarchivo"dcservers.xml"parala"plantilla"
servidor.Elpuertopredeterminadoes31200.Paracambiarelpuertodeescuchaenlalneadecomandos,un"
port "Puedeseraadidocomosigue:
/Zzz>$GTS_HOME/bin/runserver.plsplantillaport31123
O,enWindows:
C:\OpenGTS_1.2.3\>\bin\templaterunserver.batport:31123
Paraestablecerescuchandoenelpuerto"31123"(porejemplo).
Tambinpuedeagregarlalneadecomandosopcin"debugMode"parahabilitarelregistrodeniveldedepuracin.
Mientrasseejecutaenmodode"fondo",losregistrosdesalidaseguardanenelarchivo"$GTS_HOME/logs/template.log".(El
archivo"template.out"tambinsecreaenestedirectorioparadetectarcualquier/mensajesstderrstdoutquesemuestrandentrodela
servidorquenoutilizanlafuncinderegistro'Imprimir'integradoenOpenGTS.Normalmente,estearchivodebealwayestarvaco).
Cuandoseprueba/depuracin,tambinpuedeiniciarunservidor"interactiva".Esdecir,elservidorseejecutaenelprimerplano(esdecir.No
'Segundoplano'),ytodaslassalidasderegistroseenvaalaconsolaenlugardelarchivoderegistro.Parainiciarunservidor"interactiva",agrega
laopcin"i"paralalneadecomandos,delasiguientemanera:
/Zzz>$GTS_HOME/bin/runserver.plsplantillai
(Paradetenerelservidorenestemodo,slotienequepulsar'ControlC')
Pgina38de62
Pgina39
9.2.2)Detenerelservidordecomunicacionesdedispositivos
Cuandoseiniciaenmodode"fondo"(esdecir.Sinlaopcin"i"),secreaunarchivo"IdentificacindeProcesos"(PID)en
"$GTS_HOME/logs/template.pid",quecontieneelprocesodeidentificacindelatareaensegundoplano.Estearchivoseutilizaparadetener
elservidorconelcomando:
31/51
18/6/2015
/Zzz>$GTS_HOME/bin/runserver.plsplantillakill
EnlossistemasLinux,elcomandoPerl"psjava ",IncluidoconOpenGTS,sepuedeutilizarparamostrarinformacinsobre
quelosservidoresdecomunicacindedispositivosseestnejecutandoactualmente,incluyendoel"
plantilla "Servidor:
/Zzz>$GTS_HOME/bin/psjava
PIDPadresLUsuarioclaseJava/jar
215(1)1OpenGTSorg.apache.catalina.startup.Bootstrap
8115(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/gtsdmtp.jar
8129(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/template.jar
EstecomandoenumeratodoslosconocidosprocesosenejecucindeJava,consuPIDasociado(procesoid),padrePID,usuarioy
ClaseJavaounarchivojarqueseestejecutandoactualmente.El"
"Procesoindica
org.apache.catalina.startup.Bootstrap
ApacheTomcatqueseestejecutandoconelPIDindicada."
gtsdmtp "Y" plantilla "Indicarsurespectivofuncionamiento
Servidoresdecomunicacionesdeldispositivo.
9.3)ArchivodeconfiguracinXMLentiempodeejecucin.
Losservidoresdeprimasabasedeenchufedecomunicacindeldispositivo(comoelejemplodeservidor'plantilla')apoyareltiempodeejecucin
configuracinmedianteelarchivo"dcservers.xml".Unformatodeejemplodela"dcservers.xml"eslasiguiente:
<DCServerConfig
BindAddress=""
atraso=""
PortOffset="0"
includedir="dcservers"
>
<ArchivoIncluir="dcserver_template.xml"opcional="true"/>
<DCServername="icare">
...
</DCServer>
...
</DCServerConfig>
LosatributosparalaetiquetaDCServerConfigincluyenlossiguientes:
:EsteatributoespecificaladireccinIPonombredehostlocalalaqueseunirelservidor.Estoes
BindAddress
tilcuandoelservidorlocaltienemsdeunadireccinIP,ynecesitaenviarpaquetesUDPdenuevoauncliente
dispositivo.Sisedejaenblanco,elservidorseuniraladireccinIPlocalpredeterminada.
Lalongituddelacolamximaparalasindicacionesdeconexinentrantes(unasolicitudparaconectarse).Siuna
atrasos
indicacindeconexinllegacuandolacolaestllena,serechazalaconexin.Sisedejaenblanco,oes0omenos,entoncesel
seutilizarelvalorpordefectoatraso.Veala"java.net.ServerSocket"claseparamsinformacin.
:Estevalorseaadeacualquierespecificacinpuerto.Amenosqueseanecesariodeotromodoparaelsistemaespecfico
PortOffset
requisitos,estevalordebepermaneceren"0".
:Silaetiqueta"DCServerConfig"contieneningn"Incluir"subetiquetas,esteeseldirectorioqueser
includedir
buscarlosarchivosincluidos.
Pgina39de62
Pgina40
Unejemplo"Incluir"formatodeetiquetaeslasiguiente:
<ArchivoIncluir="dcserver_template.xml"opcional="true"/>
LosatributosparalaetiquetaIncluyaincluyenlossiguientes:
:Esteatributoespecificaelnombredelarchivoaincluir.Elarchivoincluyetambindebeserunaadecuada
expediente
formatodearchivoXMLDCServerConfig.Todoslosservidoresdecomunicacionesdedispositivodefinidosdentrodeesteincluyeronarchivo(comosedefine
porlasetiquetas"DCServer")seaadiralosservidoresdecomunicacionesdedispositivodefinidosenotraspartesenestearchivoXML.
RecursivaIncluirdirectivasnoestnpermitidos.
:Esteatributoespecificasilaincluyenserequierearchivodeexistir.Siestevalores"verdadero"yel
opcional
incluirarchivonoexiste,ysemostrarelerror.Siestevalores"falso"yelarchivodeinclusinnoexiste,
acontinuacin,eldirectoriodeinclusinseignoraensilencio.
Unejemploformatodeetiqueta"DCServer"eslasiguiente:
<NombreDCServer="plantilla">
<Descripcin><![CDATA[
32/51
18/6/2015
ServidorEjemploPlantilla
]]></Description>
<UniqueIDPrefix><![CDATA[
TEMPLATE_
imei_
*
]]></UniqueIDPrefix>
<ListenPorts
tcpport="31200"
UDPport="31200"
/>
<Propiedades>
<Inmuebleconclave="minimumSpeedKPH">4.0</propiedad>
<ClaveInmueble="estimateOdometer">true</propiedad>
<ClaveInmueble="simulateGeozones">true</propiedad>
</Properties>
</DCServer>
ElatributodelaetiquetaDCServersonlossiguientes:
nombre :Esteatributoesobligatorioyespecificaelnombredelservidordecomunicacionesdeldispositivo.Laespecificada
nombredebesernicoentretodoslosservidoresdecomunicacionesdedispositivoscargados.Sielnombredeundispositivodecomunicacin
seencuentraelservidorqueyasehadefinido,laentradaDCServerllamadoposteriorserignorado.
"Descripcin"subetiqueta:
Estaetiquetaespecificaladescripcinopcionaldelservidordecomunicacionesdeldispositivo.
"UniqueIDPrefix"subetiqueta:
Estaetiquetaespecificalosprefijosopcionales"UniqueID"queseutilizarncuandoseestbuscandoeldispositivomvilidenel
Tabladedispositivos.Enelordenespecificado,elprefijoespecificadoseantepondralmvilidentonceselIDresultantees
arribamiradoenelcampodelatabladedispositivos"IDunico".Sinoloencuentra,entoncesseusarlasiguienteprefijo.Elprefijo
especificacin"*"significaqueelmvilidserutilizadotalcual(sinprefijoantepuesto).
Pgina40de62
Pgina41
"ListenPorts"subetiqueta:
Estaetiquetaespecificalospuertosenlosqueelservidordecomunicacionesdispositivoescucharlasconexionesentrantesdesde
dispositivosremotos.El"tcpport"atributoespecificaelpuertoenelquesepondrenmarchaunoyenteTCP.Elatributo
"UDPport"especificaelpuertoenelquesepondrenmarchaunoyenteUDP.Sibien"tcpport"o"UDPport"esblanco,o
noseespecifica,noseiniciarelcorrespondiente"oyente".
"Propiedades"subetiqueta:
Estaetiquetaincluye"propiedad"subetiquetasqueespecificanlaspropiedadesdeejecucinquepuedenserutilizadosparaespecificaranmsla
comportamientodelservidordecomunicacindeldispositivoentiempodeejecucin.Laspropiedadesestndarquelamayoradecomunicacindeldispositivo
servidorreconocersonlossiguientes:
:(Doble)EstapropiedadespecificalavelocidadmnimaaceptablebasadoenGPS.Unavelocidad
minimumSpeedKPH
valorbeowelvalorespecificadoporestapropiedadserconsideradaunavelocidadde'0'.EstoseutilizaparamitigarGPS
valoresdevelocidadquepuedeindicarmovimiento,inclusocuandoelreceptorGPSesestacionario.
:(Booleano)EstapropiedadespecificasiunvalordelodmetrobasadoenGPSdebeser
estimateOdometer
calculadoautomticamentedelasubicacionesGPSvlidosreportadosporeleventoentrante.Elvalordelodmetro
eventoactualsecalculamedianteladeterminacindeladistanciadesdelaubicacindeleventoanterioraleventoactual
ubicacin,acontinuacin,aadirestadistanciaalalecturadelcuentakilmetrosanterior.
:(Booleano)Estapropiedadespecificasiloseventosentrantesdebenserrevisadaspara
simulateGeozones
Geozonallegar/salirocurrencias.Sisehaencontradoeleventoactualllegaatener,ohabersalido,desdeuna
Geozona(comoapareceenlatablaGeozona),entonceseleventoapropiado,conelcdigodeestadollegar/salir,ser
generadoeinsertadoenlatablaEventData.
Servidoresespecficosdecomunicacindispositivotambinpuedenapoyaraotrasespecificacionesdepropiedad.
33/51
18/6/2015
Pgina41de62
Pgina42
10)Internacionalizacin/Localizacin
ElOpenGTScdigofuenteesi18n("internacionalizacin")compatible,quesignificaquepuedeadaptarsealosdiversos
lanugagessinrequerirningncambiodecdigo(esdecir.nofijaeltextocodificadoquenosepuedecambiareneltiempodelapantalla).
Localizacin("L10n")eselprocesodeaplicacindeuntextoespecficodeidiomaparaunaconfiguracinregionaldeterminada.
10.1)Elapoyoaunanuevalengua
TodoeltextoIngls,queesvisualizableenelOpenGTSinterfazwebsepuedeencontrarenlosarchivosdepropiedadesderecursosllamados
"LocalStrings_en.properties"queseencuentradentrodelosdiferentesdirectoriosdearchivosfuente.Estosarchivoscontienenunalistadela
Inglstextopredeterminadoquesemostrarsinohayconfiguracinregionalespecficahasidoelegido.Elformatodeestearchivoes
"TextKey=valor",dondeel"textKey"esunidentificadornicoparaeltexto"valor"especfico.
10.1.a)Descarguelosarchivosmsrecientesdeconfiguracinregionalparalasiguientedistribucin:
Puededescargarunarchivozipquecontienelos"LocalStrings_xx.properties"Archivosparalaprximaversinde
OpenGTSenlasiguienteURL:
http://www.geotelematic.com/download.html#LocalStrings
Paraapoyarunnuevoidioma/locale,buscarcadaocurrenciadelosarchivos"LocalStrings_en.properties"y
crearunacopiallamada"LocalStrings_XX.properties"enelmismodirectorio,donde"XX"enestecasoeslaISO639
2letrascdigodeidioma.Luego,enelnuevoarchivo,retirelaprefijacin"#"carcterdecomentarioencadalneaclave=valor,y
modificarelvalordetextoparaquecoincidaconlasintaxisdeunlenguajeespecficoysignificado.Asegresededejarlallavedetextotalcual.La
contenidodelas"LocalStrings_XX.properties"archivosdebenserescritosusandosolamenteISO88591caracterescodificado
(Por"java.util.Properties"yrestricciones"java.util.ResourceBundle").Loscaracteresquenopuedenser
directamenterepresentadosenISO88591sepuedenincluirelusodeUnicodeescapaespecificandoelformato'\uXXXX',donde
"XXXX"eslarepresentacinhexadecimaldelcarcterUnicode.LainstalacindeJavaJDKincluyelaherramienta'native2ascii'
paraayudarconlaconversindetextoUnicodeaUnicodeescaptexto.
Siunarchivo"LocalStrings_XX.properties"nocontieneadecuadoUnicodecodificacin(esdecir.uninvlido"\uXXXX"
especificacin),yluegodeJavapuedeserincapazdecargarelarchivodepropiedades,yelarchivoLocalStringsespecficonopuedeserutilizado.
Paracomprobarquenohay"\unovlidosXXXX"especificacionesestnpresentes,elsiguientecomandoCheckInstallvalidarla
"LocalStrings_XX.properties"archivos:
/Zzz>$GTS_HOME/bin/checkInstall.shlocalStrings=$GTS_HOME/src
Estecomandobuscartodos"LocalStrings_XX.properties"archivosdela"
"Directorioy
$GTS_HOME/src
examinarsucontenidoparanovlidos"\uXXXX"especificaciones.SicualquierarchivoLocalStringscontienenovlido"\uXXXX"
especificaciones,elmensajedeerror"formatoincorrecto\codificacinuxxxx"servistoporelarchivoparticular.Estecomando
TambinsecompruebaquesloISO88591caracteresseutilizanenlosarchivosLocalStrings.
Laconfiguracinregionaldeidiomaespecficoqueapareceenlainterfazwebsecontrolamedianteelatributo"locale"enlaetiqueta"Dominio"
enelarchivo"private.xml".
Despusdehacerloscambiosenelarchivo"private.xml",ocualquieradelosarchivos"LocalStrings_XX.properties",que
Seguroquereconstruiryvolveraimplementarelarchivo"track.war".
10,2)Cambiodelidiomavisualizado
Configuracindelidiomavisualizadosepuedeconfigurarenelarchivo'private.xml'.Enlaetiquetade"Dominio",cambieel"locale"
34/51
18/6/2015
paraelcdigodepasde2letrasdeseado.Porejemplo,paracambiarelidiomaaalemn,establecerel"locale"Dominio
atribuira'locale="de"'.Tambinpuedeagregarunmendeseleccindeidiomadesplegablealapginadeiniciodesesinmedianteelestablecimientodela
Propiedad"accountLogin.showLocaleSelection"a"true".Lasseleccionesdeidiomaseespecificanenel
Etiqueta"SupportedLocales".
(Reconstruir/redistribuirelarchivo'track.war'despusdehacercualquiercambioenelfichero'private.xml'.)
Pgina42de62
Pgina43
11) Creacin/ModificacindeInformes
OpenGTSvieneconunmotormuysimpleyconfigurabledegeneracindeinformes.Losinformessecomponende3principal
componentes:eldiseodelinforme,eliteradordedatosdelinforme,ylaespecificacindeinformeXML.
LaespecificacinXMLinformeespecificauniteradordedatosdelinforme,lasrestriccionesdeinformes,ylascolumnasquehandeaparecer
enelinforme.Eliteradordatosdelinformeconstruyelosdatosqueseincluirnenelinformebasadoenlapresentacindeinformes
restricciones.Eldiseodelosdatosdelinformeseiteraporlosdatosdelinformeygenerauninformebasadoenlacolumna
informacindeformatoproporcionadoporelXMLespecificacindeinforme.
Loscomponentes"InformeLayout"y"DatosdeinformeIterator"debenserimplementadasenelcdigodeJavaporunJava
programador,ydeberaserconfigurableparaunusogeneral.El"InformeEspecificacinXML"esunaconfiguracindeinforme
archivodetextoqueespecificaeltipo,columnasycontraintsdeuninformeespecfico.Siemprequeeldiseodelinformeydatos
iteradorseimplementanparaelusogeneral,muchostiposdiferentesdeinformespuedensercreadosqueutilizanelmismodiseo
yiteradordedatos.
11.1)InformeLayout
ElInformedeDiseoesunmduloJavaquedefineloqueestndisponiblesparauninformedadocolumnas,ysusrespectivos
opcionesdeformato.
UndiseodelinformesedebeextenderlaclaseJavaabstracto"org.opengts.war.report.ReportLayout"ydebedefinirun
Subclase"DataRow"queentiendecmoanalizarinformedecolumna/camposdeobjetosdefilainformeproporcionadosporelinforme
iteradordedatos.
Laclase"org.opengts.war.report.event.EventDataLayout"esunejemploReportLayoutsubclaseque
definelascolumnasdisponiblesylasopcionesdeformatoparalosinformesDetalleEventoosumarias.
11.2)DatosdelinformeIterator
ElInformedeDatosIteratoresunmduloJavaqueconstruyelalistaderegistrosquesevanaincluirenelinformebasado
enlaslimitacionesespecificadasenlaespecificacinXMLinforme.
UniteradordedatosdelinformesedebeextenderlaclaseJavaabstracto"org.opengts.war.report.ReportData"yproporcionar
implementacionesparalosmtodos"getTotalDataIterator""getBodyDataIterator"y.Tambindebeunirseauna
ReportLayoutespecficaalproporcionarunaimplementacinparaelmtodo"getReportLayout".
Laclase"org.opengts.war.report.event.EventDetailReport"esunejemploinformesInformesubclaseque
generaelinformeDetalledeevento.
Pgina43de62
Pgina44
35/51
18/6/2015
11.3)definicindeinformeXML
El"report.xml"archivodefineelestiloHTMLutilizadoparaunacolumnadefinidaenunReportLayout.Sitambindefineespecfica
informesdeespecificarqureportDataiterador,yquelascolumnasseincluirnenuninformedado.Tambinespecifica
lasrestriccionesquesehandeaplicaralosdatosqueelinformecontendr.
Heaquunejemplodedefinicindeinformedesdeelarchivo'report.xml'paraelinforme"Detalledeeventos":
<!
===El'nombre'proporcionaunnombreparaelinforme,sehacereferenciaen'private.xml'
===El"tipo"proporcionaunnombredegrupodeinformes,sehacereferenciaen'private.xml'
===La"clase"especificaeliteradordedatosdelinformeseutilizaparagenerarelinforme
>
<Informename=tipo"EventDetail"="device.detail"
class="org.opengts.war.report.event.EventDetailReport">
<!Ladescripcindelavisualizacindelinformeenelmendeinformacin>
<MenuDescriptioni18n="ReportsXML.eventDetail.menu">
Informacinsobreeventos
</MenuDescription>
<!Elttulosemuestraarribadelinforme>
<Ttuloi18n="ReportsXML.eventDetail.title">
Informacinsobreeventos
</Title>
<!Elsubttulosemuestraarribadelinforme>
<Subttuloi18n="ReportsXML.eventDetail.subtitle">
${DeviceDesc}[${deviceId}]\n${dateRange}
</Subttulo>
<!Lascolumnasincluidasenelinforme>
<>Columnas
<Columnaname="ndice"/>
<Columnaname="fecha"/>
<Nombredecolumna="tiempo"/>
<Nombredecolumna="statusDesc"/>
<Nombredecolumna="latitud"arg="5"/>
<Nombredecolumna=arg"longitud"="5"/>
<Nombredecolumna=arg"speedH"="1"/>
<Columnaname="altitud"/>
<Nombredecolumna="cuentakilmetros"arg="0"/>
<Columnaname="direccin"/>
</Columnas>
<!Laslimitacionesdelosdatosdeinformes>
<Limitaciones>
<TipoSelectionLimit="primero">1000</SelectionLimit>
<ReportLimit>1000</ReportLimit>
<OrderAscending>true</OrderAscending>
</Restricciones>
<!Elselectordeiconodemapa(sisehabilitalavisualizacindelmapa)>
<MapIconSelectorruleFactoryName="CustomRulesEngine">
<!Estaseccinrequiereunaimplementacin"RuleFactory"instalado>
<![CDATA[(?(Mph<4)"reddot":(velocidad<15)"amarillo":"lapartida")]]>
</MapIconSelector>
</Informe>
Pgina44de62
Pgina45
11.4)DisponibleinformeEspecificaciones
Unavezqueelinformehasidodefinidoenelarchivo"report.xml",puedeestardisponibleparalaseleccindelusuarioenlaWeb
interfazhaciendoreferenciaalnombredelinformeenelarchivo"private.xml"enel"Informes"tag.
Heaquunejemplodeespecificacindeinformedesdeelarchivo"private.xml":
<!Informesdefinidos
===Todoslosinformesquesehacereferenciaaqudebenestarpredefinidasen'reports.xml'
>
<Reportajes>
<NombredeInforme="EventDetail">
<AclName>acl.report.eventDetail</AclName>
</Informe>
<NombredeInforme="EVENTO">
<AclName>acl.report.eventSummary</AclName>
36/51
18/6/2015
</Informe>
<!...>
</Informes>
Pgina45de62
Pgina46
Apndice)
A)SoporteparaMicrosoftSQLServer
ElapoyoinicialparaMicrosoftSQLServersehaincluidoconlosestndaresOpenGTS.MicrosoftSQLServer2005lata
serdescargado/instaladodesdelapginaWebdeMicrosoftsiguiente(s):
http://www.microsoft.com/sqlserver/2005/en/us/express.aspx
http://www.microsoft.com/Sqlserver/2005/en/us/expressdown.aspx
ParahabilitarelsoporteparaSQLServer,modifiqueelarchivo"common.conf"enconsecuenciaparaapagarsoporteparaMySQLyvuelta
elsoporteparaMicrosoftSQLServer:
#MicrosoftSQLServer
db.sql.provider=sqlserver
db.sql.host=localhost
db.sql.port=3193
db.sql.dbname=gts
db.sql.user=gts
db.sql.password=OpenGTS
db.sql.url=jdbc:sqlserver://${db.sql.host}:${}db.sql.port
db.sql.url.db=${}db.sql.urldatabasename=${}db.sql.dbname
TambinnecesitarelapoyodelcontroladorJDBCparaSQLServerparaserdescargado/instaladoenlosentornosdeejecucinJava
descritoabajo.
Descargar:
http://msdn.microsoft.com/enus/data/ff658549
Instalar:
%JAVA_HOME%\jre\lib\ext\.
37/51
18/6/2015
(Donde%JAVA_HOME%eslaubicacindelainstalacindeJava)
Unavez"common.conf"sehanmodificado,yelcontroladordeSQLServerJDBCsehainstalado,recompilarel
OpenGTScdigoeinicializarlabasededatos,einstalarloscomponentes,comosedescribeanteriormenteenestedocumento.
Pngaseencontactoconnosotrosconcualquierproblemaqueencuentre,osugerenciasquepuedentenerrelacinconelapoyodeMicrosoftSQL
Server.
Pgina46de62
Pgina47
Apndice)
B)ApoyoaMologogomvilesconcapacidad.
OpenGTSincluyeelservlet'mologogo.war'(
)PararecibirdatosdesdeMologogomvilesconcapacidad
wEBarcebolleta
(Http://www.mologogo.com)usandosucaractersticade"altURL".'Mologogo.war'seejecutaenuncontenedordeservletsJavaytiendas
recibidodatosenSQLDBquesepuedenveratravsdelainterfazweb(ver"track.war').
Configurarelarchivo"webapp.conf":
Elarchivodeconfiguracindeejecucinpordefectoelarchivo"webapp.conf"yelarchivo"common.conf",seencuentranenlosOpenGTS
directoriodeinstalacin.Paralamayoradelasinstalaciones,losvalorespredeterminadosespecificadosenestearchivosepuededejarcomoest.
Sideseapersonalizarestearchivoespecficoparaelservlet"mologogo.war",acontinuacin,copiarestearchivoeneldirectorio
"$GTS_HOME/guerra/Mologogo/WEBINF/"ymodificarestacopia.
B.1)Compilar/Instalacindel"mologogo.war"ServletJava:
Paragenerarelarchivo"mologogo.war",ejecuteelcomandodeconstruccinAntdelasiguientemanera:
/Zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>Mologogohormiga
El"Mologogo"targetesuncontenedorparatareasant"mologogo.compile"y"mologogo.war".Elobjetivo
"Mologogo.compile"recopilatodaslasclasesnecesariasyarchivosdeconfiguracineneldirectoriodeconstruccin
"$GTS_HOME/build/Mologogo".El"mologogo.war"objetivocontinuacin,creaelarchivo'archivoweb'
"$GTS_HOME/build/mologogo.war".
Instaleelarchivo"mologogo.war"segnlasinstruccionesdeinstalacin/configuracindeApacheTomcat.Tpicamente,estosignifica
copiarelarchivo"mologogo.war"aldirectorio"$CATALINA_HOME/webapps/.".
B.2)Lacreacindelacuenta"Mologogo"enOpenGTS:
Utilicelasherramientasdeadministracindelneadecomandosparacrearunacuentallamada"Mologogo"delasiguientemanera:
/Zzz>cd$GTS_HOME
/usr/local/OpenGTS_1.2.3>bin/Cuentaadmin.shCuenta=Mologogocreate
Luego,paracadatelfono,creeunnuevodispositivo:
/usr/local/OpenGTS_1.2.3>bin/admin.shDispositivoCuenta=Mologogodevice=createmam
/usr/local/OpenGTS_1.2.3>bin/admin.shDispositivoCuenta=Mologogodevice=createpap
(Etc.)
B.2a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:
38/51
18/6/2015
B.2b)NotaimportanteparalosusuariosdeWindows:
Cuenta=smithtampocodebeirentrecomillas,comoen"Cuenta=smith",oespecificarseconun
dospuntosenlugardeunsignoigual,comoenCuenta:smith.
Pgina47de62
Pgina48
B.3)Ajustedelafuncin"altURL"ensutelfonoMologogo:
Ajustelafuncin"altURL"desutelfonocapazMologogoalasiguienteURL:
"Http://<MyDomainName>?/Mologogo/DatosID=<id>&"
Reemplace<MyDomainName>conelnombrededominiodesuservidorconTomcat,yreemplazar<id>conelidentificadordela
telfonoespecfico(como"mam"o"pap"enestecaso).
TengaencuentaquesiusteddejTomcatqueseejecutaenelpuertopordefecto8080,entoncespuedenecesitarsuURLparaajustarsealosiguiente:
"Http://<MyDomainName>:8080/Mologogo/DatosID=<id>&"
B.4)Comprobacindelainstalacin:
Unavezquetodoestconfigurado,busquelosdatosquevienendesutelfonohabilitadoMologogo.
Nota:
Utilizandoel"ID="palabraclaveintentabuscarlaidentidaddeldispositivomedianteelusodelosdefaultidcuenta"Mologogo".Si
deseautilizarunacuentayeldispositivoIdentificacindelespecfico,ustedpuedereemplazarel"?ID=<id>"con"?ctas=<CUENTA>ydev=<dev>".
Pgina48de62
39/51
18/6/2015
Pgina49
Apndice)
C)TablaColumnasopcionales
VariastablasdentrodelosOpenGTSproporcionanparacolumnasdetablasadicionalesquepuedenserutilizadospara
requisitosdeaplicacinespeciales.Estascolumnasdelatablasepuedenactivarmedianteelestablecimientodeproperyespecfica
valoresdentrodeunodelosarchivos".conf"disponibles(esdecir."config.conf",etc).Enlasiguienteseccin
describelasdistintascolumnasdetablasopcionales,yelnombredelapropiedadquesepuedeutilizarparaactivar
estascolumnas.
Despusdeaadirlapropiedadespecificadaenelfichero".conf"elegido,tendrqueseractualizadolastablas
conlascolumnasqueacabadeagregar.Paraactualizarlascolumnasdentrodelasdistintastablasdebasesdedatos,ejecuteel
Comando"dbAdmin.pl"comosigue:
O,enWindows:
C:\>OpenGTS_1.2.3mesasbin\dbConfig.bat:ca
ElsiguientecomandomostrarlascolumnasdefinidasencadaunadelastablasutilizadasporOpenGTS(nota:loanterior
"dbAdmin.pl"o"dbConfig.batanserequierencomandos"paraasegurarquelascolumnasdetabladefinidossontambin
agregadoalatabladebasededatosreal):
/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plschema=TABLE_NAME
O,enWindows:
C:\OpenGTS_1.2.3>bin\dbConfig.batschema:TABLE_NAME
Donde"TABLE_NAME"sesustituyeporelnombredelatablaparalaquedeseavisualizarlascolumnasdefinidas.Si
"TABLE_NAME"seomite,semostrarnlascolumnasentoncesdefinidosparatodaslastablas.
Ca)IMPORTANTE:Vuelvaaimplementartodoslosservletsdespusdemodificarcualquierarchivodeconfiguracindeejecucin
Cambiosencualquierade"private.xml","reports.xml","webapp.conf","common.conf","system.conf",o
archivos"custom.conf"(uotro".xml"oarchivo".conf"),sernecesarioqueel"track.war"(aligualquelaotra
servletsarchivo)serreconstruidoyredesplegado.
Nota:Loscamposquesedescribenacontinuacinslopuedencontenerunalistaparcialdeloscamposquepuedenestardisponiblesenlosdistintos
mesacamposopcionales.Porfavorconsulteelmdulodefuentedemesaparaunalistadefinitivadeloscamposincluidos.
Pgina49de62
Pgina50
C.1)ColumnasdelatablaCuentaopcionales:
AddressFieldInfo
ConfigPropiedad:startupInit.Account.AddressFieldInfo=true
Estoscamposseutilizanparaalmacenarinformacinadicionalsobreladireccin,segnloespecificadoporlosrequisitosdeaplicacin.
DireccinLnea1
AddressLine2
addressLine3
addressCity
addressState
addressPostalCode
addressCountry
40/51
18/6/2015
MapLegendFieldInfo
ConfigPropiedad:startupInit.Account.MapLegendFieldInfo=true
Estoscamposseutilizanparaalmacenarinformacinpersonalizadaleyendadelmapa.
mapLegendDevice
mapLegendGroup
AccountManagerInfo
ConfigPropiedad:startupInit.Account.AccountManagerInfo=true
EstoscamposseutilizanparaalmacenarinformacindeconfiguracindelacuentaAdministrador.
isAccountManager
ManagerID
DataPushInfo
ConfigPropiedad:startupInit.Account.DataPushInfo=true
Estoscamposseutilizanparaalmacenarelestadodecuentadeterminada/datosdeeventos'empujado'aunservidoralternativo:
requestPassCode
requestIPAddress
dataPushURL
lastDataRequestTime
lastDataPushTime
C.2)Columnasdelatabladedispositivosopcionales:
NotificationFieldInfo
ConfigPropiedad:startupInit.Device.NotificationFieldInfo=true
Estoscamposseutilizanporlaaplicacininstalada"RuleFactory",o,posiblemente,lanotificacindeeventosextendida
Reglasdelmotor(ENRE)mdulo.EnlaversinOpenGTSdecdigoabierto,estopuedeserelRuleFactoryExample.java
mdulo.Cuandoestactivada,lapgina"Admindispositivos"seajustarautomticamenteparamostraralgunosdeestoscampos.
allowNotify
lastNotifyTime
lastNotifyCode
NotifyEmail
notifySelector
notifyAction
notifyDescription
notifySubject
notifyText
notifyUseWrapper
notifyPriority
parkedLatitude
parkedLongitude
parkedRadius
Pgina50de62
Pgina51
LinkFieldInfo
ConfigPropiedad:startupInit.Device.LinkFieldInfo=true
EstoscamposseutilizanparaalmacenarinformacindeenlaceURLparamostrarenlapginadelmapadedispositivos(ver
Propiedad"trackMap.showDeviceLink"en"private.xml"),y,posiblemente,enlasnotificacionesdecorreoelectrnico(siestconfigurado).
linkURL
linkDescription
DataPushInfo
ConfigPropiedad:startupInit.Device.DataPushInfo=true
EstoscamposseutilizanparaalmacenarinformacinsobrelaltimavezquelosregistrosEventDatafueronenviadosaotrosistema.
lastDataPushTime
lastEventCreateMillis
FixedLocationFieldInfo
ConfigPropiedad:startupInit.Device.FixedLocationFieldInfo=true
Estoscamposseutilizanparaaplicacionesespecialesdondeeldispositivo'telemtica'notieneunreceptorGPSydondeel
activoqueestsiendomonitoreadanosemueve(esdecir.Comoporejemplocuandoelseguimientodelosnivelesdeltanquedeaguaentanquesestacionarios,etc).
fixedLatitude
fixedLongitude
fixedAddress
fixedContactPhone
fixedServiceTime
BorderCrossingFieldInfo
ConfigPropiedad:startupInit.Device.BorderCrossingFieldInfo=true
Estoscamposseutilizanparaalmacenarinformacindeestadodelneadecrucefronterizo.(Requiereunmduloquepuededetectarstateline
crucesfronterizosactualmentenoseutilizanenelsistemaOpenGTSdecdigoabierto):
crucefronterizo
lastBorderCrossTime
41/51
18/6/2015
GeoCorridorFieldInfo
ConfigPropiedad:startupInit.Device.GeoCorridorFieldInfo=true
EstoscamposseutilizanparaalmacenarlainformacinactivaGeoCorridor(actualmentenoseutilizanenlosOpenGTSdecdigoabierto
sistema).
activeCorridor
MaintOdometerFieldInfo
ConfigPropiedad:startupInit.Device.MaintOdometerFieldInfo=true
Estoscamposseutilizanparaelseguimientodelainformacindemantenimientoperidico(actualmentenoutilizanenlasOpenGTSdecdigoabierto
sistema).
maintIntervalKM0
maintOdometerKM0
maintIntervalKM1
maintOdometerKM1
maintIntervalHR0
maintEngHoursHR0
maintNotes
WorkOrderInfo
ConfigPropiedad:startupInit.Device.WorkOrderInfo=true
EstoscamposseutilizanparaalmacenarinformacineinformacinWorkOrdercampopersonalizadovarios(actualmentenoseutiliza
enelsistemaOpenGTSdecdigoabierto).
workOrderID
CustomAttributes
Pgina51de62
Pgina52
C.3)Columnasdelatabladeusuarioopcionales:
AddressFieldInfo
ConfigPropiedad:startupInit.User.AddressFieldInfo=true
Estoscamposseutilizanparaalmacenarinformacinadicionalsobreladireccin,segnloespecificadoporlosrequisitosdeaplicacin.
DireccinLnea1
AddressLine2
addressLine3
addressCity
addressState
addressPostalCode
addressCountry
C.4)OpcionalEventDataTablaColumnas:
AddressFieldInfo
ConfigPropiedad:startupInit.EventData.AddressFieldInfo=true
EstoscamposseutilizanparaalmacenarinformacinadicionalDireccingeocodificadainversa,segnloespecificadoporlaaplicacin
requisitos.Paraqueestascolumnasparaserllenadoen,elproveedorinversageocodeactivodebesercapazdesoportar
estoscampos:
Direccin
ciudad
StateProvince
cdigopostal
subdivisin
speedLimitKPH
isTollRoad
GPSFieldInfo
ConfigPropiedad:startupInit.EventData.GPSFieldInfo=true
EstoscamposseutilizanparaalmacenarGPSymdematributosadicionales,talescomolaprecisin,ladilucindelaprecisin,lasealde
fuerza,etc.
gpsFixType
horzAccuracy
vertAccuracy
HDOP
satelliteCount
BatteryLevel
batteryVolts
Intensidaddeseal
CustomFieldInfo
ConfigPropiedad:startupInit.EventData.CustomFieldInfo=true
Estoscamposseutilizanparaalmacenarloscamposdedatosdeeventospersonalizadosdiversos,talescomoidconductor,valoresanalgicosgenricos,etc.
42/51
18/6/2015
entityId
DriverID
driverStatus
driverMessage
emailRecipient
sensorLow
sensorHigh
centrodecosto
Nmerodetrabajo
rfidTag
attachType
attachData
Pgina52de62
Pgina53
GarminFieldInfo
ConfigPropiedad:startupInit.EventData.GarminFieldInfo=true
EstoscamposseutilizanpararecaudarlosdatosdeETA/paradadeundispositivoGarmindenavegacinpersonal(PND)(undispositivodecapabile
Serequiereelenvodeestainformacinparaelservidor).(ActualmentenoseutilizaenelsistemaOpenGTSdecdigoabierto):
etaTimestamp
etaUniqueID
etaDistanceKM
etaLatitude
etaLongitude
stopID
stopStatus
stopIndex
CANBUSFieldInfo(anteriormenteJ1708FieldInfo,comodev2.3.2)
ConfigPropiedad:startupInit.EventData.CANBUSFieldInfo=true
Estoscamposseutilizanparaalmacenarinformacindediagnsticodelmotorrecibidadesdeelequipodediagnsticoabordodelmotor.
LainformacindediagnsticodemotorporlogeneralseobtienedelaJ1708vehculo,J1939,OBDII,odelainterfazCANBUS.
Estalistaopcionalincluyecamposcomo"engineRPM","engineHours","coolantLevel","coolantTemp",
"OilLevel","oilTemp","fuelLevel","fuelTotal","fuelIdle",ymuchosms(verla"CANBUSFieldInfo"
seccinenelmdulodefuenteEventData.javaparaobtenerunalistacompletadecamposcompatibles).
fuelTotal
engineRpm
engineHours
engineLoad
engineTorque
idleHours
Horaslaborales
transOilTemp
coolantLevel
coolantTemp
intakeTemp
brakeGForce
aceleracin
presindelaceite
niveldeaceite
oilTemp
presindelaire
airFilterPressure
turboPressure
ptoEngaged
ptoHours
throttlePos
brakePos
j1708Fault
faultCode
malfunctionLamp
fuelLevel
fuelIdle
fuelPTO
vBatteryVolts
fuelPressure
fuelUsage
fuelTemp
fuelEconomy
brakePressure
presindellanta
tireTemp
43/51
18/6/2015
Pgina53de62
Pgina54
AtmosphereFieldInfo
ConfigPropiedad:startupInit.EventData.AtmosphereFieldInfo=true
Estoscamposseutilizanparaalmacenardatosatmosfricos,talescomolatemperaturaylapresinbaromtrica.
barmetro
ambientTemp
cabinTemp
ThermoFieldInfo
ConfigPropiedad:startupInit.EventData.ThermoFieldInfo=true
Estoscamposseutilizanparaalmacenarinformacindelatemperaturatpicamenterecibidodemonitoresdetemperaturacolocadosenlacarga
quesetransporta.
thermoAverage0
thermoAverage1
thermoAverage2
thermoAverage3
AnalogFieldInfo
ConfigPropiedad:startupInit.EventData.AnalogFieldInfo=true
Estoscamposseutilizanparaalmacenarinformacinanalgicagenrica.
analoge0
analoge1
analoge2
analoge3
AutoIncrementIndex
ConfigPropiedad:startupInit.EventData.AutoIncrementIndex=true
EstoscamposseutilizanparaautoindexacindelosregistrosEventData.Amenosqueseaabsolutamentenecesario,estoscamposdebenpermanecer
discapacitados.
AUTOINDEX
EndOfDaySummary
ConfigPropiedad:startupInit.EventData.EndOfDaySummary=true
EstoscamposseutilizanparaalmacenarlosdatosderesumendiarioquepuedeserproporcionadaporeldispositivoderastreoGPSremoto.Ms
dispositivosnosercapazdeproporcionarestainformacin(actualmenteutilizadosolamenteparaelservidordecomunicacindeldispositivoAntx).
dayEngineStarts
dayIdleHours
dayFuelIdle
dayWorkHours
dayFuelWork
dayFuelPTO
dayDistanceKM
dayFuelTotal
ServingCellTowerData
ConfigPropiedad:startupInit.EventData.ServingCellTowerData=true
Estoscamposseutilizanparaalmacenarlainformacinquesirvedeclulastorre.Estopuedesertilparaproporcionarunaantenadetelefonamvilbasado
(Serequiereunservicioquepuedeproporcionarclulastorrelugarlatitud/longitud)localizacinaproximada.
cellTowerID
mobileCountryCode
mobileNetworkCode
cellTimingAdvance
locationAreaCode
cellServingInfo
cellLatitude
cellLongitude
cellAccuracy
Pgina54de62
Pgina55
NeighborCellTowerData
ConfigPropiedad:startupInit.EventData.NeighborCellTowerData=true
Estoscamposseutilizanparaalmacenarlainformacindelaclulavecinatorre.Estopuedesertilparaproporcionarunatorrecelular
(Serequiereunservicioquepuedeproporcionarclulastorrelugarlatitud/longitud)ubicacinaproximadabasada.
cellNeighborInfo0
cellNeighborInfo1
cellNeighborInfo2
cellNeighborInfo3
44/51
18/6/2015
cellNeighborInfo4
cellNeighborInfo5
WorkZoneGridData
ConfigPropiedad:startupInit.EventData.WorkZoneGridData=true
EstoscamposseutilizanparalainformacindemuestreodedatosWorkZone.(NoseutilizaenlosOpenGTSdecdigoabierto,yenlamayora
InstalacionesdelaempresaGTS):
sampleIndex
IDMuestra
CreationTimeMillisecond
ConfigPropiedad:startupInit.EventData.CreationTimeMillisecond=true
EstoscamposseutilizanparaEventDatatiemporcordcreacinconresolucindemilisegundos.Estotambincreaun"dataPush"
campoquesepuedeutilizarconeldispositivo"DataPushInfo"camposopcionales.
dataPush
creationMillis
Pgina55de62
Pgina56
Apndice)
D)InstalacinMotoDMTP
Da)Nota:
LafuenteparalaMotoDMTPsoftwaredesoportedeseguimientoGPSseencuentraenelOpenDMTP"clientej2me"
descargadelproyectoenSourceForge:
https://sourceforge.net/project/showfiles.php?group_id=151031
El"MotoDMTPaplicacin"estdiseadoparatrabajarconMotorolai415/i425/i290/i335deBoosttelfonosmviles,ypuedetrabajar
enotrasMotorolaBoosttelfonosmvilestambin."MotoDMTP"utilizaelOpenDMTPprotocoloparaenviardatosala
OpenDMTPservidor,queseincluyeconOpenGTS.
MotorolaBoostLostelfonosmvilesestndisponiblesenvariospuntosdeventaenlosEE.UU.,comoRadioShack,Walmart,Target,
BestBuy,etc,ytambinpuedeseradquiridodeBoostMobiledirectamente.DespusdecomprarunodeestosBoostMotorola
Lostelfonosmviles,activarelservicioenlareddeBoostMobilesegnlasinstruccionesqueacompaanaltelfono.Cerciorarse
queseleccioneelserviciodeplandedatos("WirelessWebActivar")paraqueeltelfonoparaenviarlosdatosalservidor.
Nota:
OpenGTS/OpenDMTPySolucionesGeoTelematic,Inc.noestnafiliadosaMotorolaoBoostMobile,o
cualquieradelosdiversospuntosdeventaalpormenorsehamencionado,encualquierforma."Motorola","BoostMobile",ylosdiversosmencionado
45/51
18/6/2015
puntosdeventasonmarcasregistradasdesusrespectivascompaas.
Db)Importante:
AlactivarelservicioBoostMobile,asegresedeseleccionarlaopcindeplandedatos(consulte"Activarinalmbrico
Web")paraactivareltelfonoparaenviarlosdatosalservidor.
Dc)Nota:
InstalacinMotoDMTPrequiereelusodeWindowsparaejecutarelMotorola"iDENJavaApplicationLoader"
aplicacin.
D.1)ConfigurarelarchivoMotoDMTP.jad:
Unaversinprecompiladade"MotoDMTP.jar"y"MotoDMTP.jad"seincluyeenestaversin.Paraconstruirsupropiaversin
delarchivo"MotoDMTP.jar",consultarelMotoDMTPdocumentacinqueaccomanieslaOpenDMTP'Java'
Descargalaaplicacin..
ElarchivoJAD(MotoDMTP.jad)seutilizaparacargarlaspropiedadesdeejecucinylainformacindeconfiguracinenelJ2ME
aplicacin.Necesitarestearchivoparasermodificadoantesdelainstalacinparaconfigurarelservidor:puertoalqueseenviarnlosdatos,
yparaconfigurarelnombre(cuenta,dispositivo,etc.)queseutilizaparaidentificareltelfonoenelservidor.
Editeelarchivo"MotoDMTP.jad"conuneditordetextoconveniente(comoWindows"WordPad")yaadelasiguiente
definicindelapropiedadalaltimalneadelarchivo(oeditarlalneaexistente,siunoestyapresente):
DMTPAccess:0,<MyServerHost>,<MyServerPort>,<MyAccountID>,<MyDeviceID>
Queespecificaelservidor:puertoyAccountID/DeviceIDutilizaparaidentificareltelfonoenelservidor.(Nota:laprefijacin
"0",queserequiereysereservaparausofuturo).
(Nota:Loscaracteres'<'y'>'enlosejemplosanterioressirvenparadelimitarlasdistintasopcionesynohandeser
incluidoenlaespecificacinpropiedadfinal.JADespecificacionespropiedadficherodebencomenzarenelprimercarcterdelalnea).
Pgina56de62
Pgina57
Porejemplo,suponiendoqueelanfitrines"data.example.com"yelpuertoes"31000",ylaAccountID/DeviceIDes
"Myaccount/mydevice",unaadecuadaespecificada"DMTPAccess:"lneawhouldaparecedelasiguientemanera:
DMTPAccess:0,data.example.com,31000,myaccount,mydevice
D.1a)Importante:
Asegresedequehayunalneaenblancoalfinaldelarchivo'MotoDMTP.jad'despusdelaltimaentradadelapropiedad.Sinesta
lneaenblanco,laltimaentradadelapropiedadnopuedesercargadoenlaaplicacinJ2ME,yeltelfonopuedenosercapaz
paraestablecerunaconexinconelservidor.
Enelservidor,agreguelacuentaidydispositivodeidentificacin,pararecibirdatosdesdeeltelfono.
D.2)Definiendootrasopcionesdegeneracindeeventosconfigurable:
TambinpuedeestablecerelintervalodepresentacindeinformesyotrasopcionesconfigurablesenelarchivoJADtambin.stossonalgunosadicional
opcionesconfigurablesquepuedenserincluidosenelarchivoJADparacambiarelcomportamientodeseguimiento:
(Nota:Loscaracteres'<'y'>'enlosejemplossiguientessirvenparadelimitarlasdistintasopcionesynohandeser
incluidoenlaespecificacinpropiedadfinal.JADespecificacinficheropropiedaddebecomenzarenelprimercarcterdelalnea).
DMTPgpsMINSPD:<MinimumMotionSpeedKPH>
EstaopcinestableceelGPSinformadovelocidadmnima(sustituir"<MinimumMotionSpeedKPH>"conelmnimodeseado
GPSinformaronvelocidadenkm/h).PlazosdeenvoindicadoporelreceptorGPSquesonmenoresqueestevalorsefijaencero
antesdeinformardeellosenunEvemt.EstoayudaamitigarlasimprecisionesenlosreceptoresGPSquepuedereportarun'movimiento'
acelerarauncuandoelreceptorGPSestsentadoinmvilenunescritorio.LavelocidadmnimapredeterminadaGPSesde12Km/h(aproximadamente
7,4mph).
DMTPmotstart:<MinimumStartSpeedKPH>
Estaopcinespecificalavelocidadmnimaquedebeserinformadoantesdequesegenereuneventode"Iniciodemovimiento"(reemplazar
"<MinimumStartSpeedKPH>"conelmnimodevelocidad'inicio'deseadaenkm/h).Estevalordebeseralmenostangrande
comoelvalorespecificadoenelGPSmnimosacelerararriba.Elvalorpredeterminadoes16,1kmh(aproximadamente10millasporhora).
DMTPmotinmotion:<InMotionIntervalSeconds>
Estaopcinespecificaelnmerodesegundosentreeventosinformadosmientraseltelfonoestenmovimiento,despusdelageneracin
deunevento"Iniciodemovimiento"(sustituir"<InMotionIntervalSeconds>"conelintervalodeseadoenmovimientoenlapresentacindeinformes
segundos).Estevalornopuedeserinferiora60segundos.Elvalorpredeterminadoesde120segundos(2minutos).
46/51
18/6/2015
DMTPmotstop:<WaitForStopSeconds>
Estaopcinespecificaelnmerodesegundosqueesperardespusdelasparadasdetelfonosmvilesparainformardeunevento"Stopped"(reemplazar
"<WaitForStopSeconds>"conelnmerodeseadodesegundosdeesperaantesdegeneraruneventode"Stopped").Este
valorseutilizaparaprevenirlaparadarpida/comienzaocurranconfrecuenciaenventanillaslucesydejardesignos,oparadascortasdurante
trficopesado.Elvalorpredeterminadoesde210segundos(3,5minutos).
DormitoriotasaDMTPmot:<DormantIntervalSeconds>
Estaopcinespecificaelnmerodesegundosentreeventosinformadosmientraseltelfononoestenmovimiento(esdecir."Durmiente")
despusdelageneracindeunevento"Stopped"(sustituir"<DormantIntervalSeconds>"conlainformacindeseadaenestadolatente
intervaloensegundos).Estevalornopuedeserinferiorque300segundos.Elvalorpredeterminadoesde1800segundos(30minutos).
Pgina57de62
Pgina58
DMTPmotEXSPEED:<ExcessSpeedThresholdKPH>
Estaopcinespecificaelumbraldevelocidadenkm/h,msalldelcualsegnerateduneventoexcesodevelocidad(reemplazar
"<ExcessSpeedThresholdKPH>"conelumbraldevelocidaddeseadaenkm/h).Elvalorpredeterminadoes"0",quenolohace
generaruneventoexcesodevelocidad.
D.2a)Importante:
Asegresedequehayunalneaenblancoalfinaldelarchivo'MotoDMTP.jad'despusdelaltimaentradadelapropiedad.Sinesta
lneaenblanco,laltimaentradadelapropiedadnopuedesercargadoenlaaplicacinJ2ME,yeltelfonopuedenosercapaz
paraestablecerunaconexinconelservidor.
D.3)Instalacindelaaplicacineneltelfono:
Descargareinstalarel"iDENJavaApplicationLoader"deMotorola,disponibleenesteenlace:
http://developer.motorola.com/docstools/idenjal/
EstaaplicacinseinstalaenWindowsXPoVista.Consulteelsitiowebdearribaparamsdetallessobreelsistema
requisitosyprocedimientosdeinstalacin.SenecesitaruncableUSB(tipoAmachoaminiBmacho)paraconectarel
i425telfono/i290atuPCconWindows(eltelfonoi415requiereuncabledeencargodisponibleensutiendadeSprint/Nextel).
TambinpuedesernecesarioparadescargarelcontroladorUSBparaMotorolaauricular,quesepuedeobtenerdesdeelsiguienteenlace:
http://developer.motorola.com/docstools/USB_Drivers/
CargandoMotoDMTPensutelfonousandoOpenJAL:
1)Coloquetantoel"MotoDMTP.jar"y"MotoDMTP.jad"enelmismodirectorio.
2)PonerenmarchaOpenJALyconfigurarlaspreferenciasde"ConectaratravsdeconexinUSB".
3)ConecteeltelfonoalPCmedianteelcableUSB.
4)Seleccione"Conectaratelfono".Alospocossegundossedebeconectaraltelfonoeindicaruna"X"rojasobre
el"Conectaratelfono"icono.
5)Seleccione"AplicacinJ2MEdecarga",acontinuacin,busqueelarchivo"MotoDMTP.jad".
6)Seleccione"Descargar".Enpocossegundosladescargadebesercompleta(sibienpuedeparecerquesloel
Archivo"MotoDMTP.jad"seestdescargando,es,dehecho,tantolacarga"MotoDMTP.jad"y"MotoDMTP.jar"
archivoseneltelfono.)
7)Unavezcargado,hagaclicenelbotn"telfonoDisconnect"dentrodelaaplicacinOpenJAL.
Diferentestelfonostienendiferentesmtodosparalainstalacin/actualizacin/aplicacionesJavadepartida.Acontinuacinsedescribeuna
visingeneraldelproceso,peroloscomandosensutelfonoparticular,puedenserdiferentes:
InstalacindelaaplicacinMotoDMTPvezdescargadoeneltelfono:
1)Desdelapantallaprincipaldeltelfono(conellogotipo"BoostMobile"),seleccioneelbotndemenyrecorrerala"Java
Aplicaciones"o"Juegosyaplicaciones"icono,acontinuacin,pulseAceptar.
2)Siselepideparainstalarlanuevaaplicacindescargada,seleccione"S".Deotramaneratransversalalaaplicacin"MotoDMTP"y
pulseelbotndemen.Sihayunaactualizacindisponible,seleccione"Actualizar"ypasarporelprocesodeactualizacin.Empezar
laaplicacin,seleccioneAceptar.
IniciodelaaplicacinMotoDMTP:
1)Desplazamientoalaaplicacinypulse"OK""MotoDMTP".
2)Siselespidealgunapreguntaconrespectoalaccesoalosrecursosmviles(GPS,transmisindedatos,etc.),siempre
responders/ok/siempre/etc.
47/51
18/6/2015
Pgina58de62
Pgina59
TambinpuedeconfigurareltelfonoparainiciarautomticamentelaaplicacinMotoDMTPcuandoeltelfonoestencendido:
1)Desdelapantallaprincipaldeltelfono,seleccioneelbotndemen,acontinuacin,seleccione"Configuracin"yseleccione"Personalizar".
2)Traversealaopcin"PowerUp"ypulseelbotnOK.
3)"App:..."seseleccionar.PulseelbotnAceptar.
4)Traversealaopcin"MotoDMTP"ypulseelbotnOK.
5)Contineseleccionando"Volver"hastaqueaparezcalapantallaprincipal.
Importante:
ElreceptorGPSeneltelfonopuedenofuncionarsieltelfononotieneservicioactivocorrienteatravsde
BoostMobile.Comoresultado,lalatitud/longitudnosemuestrecorrectamenteeneltelfonosiBoostMobile
servicionoestactiva.
D.4)Notasdeaplicacin:
Despusdeiniciarlaaplicacin,lapantallaaparecercomosigue:
TIM:n/a
LAT:n/a
LON:n/a
ACC:+/0ft
SPD:0mph
ALT:0ft
EVT:0/0
GPSAdquirir...
(Nota:si"Errordeaccesosemuestra",entonceslapropiedad"DMTPAccess"nosehaconfiguradocorrectamenteenel
Archivo"MotoDMTP.jad".Congigurelapropiedad"DMTPAccess"comosedescribeanteriormenteyvuelvaacargarlaaplicacinala
telfono.Asegresedequehayunalneaenblancoalfinaldelarchivo"MotoDMTP.jad").
UnavezquelaprimeraposicindeGPS,aparecersimilaralasiguientepantalla:
TIM:12:24:27
LAT:39.1234
LON:142.1234
ACC:+/20pies
SPD:0mph
ALT:17pies
EVT:0/0
Loscamposquesemuestransedescribencomosigue:
TIMEltiempoactual
LATLalatitud
LONLalongitudactual
ACCLa'exactitud'delaposicinGPSactual
SPDLavelocidadactual
ALTLaaltitudactual
EVTElnmerodeeventosdetransmisin/elnmerodeeventosencolaparatransmitir
Pgina59de62
Pgina60
Apndice)
48/51
18/6/2015
E)LaimportacindeGPSEventosdelTrackstickMini
(Estacaractersticaestdisponibleenlaversinv2.3.2deOpenGTS)
El"TrackstickMini"esundispositivoderegistrodedatosGPSdisponiblesenTrackStick".Msinformacinsepuedeencontrarensu
sitioweben"http://www.trackstick.com/products/mini/index.html".
Nota:
OpenGTSySolucionesGeoTelematic,Inc.noestnafiliadosaTrackstickoTelespialSystems,encualquier
manera."Trackstick"y"TrackstickMini"sonmarcascomercialesregistradasdeTrackstickySistemasTelespial.
El"TrackstickManager"puedeexportarlainformacinderegistroGPSenformatoCSV(valoresseparadosporcomasvalor).Estaexportado
ArchivoCSVsepuedeimportarenOpenGTSparamostrarlosdiversoslugarescapturadosenunmapa.Durantelaimportacinde
OpenGTS,lospuntosdedatossepuedefiltrarparaincluirslolospuntosquetienencambiosdedireccinodemsdeuncierto
nmerodesegundosdediferencia,reduciendoaselnmerodepuntosdedatosinnecesarios.
LaconfiguracinrequeridautilizadoalexportarelarchivoCSVeselsiguiente:
Fecha/HoraTodoslosformatosdefecha/horadisponiblesquelossoportesAdministradorTracksticktambinsoncompatiblesconla
OpenGTSutilidaddeimportacinCSV,sinembargo,elcuadrode"Displaysegundos"tambindebeserrevisado.Recomendado:
Fechaen"DD/MM/AAAA"formatoytiempoenunacolumnaseparadaenformatode24horascomo"hh:mm:ss".
ZonahorariaserecomiendaexportarlosdatosdezonahorariaGMT,perolazonahorariadelosdatosexportadospuedeser
especificadaenlaOpenGTS.importacinCSVRecomendado:GMT.
Latitud/LongitudTodoslosformatosdelatitud/longituddisponiblesquelossoportesAdministradorTracksticksontambin
apoyadoporelOpenGTSutilidaddeimportacinCSV,sinembargo,elcuadrode"Visible"tambindebeserrevisado.
Recomendados:grados.
AltitudLasunidadesdealturadebenestarenmetros.Lacasilla"Visible"debecomprobarse.
TemperaturaLasunidadesdetemperaturadebeestarengradosCelsius.
VelocidadLasunidadesdebenestaren"kph"(km/h),sinembargo"mph"y"nudos"debenfuncionartanbiencomosiemprequeestaunidad
especificacinsemuestradespusdequeelvalordelavelocidad.Recomendado:km/h.
Status(duracin)Lasunidadesseleccionadasdebenestaren"minutos".
CursoLasunidadesdelcurso/partidadebenestarengrados(necesarioparalarbricadefiltradodecambio).Lacasilla"Visible"
debeserrevisado.
"DisplayFixGPS"cajadebeserrevisado.
"VisualizacindeSeales"cajadebeserrevisado.
"DisplayPowerOn/OffRegistros"cajadebeserrevisado.
E.1)Configurarelfiltradodeeventos:
Elprocesodeimportacinpuedefiltrareventospararetenersloaquellosquesonpertinentes.Lasiguienteconfiguracindeejecucin
propiedadessepuedenconfigurarparaespecificareltipodefiltradoquedebeproducirsealimportarlosdatosderegistrodelGPS(estos
propiedadesdebenespecificarseenelarchivo"config.conf"):
trackstick.minimumHeadingChange
Estapropiedadespecificaelmnimodetectadocambioderumboparaaceptarunpuntodedatosparasuinclusinen
lamesaEventData.Unnmeromayorreducirelnmerodeeventosincluidos.UnnmeromspequeoWilproducir
.unalneaderutamssuavealrededorgiraValorrecomendado:15,0(grados)
trackstick.minimumMovingSeconds
Estapropiedadespecificaelnmeromnimodesegundosentrepuntosdedatosperidicoscuandoelvehculoesten
.movimientoValorrecomendado:120(segundos)
trackstick.minimumDormantSeconds
Estapropiedadespecificaelnmeromnimodesegundosentrepuntosdedatosperidicosquesepuedenproduciral
.elvehculonoestenmovimientoValorrecomendado:1800(segundo)
Pgina60de62
Pgina61
trackstick.estimateOdometer
EstapropiedadespecificasideseacalcularunvalorodmetrobasadoenGPSentrelospuntossucesivos.
Elpuntodepartidadelodmetroseobtienedelcampo"lastOdometerKM"enelregistrodedispositivos,ylafinal
valordelosodmetrossealmacenadenuevoeneldispositivodecampo"lastOdometerKM".Desdeserecuperaelodmetrodecomenzar
apartirdelregistrodedispositivos,yodmetroterminandosealmacenadenuevoenelregistrodeldispositivo,esposiblequeelintento
paraimportarunarchivoCSVmsdeunavezpuedesesgarlosvaloresdelodmetrointroducidosenlatablaEventData.La
procesodeimportacinnointentedetectarunintentodevolveraimportarelmismoarchivoCSV,paramitigarcualquier"sesgar"
efectoquepuedeocurrir,sinembargosedebetenercuidadoparaevitarvolveraimportarelarchivodesalvarCSVsiesposible.
Valorrecomendado:true
E.2)Ejecutarelcomandodeimportacin:
SuponiendoqueelnombredesuarchivoCSVexportadosellama"2011032604.05.10.csv",elcomandodeimportacin
elarchivoCSVenOpenGTSseralasiguiente:
cd$GTS_HOME
bin/trackstick.shCuenta=CUENTAdevice=DISPOSITIVOtmz=TIMEZONECSV="2011032604.05.10.csv"
OenWindows:
49/51
18/6/2015
cd%GTS_HOME%
bin\trackstick.batCuenta:CUENTAdevice:DISPOSITIVOtmz:TIMEZONECSV:"2011032604.05.10.csv"
Donde"CUENTA"y"DISPOSITIVO"sonlacuenta/dispositivoalqueseaplicarnlosdatosimportados,y"TIMEZONE"es
lazonahorariadelostiemposrepresentadosdentrodelarchivoCSV.(Nota:"a:CUENTAd:DISPOSITIVO"tambinpuedeserutilizadopara
especifiquelacuentayeldispositivo).Establezcaelarchivo"CSV"alnombredelarchivoexportadodesdela"TrackstickManager".
Elcomandoserentoncesencabezadodesalidainformatonqueindicalosvaloresdelafiltradodeeventoscomosigue(losvalores
semuestraacontinuacinslosonunejemplodelosvaloresquepuedenaparecer):
CuentaDemo
Dispositivo:demo
Mododedepuracin:false
PordefectoZonahoraria:GMT
MinVelocidadKm/H:0.0
VarDenominacinmnima:15.0
MinMudanzaSec:120
MinDurmienteSec:1800
Estimacindelcuentakilmetros:true
SeguidoporunapantalladecadaeventoanalizadoyseinsertaenlatablaEventData:
...
IncluyaEvento:trueEventodeInicio(kph)
Marcadetiempo:[1301012280]jue24demarzo17:18:00PDT2011
Estado:Inicio
GeoPoint:39.25054/142,33508
Altitud:562.7metros(1,846.1pies)
Velocidad:4.0km/h(2,5mph)endireccin337,6(Norte)
Temp:28,4C(83,1F)
Odmetro:0,0km(0,0millas)
Eventoalmacenado:[0xF111]Iniciar
Pgina61de62
Pgina62
IncluyaEvento:trueEventoMovimientoPeridico
Marcadetiempo:[1301012520]jue24demarzo17:22:00PDT2011
Estado:InMotion
GeoPoint:39.25052/142,33528
Altitud:564.5metros(1,852.0pies)
Velocidad:0,0km/h(0,0mph)endireccin62.0(Nordeste)
Temp:28,9C(84,0F)
Odmetro:0,0km(0,0millas)
Eventoalmacenado:[0xF112]InMotion
...
Silaopcin"nosave"seaadealalneadecomandos,acontinuacin,seproducirelanlisisdedatos,perolosregistrosEventDatavoluntad
Noalmacenarnihabrningunainformacinodmetroactualizarseenelregistrodedispositivos.Elusode"nosave"esporlogeneral
recomendadoparalacomprobacininicialdelosdatosparaasegurarsedequelazonahorarianosehaespecificadocorrectamente(delocontrarioel
tiempopuedeserapagadoporvariashoras).
E.3)Capturadelainformacindelatemperaturadeldispositivo:
LainformacindelatemperaturatambinsepuedealmacenarenlatabladeEventData,siemprequelasiguienteopcional
ConjuntodecamposEventData"ThermoFieldInfo"sehaactivado(configuradoen"config.conf"):
startupInit.EventData.ThermoFieldInfo=true
EntoncesactualizarlascolumnasdetablaEventData:
cd$GTS_HOME
bin/dbAdmin.plmesas=ca
Elarchivo"reports.xml"puedeentoncessermodificadaparamostrarlosvaloresdetemperaturaenunodelosinformesEventDetail.
50/51
18/6/2015
Pgina62de62
51/51

Manual de Instalación y OpenGTS Configuracion

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Manual de Instalación y OpenGTS Configuracion

Transféré par

Droits d'auteur :

Formats disponibles

18/6/2015

Vous aimerez peut-être aussi