gvSIG projects pool

# Probar vcsgis rodando sobre un Tomcat.

## Obtener una version de Tomcat

Para las pruebas he descargado el fichero:

* apache-tomcat-9.0.46.tar.gz (https://ftp.cixug.es/apache/tomcat/tomcat-9/v9.0.46/bin/apache-tomcat-9.0.46.tar.gz)

  desde "https://tomcat.apache.org/download-90.cgi"

de la web de tomcat y lo he descomprimido en un a carpeta:

* $HOME/datos/Applications/apache-tomcat/apache-tomcat-9.0.46

## Configurar el navegador en el Netbeans.

En el Netbeans selecionar la opcion de menu:

* Tools/Options

En la ventana de "Options", pestaña "Genaral", seleccionar el "Firefox" en el desplegable de "Web browser" y pulsar el boton "Ok".

## Configurar el Tomcat en el Netbeans

En el netbeans, en la pestaña de services:

* Boton derecho sobre la entrada del arbol "Servers".

* Seleccionar como "Server" "Apache Tomcat TomEE" y siguiente.

* Indicar en "Server Location" la ruta "$HOME/datos/Applications/apache-tomcat/apache-tomcat-9.0.46"

  seleccionandola con el boton "Browser...".

* En "Username" poner "sara"

* En "Password" poner "sara1"

* Marcar la casilla "Create usar if it does not exist".

* Pulsar el boton "Finish".

En el arbol seleccionar la entrada "Servers/Apache Tomcat TomEE", pulsar boton derecho y seleccionar la opcion properties.

En la pestaña general comprobar que:

* En "Username" pone "sara"

* En "Password" pone "sara1"

* En "Server Port" pone 8080.

En la pestaña "Startup":

* Esta marcada la opcion "Socket Port" con el valor 11550.

En la pestaá "Platform":

* En "Java Platform" seleccionamos "JDK 1.8 (Oracle)", o una jre/jdk compatible con gvSIG.

## Configurar el servicio VCSGis para desplegarlo en el Tomcat.

(no he sabido configurar el Netbeans para que desplegue el war en el Tomcat)

Seleccionar el proyecto "org.gvsig.vcsgis.tomcat.webapp", pulsar con el boton derecho sobre ella y seleccionar la opcion "Properties".

Se presentara la ventana "Project properties - org.gvsig.vcsgis.tomcat.webapp". 

En el arbol de "categories" seleccionar la opcion "Run":

* En el desplegable "Server" seleccionar la opcion "Apache Tomcat or TomEE".

* En "Relative URL" introducir "/vcsgis".

* En "Browser" seleccionar "IDE's default browser".

Y pulsar el boton de "Ok".

## Desplegar manualmente el servicio de VCSGis.

En la pestaña "Services" seleccionar:

* Servers/Apache Tomcat or TomEE/Web Applications/manager

Pulsar boton derecho y "Open in browser".

En el navegador se abrira la pagina de administracion del Tomcat. Puede pedir usaurio y clave (sara/sara1).

Comprobar que no este "*vcsgis*" en la columna "Ruta" de la lista de aplicaciones. Si lo esta, desinstalarla pulsando el boton "Replegar".

Mas abajo, en la seccion "Archivo WAR a desplegar", pulsaremos el boton "Excaminar" y seleccionaremos el war de dentro de la carpete target del proyecto "org.gvsig.vcsgis.tomcat.webapp", por ejemplo "org.gvsig.vcsgis.tomcat.webapp-1.0.20-SNAPSHOT.war" y pulsaremos en el boton "Desplegar".

En el navegador navegaremos a la pagina:

* http://localhost:8080/org.gvsig.vcsgis.tomcat.webapp-1.0.20-SNAPSHOT/hello

## Depurar el servicio de VCSGis.

Con el servicio iniciado en el Tomcat, en el Netbeans seleccionaremos la opcion:

* Debug/Attach Debugger...

En la ventana "Attach" seleccionaremos:

* En el desplegable de "Connector" "SocketAttache".

* En el "Host" "localhost"

* En el "Port" "11550"

Y pulsaremos el boton "Ok".

            <dependency>

                <groupId>org.apache.maven.plugins</groupId>

                <artifactId>maven-war-plugin</artifactId>

                <version>3.2.3</version>

                <type>maven-plugin</type>

            </dependency>

            <dependency>

                <groupId>org.apache.tomcat</groupId>

                <artifactId>tomcat-servlet-api</artifactId>

                <version>9.0.45</version>

            </dependency>

            <dependency>

                <groupId>javax.servlet</groupId>

                <artifactId>javax.servlet-api</artifactId>

                <version>3.1.0</version>

            </dependency>

            <dependency>

                <groupId>org.eclipse.jetty</groupId>

                <artifactId>jetty-server</artifactId>

                <version>9.4.34.v20201102</version>

            </dependency>

            <dependency>

                <groupId>org.eclipse.jetty</groupId>

                <artifactId>jetty-servlet</artifactId>

                <version>9.4.34.v20201102</version>

            </dependency>

            <dependency>

                <groupId>org.eclipse.jetty</groupId>

                <artifactId>jetty-webapp</artifactId>

                <version>9.4.34.v20201102</version>

                <exclusions>

                    <exclusion>

                        <groupId>javax.servlet</groupId>

                        <artifactId>servlet-api</artifactId>

                    </exclusion>

                </exclusions>

            </dependency>

            <dependency>

                <groupId>org.eclipse.jetty</groupId>

                <artifactId>jetty-util</artifactId>

                <version>9.4.34.v20201102</version>

            </dependency>

            <dependency>

                <groupId>org.eclipse.jetty</groupId>

                <artifactId>jetty-io</artifactId>

                <version>9.4.34.v20201102</version>

            </dependency>

            <dependency>

                <groupId>org.eclipse.jetty</groupId>

                <artifactId>jetty-jndi</artifactId>

                <version>9.4.34.v20201102</version>

            </dependency>

            <dependency>

            </dependency>

            <dependency>

            </dependency>

            <dependency>

            </dependency>

            <scope>compile</scope>

            <scope>compile</scope>

            <scope>compile</scope>

            <scope>compile</scope>

            <scope>compile</scope>

            <scope>compile</scope>

            <scope>compile</scope>

            <scope>compile</scope>

            <scope>compile</scope>

            <scope>compile</scope>

            <scope>compile</scope>