manual de instalación y opengts configuracion
Post on 16-Dec-2015
217 Views
Preview:
DESCRIPTION
TRANSCRIPT
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 1/51
Pgina1
OpenGTS
InstalacinyConfiguracin
Manual
Copyright20072014SolucionesGeoTelematic,Inc.Todoslosderechosreservados
ConfiguracinOpenGTSyManualdeinstalacin Pgina1de62
Pgina2
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 2/51
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
ConfiguracinOpenGTSyManualdeinstalacin Pgina2de62
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
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 3/51
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
ConfiguracinOpenGTSyManualdeinstalacin Pgina3de62
Pgina4
OpenGTSInstalacin/Configuracin
Contenido:(continuacin)10Internacionalizacin/Localizacin
10.1Apoyarunnuevoidioma10.2Cambiodelidiomavisualizado
11Creacin/ModificacindeInformes11.1InformedeDiseo.11.2InformedeDatosIterator11.3DefinicindelinformeXML11.4DisponibleinformeEspecificaciones
Apndice:A)SoporteparaMicrosoftSQLServerB)ApoyoaMologogomvilesconcapacidadC)TablaColumnasopcionalesD)InstalacinMotoDMTPE)LaimportacindeGPSEventosdelTrackstickMini
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 4/51
ConfiguracinOpenGTSyManualdeinstalacin Pgina4de62
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
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 5/51
EstegrficodescribelaarquitecturadelsistemabsicodelsistemadeOpenGTS.Losdiversoscomunicacindeldispositivoservidores(losmdulosdelosqueescuchanparalosdatosentrantesdelosdispositivosdelocalizacinGPSremotos)seejecutancomoprocesosseparadosenlapartesuperiordeJava.ElservletTrack(esdecir.Lainterfazweb),ascomootrosservlets(incluyendocualquierdispositivobasadoenhttpservidordecomunicaciones),ejecutedentrodeuncontenedorservlet,comoApacheTomcat.
ConfiguracinOpenGTSyManualdeinstalacin Pgina5de62
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"opengts@geotelematic.com".
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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina6de62
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 6/51
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
ConfiguracinOpenGTSyManualdeinstalacin Pgina7de62
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
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 7/51
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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina8de62
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:
C:\Archivosdeprograma\Java\jdk1.8.0_40\jre\lib\ext\C:\Archivosdeprograma\Java\jre1.8.0_40\lib\ext\
NOTA:Estearchivojardebesercopiadoatravsdearrastrar/soltardesdelaconsoladeWindows.Attempingcopiarlosdesdeunasmbolodelsistemapuedeparecerquesehancopiadoconxito,sinembargo,estosarchivosjardelabibliotecapuedennoseraccesibleporeltiempodeejecucindeJava.
EstopermitirqueelconductorJavaMailestdisponibleparatodoelcdigoJavaqueseejecuta,yentornosdeservletsTomcat.(Notaimportante:asegurarsedequelospermisosdelosarchivosdelabibliotecatarrosonlegiblesmundo)
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 8/51
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
ConfiguracinOpenGTSyManualdeinstalacin Pgina9de62
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/"{
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 9/51
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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina10de62
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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina11de62
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 10/51
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:
C:\Archivosdeprograma\Java\jdk1.8.0_40\jre\lib\ext\C:\Archivosdeprograma\Java\jre1.8.0_40\lib\ext\
NOTA:Estearchivojardebesercopiadoatravsdearrastrar/soltardesdelaconsoladeWindows.Attempingcopiarlosdesdeunasmbolodelsistemapuedeparecerquesehancopiadoconxito,sinembargo,estosarchivosjardelabibliotecapuedennoseraccesibleporeltiempodeejecucindeJava.
EstopermitirqueelcontroladorJDBCestdisponibleparatodoelcdigoJavaqueseejecuta,yentornosdeservletsTomcat.(Notaimportante:asegurarsedequelospermisosdelosarchivosdelabibliotecatarrosonlegiblesmundo)
ConfiguracinOpenGTSyManualdeinstalacin Pgina12de62
Pgina13
3)Instalacin/ CompilacindelaFuenteOpenGTS
NotaImportante:LainstalacindelascaractersticasOpenGTSapoyadosrequierealmenosunconocimientointermediodecmoinstalaryconfigurarserviciosdesistemastalescomoelcompiladorJava,ApacheAnt,MySQL(uotroservidordebasededatosSQL),ApacheTomcat(uotrocontenedordeservlets),yotrastecnologasrelacionadas.
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 11/51
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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina13de62
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)
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 12/51
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
ConfiguracinOpenGTSyManualdeinstalacin Pgina14de62
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).
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 13/51
ConfiguracinOpenGTSyManualdeinstalacin Pgina15de62
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
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 14/51
ConfiguracinOpenGTSyManualdeinstalacin Pgina16de62
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/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
AlgunosdatosdelamuestrasehaproporcionadoconelOpenGTSinstalacinquepuedesercargadoyconsiderarseenelWebinterfaz.Porfavor,consulteeldocumentoen"sampleData/README.txt"dentrodelOpenGTSdirectoriodeinstalacinparainformacinsobrecmocargarlosdatosdelamuestra.
ConfiguracinOpenGTSyManualdeinstalacin Pgina17de62
Pgina18
4.4)LacreacindelaCuenta"sysadmin"
(Lafuncinde"sysadmin"sloestdisponibleconlaversin2.2.7OpenGTSysuperior)
Alentrarala"sysadmin"cuentaunanueva'ficha'menestardisponible,connuevasseleccioneswebpgina,quepermiten
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 15/51
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".
ConfiguracinOpenGTSyManualdeinstalacin Pgina18de62
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".
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 16/51
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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina19de62
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
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 17/51
/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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina20de62
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)Pruebadelainstalacin
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:
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 18/51
/usr/local/OpenGTS_1.2.3>acumulacincp/pista .war$CATALINA_HOME/webapps/pista1 .war
Acontinuacin,puedeaccederaestaversininstaladaconlasiguienteURL:
http://localhost:8080/pista1/Pista
ConfiguracinOpenGTSyManualdeinstalacin Pgina21de62
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"')
6.3)Pruebadelainstalacin
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].
ConfiguracinOpenGTSyManualdeinstalacin Pgina22de62
Pgina23
Nota:El'rf'y(nmerodesegundosintervalosdefechas'rt'puedenespecificarseenformatodehora'UnixEpoch'desdelamedianocheEne
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 19/51
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".
ConfiguracinOpenGTSyManualdeinstalacin Pgina23de62
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.
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 20/51
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:
ConfiguracinOpenGTSyManualdeinstalacin Pgina24de62
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.
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 21/51
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.
ConfiguracinOpenGTSyManualdeinstalacin 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=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']
Paraseleccionarunvalordecampodecambiar,introduzcaelnmerodecampo,luegopulsaenter.Despusdecambiarelvalordelcampo,pulsaenterdenuevo.Guardeloscambiosporfinentraren"Guardar".
Heaquunadescripcindetalladadealgunosdeloscamposdeusuario(consulte"Schema.txt"paraunadescripcindeotrosposiblesdefinicionesdecampo):
ContraseaLacontraseadeiniciodesesindelusuario.Dejandoelarchivodecontraseasvacoimpedirqueelusuarioiniciesesin.Sideseapermitirqueelusuarioiniciesesinsintenerqueintroducirunacontrasea,acontinuacin,debeestablecerelcampodecontraseaparalaprueba"*blanco*"(maysculasyminsculas,ysinlascomillasporsupuesto).
DescripcinLadescripcindelusuario(utilizadoenlosinformes,etc).EsactivoEstevalores"true"sielusuariotodavaseconsideraenservicio.If"falsos",todoslosintentosdeconexindeeste
Usuarioserrechazada.
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 22/51
NombredeContactoElnombredelapersonadecontactodelusuario.Telfonodecontactoelnmerodetelfonodelapersonadecontacto.ContactoDireccindecorreoelectrnicoaddrescorreoelectrnicodelapersonadecontacto.ZonaHorariaLazonahorariapreferidaparaelusuario
ConfiguracinOpenGTSyManualdeinstalacin Pgina26de62
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']:
Paraseleccionarunvalordecampodecambiar,introduzcaelnmerodecampo,luegopulsaenter.Despusdecambiarelvalordelcampo,pulsaenterdenuevo.Guardeloscambiosporfinentraren"Guardar".
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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina27de62
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 23/51
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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina28de62
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
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 24/51
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].
ConfiguracinOpenGTSyManualdeinstalacin Pgina29de62
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"
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 25/51
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").
ConfiguracinOpenGTSyManualdeinstalacin Pgina30de62
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
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 26/51
servidorconelcomando:
/Zzz>$GTS_HOME/bin/runserver.plsservidorkill
Donde"servidor"debesustituirseporelnombreespecficodelservidorparaempezar(esdecir."gtsdmtp","tk10x",o"Aspicore").
ConfiguracinOpenGTSyManualdeinstalacin Pgina31de62
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).
ConfiguracinOpenGTSyManualdeinstalacin Pgina32de62
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 27/51
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.
ConfiguracinOpenGTSyManualdeinstalacin Pgina33de62
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
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 28/51
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)
ConfiguracinOpenGTSyManualdeinstalacin Pgina34de62
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
-
18/6/2015 ManualdeInstalacinyOpenGTSConfiguracion
https://translate.googleusercontent.com/translate_f 29/51
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
ConfiguracinOpenGTSyManualdeinstalacin Pgina35de62
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,
top related