Manualdeusuario. ExtensinPublicacinBN14.

9Septiembre2008

ndice
.......................................................................................................................................................................1 Manualdeusuario.........................................................................................................................................1 ExtensinPublicacinBN14.........................................................................................................................1 Introduccin..............................................................................................................................................3 Requisitospreviosalainstalacin............................................................................................................3 Instalacin.................................................................................................................................................4 Cmopublicarundocumento...................................................................................................................5 Creardocumentoparapublicar............................................................................................................5 Seleccindelservidoryservicio..........................................................................................................7 Parmetrosdelservidor........................................................................................................................9 Parmetrosdelservicio.......................................................................................................................11 Aadirrecursosalapublicacin........................................................................................................12 Parmetrosdelrecursoremoto...........................................................................................................13 Generacindelaconfiguracin..........................................................................................................15 Propiedadesdelapublicacin............................................................................................................17 Algunosprocesosdeutilidad.................................................................................................................17 Crearunmosaicodeimgenes...........................................................................................................17 Limitacionesyproblemasconocidos......................................................................................................18

Introduccin
ElobjetivodeestaherramientaesdotaragvSIGdelacapacidaddepublicarlainformacinqueseest manipulandoenlavistaenunservidorqueimplementaserviciosOGCcomoWMS,WCSoWFS. BsicamenteestanuevafuncionalidaddegvSIGpermitegenerarlasconfiguracionesdelossiguientes servicios:

Mapserver5.xWMSconfuentesdedatosrster,shapefilesyPostGIS Mapserver5.xWFSconfuentesdedatosshapefilesyPostGIS Mapserver5.xWCSconfuentesdedatosrster Geoserver1.5.4WFSconfuentesdedatosPostGISyshapefiles

Enresumen,estaextensinpermitealusuariopublicarenunservicioOGCestndarlainformacin cartogrficaqueestvisualizandoenunavistadegvSIG,paraaspoderaccederalosrecursos cartogrficosdeformaremota.

Requisitospreviosalainstalacin
Estaversindelaextensindepublicacinsehatesteadoconlaversin1.1.xdegvSIGypara comprobarsufuncionamientonecesitartenerinstaladoMapserver5.xy/oGeoserver1.5.4.A continuacinsemuestranunosprocedimientossencillosparapoderinstalarlosservidoresMapservery GeoservertantoenUbuntulinuxcomoenWindowsXP.Hayquedestacarqueestosprocedimientos tienenlafinalidadderealizarunainstalacinbsicaparapoderprobarlaextensin,enningnmomento setratandeinstalacionesrecomendadasparaentornosenproduccin. InstalacindeMapserver:

EnWindows Estopuederealizarsededistintasmaneras,perolamssencillaesdescargarelpaqueteMS4W desde:http://maptools.org/ms4w/index.phtml?page=downloads.html MS4W(MapServerForWindows)esunpaquetequeincluyeApache,PHP,elmismoMapServer yalgunasutilidades.AldescargarMS4Wtendrunarchivo.zipquedeberdescomprimir directamenteeneldiscoC:desumquina,debiendoquedarundirectoriollamadoc:ms4wal hacerlo.Porltimo,ejecuteelarchivoapacheinstall.bat.Trasestospasos,sehabrcreadoun serviciodewindowsqueiniciaelservidorwebApachecuandoarrancasuordenador.LaURLdel servidorMapserverrecininstaladoser:http://localhost/cgibin/mapserv.exe

EnLinux Abrimosunintrpretedecomandosyejecutamos:sudoaptitudeinstallapache2cgimapserver ConestesimplecomandotendremosinstaladoMapserverenlaURL:http://localhost/cgi bin/mapserv Nota:Conestebinarionohaycompatibilidadconlasfuentesdedatosrasterecwymrsid.Para obtenerdichacompatibilidaddebercompilarlosfuentesdeMapserver.

InstalacindeGeoserver: Geoserverofrecedistintosbinariosparasuinstalacin,cadaunosegnlaplataformaenlaquedeseemos instalarlo.Ensupginawebdedescarga(http://geoserver.org/display/GEOS/Stable)podemosencontrar

lossiguientestiposdebinarios: .EXE:EjecutabledeWindowsqueinstalaGeoserverconuncontenedordeservlets(Jetty)integrado .BIN:ficherocomprimido(zip)quecontienelosbinariosparapoderejecutarsetantoenLinuxcomoen Windows.TambinincorporaelservidorJetty. .WAR:WebArchivequecontienelaaplicacinwebGeoserverlistaparadesplegarseenuncontenedor deservletscomoTomcat.

EnWindows Descargueelficherogeoserver1.5.4.exeyejectelo. LaaplicacinbuscarunJDKinstalado,enelcasodenoencontrarlodeberinstalarlo. Aceptelalicencia. Seleccioneeldirectoriodeinstalacin(puededejareldirectoriopordefecto). Seleccioneeldirectorioquecontienelaconfiguracin(tilparamigracionesentre versiones).SieslaprimeravezqueseinstalaGeoserver,pulseSiguiente. IndiqueellugardondesegenerarelmendeGeoserver.Puededejarlaopcinpor defecto. Paracomprobarlacorrectainstalacin,ejecuteenelmendeGeoserverStartGeoserver. Siseleccionlaopcinpordefectoenlacreacindelosmens,seencontrarenInicio TodoslosprogramasGeoserver1.5.4StartGeoserver.Unavezarrancado,abrala pginawebhttp://localhost:8080/geoserverparacomprobarlacorrectainstalacin. EnLinux

Descargamoselficherogeoserver1.5.4.bin.zip. Lodescomprimimos. Debemosindicarledosvariablesdeentorno:JAVA_HOMEy GEOSERVER_DATA_DIR.Unaopcinparahacerestoeseditarelficherogeoserver/bin/ startup.shyaadindolealiniciodelmismoesosparmetros,porejemplo: JAVA_HOME=/home/usuario/gvSIG/jre/1.5.0_12 GEOSERVER_DATA_DIR=directoriodeconfiguracinqueelijamos Otraopcinesdefinirlasvariablesdeentornoantesdelaejecucinconelcomando export.

ParaarrancarGeoserver,ejecutarenunintrptedecomandosbin/startup.sh,dentrodel directoriodondeseencuentreinstalado.

Instalacin
Pararealizarlainstalacin,deberseguirlosmismospasosqueenlainstalacindecualquierextensin degvSIG.Esdecir,debemosdescargarelficherodelaextensindePublicacindelawebdegvSIG (www.gva.gvsig.es)correspondientealsistemaoperativoqueestemosutilizando,yejecutarlo. Nota:Elprocesodeinstalacinnoencuentraautomticamenteeldirectoriodondesehallainstaladala versincorrectadelaaplicacin,porloquehayqueindicarlomanualmente.Porejemplo,enWindows XPeldirectoriopodraserC:/Archivosdeprograma/gvSIG_1.1,yenLinux/home/usuario/gvSIG_1.1

Cmopublicarundocumento
Lapublicacinconsisteenlossiguientespasos:

ConfiguracindelasvistasdegvSIGconlasfuentesdedatosyleyendasasociadas(paraelcaso deWMS)quesedeseapublicar. Creacindeundocumentodepublicacin. Seleccindelservidoryservicioaconfigurar. Configuracindelosparmetrosespecficosdelservidor Configuracindelosparmetrosespecficosdelservicio AdicindelosrecursosapublicarprovenientesdelasvistasdegvSIG. Configuracindelosparmetrosespecficosdecadaunodelosrecursos. Generacindelaconfiguracin.

Porotraparte,habrquetenerencuentaquelasfuentesdedatosdebenestaraccesiblestantodesde gvSIGcomodesdeelservidor.Porejemplo,losficherosdeberntenerpermisosdelecturaparaelusuario queejecutaelCGIdeMapserver.

Creardocumentoparapublicar
ArrancamosgvSIGyabrimoselGestordeProyectos.Sielprocesodeinstalacinhasidocorrecto, veremosquesehaaadidounnuevotipodedocumento:Publicacin.

Enprimerlugar,abrimosunaVistadegvSIGycargamoslosrecursosocapasdeseados,que posteriormentesernpublicadasmedianteWMS,WFSoWCS.Dichascapaspuedensertantorster (imgenes)comovectoriales.

Seleccindelservidoryservicio
Trasconfigurarcadaunadelasvistasquedeseamospublicar,pararealizarunapublicacinsigalas siguientesinstrucciones:

SeleccioneeltipodedocumentoPublicacinenelGestordeproyectosypulseelbotnNuevo.

SeleccionelapublicacinypulseelbotnAbrir,gvSIGlemostrarunapantalladondepodr elegirelservidoryservicioaconfigurar.

IndiquelaURLdelservidorquedeseaconfigurar,porejemplohttp://localhost/cgibin/mapservo http://localhost:8080/geoserver Seleccioneeltipodeservidoryservicio. PulseAceptarparaconfigurarlosparmetrosespecficosdelapublicacin.Enfuncindel servidoryservicioseleccionadodeberconfigurarsusparmetrosespecficos.Acontinuacinse detallanlasposiblesopciones.

Parmetrosdelservidor
Trasseleccionarelservidoryservicio,gvSIGlemostrarunapantallacontrespestaasparaquevaya indicandolosparmetrosespecficosdecadaunodeloscomponentesdeunapublicacin,elservidor,el servicioylosrecursosremotosaccesiblesatravsdelservicio.Adems,cadaunadelaspestaas,la podremosdividireninformacinbsicayopcionesavanzadas.Paravisualizarestasltimas,seleccioneel checkboxllamadoOpcionesavanzadas.Veamosacontinuacinlosdistintosparmetrosquepueden definirseparacadaunodelosservidores. Mapserver LosparmetrosbsicosparalaconfiguracindeMapserversonlossiguientes:

Ficherodeconfiguracin:Setratadelfichero.map(mapfile)dondesegenerarlaconfiguracin. Eneldirectoriodondeestsituadoesteficherosegenerarntambinotrosficherosparael correctofuncionamientodelservicio.Estosficherossoneldesmbolos(nombre_mapfile.sym),el defuentes(fonts.txt),unafuentetruetype(Vera.ttf)ylosiconosdefinidosenunetiquetadode smbolospuntuales.

Encuantoalasopcionesavanzadas,tenemos:

Depuracin:ActiveestaopcinparavolcarlatrazadeejecucindeMapserverenelficherode logdelservidorweb. Directoriotemporal:AlgunaspeticionesalCGIdeMapserverrequierenlageneracindeficheros

temporales.Pordefectoestosficherosseescribirnenelmismodirectorioenelqueseencuentra elmapfile,sinembargo,medianteestaopcin,podrelegireldirectoriotemporalparagenerar dichosficheros.Enlinuxsueleemplearseeldirectorio/var/tmp(conpermisodeescriturapara todoslosusuariosdelsistema)yrecuerdeque,sieligeotrodirectorio,elusuarioqueejecutael CGI(tpicamentewwwdata)debertenerpermisosdeescrituraenl. NOTA:Actualmente,nicamenteelservicioWCSgeneraficherostemporales.

Directoriodedatos:EstaopcinsirveparadefinirelparmetroSHAPEPATHenelmapfile.La extensindepublicacinutilizarutasabsolutasparalocalizarlosficheros,portanto,estaopcin serdeutilidadnicamentecuandoseutiliceunmosaicodeimgenescuyafuentededatosutiliza rutasrelativasenelcampodelocalizacindelasimgenes.

Geoserver LosparmetrosbsicosdeconfiguracindeGeoserversonlossiguientes:

Usuarioycontrasea:Setratadelusuarioycontraseaquesenecesitarparaaccederala aplicacinwebdeconfiguracindeGeoserver Directoriodeconfiguracin:Directorioquesecrearconlaconfiguracinnecesariaparala ejecucindeGeoserver.Trasgenerarlapublicacin,paraqueGeoserverutilicelaconfiguracin generadaporlaextensin,debercambiarelvalordelavariabledeentorno $GEOSERVER_DATA_DIRparaqueapunteaestedirectorio.

Encuantoalasopcionesavanzadastenemoslassiguientes:

Mx.features:MximonmerodegeometrasquepuededevolverGeoserverenunapeticin GetFeature. Niveldelog:CantidaddeinformacinqueGeoserverescribirenelficherodelogdelcontenedor deservlets.ElvalorSEVEREsloescribirlosfallosmsimportantemientrasqueelvalor FINESTserelquemayorcantidaddeinformacinvolcaralficherodelog.

Parmetrosdelservicio
Trasconfigurarelservidor,deberindicarlosparmetrosdelservicio. Losparmetrosbsicosparatodoslosserviciossonlossiguientes:

Ttulo:ttuloidentificativodelservicio Resumen:descricindelservicio Onlineresource:URLdelservicio.PorejemploenMapserver,sinoindicamoslavariablede entorno$MS_MAPFILE,tendremosqueespecificarlamquina,larutaelCGIdemapserveryla rutaalficheromapfile(p.ejhttp://servidor.com/cgibin/mapserv?map=/etc/mapserver/wms.map). Esimportantedestacarqueenestecaso,larutaalficheromapfilecoincidirconlarutadonde generamosdichofichero.

Respectoalasopcionesavanzadas,enestaversinslopodremosconfigurarlasenlossiguientes servicios: GeoserverWFS

Niveldeservicio:SetratadelmododetrabajodelservicioWFS,enfuncindecadanivelse permitirnunasoperacionesdelanormaWFS:

Basic:Nivelbsico.PermitelasoperacionesGetCapabilities,DescribeFeaturey GetFeature Transactional:Niveltransaccional.Permitelasoperacionesbsicasmslaoperacin Transaction Complete:Nivelcompleto.Permitelasoperacionesdelniveltransaccionalmsla operacinGetFeatureWithLock

Aadirrecursosalapublicacin
Unavezconfiguradoelservidoryelservicio,aadiremosrecursosalapublicacin.Porrecursosse entiendencualquiertipodeentidadquepodemostratarcongvSIGyqueessusceptibleaconvertirseen

unrecursoremotoaccesibleatravsdeunserviciowebcomolayersWMS,featureTypesWFSo coveragesWCS.EnestaversinlosrecursosdegvSIGquepodemospublicarsonlasvistasysuscapas. ParaaadirrecursosalapublicacinpulseelbotnAadirrecursos,aparecerunapantallaconlas vistasylascapas,seleccioneunacapaodirectamentetodaunavista.FinalmentepulseelbotnAadir.

Parmetrosdelrecursoremoto
Deigualformaquelosservidoresylosservicios,tendremoslaposibilidaddeconfigurarunosparmetros bsicosyavanzados.Enestecasoalaizquierdadelasistentedispondremosdeunrbolquenospermitir navegarporlosrecursosremotosyaladerechalainformacindedichosparmetros. Veamosenprimerlugarlosparmetrosbsicosquecompartentodoslosrecursosremotosimplementados enestaversin.

Nombre:Nombrenicoqueidentificaelrecursoremoto.LogeneraautomticamentegvSIGylo utilizaelclientedelserviciodeformatransparenteparaelusuario. NOTA:EnMapserver,elnombredelrecursoeselnombredelacapadefinidoenlavistade gvSIG,portanto,elusuariopuedecontrolardichoparmetro.Porcontra,enGeoserver,el nombredelrecursoesgeneradoautomticamenteynosepuedemodificar.

Ttulo:Conjuntodepalabrasquepermitenalusuarioidentificarelrecursoremoto. Resumen:Descripcindelrecursoremoto.

Porotraparteycomopuedeapreciarseenlasiguientefiguradisponemosdedosoperacionesbsicaspara aadiryeliminarrecursosremotosdelapublicacin.

Losparmetrosavanzadosdelosquesedisponeenestaversinsedetallanacontinuacin. MapserverWMS

Consultable:HabilitalaoperacinGetFeatureInfoparapoderconsultarlosvaloresalfanumricos delacapa. Mosaicodeimgenes:PermitecrearunacapaWMSqueesunmosaicodeimgenes(TILEINDEX deMapserver).Actualmenteslopodrnsermosaicoslosshapefilesquecontenganunatributode nombrelocationyquecontienelarutaalficheroraster.Enelcasoquelarutaalficherorastersea relativa,sedeberespecificareldirectoriobaseenlasopcionesavanzadasdeMapserver.Un herramientaparagenerardeformasencillaestosshapefilesesgdaltindex(herramientadeGDAL/ OGR).

GeoserverWFS

Espaciodenombres:PrefijodelespaciodenombresdelosGMLgeneradosporGeoserver.Este parmetrologeneraautomticamentegvSIGyparashapefilestomaelvalordeldirectorioque contienealfichero,parapostGIStomaelvalordelnombredelabasededatos. Cach:ModificaelparmetroCacheControl:maxage=XXenlacabeceraHTTPparapoder realizarcacheadodepeticiones.

Generacindelaconfiguracin
Finalmente,paragenerarlaconfiguracin,bastaconpulsarelbotnPublicar.Trasello,ysinohan habidoerroresenlapublicacin,visualizaremosunmensajequenosindicaquelapublicacinseha generadocorrectamenteyyatendremospublicadonuestroservicioremoto(WMS,WFSoWCS).

Paracomprobarquehemosrealizadocorrectamentedichapublicacin,podemosabrirunanuevaVistade gvSIGycargar,desdelapestaacorrespondientesegnelcaso(WMS,WFSoWCS)algunacapa conctandonosalservicioqueacabamosdecrear(laURLserel'Onlineresource'delserviciovisto anteriormente):

Comprobamosasque,efectivamente,estamosvisualizandodeformaremotalosmismosrecursos cartogrficosquetenamosennuestraVistaoriginal.

Geoserver

Enestaprimeraversindelaextensinesnecesarioreiniciarlaaplicacinwebparaqueloscambios tenganefecto.

Propiedadesdelapublicacin
Enprincipio,cuandosecreaunapublicacin,laconfiguracingeneradacontienereferenciasalasfuentes dedatosenformaderutasabsolutasalosficheros,portanto,unapublicacinslofuncionarenun servidorqueestenlamismamquinaqueejecutagvSIG.Parasolventarestalimitacinypermitir generarconfiguracionesenservidoresremotossehaimplementadounmecanismoparacambiarlasrutas absolutasaestosficherosdeformaqueseanaccesiblesporelsoftwareservidor.Lospasosaseguirpara lograresteobjetivosedetallanacontinuacin. EnprimerlugardeberemosmontarelsistemadeficherodelservidorenlamquinaqueejecutagvSIG. Segnelsistemaoperativoqueestamosutilizandoexistendistintasformasparahacerlo.Porejemplo,en Windows,utilizaremoslautilidad"conectaraunidaddered"mientrasqueenLinuxpodemosemplear lasherramientasmount,smbmount,sshfs,etc. Unavezquetenemosaccesiblelosficherosdelservidor,cargaremosengvSIGlascapascuyasfuentesde datosresidenenelservidor.Encuantoallugardndegenerarlaconfiguracin,tambinsedeber seleccionarelsistemadeficherosremoto. Finalmentedeberemosindicaralaextensindepublicacinquecambielasrutaslocalesporrutas remotas,paraello,editaremoslaspropiedadesdelapublicacinseleccionandolapublicacinenelgestor deproyectosypulsandoelbotnPropiedades.Nosaparecerunapantallacomosemuestraenla siguientefiguradondedeberemosindicarlossiguientesparmetros:

Directoriolocal:DirectoriodelsistemadeficherosdondeseejecutagvSIG(local)quetienelos ficherosdelservidor. Directorioremoto:Directoriodelsistemadeficherosdelservidor(remoto)quehemoshecho accesibleennuestramquinalocal.

Algunosprocesosdeutilidad Crearunmosaicodeimgenes
ParacrearunmosaicodeimgenesqueposteriormenteseutilizarenlapublicacindeMapserverse puedeemplearlaherramientagdaltindexdeGDAL/ogr.Esteprocesoconsisteengenerarunshapefile

compuestoporrectngulosquerepresentanaimgenes,cadarectngulotendrunatributodenombre locationcuyovaloreslaruta,relativaoabsoluta,alficherorasterquerepresenta.Vemosloconun ejemplo. Suponiendoqueutilizamoselsistemaoperativolinux,imaginemosqueeneldirectorio /home/jvhigon/dataexistenunaconjuntodeimgenesGeoTiffquequeremosmosaicar.Enprimerlugar abriramosunintrpretedecomandosycrearamosunficheroquecontienelasrutasalosficheros. Paragenerarunmosaicoconrutasabsolutas:

jvhigon@jvhigon-laptop:~/data$ find `pwd` -name "*.tif" > optfile.txt

Paracrearloconrutasrelativas:
jvhigon@jvhigon-laptop:~$ find data -name "*.tif" > data/optfile.txt

Ensegundolugarejecutamoselcomandogdaltindexparacrearelshapefileconelmosaico:
jvhigon@jvhigon-laptop:~$ gdaltindex data/mosaico --optfile data/optfile.txt

Eltercerpasoesopcionalperoserecomiendahacerloyconsisteencrearunndiceenelshapefile:
jvhigon@jvhigon-laptop:~/data$ ogrinfo -sql "CREATE SPATIAL INDEX ON mosaico" mosaico.shp

NOTA:otraformadegenerarelndiceesejecutandoelcomandoshptreemosaico.shp FinalmentesloquedaracargarelshapefileengvSIGycrearunapublicacinenelqueesterecursoest marcadocomomosaciodeimgenesenlasopcionesavanzadasdecapasMapserverWMS(cmose comentanteriormente).

Limitacionesyproblemasconocidos
Limitacionesgenerales

Lasfuentesdedatosquepuedecontenerunadocumentacinsonnicamenteshapefiles,postGISy raster.

LimitacionesenlapublicacindeMapserverWMS

Eneletiquetado,nosepuededefinireltamaodelasetiquetasenmetros. Eneletiquetado,lapublicacinemplearsiemprelafuentetruetype"Vera". ElcolordefondodelapublicacineselpredefinidodeMapserver,noeldelavistadegvSIG. AunqueengvSIGsepuededefinirunestiloparaelanilloexteriordeunpolgono,lapublicacin noloreflejar. NosepuedenpublicarcapaspostGISdeltipoGEOMETRY Mapservertieneunlmiteenelnmerodecapasynmerodevaloresnicosquesepuedendefinir paraunacapa(estosparmetrossepuedenmodificarrecompilandoMapserver).Sisesuperaeste lmiteenlapublicacin,elservicionofuncionar.

LimitacionesenlapublicacindeMapserverWFS

NoesposibledefinirelespaciodenombresGML. NosepuedenpublicarcapaspostGISdeltipoGEOMETRY

LimitacionesenlapublicacindeMapserverWCS

SlosepuedenpublicarcoberturasIMG,ECW,JPEGyTIFF

LimitacionesenlapublicacindeGeoserverWFS

Nosepuedenpublicardoscapascuyafuentededatoseselmismoshapefile. CuandopublicasunacapapostGISyGeoservernecesitalacontraseaparaaccederaella,tras reiniciarlaaplicacinweb,sernecesarioaccederalinterfazdeadministracinyponerla contraseaenelalmacndedatoscorrespondiente.

Problemasconocidos

Siseeliminanorenombranlascapasqueestnpublicadas,ocasionarunerroralreiniciarla aplicacin. EnMapserverWMS,siserealizaunaleyendaporvaloresnicosconunshapefilesobreuncampo quecontienecarateresespeciales,comoporejemplolosacentos,lasentidadescorrespondientesa stosvaloresnicosnosevisualizarn. EnMapseverWMS,nosepuederealizarunapublicacindeunacapacuyaleyendasonvalores nicosquecontienencomillasdobles. CuandosepublicanvariasvistasendistintossistemasdecoordenadasenMapserver,elobjeto EXTENTdelmapfileseconfiguraincorrectamente. ExistenproblemasalahoradepublicarshapefilesdeanotacionesgeneradoscongvSIG. AlgunasversionesdeMapserverquesedistribuyenconFWtoolsdanproblemasrelacionadoscon eletiquetadoyelvalor"FOLLOW"