| gvSIG desktop 1

Notas para la puesta en marcha de un workspace para el server

Prerequisitos

1.- Tomcat v5.5 instalado en la m?quina.

2.- Java SDK 1.5 instalado.

3.- Postgresql 8.2+Postgis instalado con las funciones de proximidad(levhenstein).

4.- Existe la carpeta /var/www/wps-files (donde se dejar?n temporalmente los ficheros generados). Esta ruta se puede modificar en el proyecto DownloadWPSResults

Para poner en marcha la base de datos con la cartograf?a de ejemplo, se crear? en postgres un usuario ?callejero?.

Como usuario postgres se har?

$ sh load_db_callejero.sh db_callejero.dump

(los dos ficheros se adjuntan al final).

Para permitir que postgres admita conexiones remotas desde cualquier servidor:

1.- Editar el fichero /etc/postgresql/8.2/main/postgresql.conf y dec

buscamos las siguientes l?neas que se encuentran comentadas:

listen_addresses = ?localhost?

Y la substituimos por la siguiente l?nea:

listen_addresses = '*'

Posteriormente buscamos la siguiente l?nea y le quitamos la marca de comentario:

#password_encryption = on

Y nos debe quedar lo siguiente:

password_encryption = on

Guardamos los cambios y reiniciamos el demonio para que los cambios surtan efecto:

$ sudo /etc/init.d/postgresql-8.2 restart

Para permitir que se conecten desde cualquier m?quina:

2.- $ sudo vi /etc/postgresql/8.2/main/pg_hba.conf

y en #IPV4

host all all 0.0.0.0 0.0.0.0 md5

Guardamos los cambios y reiniciamos el demonio para que los cambios surtan efecto:

$ sudo /etc/init.d/postgresql-8.2 restart

Para la puesta en marcha del workspace

1.- Desde linea de comandos.

$ mkdir /home/user/wrk_wps_server

$ cd /home/user/wrk_wps_server

$ svn checkout http://subversion.gvsig.org/gvSIG/branches/v10/applications/srvWPSCallejero .

Una vez bajado el contenido del svn, arrancar eclipse y elegir el WorkSpace en /home/user/wrk_wps_server

Est? probado con Eclipse-Ganymede.

Desde Eclipse(en la vista ?Java2 EE?), con el WorkSpace en blanco:

1. En la pesta?a Servers, crear un nuevo Server ?Apache Tomcat v5.5 Server? y aceptar el ?Server Name? por defecto(?Tomcat v5.5 Server al localhost?).

2. En Tomcat Installation directory poner la ruta de nuestra instalaci?n de tomcat(runtime).

3. En JRE : La ?Workbench deault jre? deber? ser un jre 1.5.x

Se crear? autom?ticamente una nueva carpeta ?Servers? en el ?Project Explorer?.

Crear una carpeta ?deploy? en la Carpeta Servers y editar las propiedades del servidor tomcat(doble click sobre ?Tomcat v5.5 Server at localhost? en la pesta?a servers).

En el bloque ?Server Locations?, Marcar ?Use custom location(does not modify Tomcat installation) y poner ?Servers/deploy?, para que el deploy local del Tomcat lo haga en esta carpeta.

De esta forma podemos ver m?s f?cilmente qu? se deploya en el servidor embebido.

Grabar los cambios.

En el men? Window-Preferences-Java-Build Path-Classpath Variables crear una nueva variable:

Name: SHARED_LIBRARIES

Path: /home/user/wrk_wps_server/Dependencies-libs/dependencies

Desde File ? Import ? Existing Projects into Workspace

Buscar el directorio /home/user/wrk_wps_server y aceptar

NO MARCAR ?Copy projects into workspace? porque ya est?n en el workspace

En caso de que los proyectos WPS y DownloadWPSResults no compilaran, comprobar en su build-path que el JRE-Library est? bien referenciado.

Arrastrar los proyectos wps y DownloadWPSResults al ?Tomcat v5.5 Server at localhost? en la pesta?a ?Servers?.

Ahora deberemos editar el fichero server.xml de ?Servers -> Tomcat v5.5 Server at localhost-config? y reemplazar al final del fichero el

context

<Context docBase=?wps? path=?/wps? reloadable=?true? source=?org.eclipse.jst.j2ee.server:wps?/>

por este otro

< Context docBase=?wps? path=?/wps? reloadable=?true? source=?org.eclipse.jst.j2ee.server:wps?>

maxActive=?20? maxIdle=?10? maxWait=?-1? name=?jdbc/callejero?

password=?? type=?javax.sql.DataSource? url=?org:postgresql://host:port/db_callejero? username=?callejero?/>

</Context>

Donde host y port corresponderan con nuestro servidor postgres y su puerto(normalmente el 5432).

OJO: S?lo cambiar el context de ?wps?(en el fichero los context est?n seguidos y es f?cil borrar tambi?n el context de DownloadWPSResults).

Copiar desde Dependencies-libs/dependencies los ficheros postgresql-jdbc3-8-2.jar y postgis.jar a nuestro Tomcat\common\lib(el runtime elegido cuando se cre? el nuevo server).

Arrancar Tomcat.

En el men? Run->Run Configurations->Tomcat v5.5 Server, en la pesta?a Arguments, a?adir al final de VM Argumentes el siguiente texto:

-DSERVER_NAME=localhost -DSERVER_PORT=8080

suponiendo que tenemos el tomcat del eclipse arrancado en el puerto 8080.

Desde un navegador ir a la direccion http://localhost:8080/wps/StreetsMap/service.wps?WSDL

y deber? mostrar la definici?n SOAP del proceso.

Para el caso de querer deployar el servidor en un tomcat fuera de eclipse, hay que tener en cuenta:

El servidor wps admite que se le diga con qu? nombre y puerto se va a exponer al exterior, para permitir reglas nat en los routers, por ejemplo:

En local podemos conectarnos a localhost:8080 y desde el exterior queremos que se conecten como ?servidor.wps.es:7654?.

Para esto hemos a?adido antes el -DSERVER_NAME?. en los par?metros de la m?quina virtual.

Si se quiere deployar en un tomcat en producci?n podemos utilizar este script en la raiz de tomcat para especificar el servidor y puerto:

export JAVA_OPTS=?-DSERVER_NAME=nombredelservidor -DSERVER_PORT=puertodelservidor?

bin/shutdown.sh

bin/startup.sh

Para probar el servicio usando la extensi?n de gvsig, seguir las instrucciones del cliente wps.