Instalación de MS4W

2008-09-26T09:48:56Z

Wiki-Maytemanrique: /* Instalación de MS4W */

Nota:

EN: THIS IS STILL A DRAFT
ES: SIGUE SIENDO UN BORRADOR

=Instalación de MS4W=

Como servidor WMS hemos escogido '''UMN Mapserver''', un potente servidor de mapas desarrollado por la Universidad de Minnesota. Este proyecto es uno de los pilares del GFOSS desde hace años. Para ofrecer una experiencia más sencilla al publico neófito, hemos escogido el paquete para ''MS Windows'' de ''UMN Mapserver''. Este paquete se llama '''MS4W''' (''MapServer for Windows'').

== Qué es MS4W==

El fin de este paquete de ''software'' es ofrecer a los usuarios de [http://mapserver.gis.umn.edu/ MapServer] de todos los niveles un entorno de trabajo sobre ''Windows'' de fácil instalación, útil para dar clases y talleres, o preparar aplicaciones pero no para un entorno de ''producción'' real. Es también un entorno para paquetes de aplicaciones que funcionan sobre MapServer.
La pagina oficial de MS4W se encuentra en:
* http://www.maptools.org/ms4w/

[[Image:Home page ms4w.jpg|thumb|none|400px|página de inicio de MS4W]]

La comunidad de ''software'' libre para la geomática (OSGeo) está trabajando activamente en otro proyecto que incluya los paquetes más conocidos del ''software'' SIG (no sólo de componentes de servidor sino también utilidades y clientes de escritorio). Este proyecto, recién comenzado se llama '''OSGEO4W''' y su pagina principal es:
* http://trac.osgeo.org/osgeo4w/

==Descarga de MS4W ==
La página de descarga del paquete se encuentra directamente en el sitio ''web'' o en este enlace:
* http://www.maptools.org/ms4w/index.phtml?page=downloads.html

Se recomienda, para este curso, la descarga de los siguientes paquetes:
* '''setup.exe Installer''' - <tt>ms4w-2.2.9-setup.exe</tt> ''19 MB''
* '''MapServer Itasca Demo Application''' - <tt>mapserv_demo_ms4w.zip</tt> ''9 MB''

===''Setup.exe Installer''===
[[Image:Ms4w.exe link.jpg|thumb|none|400x400px|enlace al instalador de MS4W]]

===''MapServer Itasca Demo Application''===
Para completar la clase necesitaremos el juego de datos libres ''Itasca''.
[[Image:Itasca demo link.jpg|thumb|none|400x400px|enlace al juego de datos ''Itasca'']]

'''NOTA'''
la versión del ''software'' puede ser ligeramente diferente. En este caso el
nombre podría cambiar en su parte numérica. En general este cambio no debe dar
problemas con este curso.

==Procedimiento de instalación de MS4W==
Una vez que tenemos el fichero '''ms4w-2.2.9-setup.exe''' en nuestro ordenador podemos lanzar el proceso de instalación con un doble clic sobre su icono.

===Primera ventana: ''Installation Options''===
Aparece una pequeña ventana que nos ofrece una lista de paquetes para instalar. Los primeros tres ''checkbox'' son fundamentales para que la aplicación funcione correctamente a lo largo del curso.
* ''MS4W base files''
* ''Specify Apache Port''
* ''Install and start Apache Service''

Una vez seleccionados se puede clicar sobre el botón '''Next'''.

[[Image:Ms4w installer 1.jpg|thumb|none|400x400px|instalación de MS4W: primera ventana]]

===Segunda ventana: ''Installation Folder''===
La segunda ventana de configuración indica el camino a la carpeta de instalación. El instalador ofrece por defecto <tt>C:\Program Files</tt> (o <tt>C:\Archivos de programa</tt>) pero resulta más conveniente indicar <tt>C:\</tt> para la compatibilidad con otros paquetes MS4W más antiguos. Si ponemos <tt>C:\</tt> el instalador creará una carpeta <tt>C:\MS4W</tt> con todos los ficheros.
Una vez configurado se puede clicar sobre el botón '''Next'''.
[[Image:Ms4w installer 2.jpg|thumb|none|400x400px|instalación de MS4W: la carpeta]]

===Tercera ventana: ''Apache Port''===
El puerto del servidor ''web'' ''Apache'' ha de ser definida con criterio. Algunos técnicos están acostumbrados a utilizar un servidor ''web'' en su entorno de trabajo y añadir otro (como el incluido en MS4W) puede provocar problemas. Para estar más tranquilos vamos a escoger un puerto generalmente libre, el '''9000'''.
Una vez configurado, clicar sobre el botón '''Install'''.

[[Image:Ms4w installer 3.jpg|thumb|none|400x400px|instalación de MS4W: seleccionar el puerto 9000 para ''Apache'']]

===Cuarta ventana: ''Completed''===
El instalador si no se produjeron problemas durante el proceso acaba con este mensaje:

[[Image:Ms4w installer 4.jpg|thumb|none|400x400px|instalación de MS4W: terminada]]

==Procedimiento de instalación del juego de datos ''Itasca''==
Una vez bajado el fichero podemos proceder a su instalación.
Como MS4W no tiene un verdadero instalador sino que realmente copia los ficheros en una carpeta (para nosotros <tt>C:\MS4W</tt>), sus módulos necesitan sólo ser copiados en el lugar apropiado dentro su estructura.

Con un doble clic sobre el fichero comprimido de ''Itasca'' (<tt>mapserv_demo_ms4w.zip</tt>) se visualiza su contenido.

[[Image:Itasca 1.jpg|thumb|none|400x400px|carpeta expandida del fichero Itasca]]

Se selecciona la carpeta <tt>ms4w</tt>, se copia (ctrl+c) y se pega en la carpeta <tt>C:\</tt>. Debes
confirmar la sobre escritura para todos los ficheros (''Yes to all'' o ''Sí a todos'')

[[Image:Itasca 2.jpg|thumb|none|400x400px|copiando el juego de datos]]

Para estar seguro de que la instalación del paquete se ha producido con éxito se tiene que reiniciar el servidor ''web''. El en menú de inicio de ''Windows'', se busca la carpeta ''MS4W'', luego ''Apache'' y en fin el comando ''MS4W-Apache-restart''.

[[Image:Ms4w restart server.jpg|thumb|none|400x400px|reiniciando Apache]]

aaa

= Configuración del servidor WMS=

Para este curso, el proceso de configuración del servidor WMS consistirá en:

* comprobar el fichero ''map'' de configuración de ''MapServer''
* mostrar con el navegador ''web'' las llamadas fundamentales al servidor
** ''getCapabilities''
** ''getMap''
** ''getLegend''

==Comprobando la instalación de ''MS4W''==
Después de la instalación de ''MS4W'' podemos comprobar su efectividad mirando la dirección ''web'' que le hemos asignado.
Para eso abrimos un navegador ''web' (p.ej. ''Mozilla Firefox'', ''Iternet Explorer'', ''Opera'', etc.) y teclearemos esta dirección:
* http://localhost:9000

[[Image:Ms4w base url.jpg|thumb|none|300x300px|URL del servidor local]]

En definitiva esta es la página que deberíamos encontrar:

[[Image:Ms4w home page.jpg|thumb|none|400x400px|la página ''web'' de inicio de ''MS4W'' en nuestro ordenador]]

==Comprobando el servicio WMS==
Con la instalación de ''MS4W'' tenemos MapServer y sus capacidades de servidor WMS en nuestro ordenador.
El paquete ''Itasca'' nos ofrece los datos para evaluar si servidor WMS funciona correctamente.
Ahora es el momento de comprobar si el servidor WMS contesta como esperamos.

WMS es un estándar para la comunicación de Información Geográfica entre sistemas informáticos. Por eso tiene unas llamadas muy definidas y utiliza URLs (direcciones ''web'') para pasar todos los parámetros que se necesiten para obtener la respuesta deseada.

Las tres llamadas más usadas son:
* '''getCapabilities'''
* '''getMap'''
* '''GetLegendGraphic'''

===''getCapabilities''===
Esta llamada nos ofrece las descripción general de lo que ofrece el servidor.
La página que debes visitar es:
* http://localhost:9000/cgi-bin/mapserv.exe?service=WMS&request=getCapabilities&map=/ms4w/apps/mapserv-demo/itasca.map&version=1.0.0

[[Image:Ms4w itasca getCapabilities.jpg|thumb|none|400x400px|la respuesta del ''getCapabilities'']]

Hay muchas cosas a destacar:
* la dirección que hemos puesto esta compuesta por:
** la dirección de servidor ''UMN Mapserver'': <tt><nowiki>http://localhost:9000/cgi-bin/mapserv.exe?</nowiki></tt>
** el parámetro que indica qué queremos el servicio WMS: <tt>service=WMS</tt>
** el parámetro que define qué tipo de respuesta necesitamos: <tt>&request=getCapabilities</tt>
** el parámetro que especifica qué fichero de mapas queremos que el servidor utilice: <tt>&map=/ms4w/apps/mapserv-demo/itasca.map</tt>
** el parámetro que indica la versión del servicio: <tt>&version=1.0.0</tt>
* el servidor nos contesta con un fichero '''XML''' con la descripción del los juegos de datos ofrecidos por el servidor según el estándar OGC WMS.

===''getMap''===
Esta es la llamada más utilizada. Una vez se sabe qué capa queremos, es '''getMap''' quien devuelve una imagen con el mapa deseado. Así, por ejemplo en nuestro servidor local podemos solicitar un mapa de los datos ''Itasca'' con la siguiente ''url'':
* http://localhost:9000/cgi-bin/mapserv.exe?map=/ms4w/apps/mapserv-demo/itasca.map&&REQUEST=GetMap&SERVICE=WMS&VERSION=1.1.1&LAYERS=drgs&SRS=EPSG:4326&BBOX=-94.4981,46.9722,-92.988,47.9455&WIDTH=551&HEIGHT=356&FORMAT=image/png&STYLES=default&TRANSPARENT=TRUE
[[Image:Ms4w wms getMap.jpg|thumb|none|400x400px|imagen devuelta por la petición ''getMap'']]

===''GetLegendGraphic''===
Muchos clientes de mapas manejan también las leyendas proporcionadas por el servidor de mapas. Por eso un servidor de mapas bien configurado devuelve también la leyenda de una capa respondiendo a la llamada '''GetLegendGraphic'''.
* http://localhost:9000/cgi-bin/mapserv.exe?map=/ms4w/apps/mapserv-demo/itasca.map&REQUEST=GetLegendGraphic&SERVICE=WMS&VERSION=1.1.1&LAYER=drgs&FORMAT=image/png
[[Image:Ms4w wms getLegendGraphics.jpg|thumb|none|400x400px|la respuesta del ''GetLegendGraphic'']]

==Comprobar el fichero ''map'' (''mapfile'')==
Los '''mapfiles''' son los ficheros que describen la configuración del servidor de mapas para ''UMN Mapserver''.
La instalación por defecto del paquete '''Itasca Demo''' pone un ''mapfile'' casi completo, sólo le faltan un par de cambios para funcionar perfectamente.

Para editar el fichero sólo se necesita de un editor de texto, por ejemplo:
* http://notepad-plus.sourceforge.net/es/site.htm
'''Notepad++''' es un completo editor de texto, que además es ''Software'' Libre y nos ofrece todo lo que necesitamos en nuestras clases.

'''NOTA:''' es importante que el editor de texto no sea ''Word'' u otros editores que utilizan texto enriquecido. Cualquier editor de texto sencillo como ''Notepad++'' será suficiente.

====Abrir el ''mapfile''====
Con el editor abre el fichero ''map'' que se encuentra en <tt>C:\ms4w\apps\mapserv-demo\itasca.map</tt>

====Objeto <tt>PROJECTION</tt>====
En la linea 13 cambiar:
#
# Projection definition, consult the PROJ.4 documentation for parameter discussion
#
# PROJECTION
# "proj=utm"
# "ellps=GRS80"
# "zone=15"
# "north"
# "no_defs"
#
# OR:
#
# "init=epsg:26915"
# END

por:
#
# Projection definition, consult the PROJ.4 documentation for parameter discussion
#
PROJECTION
# "proj=utm"
# "ellps=GRS80"
# "zone=15"
# "north"
# "no_defs"
#
# OR:

"init=epsg:26915"
END

'''NOTA:''' en el ''mapfile'' el carácter almohadilla (<tt>#</tt>) al principio de línea inicia un comentario. ''Mapserver'' nunca lee ni interpreta el texto que sigue a <tt>#</tt>.

====<tt>WMS_ONLINERESOURCE</tt>====
En la linea 76:
# change this value to match your setup
WMS_ONLINERESOURCE "<nowiki>http://127.0.0.1/mapserv-demo/index.html</nowiki>"

cambiar la ''url'' por:
# change this value to match your setup
WMS_ONLINERESOURCE "<nowiki>http://localhost:9000/cgi-bin/mapserv.exe?map=/ms4w/apps/mapserv-demo/itasca.map</nowiki>"

=Autores=
* [[User:ominiverdi| Lorenzo Becchi]]
* [[User:jsanz| Jorge Gaspar Sanz Salinas]]

[[Category:Español]]
[[Category:Education]]
[[Category:Cursos]]

OSGeo - User contributions [en]

Instalación de MS4W