Manual de Instalación y OpenGTS Configuracion

18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion

https://translate.googleusercontent.com/translate_f 1/51

Pgina1

OpenGTS

InstalacinyConfiguracin

Manual

Copyright20072014SolucionesGeoTelematic,Inc.Todoslosderechosreservados

ConfiguracinOpenGTSyManualdeinstalacin Pgina1de62

Pgina2



HistorialderevisionesManualRevolucinFecha Cambiado Autor0.0.1 25/03/2007Versininicial MDF0.0.2 30/03/2007Seagreginformacinparalaadministracintabla"Usuario" MDF0.0.3 22/04/2007Objetivosdehormigasdenivelsuperiormodificadosparaelevento,Mologogo,ylapistadeservletconstruye.

CambiosdetipodeMenores,yloscambiosdeformatodeprrafo/pgina..MDF

0.0.4 05/06/2007NotasaadidasparalosusuariosdeWindows.Todalalneadecomandossolicitaencursiva..AadidonotasobreelregistrodeunaclavedeGoogleMap.

MDF0.0.5 25/05/2007NotasrelativasAadidosoporteparaMicrosoftVirtualEarth.

NotasaadidasparalosusuariosdeWindowsenrelacinconelestablecimientodelasvariablesdeentornoacininstal.MDF

0.0.6 06/03/2007ActualizadoenlacesdedescargadeMySQL.IncluirAntenlacesdedescargav1.7.0. MDF0.0.7 13/06/2007Aadidodocumentacindeadministracindebasededatosadicional.

SeagregunanotaenrelacinconinstalingunintrpretedePerlenWindows.Errorestipogrficosmenoresfijos.MDF

0.0.8 06/30/2007AadidoenlaceadicionalparasudescargaMySQLWinXP. MDF0.0.9 14/07/2007ComentariosadicionalessobreJavaBeansActivationFrameworkcambiosdenotasmenores.

Comentariosadicionalessobrelaredesplieguede"Track.war".Cambiadoelnombredelcomando"server_mysql.*"Para"server_dmtp.*".MDF

0.0.10 27/07/2007Eliminadareferenciaalacreacindelacuentapordefecto"opendmtp",dispositivo"mvil",alinicializarlabasededatoscon"initdb".ComandosAadidoquesonequivalentesacorrer"initdb".Aadidocomentariosrespectoalapersonalizacindelarchivoconfiguationtiempodeejecucindeservlets"webapp.conf".

MDF

0.0.11 08/09/2007Aadidoalgunoscomentariosadicionalessobreelservlet'Eventos'.Tablacomandosdeadministracincambide"bin/admin.sh..."a"admin.sh...".ScriptdearranquedelservidorDMTPcambiadoa"runserver.shsgtsdmtp".

MDF

0.0.12 16/09/2007AadidocomentariosacercadelusodearchivosporlotesenWindows.NotasAadidorespectoalusode'plantilla'y'GPRMC'paracrearservidoresdedispositivospersonalizada..

MDF0.1.1 30/11/2007Aadidonotaadicionalsobreeluso'dbAdmin.pl"paraaadirquefaltancolumnasdelatabla.Cambiosdetextomenoreshicieron.MDF0.1.2 06/02/2008ComentarioaadidoderequisitospreviosencuantoalainflacininstaldeTomcatenLinux.MDF0.1.3 17/02/2008SeagregunaseccindeInternacionalizacin/localizacin.

Seagreginformacinsobrelaimplementacindeservidoresdecomunicacionesdeldispositivo.MDF

0.1.4 20/02/2008AadidocomentariosadicionalesdeconfiguracinregardindeTomcatenDebian/Ubuntu MDF0.1.5 03/28/2008JavaSDK5.0ahoraserequiereparaconstruirOpenGTS. MDF0.1.6 11/04/2008Sehaaadidounaseccinsobrelaspruebasacininstal MDF0.1.7 14/05/2008Seccin"Compilar"Actualizacinparaincluir"hormigatodos".AadidocomentariosadicionalesalaseccinLocalizacin..MDF0.1.8 20/06/2008Actualizadoubicacindelarchivo'private.xml'.Actualizadalainformacindeenlacededescargaparalosvariosmdulos.MDF0.1.9 08/07/2008ComentariosadicionalesconrespectoalaconstruccinAadidoelejemplodelservidor'plantilla'.MDF0.1.10 07/27/2008Aadidonotaconrespectoa'bindbConfig.bat\'comandodisponibleparausuariosdeWindows.

SeagreginformacinrespectoalapersonalizacindelmapaPasadores..MDF

0.1.11 10/16/2008Varioscambiosmenores MDF0.1.12 01/12/2008Actualizadoseccin"Administracindebasededatos' MDF0.1.13 12/16/2008ActualizacindeApacheTomcatURLdedescarga MDF0.1.14 01/02/2009ActualizacionesVarios MDF0.2.0 02/04/2009AgregadoMacOSXinformacindeconfiguracin.Captulosreorganizado.

InicioAadidoadicional'dispositivoservidordecomunicaciones'/paradainformacin.MDF

0.2.1 05/24/2009SeagregunaseccineninstalingMotoDMTP MDF0.3.0 01/07/2009Aadidonotasrelativasalapoyo"events.war"paraexportarloseventosconformatoGPX.

Seagregunaseccinde"Creacin/ModificacindeInformes".NotasAadidoenlavalidacindearchivosLocalStrings.MDF

0.3.1 02/08/2009Comentariosadicionalesaadidosconrespectoaluso"events.war"demapadeGoogleEarth,actualizacionesnotaconrespectoalapersonalizacindelaloogandfeel,etc.MDF0.3.2 08/23/2009Aadidocomentariosrespectoacorrer"runserver.bat"enWindows.ActualizadoTomcatversin5.5.28a.MDF0.3.3 30/10/2009Aadidoopcin'sendMail'almandatodeCheckInstall'. MDF0.3.4 06/18/2010Informatonactualizadasobre'runserver',iniciar/detenerlosservidoresdecomunicacionesdedispositivosyelusode'psjava'.

Seagreginformacinconrespectoalacomunicacindeldispositivoficherodeconfiguracindeservidoresdetiempodeejecucin"dcservers.xml".MDF

0.3.5 08/07/2010AgregadoGTSseccindearquitecturadelsistema.Actualizadodiferentesenlacesprerequisitos.Actualizadopartida/paradaDCS.MDF0.3.6 10/09/2010Aadido"dispositivo"opcionesdeadministracinadicionales.Aadido"Columnasdelatablaopcionales"MDF0.4.1 08/03/2011ColocadodePrerrequisitosyOpenGTSinstalacionesencaptulosseparados.Captulosrenumerado.

Aadidoinformacinadicionalsobreel"GPRMC"httpbasadoservidordecomunicacionesdeldispositivo.MDF

0.4.2 04/01/2011AgregadoTrackstickCSVinformacindeimportacindedatos(v2.3.2).Errorestipogrficosmenoresfijos,etc.MDF0.4.3 21/08/2011Varioscambios.AgregadoJSONformatodearchivoaladescripcindel"events.war".ActualizacinJavaMaildescargaVersin/URL.

AadidoinformacinsobrecmoiniciarlaMduloTK10xDCS.MDF

0.4.4 12/27/2012MesaIncluidonombresdecampoopcionales. MDF0.4.5 11.20.13 Actualizarvnculos. MDF


Page3

OpenGTSInstalacin/Configuracin

Contenidos:1.Introduccin

1.1Plataformascompatibles1.2ArquitecturadelSistema1.3MejorasPlanificadas1.4Convencionesdeldocumento

2Cargadelosmdulosderequisitosprevios2.1JavaCompiler2.2ApoyoJavaMail2.3Apache"Ant"ConstruirHerramienta2.4Apache"Tomcat"contenedorservlet2.5BasededatosMySQLProveedor2.6deMySQLcontroladorJDBC

3Instalacin/CompilacindelFuenteOpenGTS3.1Descomprimir/InstalacindelaFuenteOpenGTS



3.2Configuracindelasvariablesdeentorno3.3CompilarelapoyoGTSBibliotecaArchivos4deinicializacinypruebasdeinstalacin

4.1InicializandolastablasdebasesdedatosSQL4.2Pruebadelainstalacin4.3Cargadelosdatosdeejemplo4.4CreacindelaCuenta"sysadmin"

5Instalacin"track.war"5.1Configuracindelarchivo"webapp.conf"5.2ConfiguracindelInformesdisponibles5.3ConfiguracindelaPrivateLabelLookandFeel5.4Compilar/Instalacindelservlet"track.war"5.5Pruebadelainstalacin5.6Instalacindevariasversionesde"track.war"

6Instalacin"events.war"6.1Configurarelarchivo"webapp.conf"6.2Compilar/Instalacindel"events.war"JavaServlet6.3Comprobacindelainstalacin

Administracindebasesdedatos77.1Creacindecuentas/Edicin7.2Creacin/EdicindeUsuarios7.3Creacin/EdicindeDispositivos7.4BasedeDatosGeneraldeFuncionesAdministrativas

8Instalacin/PuestaenmarchadelOpenDMTP,TK10xyMdulosAspicoreDCS8.1Configuracindelarchivo"dcservers.xml"8.2Iniciodelservidordecomunicacindedispositivos8.3Detencindelservidordecomunicacindedispositivos8.4Adicindeunnuevoregistrodedispositivos

9CreacindesupropioComunicacinDeviceServer9.1ServidoresdecomunicacindedispositivosbasadosenHTTP(utilizandoelservlet"GPRMC")

9.1.1Configuracindelservlet"GPRMC"9.1.2Configuracinpredeterminada"GPRMC"9.1.3Construccindelservlet"GPRMC"

9.2RawSocketBasadoComunicacinDeviceServer9.2.1Iniciodelservidordecomunicacindedispositivos9.2.2Detencindelservidordecomunicacindedispositivos

ArchivodeconfiguracinXML9.3Runtime


Pgina4

OpenGTSInstalacin/Configuracin

Contenido:(continuacin)10Internacionalizacin/Localizacin

10.1Apoyarunnuevoidioma10.2Cambiodelidiomavisualizado

11Creacin/ModificacindeInformes11.1InformedeDiseo.11.2InformedeDatosIterator11.3DefinicindelinformeXML11.4DisponibleinformeEspecificaciones

Apndice:A)SoporteparaMicrosoftSQLServerB)ApoyoaMologogomvilesconcapacidadC)TablaColumnasopcionalesD)InstalacinMotoDMTPE)LaimportacindeGPSEventosdelTrackstickMini




Pgina5

1.Introduccin

OpenGTS(OpenSourceGPSTestanterasSistema)tienelaintencindeofrecerunserviciobasadoenlawebdeserviciosdefondogenricoparaconsultayvisualizacindedatosGPSrelacionados.SedesginedparaoperardeformaindependientedecualquierdispositivoderastreoGPSespecficooprotocolo,perovieneconsoporteparavariosformatosdeprotocolodeldispositivo(comoOpenDMTPAbrirdispositivofuenteMonitoreoySeguimientoProtocolohttp://www.opendmtp.org).

EstdiseadoespecficamenteparasuusoenpequeasymedianasempresascomercialesquedeseentomarventajadeGPSseguimientopara"flotas"devehculos.Sinembargo,OpenGTSesaltamenteconfigurableyescalableparaempresasmsgrandestambin.

Enelladodelservidor,OpenGTSestdiseadoparasereldispositivoyelprotocoloindependiente.ParautilizarlascaractersticasdeOpenGTS,necesitarunservidordecomunicacionesdeldispositivo/protocoloespecficoparaseraplicadoparacomunicarseconeldispositivoremotoycolocarlosdatosenlabasededatosSQL.OpenGTSbarcosconsoporteparaOpenDMTP(http://www.opendmtp.org)DemodoquelosdispositivoscompatiblesconOpenDMTPestarlistoparautilizarinmediatamentelosserviciosdeOpenGTS.Unservidordecomunicacionesdispositivopersonalizadotambinsepuedeimplementarutilizandolafuentedeservidordeejemploincluidocdigo.Consulteelcaptulotitulado"CreacindesupropioComunicacinDeviceServer"paraobtenermsinformacin.

Porelladodelainterfazweb,lapresentacindeusuarioesfcilmentepersonalizableparaadaptarsealapersonadeseadamotivo.Opcionesdemenylascaractersticastambinsonfcilmentepersonalizableparaadaptarsealosrequisitosespecficos.

ElcdigofuenteparaelproyectoOpenGTSpuededescargardesdeSourceForgeenelsiguienteenlace:https://sourceforge.net/projects/opengts/files/

(ConlicenciabajolaLicenciaApacheVersin2:http://www.apache.org/licenses/LICENSE2.0)

Exencinderesponsabilidad:OpenGTS/OpenDMTPnodebenserutilizadosparacualquieractividadilegal.Losproveedoresdeesteproyectonoasumenresponsibityparacualquieractividadilegalquepuedenllevarseacaboporlosusuariosdeestesoftware.

1.1) Plataformascompatibles

OpenGTSseimplementacompletamenteenJavaydebefuncionarbienencualquiersistemaqueestotalmentecompatibleconelJavaRuntimeMedioAmbiente.Sinembargo,estaaplicacinrequiereunservidordebasededatosSQL,yporlotantoselimitatambinasistemasenlosquesubasededatosSQLelegidoejecuta.VisiteelsitiowebdesoportedebasededatosSQLcorrespondienteparasusistemascompatibles(esdecir.paraMySQLver"http://www.mysql.org"QuehasidoprobadoconOpenGTSenLinux,MacOSX,FreeBSD,OpenBSD,ylasplataformas/Vista/WindowsXP20xx).

1.2) ArquitecturadelSistema



EstegrficodescribelaarquitecturadelsistemabsicodelsistemadeOpenGTS.Losdiversoscomunicacindeldispositivoservidores(losmdulosdelosqueescuchanparalosdatosentrantesdelosdispositivosdelocalizacinGPSremotos)seejecutancomoprocesosseparadosenlapartesuperiordeJava.ElservletTrack(esdecir.Lainterfazweb),ascomootrosservlets(incluyendocualquierdispositivobasadoenhttpservidordecomunicaciones),ejecutedentrodeuncontenedorservlet,comoApacheTomcat.


Page6

1.3) MejorasPlanificadas

OpenGTSsiempreestevolucionando,ylasnuevascaractersticascontinuamenteseestnhaciendodisponibles.stossonalgunosgeneralescategorasdelascaractersticasqueseencuentranenlaetapadeplanificacinoimplementacin:

CaractersticasdelmapaAdicionales. Informesadicionales.

GTSEnterprisefueconstruidosobreOpenGTSytienevariascaractersticasadicionalesdisponibles,as(msinformacinconrespectoalaGTSempresasepuedeencontraren"http://www.geotelematic.com/gts.html"):

Soporteparavarios"usocomercial"proveedoresdeserviciosdemapeo. SoporteparamuchosdispositivosdelocalizacinGPSadistanciaadicionales. Lasopcionesadicionalesdepresentacindeinformes. Motorsimple'Reglas'paraenviarnotificacionessobrelabasedecriteriosdeloseventosentrantes(mejoradolanotificacindeeventos

Reglasdelmotortambinestdisponible).

Pngaseencontactoconnosotrosconrespectoaladisponibilidaddeestasyotrascaractersticasal"[email protected]".

1.4) Convencionesdeldocumento

Conelfindeproporcionarundocumentodeinstalacin/configuracingenricaqueabarcadiversostiposdesistemas(esdecir.DeWindowsXP,MacOSX,ylasdistintasdistribucionesdeLinux),ydelasdiversasversionesdelsistemaOpenGTS,lasiguienteconvencionesysupuestossehanadoptadoenestedocumento:

1)EstedocumentoseasumequeelsistemaoperativodedestinoestbasadoenLinux.Paraotrostiposdesistemasoperativos,elseparadoresderutayespecificacionesdedirectorioapropiadotendrqueserutilizadoquecoincidanconlosrequisitosdesusistemaoperativoespecfico.MedioAmbienteespecificacinvariabletambinpuedevariarentresistemasoperativos.Porejemplo,paradesreferenciaelentornoJAVA_HOMEvairable,"%JAVA_HOME%"seespecificaenunSistemadeWindows,mientrasque"$JAVA_HOME"seespecificaenLinuxyMacOSX.

2)EstedocumentoseasumequeeldirectorioenelqueseinstalarnOpenGTSes"/usr/local/".SisequieredebeinstalarOpenGTSenundirectoriodiferente,ustedtendrquereemplazarlasreferenciasdedirectorioenestedocumentoaldirectorioenelqueseinstalOpenGTS.

3)OpenGTStieneuncalendariodelanzamientosfrecuentes.Paramantenerlacoherencia,estedocumentoasumequelaversindeOpenGTSainstalares"OpenGTS_1.2.3".Asquelasreferenciasa"OpenGTS_1.2.3"dentrodeestedocumentodebeserreemplazadoporelnombrerealylaversindelOpenGTSquevaainstalar.

4)Endiversosejemplosdelneadecomandos,puedeverlaespecificacindedirectorio"/zzz".Estaespecificacinessimplementeunnombredemarcadordeposicinquerepresentaalgndirectorioactualenelsistema,ynounnombrededirectorioliteralexistenteenelsistema.

5)Envarioslugaresdentrodeestedocumento,lasopcionesdelneadecomandosseespecificancomo"argName=valor",donde"ArgName"eselnombredeunargumentodelneadecomandos,yel"valor"eselvalorqueseasignaralmandamientoargumentoine.AlintroducircomandosdeWindowsenunsmbolodelsistemaDOS(comocuandoseutilizael".bat"versindeloscomandos),comandoargumentoscomorootUser=rootDEBENbienestarencerradosentrecomillas,comoen"rootUser=root",oespecificarsecondospuntosenlugardeunsignoigual,comoenrootUser:root(preferido).

6)Envarioslugaresdentrodeestedocumento,lasopcionesdelneadecomandosquesemuestranpuedenincluirvaloresdeejemploquedebensersustituidosporvaloresespecficosasusnecesidades.Porejemplo,unaopcindelneadecomandosqueindicauncuentapuedeserespecificadocomo"Cuenta=myaccount"ocomo"Cuenta=".Enestecasoelnombredeargumento"Cuenta="puedesertomadoliteralmente,mientras"myaccount"o""indicaunvalorquedebeserreemplazadoconunvalorespecficoquecumplasusrequisitos.

7)Envarioslugaresdentrodeestedocumento,lasopcionesdelneadecomandosquesemuestranpuedenmandarlneaparmetrosquesonopcionales(slotienenqueserincluidosaparaalgunasaplicaciones,oparacambiarelcomportamientopordefecto).Estosparmetrosopcionalessemostrarndentrodecuadradoscorchetes'['...']"(porejemplo".[dir=/Tmp/gts]")Estoscuadradossoporteindicarqueelparmetroespecificadodentrodeloscorchetesesopcional,dependiendodelarequisitosdecomando.Loscuadradossoportesensnosonparaserincluidosenlaordenintroducida.




Pgina7

2) Cargandolospaquetesderequisitosprevios

NotaImportante:LainstalacindelosmdulosOpenGTSrequisitoprevionorequierenporlomenosunconocimientointermediodecmoinstalaryconfigurarserviciosdesistemastalescomoelcompiladorJava,ApacheAnt,MySQL(uotroservidordebasededatosSQL),ApacheTomcat(uotrocontenedordeservlets),yotrastecnologasrelacionadas.

CompilarOpenGTSrequierequeseinstalarnlossiguientespaquetesoaplicaciones,configurar,yseejecutaenelsistemalocal:

2.1)JavaCompiler

Paquete:JavaSEJDK8Descargar:http://www.java.com/en/download/manual.jspNotas: descargarsloelJDK(JREyaestincluidaenelJDK)

Nota:ParaevitarposiblesdoloresdecabezatratandodeobtenerelcdigoOpenGTScompilar,asegresedequeestutilizandoel"SunMicrosystems"versindelcompiladordeJava.Lasversionesde"otros"tienenproblemasalcompilarelcdigo.

DespusdeinstalarelcompiladordeJava,compruebesuversinconelsiguientecomando:javaversion

Asegresedequedice"Java(TM)"y"JavaHotSpot(TM)ClientVM".

Nota:AsegresedequeeldirectoriodeinstalacindeJavaSDK'bin'sehaaadidoalavariabledeentornoPATH(vermsabajo).Nohacerlopuededarlugaraerroresdecompilacin.

NOTAIMPORTANTE:SloinstalarelcomponenteJDK,noinstaleelcomponenteseparadoJRE.ElJDKyacontieneunJREcomponenteyelJDKesnecesarioparacompilarelcdigoJava.DespusdehaberinstaladotantoenelJDKyJREensusistema,puedeprovocarciertaconfusinalahoradecompilaryejecutarlaaplicacin.

2.1.a)alosusuariosdeMacOSX:Elv1.6.0JavaJDKesprobablequeyainstaladoenelsistemaMacOSX,porloqueesposiblequenoserianecesariodescargarotracopiadelJDKdeJava.SuversininstaladadelV.1.6.0JavaJDKpuedeestarenelsiguientedirectorio:

/System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home

2.1.b)usuariosdeFedora/CentOSLinux:ElFedora/CentOSJava"OpenJDKDevelopmentEnvironment"sepuedeinstalaryutilizarenlugardedescargarlaJDK8directamentedeSunMicrosystems.ElcomandoparainstalareldesarrolladordeJava1.8.0medioambienteenFedora/CentOSeselsiguiente(debeser'root'parainstalar):

#Yuminstalljava1.8.0openjdkdevel

LavariabledeentornoJAVA_HOMEentoncessedebeestablecerenlasiguiente:#ExportJAVA_HOME=/usr/lib/jvm/java1.8.0openjdk

(Asegresedeque"/usr/lib/jvm/java1.8.0openjdk"coincideconelnombredelainstalacindeJavaJDKdirectorio)

Serecomiendacreartambinun"java"enlacesimblicoeneldirectorio"/usr/local/"directorioqueapuntaalaJavaJDKinstalacin,comosigue:

#Cd/usr/local#Lns$JAVA_HOMEjava


Pgina8

2.1.c)losusuariosdeWindows:ElprocesodeinstalacindeJavaenWindowsesprobablequesigaadelanteunainstalacintantolosdirectoriosJDKyJRE(InclusosielJREnofueseleccionadoduranteelprocesodeinstalacin).Lainstalacinpredeterminadainstalarelsiguientesdirectorios:

C:\Archivosdeprograma\Java\jdk1.8.0_40\C:\Archivosdeprograma\Java\jre1.8.0_40\

Apache"hormiga"yotrosprogramasJavanofuncionanbienconunavariabledeentornoJAVA_HOMEquecontieneespaciosincrustados(como"C:\Archivosdeprograma\Java\jdk1.8.0_40").ParaevitarestoOracletienecreadounsubdirectorioen"C:\Datosdeprograma\Oracle\Java\javapath\"paracontenerlinksadiversosJavaejecutablessinespaciosincrustados,sinembargo,poralgunaraznsehaomitidoelcompiladorJDKdesdeestalista.Paracorregiresto,necesitamoscrearundirectoriodeenlacesimblicoadicionalalainstalacindelJDK.Ir



almen"Inicio"yseleccione"Todoslosprogramas",luego"Accesorios",acontinuacin,hagaclicen"Smbolodelsistema"yseleccione"EjecutarcomoAdministrador".Estoproporcionaralosprivilegiosadecuadosparacrearelenlacesimblico,utilizandoelsiguientescomandos:

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)necesitarnsercopiadotantoaladirectoriosdebibliotecasextensasenlasinstalacionesdeJDKyJRE.Estosdirectoriosseenumeranacontinuacin:

C:\Archivosdeprograma\Java\jdk1.8.0_40\jre\lib\ext\C:\Archivosdeprograma\Java\jre1.8.0_40\lib\ext\

NOTA:Losarchivosjarbibliotecaadicionalesdebencopiarseusandoarrastrar/soltardesdelaconsoladeWindows.Attempingcopiarlosdesdeunaventanadelsmbolodelsistemapuedeaparecercomohancopiadoconxito,sinembargo,estosarchivosjardelabibliotecaannopuedenseraccesiblesporeltiempodeejecucindeJava.


Page9

2.2)SoporteJavaMail

Paquete:APISunJavaMail(v1.5.2+)URL: https://java.net/projects/javamail/pages/HomeCdigoPostal:javax.mail.jar

Elarchivojar"javax.main.jar"deestearchivodescargasedebeinstalareneldirectoriodeJavaextendibibliotecacomosiguiente(acceso"root"requiere):

#Cd/tmp/#Javax.mail.jarcp$JAVA_HOME/jre/lib/ext/.

(Donde"/tmp/"eseldirectoriodonde"javax.mail.jar"fuedescomprimido)

2.2.a)alosusuariosdeMacOSX:EnMacOSX,eldirectoriodelabibliotecaampliadadeJavapuedeserenlasiguienteubicacin:

$JAVA_HOME/lib/ext

2.2.b)losusuariosdeWindows:NecesitarEstearchivojarquesecopiarnenlosdirectoriosAMBOSbibliotecaextendidosenlasinstalacionesdeJDKyJRE:


NOTA:Estearchivojardebesercopiadoatravsdearrastrar/soltardesdelaconsoladeWindows.Attempingcopiarlosdesdeunasmbolodelsistemapuedeparecerquesehancopiadoconxito,sinembargo,estosarchivosjardelabibliotecapuedennoseraccesibleporeltiempodeejecucindeJava.

EstopermitirqueelconductorJavaMailestdisponibleparatodoelcdigoJavaqueseejecuta,yentornosdeservletsTomcat.(Notaimportante:asegurarsedequelospermisosdelosarchivosdelabibliotecatarrosonlegiblesmundo)



2.3)Apache"Ant"ConstruirHerramienta

Paquete:v1.9.4Ant+Descargar:http://ant.apache.org/bindownload.cgiCdigoPostal:http://archive.apache.org/dist/ant/binaries/apacheant1.9.4bin.zip

Nota:Asegresedequeeldirectoriodelainstalacindelahormiga'bin'sehaaadidoalavariabledeentornoPATH(vermsabajo).

2.3.a)alosusuariosdeMacOSX:LaltimaversindelahormigaesprobablequeyainstaladoenelsistemaMacOSX,porloqueesposiblequenoserianecesariodescargarotracopiadelApacheAnt.SuversininstaladadeApacheAntpuedeestarenlasiguientedirectorio:

/Usr/share/ant

2.3.b)usuariosdeFedora/CentOSLinux:ElFedora/CentOSApache"Hormiga"sepuedeinstalaryutilizarenlugardeladescargadelainstalacin"Ant"directamentedeApache.Elcomandoparainstalarel"Hormiga"crearambienteenFedora/CentOSeselsiguiente(Debeser'root'parainstalar):

#Yuminstallant


Pgina10

2.4)Apache"Tomcat"contenedorservlet

Paquete:ApacheTomcatV7.xcontenedordeservletsURL: http://tomcat.apache.org/download70.cgiCdigoPostal:http://www.apache.org/dist/tomcat/tomcat7/v7.0.59/bin/apachetomcat7.0.59.zip

Notas:NoinstaleTomcatv8,yaquecontienealgunasincompatibilidadesAPIconversionesanterioresdecdigoservlet.SisuversindeladistribucinLinuxyavieneconunaversindeTomcatinstalada,todavaesmuyrecomendablequeseiniciaconunaversindeTomcatdescargardirectamentedesdelapginawebdeApache.Estoeliminaroreducircualquierpermisosoproblemasclasspathquesepuedenencontrar.Luego,cuandotodoestenmarchayfuncionandocorrectamente,sioptarporhacerlo,sepuedevolveratrseinstalarOpenGTSenlaversindeApacheTomcatqueseenvi/instalaconsudistribucindeLinux.

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/"directorioqueapuntaalaInstalacindeTomcat,comosigue:

#Cd/usr/local#Lns$CATALINA_HOMEtomcat

DentrodeldirectoriodeinstalacindeTomcat'bin'(esdecir."$CATALINA_HOME/bin"),asegresedequelaejecucindePermisosbitseestableceentodoslosarchivos".sh".Sinoseestableceelsiguientecomandoestablecerelbitdeejecucin:

$Cd$CATALINA_HOME/bin$Chmoda+x*.sh

Sielbitdeejecucinnoseencuentraenestosarchivos,Tomcat"startup.sh"ycomandos"shutdown.sh"puedennosercapazdeejecutar.

2.4.b)usuariosdeDebian/UbuntuutilizandounpreinstaladoApacheTomcat:LerecomendamosdescargarlaversindeTomcatdirectamentedeApache,sinembargo,siustedtodavavaautilizarelDebian/UbuntuinstaladolaversindeTomcat,ylosarchivosderegistrodeTomcatestnllenandodeMensajes"java.security.AccessControlException"alintentaraccederalaspropiedadesdelsistema,entoncesustedpuedesernecesarioparacrear/editarunarchivodepolticadeTomcateneldirectorio"/etc/tomcat6/policy.d"quecontieneelinformacinsiguiente(osimilar):

concedercodeBase"file:${catalina.home}/webapps/pista/WEBINF/"{java.util.PropertyPermissionpermiso"*","leer,escribir"java.security.AllPermissionpermiso

}concedercodeBase"file:${catalina.home}/webapps/eventos/WEBINF/"{



java.util.PropertyPermissionpermiso"*","leer,escribir"java.security.AllPermissionpermiso}conceder"file:${catalina.home}/webapps/Mologogo/WEBINF/"codeBase{

java.util.PropertyPermissionpermiso"*","leer,escribir"java.security.AllPermissionpermiso

}Asegresedequelosvaloresanterioressonadecuadosparasuinstalacin.


Pgina11

2.5)ProveedordebasededatosMySQL

Paquete:MySQLv5.xxURL: http://dev.mysql.com/downloads/mysql/

2.5.a)losusuariosdeWindows:EnWindows,descargar/instalarelsiguientearchivo:

mysqlesencial5.X.XXm2win64.msiDonde"mysqlesenciales5.X.XXm2win64.msi"eselnombredelainstalacindeMySQLmsrecienteparaDeWindows.

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'parainstalar):

#Yuminstallmysqlmysqlserver

Nota:AsegresedequeeldirectoriodeinstalacindeMySQL"bin"sehaaadidoalavariabledeentornoPATH.




Pgina12

2.6)MySQLcontroladorJDBC

Paquete:controladorMySQLConnector/Jv5.1.XXJDBCURL: http://dev.mysql.com/downloads/connector/j/CdigoPostal:mysqlconnectorjava5.1.XX.zip

Nota:Connector/JsedistribuyebajolicenciaGPL.

2.6.a)usuariosdeFedora/CentOSLinux:ElconductorFedora/CentOSMySQLJDBCsepuedeinstalaryutilizarenlugardedescargarelJDBCdeMySQLinstalacindelcontroladordirectamentedesdeMySQL.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"deestearchivozipdescargadodebeinstalarseenelJavadirectoriodelabibliotecaampliadadelasiguientemanera(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.Attempingcopiarlosdesdeunasmbolodelsistemapuedeparecerquesehancopiadoconxito,sinembargo,estosarchivosjardelabibliotecapuedennoseraccesibleporeltiempodeejecucindeJava.

EstopermitirqueelcontroladorJDBCestdisponibleparatodoelcdigoJavaqueseejecuta,yentornosdeservletsTomcat.(Notaimportante:asegurarsedequelospermisosdelosarchivosdelabibliotecatarrosonlegiblesmundo)


Pgina13

3)Instalacin/ CompilacindelaFuenteOpenGTS

NotaImportante:LainstalacindelascaractersticasOpenGTSapoyadosrequierealmenosunconocimientointermediodecmoinstalaryconfigurarserviciosdesistemastalescomoelcompiladorJava,ApacheAnt,MySQL(uotroservidordebasededatosSQL),ApacheTomcat(uotrocontenedordeservlets),yotrastecnologasrelacionadas.



3.1)Descomprimir/InstalacindelaFuenteOpenGTS

EnlossistemasLinux,serecomiendaquelosOpenGTSarchivozipsedescomprimenyseinstalaneneldirectorio"/usr/local/"directorio.EnWindows,sepuedeinstalarencualquierdirectorioconveniente,comoenlaparticinrazde"C:\".

Alosefectosdeestedocumento,vamosasuponerqueelsistemaoperativodedestinosebasaenLinux,yquelaubicacindondeseinstalarn/descomprimidoOpenGTSes"/usr/local/OpenGTS_1.2.3/"(Nota:esposiblequetengaqueelegirotrodirectoriodeinstalacinsinotieneacceso"root"enelsistemadedestino).Ajustelosseparadoresarchivo/rutaycomandossegnseanecesarioparasusistemaoperativoparticular,ydirectoriodeinstalacinelegido.

InstalarelcdigofuenteOpenGTS:DescomprimirelpaqueteOpenGTSen"/usr/local/"(estotendrquehacersecomoelusuario"root"),uotroconvenientedirectorio(enWindows,elijaundirectoriodondelegustaraestepaqueteparasercolocadopreferiblementeuncaminoquenocontieneespaciosincrustados).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".SilosOpenGTSziparchivosedescargenundirectoriodiferente,modificarlaubicacindeldirectorioanterioryelnombredelarchivodescargadoenconsecuencia.Tambin,reemplaceelNombredeusuario"usuario"yelnombredelgrupo"grupo",anteriormenteconelnombredelusuario:grupoqueusteddeseatenerdueosdelaInstalacinOpenGTS).

(Tambintengaencuentaqueel"/Zzz "Nombredeldirectorioanterioresslounnombredemarcadordeposicinquerepresentacualquierdirectorioactualquepuedeser,enefecto,antesdeemitirelcomando"cd").

3.2)Configuracindelasvariablesdeentorno

Lasiguientevariabledeentornodebeestablecerseeneldirectoriodeinstalacindelpaquetecorrespondienteoaplicacin:

JAVA_HOMEElJavaJDK(noelJRE)directoriodeinstalacin. ANT_HOMEEldirectoriodeinstalacindeApacheAnt. CATALINA_HOMEEldirectoriodeinstalacindeApacheTomcat. GTS_HOMEEldirectoriodeinstalacinOpenGTS.


Pgina14

3.2.a)losusuariosdeWindows:Laubicacindelainstalacindedirectorios'bin'paraelSDKdeJava,Hormiga,ylasinstalacionesdeservidordebasededatosSQL,necesitaseraadidoalavariabledeentornoPATHejecucindecomandos(sielprocesodeinstalacinnotieneyalesaadealavariablePATH).

Lasvariablesdeentornosepuedenconfigurardeformamanualenunsmbolodelsistemaconelcomando"set",comoenelsiguienteejemplo:

C:\>setGTS_HOME=C:\OpenGTS_1.2.3(Alestablecerlasvariablesdeentorno,lascitasnodebenserutilizadosparaencerrarundirectoriodeinstalacin,inclusosiladirectoriocontieneespaciosincrustados)

Lasvariablesdeentornosonreferenciadosporencerrndolosen'%'.Porejemplo,despusdeestablecerelentornoJAVA_HOMEvariableenpuntoasudirectoriodeinstalacindeJDK,estavariabledeentornoseradesreferenciadocomo"%JAVA_HOME%".

Elseparadorderutadelarchivoeselcarcterdebackslash"\".As,mientrasqueenLinuxpodrahacerreferenciaaundirectorio/archivocomo"$JAVA_HOME/jre/libext//.",enWindowssehacereferenciaaestemismodirectorioque"%JAVA_HOME%\Jre\lib\ext\".

Lasvariablesdeentornopuedenajustarseparaserdefinidoautomticamentealiniciarunsmbolodelsistemaatravsdelaventana"Propiedadesdelsistema"delasiguientemanera: Hagaclicderechosobre"MiPC"yseleccione"Propiedades",laventana"Propiedadesdelsistema"mostrar.

Seleccionelapestaa"Avanzado"yluegopresioneelbotn"Variablesdeentorno". Enlaseccin"Variablesdelsistema",aadelassiguientesvariables:

Nombredelavariable:JAVA_HOME(necesarioparalaconstruccindeOpenGTS,ycorriendoTomcat)



Valor:(LaubicacindesuJavaSDKcarpetadeinstalacin,NOJRE)Nombredelavariable:ANT_HOMEValor:(LaubicacindesucarpetadeinstalacinAnt)

Nombredelavariable:CATALINA_HOME(necesarioparaOpenGTSconstruccin)Valor:(LaubicacindesucarpetadeinstalacinApachTomcat)

Nombredelavariable:GTS_HOMEValor:(LaubicacindesucarpetadeinstalacinOpenGTS)

(PresupuestosdeberanNOpuedenusarparaencerrarundirectoriodeinstalacindestosvariabledeentornoespecificaciones,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/"directoriocuyopuntoasudirectorios'home'correspondiente(saltarunenlacesimblicodadosiyasehacreado):

#Cd/usr/local#Lns$JAVA_HOMEjava#Lns$CATALINA_HOMEtomcat#Lns$GTS_HOMEgts


Pgina15

3.3)CompilarelapoyoGTSBibliotecaArchivos.

3.3a)VersionesprecompiladosdeGTS:SiustedharecibidounaversinprecompiladadelpaqueteGTS,enestaseccinsepuedeomitir(sinembargoustedpuedereconstruirlosdiversosservletsyarchivosjarsidesearealizarningncambioenlaconfiguracindeejecucinantesdelaimplementacin.

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,silaadvertenciaodeerrorpuedenserignorado,tambinhabrunmensajequeindicaqueesteladodelaadvertencia/error(oenunalneajustodebajodelaadvertencia/error).




Pgina16

4) InicializacineInstalacindePruebas

AntesdeutilizarOpenGTS,primerosedebeinicializar.Enestaseccinsedescribenlospasosnecesariosparalainicializacinypruebas.

4.1)InicializandolastablasdebasesdedatosSQL

AntesdeguardarlosdatosenlabasededatosSQL,primerosedebeinicializarlastablasutilizadasporOpenGTS.Estopuedeserlogradoconelcomando"bin/init.sh"delasiguientemanera:

/Zzz>cd$GTS_HOME/usr/local/OpenGTS_1.2.3>bin/initdb.shrootUser=rootPass=

DondeeselusuarioconaccesorootenelservidorSQL,yeslacontraseadelusuarioroot(mayoseropcionaldependiendodelaconfiguracindesuservidorSQL).[NOTA:Estenoeselmismoqueelusuario"root"Linux]

4.1.a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:Loscomandosqueterminanen".sh"o".bat"DEBENserejecutadosdesdeelOpenGTSdirectoriodeinstalacin.Elintentodeejecutarestoscomandosdesdeotrodirectoriopuederesultarenuna"ClassNotFoundException"oError"NoClassDefFoundError",osimilar.(Estosignificaqueusteddebecd$GTS_HOME,acontinuacin,ejecutarelcomandocomo"")losusuariosdeWindowspuedendesearinstalarunintrpretedePerlensumquinaenParautilizarlasversionesdePerl(".pl")delosscriptsdelneadecomandosquenorequierenqueseejecutanDelOpenGTSdirectoriodeinstalacin.MsinformacinsobrelasposiblesdistribucionesdePerldisponiblesenWin32plataformassepuedenencontrarenestelugar:"http://win32.perl.org/wiki/index.php?title=Win32_Distributions"

4.1.b)NotaimportanteparalosusuariosdeWindows:Alutilizarlaversin".bat"deloscomandosenunaventanadeDOS,argumentosdecomandoscomorootUser=rootobiendebeirentrecomillas,comoen"rootUser=root",oespecificarsecondospuntosenlugardeunsignoigual,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):

Cuenta TabladeTitulardelacuenta Usuario Mesadeusuario UserAcl AccesoControlListadeusuariostabla Dispositivo Tabladeinformacindedispositivos EventData LosdatosdeeventosRecibido Geozona definicionesGeozona/Geofence EventTemplate Plantillasdepaquetesdeeventospersonalizados(DMTPsolamente) PendingPacket Lospaquetesenesperadetransmisinaldispositivo(sloDMTP) etctera

Elcomando"initdb.sh"realizalasmismasfuncionesquelasiguientesecuenciadecomandos:

/Zzz>cd$GTS_HOME/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plcreateDBuser=/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plGrantuser=/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plmesas=ca




Pgina17

NotaparalosusuariosdeWindows:"Bin/dbAdmin.pl"sloestdisponibleparalosusuariosdeLinux,ylosusuariosdeWindowsqueseejecutadentrodeunCygwinmedioambiente."Bin\dbConfig.bat"proporcionaunsubconjuntodelasfuncionesdisponiblesen"bin/dbAdmin.pl"quesedesarrollardesdeunsmbolodelsistemadeWindows.

4.2)Pruebadelainstalacin

4.2.a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:Loscomandosqueterminanen".sh"o".bat"DEBENserejecutadosdesdeelOpenGTSdirectoriodeinstalacin.Elintentodeejecutarestoscomandosdesdeotrodirectoriopuederesultarenuna"ClassNotFoundException"oError"NoClassDefFoundError",osimilar.(Estosignificaqueusteddebecd$GTS_HOME,acontinuacin,ejecutarelcomandocomo"")

Elsiguientecomandosehaincluidoparaayudarenelcontroldelainstalacindelsistemaylavisualizacindecualquierinconsistenciasquepodrancausarproblemasentiempodeejecucin:

/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,quedebesercorregido(oalmenosentiende)antesdecontinuarlaimplementacindelsistema.

SerequiereconfiguracinSMTPparaadmitircaractersticascomoelenvodenotificacionesporcorreoelectrnicoolvidados,emailinginformes,etc.LaspropiedadesrequeridasparaSMTPpuedenconfigurarseenunodelosarchivosdeconfiguracindetiempodeejecucin".conf"(tpicamente"Custom.conf").SideseaprobarlaconfiguracindecorreoelectrnicoSMTP,puedeaadirlaopcin"sendMail",queintentarenviarunmensajedepruebaaladireccindecorreoelectrnicoespecificada:

/usr/local/OpenGTS_1.2.3>bin/[email protected]

(Tengaencuentaquehayunespacioentrelaopcin'sendMail'yladireccindecorreoelectrnico)

O,enWindows:

C:\OpenGTS_1.2.3>bin\checkInstall.batsendMail:[email protected]

(Tengaencuentaquehayesun":"entrelaopcin'sendMail'yladireccindecorreoelectrnicoparalaversinWindowsdelcomando)

Reemplazar"[email protected]"conladireccindecorreoelectrnicoquedeseaquerecibaelcorreoelectrnicodeprueba.

4.3)Cargandolosdatosdeejemplo

AlgunosdatosdelamuestrasehaproporcionadoconelOpenGTSinstalacinquepuedesercargadoyconsiderarseenelWebinterfaz.Porfavor,consulteeldocumentoen"sampleData/README.txt"dentrodelOpenGTSdirectoriodeinstalacinparainformacinsobrecmocargarlosdatosdelamuestra.


Pgina18

4.4)LacreacindelaCuenta"sysadmin"

(Lafuncinde"sysadmin"sloestdisponibleconlaversin2.2.7OpenGTSysuperior)

Alentrarala"sysadmin"cuentaunanueva'ficha'menestardisponible,connuevasseleccioneswebpgina,quepermiten



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".


Pgina19

5) Instalacin"track.war"

El"track.war"( WEBARcebolleta)SeejecutaenuncontenedordeservletsJavaytrabajaconelalmacndedatosSQLDBparaproporcionaruncompletointerfazwebofrecidoalosdatosdelocalizacinGPScapturadosenlabasededatosSQLdesdedispositivosremotos.ElmapeoasistenciautilizaactualmenteOpenLayers/OpenStreetMap,peropuedeserconfiguradoparautilizarotroserviciodemapascomercialproveedores.

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".



Msinformacindetalladasepuedeencontrarenelarchivodearriba"reports.xml",yenestedocumentoenotroslugares.EsteesunResumendelascaractersticasdisponiblesenelarchivo"reports.xml"(experienciaenelformatogeneralylaedicindearchivosXMLsernecesario).

"ReportLayout"defineelformatoderegistroesperadoylascolumnasdisponiblesparaelinformedefinido.LaespecficadiseodelinformesedefineporlaclaseJavaespecificaday2diseosdeinformessehanproporcionado:

org.opengts.war.report.event.EventDataLayoutEstadisposicinprevparamostrarregistrosEventDatayespecificalascolumnasdisponiblesenfuncindeloscamposdisponiblesenelregistroEventData.

org.opengts.war.report.field.FieldLayoutEstadisposicinprevmostrargenrico"fielddata"registrosyespecificadiversostipoquesepuedeutilizarparamostrarlosdatospertinentescolumnasdisponibles.

El"Informe"etiquetaespecificaunaclaseJavaqueestunidoaunReportLayoutespecfico.El"Informe"tambinespecificalaformaenquesevaapresentaralusuario(esdecir.laopcindemen),ttulodelinforme,quesemuestracolumnasycriteriosdeseleccindeinforme.

5.3)Configuracindelaetiquetaprivadalook&feel

Laconfiguracinypersonalizacindelainterfazdeusuariodelawebsepuedenespecificarenelarchivo"$GTS_HOME/private.xml"(O"$GTS_HOME/private/private_common.xml"paraelGTSEmpresa).Estearchivocontrolalassiguientesopcionesqueestndisponiblesenbaseaun"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")dearchivosparaobtenermsinformacin.


Pgina20

OpenGTSincluyesoportedemapeoparaOpenLayers/OpenStreetMap,GoogleMaps,MicrosoftVirtualEarth,yMapstraction(quepuedesoportarvariosotrosproveedoresdeserviciosdemapeotambin).Pngaseencontactoconnosotrosenrelacinconelapoyoaotrosproveedoresdeserviciosdemapeocomerciales.SiustedvaautilizarGoogleMapsparasuproveedordemapas,tambindeberegistrarseparaobtenerunaclavedeGoogleMap(asegresedequeustedcumplaconsustrminosdeservicio)ycoloquelallavederegresarenel(O"private_common.xml")archivo"private.xml"enellugarindicado(esdecir.Reemplazar"***PlaceGoogleMapsClaveAqu***"consuclavecitado).Paracambiarelvalorpordefectoaparecemapachinchetas,puedecrearsupropioSeccin"Pasadores"dentrodesuMapProviderelegido.Vealaseccindearchivos'private.xml'Pasadores(enel"OpenLayers"seccinMapProvider)paraobtenermsinformacinsobrelapersonalizacindeiconospasador.

Consulteloscontenidosdelarchivodeetiquetaprivadaproporcionadaen"$GTS_HOME/private.xml"paraobtenermsinformacinsobreespecficapersonalizaciones(experianciaenelformatogeneral,edicinysintaxisdelosarchivosXMLsernecesario).

5.3.a)MantenersintaxisXMLadecuadoalmodificar"private.xml"o"reports.xml"Asegresedequeloscambiosenelarchivo'private.xml'todavacumplenconsintaxisXMLadecuado.XMLesmuyenparticularacercadelasintaxiscorrecta,ylaintroduccindeunerrordesintaxisXMLmenudoresultaenunmensajedeerrorsimilaralelsiguientealintentarverlapginadeiniciodesesinenunnavegadorweb:

Configuracinnovlida'private.xml',porfavorpngaseencontactoconeladministradordelsistemaEjecutar"bin/checkInstall.sh"paraayudaradiagnosticarloserroresdesintaxisXMLquepuedenhabersidointroducidas.

EllookandfeelgeneraldelainterfazwebtambinsepuedencambiarmodificandoelarchivoJSP"$GTS_HOME/guerra/pista/jsp/loginSession.jsp"ylosdiferentesarchivosCSSeneldirectorio"$GTS_HOME/guerra/pista/css/".Busquelaseccindeetiqueta"pginasweb"enelarchivo"private.xml"paraadicionalinformacinsobrelapersonalizacindelarchivo"loginSession.jsp".

5.3.b)IMPORTANTE:VuelvaaimplementartodoslosservletsdespusdemodificarcualquierarchivodeconfiguracindeejecucinCambiosencualquierade"private.xml","reports.xml","webapp.conf","common.conf","system.conf",oarchivos"custom.conf"(uotro".xml"oarchivo".conf"),sernecesarioqueel"track.war"(aligualquelaotraservletsarchivo)serreconstruidoyredesplegado.

5.4)Compilar/Instalacindel"track.war"ServletJava

Paragenerarelarchivo"track.war",ejecuteelcomandodeconstruccinAntdelasiguientemanera:

/Zzz>cd$GTS_HOME



/usr/local/OpenGTS_1.2.3>pistahormiga(Nota,la"hormigatodos"realizadoanteriormentetambinsebasaenelarchivo"track.war")

La"pista"dedestinoesuncontenedorparatareasant"track.compile"y"track.war".El"track.compile"objetivocompilatodaslasclasesnecesariasyarchivosdeconfiguracineneldirectoriodeconstruccin"$GTS_HOME/build/pista".Elobjetivo"Track.war"yluegocreaelarchivo'archivoweb'"$GTS_HOME/build/track.war".Sialgunodelostiempodeejecucinarchivosdeconfiguracinhancambiado,comoarchivos"common.conf""private.xml","reports.xml","webapp.conf",o(Oposiblementecualquierotro"*.conf"del"*.xml"archivo),acontinuacin,elarchivo"track.war"debeserreconstruidoyredistribuido.Unaccesodirectoparareconstruirelarchivo"track.war",sitodoslosmdulosdeorigenyasehancompilado,esemitirlasiguientecomando:

/Zzz>cd$GTS_HOME/usr/local/OpenGTS_1.2.3>hormigatrack.war

Estosimplementevolveraempaquetarelarchivo"track.war"delosmdulosdeorigenpreconstruidos,ylaconfiguracindetiempodeejecucincambiadaarchivos.Sitodoloqueyahasidocompilado,estecomandotomanormalmenteslounossegundosencompletarse.


Pgina21

Instaleelarchivocreado"track.war"segnlasinstruccionesdeinstalacin/configuracindeApacheTomcat.Tpicamente,estosignificacopiarelarchivo"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".Siloscambiosnoaparecendespusdereconstruiryvolveradesplegarelarchivo"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)esmuyrecomendablequelaURLincluyelacontraseadelacuentayserencriptadaatravsde'https',perosernenviadosenelclarosiplain'http'seutiliza.InstruccionesparaconfigurarTomcatparasoportarSSLsepuedeencontrarenelsitiowebdeApacheTomcat.

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"enelArchivo'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(algunasanomalasvisualeshansidoreportadosconversionesanterioresdeIE).Otrosnavegadoresnosehanprobadocompletamente.

5.6)Instalacindevariasversionesde"track.war"

LaURLparaaccederalapginadeiniciodesesinesnormalmentedelasiguientemanera:

http://localhost:8080/pista/Pista

Elnombrede"pista"queaparecemsarribaderivasunombredelnombreparaelarchivodelaguerra,enestecaso"pista.war".Estesignificaqueustedpuedeinstalarmltiples/diferentescopiasdela"pistaarchivo.war",siempreycuandoelnombredelarchivodelaguerraescambiadodurantelacopia.Porejemplo,sicopiael"trackarchivo.war"paraTomcatdelasiguientemanera:



/usr/local/OpenGTS_1.2.3>acumulacincp/pista .war$CATALINA_HOME/webapps/pista1 .war

Acontinuacin,puedeaccederaestaversininstaladaconlasiguienteURL:

http://localhost:8080/pista1/Pista


Pgina22

6) Instalacin"events.war"

El"events.war"( WEBARcebolleta)SeejecutaenuncontenedordeservletsJavaytrabajaconelalmacndedatosSQLDBparapermitirdescargarporcionesseleccionadasdeunasecuenciadeeventosatravsdeInternet.Estosepuedeutilizarconelmapeobasadoenlawebaplicacionesparaproporcionarseguimientocasientiemporealdeunvehculoounapersona.Elservlet'"events.war"apoyaactualmentelarecuperacindedatosenKML,XML,CSV,TXT,GPX,oformatosdearchivoJSON,ysepuedeutilizarenlosprogramasdemapeocomoGoogleEarth,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",copiarestearchivoaladirectorio"$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,estosimplementeimplicacopiarelarchivo"events.war"aldirectorio"$CATALINA_HOME/webapps/.".(ElmtodoanteriorparadesplieguesuponequeTomcatestconfiguradopara'AutoDeploy="true"')


AccedaalosdatosalmacenadosenlabasededatosSQLatravsdelawebconlasiguienteURLconstruida:

http[s]://localhost:8080/eventos/{kml|XML|csv|txt|gpx|json}.?un[UENTA]=elnombredelacuenta

&U[Ser]=elnombredeusuario&P[assword]=lacuenta/contraseadeusuario+D[evice]=elnombredeldispositivo&G[rupo]=elnombredelgrupodedispositivos(opcional)[&Rf=]opcional'de'rangodedatos.[&Rt=]opcional"a"rangodedatos.[&L[imit]=]opcionalnmerode"lmite"deloseventosdevueltos.

Donde"localhost:8080"debeserreemplazadoconelnombrededominiorealyelpuertoutilizadoparaaccederalApacheServidorwebTomcat.[Nota:porencimadeobjetoscolocadosencuadradoscorchetessonopcionales.Lasopcionescolocadosentrellavesindicanqueunadelasopcionesdentrodelasllavesdebenserseleccionados].


Pgina23

Nota:El'rf'y(nmerodesegundosintervalosdefechas'rt'puedenespecificarseenformatodehora'UnixEpoch'desdelamedianocheEne



1,1970)oen"aaaa/mm/dd/HH:MM:SS"formato.Sinoseespecifica,sedevolvernlosltimos100eventos.

6.3.a)Notasobreelaccesowebseguro:Configuracinyusode"https"(esdecir.SSL)esmuyrecomendablequelaURLincluyelacontraseadelacuentayserencriptadaatravsde'https',perosernenviadosenelclarosiplain'http'seutiliza.InstruccionesparaconfigurarTomcatparasoportarSSLsepuedeencontrarenelsitiowebdeApacheTomcat.

Algunosejemplos:

https://localhost:8080/eventos/data.csva=opendmtp&p=mypass+D=mvilDevolucindeunarchivoCSVconformatodedatos('data.csv')quecontieneelltimoregistro100eventosparaeldispositivo'opendmtp'/'mvil'.LosdatossedevuelvenatravsdeunaconexinHTTPSSL.(Nota:sustituirmypass'conlacontraseacorrecta)

http://localhost:8080/eventos/data.jsona=Demo&p=mypass+D=DemoDevolucindeunarchivoconformatoJSONdedatos('data.json')quecontieneelltimoregistrode100eventosparaeldispositivo'Demo'/'Demo'.(Nota:sustituirmypass'conlacontraseacorrecta)

http://localhost:8080/eventos/data.kmlungts=&p=mypass+D=devyrf=1145776000yrt=1145777000DevolverunKML(XML)archivodedatosfomatted('data.kml')conlosprimeros100eventosdentrodelaespecificadarangoparaeldispositivo"gts/dev".

http://localhost:8080/eventos/data.gpxa=gts&p=mypass+D=devyrf=1145776000yrt=1145777000DevuelveunaGPX(XML)archivodedatosfomatted('data.gpx')conlosprimeros100eventosdentrodelaespecificadaalcanceparaeldispositivo"gts/dev"(vase"http://www.topografix.com/gpx.asp"ParaobtenerinformacinconrespectoalaFormatodedatosGPX).

GoogleEarthtienelacapacidaddeformaautomticadatosdelasencuestasdeesteURLaintervalosespecificados.AconfigurarGoogleEarthparaleerlospuntosdedatosdeeventosdelservidor,hagaclicen"Aadir"enlabarrademenprincipal,luegoseleccione"RedEnlace".AadirlaURLrecuperacindeKMLalservidoryhagaclicen"ParmetrosRefresh"parapoderentrarentiemposdeactualizacinperidica.ParamostrarsiemprelosacontecimientosmsrecientesdentrodeGoogleEarth,omitalafechaopcindegama("rf"y"ta")yensulugarespecificarlaopcinde"lmite"parahacerquelalistadevueltaparasiempreincluirlaltimaseriedeeventos.

http://localhost:8080/eventos/data.kmla=gts&p=mypass+D=devylmite=100?DevolverunKML(XML)archivodedatosfomatted('data.kml')conlosltimos100eventosdisponiblesparaeldispositivo"gts/dev".

http://localhost:8080/eventos/data.kmla=gts&p=mypass+D=devylmite=1?DevolverunKML(XML)fomattedarchivodedatos('data.kml')consloelltimo(msreciente)deeventosparaeldispositivo"gts/dev".


Pgina24

7) Administracindebasesdedatos

7.a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:Loscomandosqueterminanen".sh"o".bat"DEBENserejecutadosdesdeelOpenGTSdirectoriodeinstalacin.Intentandoparaejecutarestoscomandosdesdeotrodirectoriopuederesultarenun"ClassNotFoundException"oError"NoClassDefFoundError",osimilar.(Estosignificaqueusteddebecd$GTS_HOME,acontinuacin,ejecutarelcomandocomo"")

7.b)NotaimportanteparalosusuariosdeWindows:Alutilizarlaversin".bat"deloscomandosenunaventanadeDOS,argumentosdecomandoscomorootUser=rootobiendebeirentrecomillas,comoen"rootUser=root",oespecificarsecondospuntosenlugardeunsignoigual,comoenrootUser:root.



Lamayorpartedeadministracindebasededatos(cuentas,usuariosydispositivos,etc)sepuederealizaryaseaatravsdelalneadecomandosserviciospblicosoatravsdelainterfazweb.LosejemplosdeedicinejemploCuenta/usuario/dispositivoquesemuestraacontinuacindescribensolamentealgunosdelosposiblescamposencadaunadeestastablas.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"SQLmesa.Estassonalgunasdelasfuncionesquesepuedenrealizaratravsdel"bin/Cuentaadmin.sh"comando:

Creacindeunacuenta:

/usr/local/OpenGTS_1.2.3>bin/Cuentaadmin.shCuenta=create

Estocrealacuentaespecificadaconlosvalorespordefecto(sustituir""conelidentificadordecuentaquedeseacrear).

Edicindeunacuenta:

/usr/local/OpenGTS_1.2.3>bin/Cuentaadmin.shCuenta=edit

EstecomandomuestrauneditordecampoCuentadelneadecomandos,deformasimilaralosiguiente:


Pgina25

(NOTA:LasiguienteesslounejemploSuaplicacincontienedefinicionesdecampoaddtionalfavor..revisarelarchivo'Schema.txt'enelpaqueteOpenGTSparaobtenerunalistadelasposiblesdefinicionesdecampo.)

Clave:opendmtp0)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,pulsaenterdenuevo.Guardeloscambiosporfinentraren"Guardar".

Aquestunadescripcindealgunosdeloscamposdecuenta(porfavorver'Schema.txt'paraunadescripcindeotrocampoposibledefiniciones):

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.



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'alosqueestacuentadebeserasignado.Sihaymsdeun"dominio"sedefineenelarchivo'private.xml',acontinuacin,estopermiteelusoderecursosdiferentesinversageocodificacin,ycartografaparadiferentescuentas.

Listadodecuentasexistentes:

/usr/local/OpenGTS_1.2.3>bin/listCuentaadmin.sh

Estalistadetodaslascuentasydispositivosdepropiedad.


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=user=create

Estocreaelusuarioespecificadoconvalorespordefecto(sustituir""conelidentificadordeusuarioquedeseacrear).Elusuarionombre"admin"estreservadoparasuusoporeladministradordelacuenta.Cuandoeladministradordelacuentaregistraen(dejandoelcampodenombredeusuarioenblancoenelregistroenlapantalla),entonceselregistroenelprocesosecompruebasiexisteelusuario"admin".Siestoelnombredeusuarionoexiste,entonceslacontraseaydecontroldeaccesoasignadoalusuario"admin"seutilizarparalaCuentaadministrador(Nota:elusuariopredeterminadodeiniciodesesinsepuedecambiarenlapginawebAdministracindecuentas,oenlaCuentadelneadecomandosdeedicin).

Edicindeunusuario:

/usr/local/OpenGTS_1.2.3>bin/admin.shusuarioCuenta=user=edit

Estecomandomuestrauneditordecampodeusuariodelneadecomandos,deformasimilaralosiguiente:

(NOTA:LasiguienteesslounejemploSuaplicacincontienedefinicionesdecampoaddtionalfavor..revisarelarchivo'Schema.txt'enelpaqueteOpenGTSparaobtenerunalistadelasposiblesdefinicionesdecampo.)

Clave:opendmtp,elusuario0)Contrasea:""1)Descripcin:"UsuarioNuevo"2)estactivo:"true"3)Nombredecontacto:""4)Telfonodecontacto:""5)ContactoDireccindecorreoelectrnico:""6)Zonahoraria:""

Introduzcaelnmerodecampo[o'conservar','salida']


Heaquunadescripcindetalladadealgunosdeloscamposdeusuario(consulte"Schema.txt"paraunadescripcindeotrosposiblesdefinicionesdecampo):

ContraseaLacontraseadeiniciodesesindelusuario.Dejandoelarchivodecontraseasvacoimpedirqueelusuarioiniciesesin.Sideseapermitirqueelusuarioiniciesesinsintenerqueintroducirunacontrasea,acontinuacin,debeestablecerelcampodecontraseaparalaprueba"*blanco*"(maysculasyminsculas,ysinlascomillasporsupuesto).

DescripcinLadescripcindelusuario(utilizadoenlosinformes,etc).EsactivoEstevalores"true"sielusuariotodavaseconsideraenservicio.If"falsos",todoslosintentosdeconexindeeste

Usuarioserrechazada.



NombredeContactoElnombredelapersonadecontactodelusuario.Telfonodecontactoelnmerodetelfonodelapersonadecontacto.ContactoDireccindecorreoelectrnicoaddrescorreoelectrnicodelapersonadecontacto.ZonaHorariaLazonahorariapreferidaparaelusuario


Pgina27

7.3)Creacin/EdicindeDispositivos

Elcomando"Dispositivobin/admin.sh"apoyamuchasfuncionesadministrativasqueactansobreel"dispositivo"SQLmesa.Estassonalgunasdelasfuncionesquesepuedenrealizarconelcomando"bin/Dispositivoadmin.sh":

Creacindeundispositivo:

/usr/local/OpenGTS_1.2.3>bin/admin.shDispositivoCuenta=device=create

Estocreaeldispositivoespecificadoconvalorespordefecto(sustituir""conelidentificadordedispositivoquedeseacrear).

Edicindeundispositivo:

/usr/local/OpenGTS_1.2.3>bin/admin.shDispositivoCuenta=device=edit

Estecomandomuestrauneditordecampodeusuariodelneadecomandos,deformasimilaralosiguiente:

(NOTA:LasiguienteesslounejemploSuaplicacincontienedefinicionesdecampoaddtionalfavor..revisarelarchivo"Schema.txt"enelpaqueteOpenGTSparaobtenerunalistadelasposiblesdefinicionesdecampo.)

Clave:opendmtp,mvil0)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"paraunadescripcindeotraposiblesdefinicionesdecampo):

DescripcinLadescripcindeldispositivo(utilizadoenlosinformes,etc).Estactivo"true"siestedispositivoseconsideratodavaenservicio.Si"false",todaslasconexionesdeestedispositivosern

negado.LasdireccionesIPvlidasLadireccinIPdeldispositivoenunaconexinentrantesecompruebacontraestaespecificada

bloquededireccionesIPvlidas,ysenegsiladireccinIPnocoincide.UnvalorenblancoaceptatodoIPentrantedirecciones.

CodificacionessoportadasEsteesunOpenDMTPparmetrosdelprotocolo,yporlogeneraldebesersiempre"7".VeaelEspecificacindelprotocoloOpenDMTPparamsinformacin.

ContabilidadtiempodeintervaloMinutos(OpenDMTPsolamente)Estevalorseutilizaparaevitarquelosclientesdefueradecontrolelconsumoexcesivodeanchodebanda.Elvaloraquespecificaelnmerodeminutosduranteloscualeslossiguientes"Max"seimponenlmitesdevalor.Unvalorde"0"desactivalacontabilidaddeconexin.

NmeromximodeeventosporIntervalo(OpenDMTPsolamente)Elnmeromximodeeventospermitidosduranteelanteriorespecificaintervalo.

MaxTotaldeconexionesporIntervalo(OpenDMTPsolamente)EsteeselnmeromximodeTCPoUDPconexionesquesepermitenduranteelintervaloespecificadoanteriormente.




Pgina28

MaxTotaldeconexionesporminuto(OpenDMTPsolamente)EsteeselnmeromximodeTCPoUDPconexionesquesepermitenduranteunintervalode60segundos.

ConexionesMaxDplexporIntervalo(OpenDMTPsolamente)EsteeselnmeromximodeconexionesTCPquesepermiteduranteelintervaloespecificadoanteriormente.

ConexionesMaxdplexporminuto(OpenDMTPsolamente)EsteeselnmeromximodeconexionesTCPqueselespermiteduranteunintervalode60segundos.

RecuperandoDispositivosEventosatravsdelalneadecomandos:

/usr/local/OpenGTS_1.2.3>bin/admin.shDispositivoCuenta=device=Eventos

EstecomandodevuelvelosltimosacontecimientosenformatoCSV.

Fecha,Hora,Cdigo,Latitud,Longitud,velocidad,rumbo,altitud,direccin2007/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,avecesmuchotiempoenelfuturo.Paramostrarelnmerodeeventosactualesqueestnenelfuturomsde5minutos,introduzcalasiguientecomando:

... >bin/admin.shDispositivoCuenta=device=countFutureEvents=300

Paraeliminarestoseventos"futuro":

... >bin/admin.shDispositivoCuenta=device=deleteFutureEvents=300

Eliminacindeeventos"viejos"paraundispositivodeterminado:

Comoeventosseacumulanenlabasededatos,puedesertilenalgnmomentopararecortareventosantiguosdelsistema.Lasiguientecomandocontarelnmerodeeventosantesdehace90das:

... >bin/admin.shDispositivoCuenta=device=countOldEvents=90d

Paraeliminarestoseventos"viejos":

... >bin/admin.shDispositivoCuenta=device=deleteOldEvents=90d

Elvalordeargumentoparalos"countOldEvents"y"deleteOldEvents"sepuedeespecificarelusodeuntiemporelativo,talescomo"120d",indicandoeventosmayoresdehace120das,oconunaespecificacindetiempoespecfico,comoporejemplo"2010/03/12,13:15:00,GMT",indicandoeventosexistentesantesde12demarzo201013:15GMT.

ADVERTENCIA:LaeliminacindeeventosantiguosdelamesaEventDataesdefinitiva.Unavezquesehaneliminadolosacontecimientos,nosepuederecuperar.


Pgina29

7.4)Funcionesadministrativasdebasededatosgeneral

El"dbAdmin.pl"comando(sloestdisponiblecomounscriptdePerl)puederealizarvariasfuncionesadministrativasenelSQLbasededatos(Nota:elcomando"bin\dbConfig.bat'seproporcionaparalosusuariosdeWindows,yrealizaunsubconjuntodelaoperacionesdisponiblesparaelcomando"dbAdmin.pl").EstassonalgunasdelasfuncionesquesepuedenrealizarutilizandoelComando"dbAdmin.pl":

Verifiquecolumnasdetabla/Actualizar:

/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plmesas

EstecomandocomprobarlaconfiguracindecolumnadetodosOpenGTStablaseinformarsobrelascolumnasquefaltan,uotro



anomalas.SiunOpenGTSnoexistelatabla,secrear.

/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plmesas=c

AlactualizaraunaversinmsrecientedeOpenGTSenquelasnuevascolumnassehanaadidovariastablas,loanteriorcomandoemitirlarequerida"ALTERTABLE"comandosparalastablascomoseanecesarioconelfindeagregarcualquiernuevatablalascolumnas.Siun"tipo"especficacolumnahacambiado,elusode"mesas=ca"harquelostiposdelascolumnasparaseralterados.

/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plmesas=ca

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"eseldestinopordefectosinoseespecificalaopcin"dir").SiesrequeridoporlainstalacindeMySQL,esposiblequetambintengaqueespecifiqueelusuariorootdebasededatos(esdecir.,comoen"rootUser=").Mesasindividualespueden,posteriormente,volveracargarconel"=opcindecarga".

(NotaparalosusuariosdeLinux:EnalgunasversionesdeLinuxqueempleanSELinux,puederecibirunerrorqueindicaqueMySQLnoestpermitidoescribireneldirectorioespecificado.Enestoscasos,puedequetengaqueespecificarundirectorioqueMySQLestpermitidoescribiren,ocambiarlaconfiguracindeseguridaddeSELinuxparaproporcionarMySQLconautorizacinparaescribireneldirectorio"/tmp".)

Tablasdecargadedisco:

/usr/local/OpenGTS_1.2.3>bin/dbAdmin.plload=dir=/tmp/gts

Estecomandosecargalatablaespecificadadesdeelarchivopreviamentecreadoporelargumento"dump".Durantelamesacarga,secorrespondenenloposiblecolumnas.Siunacolumnaestpresenteenelarchivode'dumping',perosehaeliminadoeneltablaactualGTS,segenerarunaadvertenciadequelacolumnasehacado.Estecomandoestilcuandopequeacambiosdelatabladebenserrealizadosenlaestructuradelacolumna.[Nota:loscorchetesespecificadosanteriormenteindicanquelaopcindentrodeloscorchetesesopcional.Loscorchetesnodebenespecificarseliteralmenteenlalneadecomandossielargumentoopcionaldentrodeloscorchetesseutiliza].


Pgina30

8) Instalacin/PuestaenmarchadelOpenDMTP,TK10xymdulosDCSAspicore

Enestaseccinsedescribecmoiniciarydetenerel"gtsdmtp","tk10x",yelservidordecomunicacindeldispositivo"Aspicore"Mdulos(DCS),sinembargoestasinstruccionestambinsonaplicablesaotrosservidoresdecomunicacionesdedispositivosquepuedentambinserinstaladoopuestoenprctica.

MsinformacinsobrelaOpenDMTPproyectosepuedeencontrarenelvnculo"http://www.opendmtp.org".ApoyoparaOpenDMTPdispositivoscompatiblesseincluyenenOpenGTSconelservidordecomunicacindeldispositivo"gtsdmtp"(DCS).

ElmduloDCS"tk10x"escompatiblecondispositivoscompatiblesTK102/TK103protocolomscomn(Nota:algunosfabricantesproduccindeundispositivoTK102/TK103puedeserelusodesupropiavarianteprotocolopersonalizadoquenoescompatibleconelTK102comn/protocoloTK103).

AspicoreofrecesoftwaredeltelfonodelclienteparaelseguimientodelosdiferentestelfonosNokia,SamsungySonyEricsson.LaAspicoreDCSdentrodelpaqueteOpenGTSestdiseadoparatrabajarconelTCPoUDPmtododetransportededatosquepuedeconfigurarsedentrodelaaplicacindetelfonodelclienteAspicore.Paraobtenermsinformacinsobresustelfonoscompatibles,yparaobtenersusoftwarecliente,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"



TK10X: tcpport="31272" UDPport="31272"

Aspicore: tcpport="31265" UDPport="31265"

Estospuertosseespecificanenlaetiqueta"ListenPorts"parasurespectiva"DCServer",ysonlospuertospredeterminadosenqueestosservidoresescuchanparalasconexionesentrantesdelosdispositivosremotos.Puedecambiarestepuertoalcambiarlavalorenesteatributodeetiqueta.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").


Pgina31

8.2a)Notaimportanteconrespectoa".sh"y".bat"archivosdecomandos:Loscomandosqueterminanen".sh"o".bat"DEBENserejecutadosdesdeelOpenGTSdirectoriodeinstalacin.Elintentodeejecutarestoscomandosdesdeotrodirectoriopuederesultarenuna"ClassNotFoundException"oError"NoClassDefFoundError",osimilar.(Estosignificaqueusteddebecd$GTS_HOME,acontinuacin,ejecutarelcomandocomo"")

Obien,laversindePerldeestecomandosepuedeutilizarsinnecesidaddeestarenelOpenGTSdirectoriodeinstalacin:

/Zzz>$GTS_HOME/bin/runserver.plsservidor

EnWindows,elcomandosepuedeomitirlos"s"ypuedeserintroducidadelasiguientemanera:

C:\>cd\OpenGTS_1.2.3C:\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",agregalaopcin"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



servidorconelcomando:

/Zzz>$GTS_HOME/bin/runserver.plsservidorkill

Donde"servidor"debesustituirseporelnombreespecficodelservidorparaempezar(esdecir."gtsdmtp","tk10x",o"Aspicore").


Pgina32

EnlossistemasLinux,elcomandoPerl"psjava ",IncluidoconOpenGTS,sepuedeutilizarparamostrarinformacinsobrequservidoresdecomunicacindedispositivosActualmenterunningr:

/Zzz>$GTS_HOME/bin/psjava

PIDPadresLUsuarioclaseJava/jar

215(1)1OpenGTSorg.apache.catalina.startup.Bootstrap8115(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/gtsdmtp.jar8120(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/tk10x.jar8123(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/aspicore.jar8129(1)1OpenGTS/usr/local/OpenGTS_1.2.3/build/lib/template.jar

EstecomandoenumeratodoslosconocidosprocesosenejecucindeJava,consuPIDasociado(procesoid),padrePID,usuarioyClaseJavaounarchivojarqueseestejecutandoactualmente.El"org.apache.catalina.startup.Bootstrap "ProcesoindicaApacheTomcatqueseestejecutandoconelPIDindicada."gtsdmtp "," tk10x ","Aspicore",y" plantilla "Indicarsurespectivosservidoresdecomunicacindeldispositivoenfuncionamiento.

8.4)Adicindeunnuevoregistrodedispositivos

Unavezqueelservidordecomunicacionesdispositivoadecuado(DCS)estenejecucin,iniciesesinenunacuentaquedeseatenerlapropiadispositivo/telfonoqueserelseguimientoyagregarunnuevoregistrodedispositivos/vehculoenlapgina"Admindispositivos".

OpenDMTP:DispositivosOpenDMTPsuelenutilizarla"cuenta"realyde"dispositivo"deidentificacin.Enestecaso,asegresedequelacuentayeldispositivoIdentificacindelprogramadoeneldispositivocompatibleconOpenDMTPcoincideconlamismacuentaydispositivodeIdentificacincreadodentrodelaSistemaOpenGTS.

TK10x:DispositivosTK102/TK103normalmentereportansuinformacindeidentificacinnicamedianteelnmeroIMEIdelmdem.Enel"Dispositivodeadministracin"delapgina,configurarel"SteamIDcampo"alvalordeIMEIenelformato[tk_12345679012345],donde"123456789012345"eselnmeroIMEIdeltelfono(El"tk_prefijo"seutilizaparaayudaraidentificareltipodedispositivoservidordecomunicacionesutilizadoparaanalizarlosdatosenestecasoTK102/TK103).

Aspicore:ElsoftwaredeclienteAspicoreinformadelainformacindeidentificacinnicautilizandoelnmeroIMEIdeltelfono.Enel"Dispositivodeadministracin"delapgina,configurarel"SteamIDcampo"alvalordeIMEIenelformato[s60_12345679012345],donde"123456789012345"eselnmeroIMEIdeltelfono(El"s60_prefijo"seutilizaparaayudaraidentificareltipodedispositivoservidordecomunicacionesutilizadoparaanalizarlosdatosenestecasoAspicore).




Pgina33

9) Creacindesupropioservidordecomunicacindedispositivos

ParaqueOpenGTSpararecibirdatosdeundispositivo,unpersonalizado"ComunicacinDeviceServer"tendrqueserimplementadoqueentiendeelprotocoloutilizadoparacomunicarseconeldispositivoremoto,yelinsertorecibieventosenlabasededatosSQL.Enestaseccinseofreceunabrevedescripcindelejemploservidores'plantilla'provistoOpenGTSparalaimplementacindesupropioservidordecomunicacionesdispositivoremoto.

Elmtodoutilizadopordispositivosremotosparaeltransportedeeventosalservidorvaraengranmedidaconelfabricantedeldispositivo.AlgunosdatosdetransporteaunservidoratravsdemensajesSMS,algunosusanuntransportedecorreoelectrnicoSMTPparaenviardatosaunservidor,algunosutilizarunprotocolobasadoenHTTPquecodificanlosdatosenlasolicitudalservidor,ymuchosutilizanalgunaformadeprimasocketcomunicacinbasadaen(atravsdeTCP/UDP)paraconectarseaunoyenteenelservidorparatransmitirdatos.Conelfindecrearundispositivoservidordecomunicacionesqueescapazdeanalizarlosdatosdeentradadeundispositivo,unacomprensinntimadelascaractersticasespecficasdeSerequiereelprotocoloutilizadoporelfabricantedeldispositivo.OpenGTSincluyeejemplosparaservidoresbasadosenHTTP,ylosservidoresbasadosenbrutosockets(soporteTCPyUDP),sinembargo,yaquecadafabricantedeldispositivotienenormalmentesupropioprotocoloymododetransportededatos,estosservidoresejemplo,nosepuedesuponerquesoloeltrabajoconcualquier/todosdispositivo.Dependiendodeldispositivoparticularelegido,puedehaberunacantidadsignificativaysustancialdetrabajonecesarioparaapoyareldispositivodehardwareelegido.

Elprimero,ymsimportante,elpasoalcomenzaraimplementarunservidordecomunicacionesdedispositivoparaunhardwareelegidodispositivoesobteneryentendercompletamenteladocumentacindelprotocolodelfabricantedeldispositivo.Mientrashttpcomunicacinbasadaamenudopuedeseringenierainversadelaobservacindelosdatosquelleganalservidor,elintentodeingenierainversadeunprotocolobasadoenbrutosocketspuederesultarextremadamentedifcil,sinoimposible,sinprotocoloadecuadodocumentacin.

9.a)NotaimportanteconrespectoalaIMPLEMENTACINdeunservidordecomunicacionesdeldispositivo:Laimplementacindeunservidordecomunicacionesdedispositivoparaundispositivodadopuedetomarunacantidadsignificativaysustancialdetrabajodeprogramacinparallevaracabo,dependiendodelprotocolodedispositivo.Paraimplementarunservidor,esprobablequenecesitaunacomprensinenprofundidaddelacomunicacinbasadaenTCP/UDP,yunabuenacomprensindeJavatcnicasdeprogramacin,incluidalacomunicacinzcalo,multithreadingymanipulacinposiblementebitabittcnicasparalaextraccindeloscamposdebitsdedatosbinarios(incluyendosabersieldispositivodeseguimientoenvadatosenformatosgrandesendianolittleendian).SiseutilizaunprotocolobasadoenHTTP,esposiblequetengaunacomprensindecmolosservletsseconstruyen,ycmofuncionandentrodeuncontenedordeservlets,comoApacheTomcat.


Pgina34

9.1)ServidoresdeComunicacindispositivobasadoenHTTP(utilizandoelservlet"GPRMC")

[Habilidadesnecesarias:Java,servlets,protocolosbasadosenHTTP]

LacomunicacinbasadaenHTTPestpicamenteelmsfcildeimplementar.SisudispositivoderastreoremotoenvamensajesalaservidorusandounprotocolodecomunicacinHTTPbase,entonceselservidordeejemplo'GPRMC'puedesermodificadoparaanalizarrecibidodatoseinsertarloenlabasededatosSQL.Lasfuentesparaelservidor'GPRMC'(elnombredelacifrarcordde$GPRMCenelprotocoloNMEA0183)sepuedeencontrarenelOpenGTSdirectoriodeorigen"src/org/OpenGTS/guerra/GPRMC"ycorrecomounservletenuncontenedordeservletscomoApacheTomcat(yusalosmismospuertosdeaccesoconfiguradaspara



Tomcat).

9.1.1)Configuracindelservlet"GPRMC":

Estemdulohaincorporadomuchasopcionesconfigurablesyslopuedetenerpropiedadesespecialesdepersonalizacinquepuedenserespecificadoenelarchivo"webapp.conf".Lasiguienteesunalistadepropiedadesconfigurablesdisponiblesparael"GPRMC"httpbasadoservidordecomunicacionesdeldispositivo:

Formatodedatos/valorClavesdelapropiedad:

gprmc.logNameRegistrodenombredesalida.Valorpordefecto:GPRMC

gprmc.uniquePrefixPrefijoUniqueID,utilizacuandolasoperacionesdebsquedaDispositivo.Valorespredeterminadosdevalor:(igualque"gprmc.logName"valordelapropiedad)

gprmc.defaultAccountIDIDdelacuentapordefecto.Valorpordefecto:GPRMC

gprmc.minimumSpeedKPHVelocidadmnimaaceptable(aceleramenosdeestevalorseestableceen'0')Valorpordefecto:0.0

gprmc.estimateOdometerDesercierto,secalcularunodmetroGPSbasado.Valorpordefecto:falso

gprmc.simulateGeozonesSiesverdad,unallegadaGeozona/salidasserdetectadoysecrearloseventosadicionalesoportunas.Valorpordefecto:falso

gprmc.dateFormatFormatodefechaparaelparmetro'fecha'.Valoresvlidos:NINGUNO,EPOCH,AMD,DMY,MDYValorpordefecto:AMD

gprmc.response.okRespuestavolvialdispositivoenlarecepcindedatosconxito.Valorpordefecto:(nadavolvi)

gprmc.response.errorRespuestaderegresadispositivoenelxito(deerror)larecepcindedatos.Valorpordefecto:(nadavolvi)


Pgina35

URLdeparmetrosTeclasdelapropiedad:

gprmc.parm.uniqueURLdeparmetrosclave:UniqueIDValorpordefecto:Identificacin

gprmc.parm.accountURLdeparmetrosclave:CuentaIDValorpordefecto:ctas

gprmc.parm.deviceURLdeparmetrosclave:DispositivoIDValorpordefecto:dev

gprmc.parm.authURLdeparmetrosclave:Aut/contrasea(noseutiliza)Valorpordefecto:(enblanco)

gprmc.parm.statusURLdeparmetrosclave:StatusCodeValorpordefecto:cdigo

gprmc.parm.gprmcURLdeparmetrosclave:GPRMC(SeesperaqueelNMEA0183rcorddeGPRMCparaestevalordeesteparmetro)Valorpordefecto:GPRMC

gprmc.parm.dateURLdeparmetrosclave:Fecha(ignorasi'gprmc.parm.gprmcseespecifica')Valorpordefecto:fecha

gprmc.parm.time



URLdeparmetrosclave:Tiempo(ignoradosi"gprmc.parm.gprmcseespecifica')Valorpordefecto:eltiempo gprmc.parm.latitude

URLdeparmetrosclave:Latitud(ignorasi'gprmc.parm.gprmcseespecifica')Valorpordefecto:lat

gprmc.parm.longitudeURLdeparmetrosclave:Longitud(ignorasi'gprmc.parm.gprmcseespecifica')Valorpordefecto:lon

gprmc.parm.speedURLdeparmetrosclave:clavedeparmetrosdevelocidad(kph)(ignorasi'gprmc.parm.gprmcseespecifica')Valorpordefecto:velocidad

gprmc.parm.headingURLdeparmetrosclave:Titulo(grados)(ignorasi'gprmc.parm.gprmcseespecifica')Valorpordefecto:lacabeza

gprmc.parm.altitudeURLdeparmetrosclave:Altitud(metros)Valorpordefecto:alt

gprmc.parm.odometerURLdeparmetrosclave:cuentakilmetros(kilmetros)Valorpordefecto:odom

gprmc.parm.addressURLdeparmetrosclave:DireccingeocodificadasInvertirValorpordefecto:dir

gprmc.parm.driverURLdeparmetrosclave:DriverIDValorpordefecto:drv

gprmc.parm.messageURLdeparmetrosclave:MensajeValorpordefecto:msg


Pgina36

9.1.2)Incumplimiento"GPRMC"Configuracin:

Elcofigurationdefecto"GPRMC"(sincambiosdeconfiguracinespecialesrealizadosenelarchivo"webapp.conf")esperaunhttpbasaURLsiguienteformato:(laURLacontinuacinmuestralosdiferentescamposenlneasseparadas,peroseenvanormalmentealservidorcomounanicaURLtodoenunasolalnea):

http://example.com:8080/gprmc/Data?id=123456789012345ycode=0xF020yGPRMC=$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

123456789012345RepresentaelIDdemvilnicodeldispositivo(talcomoelIMEI#).(Estevalordebeintroducirseenel"Administradordedispositivos"Pginadecampo"SteamID"enelformato"gprmc_123456789012345").

0xF020Representaelcdigodeestadoseutilizaparaidentificarelmotivodelevento.Elcdigodeestadoseutilizaaqudebecoincidirconelmaleficio,

Manual de Instalación y OpenGTS Configuracion

Documents

Transcript of Manual de Instalación y OpenGTS Configuracion