Manual de Instalación en Windows

85  Download (0)

Full text

(1)

openFWPA Internacional

openFWPA

Manual de Instalación en Windows

(ManualInstacionWindows_openFWPA_20111230_v

(2)

Proyecto OpenFWPA Internacional openFWPA Página 2 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

ÍNDICE

1. Control del documento...3

1.1. Información general ...3

1.2. Histórico de revisiones...3

1.3. Estado del documento ...3

2. Entorno de desarrollo ...4

2.1. Estructura del puesto de desarrollo ...4

2.2. Herramientas de desarrollo ...4

2.2.1. Instalación del J2SDK...4

2.2.2. IDE ...22

2.2.2.1. Integración de MantisBT con Eclipse...29

2.2.3. Maven2...40

2.2.3.1. Instalación de Maven2 ...40

2.2.3.2. Integración de Maven2 con Eclipse ...44

2.2.3.3. Configurar el fichero settings.xml de Maven...52

2.2.4. MySQL...53

2.2.5. Tomcat ...57

2.2.5.1. Instalación de Tomcat ...57

2.2.5.2. Modificar el puerto por defecto de Tomcat (8080)...70

2.2.5.3. Instalación de un certificado de seguridad para Tomcat 7...70

2.2.5.4. Integración de Tomcat con Eclipse ...72

2.2.5.5. Conector de MySQL en Tomcat ...75

2.2.6. Configuración inicial de openFWPA...75

2.2.6.1. Descarga de openFWPA ...75

(3)

Proyecto OpenFWPA Internacional openFWPA Página 3 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

1.

Control del documento

1.1. Información general

Título Manual de Instalación en Windows

Creado por: Jorge Méndez Rodríguez

A revisar por: Consultores Senior: Juan José Parada Vales e Ignacio Álvarez Valdeón

A aprobar por: Jefe de Proyecto: Joaquín Fernández Juárez

1.2. Histórico de revisiones

Versión Fecha Autor Observaciones

1.0 30/12/2011 Jorge Méndez Rodríguez

1.3. Estado del documento

Versión Estado Fecha

(4)

Proyecto OpenFWPA Internacional openFWPA Página 4 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

2.

Entorno de desarrollo

2.1. Estructura del puesto de desarrollo

Suponemos que el desarrollo de las aplicaciones sobre el openFWPA se realiza sobre un entorno Windows. Se recomienda trabajar con la siguiente estructura de directorios por ejemplo dentro de la unidad C: para seguir un convenio.

• desarrollo

◦ java

▪ install → En este directorio se almacenarán todos los componentes externos que sean necesarios para el desarrollo de aplicaciones J2EE sobre openFWPA, como por ejemplo Eclipse, JDK, ...

▪ proyectos → Será nuestro espacio de trabajo dentro del Eclipse.

2.2. Herramientas de desarrollo 2.2.1. Instalación del J2SDK

A continuación se detallará como realizar la instalación del Java SE Development Kit 6. Puedes descargar la versión 1.6 en este enlace:

http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u27-oth-JPR

A continuación se mostrarán los distintos sistemas operativos para los que está disponible esta versión, tal y como podemos ver en la siguiente imagen.

(5)

Proyecto OpenFWPA Internacional openFWPA Página 5 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

1 Listado de versiones disponibles para los distintos sistemas operativos

Tras aceptar la licencia de uso, seleccionaremos la versión correspondiente, que en este caso es para el sistema operativo Windows x86.

(6)

Proyecto OpenFWPA Internacional openFWPA Página 6 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

2 Selección de la versión para nuestro sistema operativo

(7)

Proyecto OpenFWPA Internacional openFWPA Página 7 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

3 Pantalla de bienvenida del instalador

Tras pulsar el botón “Next” disponible en la parte inferior, se mostrará una nueva ventana donde tendremos que especificar el directorio donde queremos que se realice la instalación. Como podemos ver en la siguiente imagen, por defecto nos proponen una ruta que no se corresponde con el convenio que hemos definido anteriormente. Para cambiarla, tendremos que pulsar en el botón “Change” para introducir la nueva ruta.

(8)

Proyecto OpenFWPA Internacional openFWPA Página 8 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

4 Ruta de instalación por defecto para el J2SDK

Tras pulsar en “Change”, escribiremos la nueva ruta, que en este caso será “C:\desarrollo\java\install\jdk1.6.0_27”, y pulsaremos en el botón “OK”.

(9)

Proyecto OpenFWPA Internacional openFWPA Página 9 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

5 Introducir la nueva ruta para el J2SDK

A continuación podemos comprobar que se ha cambiado la ruta de instalación del J2SDK, y pulsaremos en el enlace “Next” para continuar con el proceso de instalación.

(10)

Proyecto OpenFWPA Internacional openFWPA Página 10 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

(11)

Proyecto OpenFWPA Internacional openFWPA Página 11 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

7 Instalación del J2SDK

Una vez finalizado el proceso de instalación del J2SDK, tendremos que seguir los mismos pasos detallados anteriormente para instalar ahora el JRE (Java Runtime Environment).

Tal y como hicimos anteriormente, pulsaremos en el botón “Change” para cambiar la ruta por defecto de la instalación, e introducir la que hemos definido para seguir el convenio.

(12)

Proyecto OpenFWPA Internacional openFWPA Página 12 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

8 Ruta de instalación por defecto para el JRE

A continuación introduciremos la nueva ruta “C:\desarrollo\java\install\jre6” donde se instalará el JRE.

(13)

Proyecto OpenFWPA Internacional openFWPA Página 13 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

9 Introducir la nueva ruta para el JRE

Una vez cambiada la ruta, pulsaremos en el enlace “Next” para continuar con la instalación.

(14)

Proyecto OpenFWPA Internacional openFWPA Página 14 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

11 Instalación del JRE

Como podemos ver en la siguiente imagen, tras finalizar la instalación del JRE, se ha completado el proceso de instalación.

(15)

Proyecto OpenFWPA Internacional openFWPA Página 15 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

12 Instalación finalizada correctamente

Una vez terminado el proceso de instalación, debemos configurar la variable de entorno JAVA_HOME al directorio donde acabamos de realizar la instalación.

(16)

Proyecto OpenFWPA Internacional openFWPA Página 16 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

Suponiendo que estamos trabajando con un entorno Windows como ya comentamos, debemos de ir a “Mi PC”, pulsar sobre el botón derecho, y seleccionar “Propiedades”.

A continuación se mostrará la pestaña “General” de las propiedades del sistema, tal y como podemos ver en la siguiente imagen.

14 Propiedades del sistema

(17)

Proyecto OpenFWPA Internacional openFWPA Página 17 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

15 Opciones avanzadas

En la parte inferior de esta pestaña “Opciones avanzadas”, pulsaremos en el botón “Variables de entorno”. Para añadir una nueva variable de entorno, pulsaremos en el botón “Nueva” dentro de las variables del sistema.

(18)

Proyecto OpenFWPA Internacional openFWPA Página 18 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

16 Variables de entorno

Establecemos la variable de entorno JAVA_HOME al directorio donde se ha instalado el J2SDK “C:\desarrollo\java\install\jdk1.6.0_27”, tal y como podemos ver en la siguiente imagen.

(19)

Proyecto OpenFWPA Internacional openFWPA Página 19 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

17 Añadir la variable de entorno JAVA_HOME

A continuación añadiremos el directorio “bin” del JDK en el path de búsqueda. Para ello buscamos la variable de entorno llamada “Path”, la seleccionamos y pulsamos en modificar.

(20)

Proyecto OpenFWPA Internacional openFWPA Página 20 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

18 Editar variable de entorno Path para añadir el bin del JDK

Nos ponemos al final del valor de la variable, y añadimos “;%JAVA_HOME%\bin” (utilizamos la variable JAVA_HOME creada anteriormente para especificar la ruta del JDK, y añadimos un punto y coma delante para separarlo del resto de los path).

(21)

Proyecto OpenFWPA Internacional openFWPA Página 21 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

19 Añadimos a la variable de entorno Path el bin del JDK

Tras finalizar este proceso, tendremos el JDK configurado correctamente. Para comprobar que todo este proceso ha sido correcto, iremos a inicio → Ejecutar y teclearemos el comando “cmd”.

(22)

Proyecto OpenFWPA Internacional openFWPA Página 22 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

21 Teclear el comando cmd

Se abrirá una consola, en la que tras escribir “java -version”, se mostrará en pantalla la versión de java que acabamos de configurar.

22 Versión de java

2.2.2. IDE

El IDE seleccionado para el desarrollo de aplicaciones J2EE sobre openFWPA es Eclipse. Para descargarse esta herramienta, accederemos a http://www.eclipse.org/downloads/ y seleccionaremos el entorno para Java EE Developers (este manual se ha elaborado sobre el Eclipse Indigo), tal y como podemos ver en la siguiente imagen.

(23)

Proyecto OpenFWPA Internacional openFWPA Página 23 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

23 Descarga del Eclipse

A continuación descomprimimos el contenido del fichero .zip que acabamos de descargar dentro de la carpeta “install” que se encuentra en “C:\desarrollo\java\install”, y después entramos en “C:\desarrollo\java\install\eclipse” y ejecutamos “eclipse.exe”. Seleccionamos como espacio de trabajo el directorio “C:\desarrollo\java\proyectos” y pulsamos en el botón “OK” (por defecto nos mostrará un workspace que tendremos que reemplazar por el que hemos definido anteriormente).

24 Introducir Workspace para el Eclipse

Una vez arrancado Eclipse, procedemos a configurar el J2SDK dentro del Eclipse. Para ello, tenemos que ir a la configuración del Eclipse en “Window->Preferences”.

(24)

Proyecto OpenFWPA Internacional openFWPA Página 24 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

25 Preferencias de Eclipse

Seleccionamos la opción Installed JREs, que como podemos ver en la siguiente imagen, está dentro del apartado “Java”. Esta parte puede resultar confusa, pero dentro de este apartado tenemos que seleccionar el JDK que instalamos previamente, no el JRE que aparece seleccionado por defecto.

(25)

Proyecto OpenFWPA Internacional openFWPA Página 25 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

26 Configurar el JRE dentro del Eclipse

Para ello pulsaremos en el botón “Add” que está disponible en la parte derecha de la imagen anterior. Seleccionamos el tipo “Standar VM” que nos viene marcada por defecto, y pulsamos en el botón “Next” que está disponible en la parte inferior.

(26)

Proyecto OpenFWPA Internacional openFWPA Página 26 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

27 Configurar el JRE dentro del Eclipse

Después configuramos el J2SDK que hemos instalado anteriormente dentro de los apartados “JRE home” y el “JRE name”, tal y como podemos ver en la siguiente imagen, y finalmente pulsar en el botón “Finish” disponible en la parte inferior.

(27)

Proyecto OpenFWPA Internacional openFWPA Página 27 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

28 Configurar el JRE dentro del Eclipse

A continuación, tenemos que seleccionar la versión que acabamos de configurar, tal y como se puede ver en la imagen siguiente:

(28)

Proyecto OpenFWPA Internacional openFWPA Página 28 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

29 Configurar el JRE dentro del Eclipse

Para terminar con este proceso de configuración, tenemos que verificar que el Eclipse va a utilizar la versión correcta del JDK para compilar nuestro código. Para eso, pulsamos en la opción “Compiler”, que al igual que la opción “Installed JRE”, se encuentra en las preferencias del Eclipse dentro de la opción “Java”, y verificamos que está seleccionada la versión 1.6 (el JDK 1.6 es el mismo que el JDK 6.0), tal y como se muestra en la siguiente imagen.

(29)

Proyecto OpenFWPA Internacional openFWPA Página 29 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

30 Verificar la versión del compilador JDK

2.2.2.1. Integración de MantisBT con Eclipse

En este apartado vamos a integrar MantisBT con Eclipse para agilizar el proceso de administración y notificación de las incidencias.

(30)

Proyecto OpenFWPA Internacional openFWPA Página 30 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

En este caso, utilizaremos un conector de Eclipse llamado “Mylyn-Mantis Repository Connector”. Si desea obtener más información sobre este componente puede acceder a

http://sourceforge.net/apps/mediawiki/mylyn-mantis/index.php?title=Mylyn-Mantis_Repository_Connector.

Para integrar este conector en Eclipse iremos a la pestaña “Help”, y seleccionaremos la opción “Install New Software”.

31 Instalar nuevo plugin en Eclipse

A continuación añadiremos el repositorio desde el que podemos descargarnos el conector de Mylyn. Para eso pulsaremos en el botón “Add” que tendremos disponible en la parte derecha de la ventana.

(31)

Proyecto OpenFWPA Internacional openFWPA Página 31 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

32 Añadir nuevo repositorio al Eclipse

Para añadir el repositorio del conector, pondremos un nombre con el que podamos identificarlo posteriormente, por ejemplo Mylyn-Mantis Connector, e introduciremos la dirección del repositorio “http://mylyn-mantis.sourceforge.net/eclipse/update/”.

(32)

Proyecto OpenFWPA Internacional openFWPA Página 32 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

33 Añadir el repositorio de Mylyn al Eclipse

Tras añadir el repositorio de Mylyn, Eclipse conectará con la dirección introducida en el apartado anterior, y mostrará las opciones disponibles para que seleccionemos los componentes que deseamos instalar en el Eclipse.

(33)

Proyecto OpenFWPA Internacional openFWPA Página 33 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

34 Repositorio de Mylyn seleccionado

(34)

Proyecto OpenFWPA Internacional openFWPA Página 34 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

35 Selección de los componentes a instalar

Tras pulsar en el botón “Next” situado en la parte inferior de la ventana, se mostrarán los componentes que hemos seleccionado en el paso anterior para que podamos confirmar que la selección realizada ha sido correcta, en cuyo caso volveremos a pulsar en el botón “Next” para continuar.

(35)

Proyecto OpenFWPA Internacional openFWPA Página 35 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

36 Confirmar los componentes a instalar en el Eclipse

Antes de comenzar con la instalación de los componentes seleccionados, tendremos que aceptar la licencia de uso, y pulsar en el botón “Finish”.

(36)

Proyecto OpenFWPA Internacional openFWPA Página 36 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

37 Aceptar términos de la licencia de uso

(37)

Proyecto OpenFWPA Internacional openFWPA Página 37 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

Para completar el proceso de instalación, tendremos que reiniciar el Eclipse.

39 Reiniciar el Eclipse para completar el proceso de instalación

Finalmente es necesario realizar el enlace entre Eclipse y la instancia de MantisBT. En primer lugar es necesario configurar el repositorio Mantis. Para ello es necesario utilizar la vista Task Repositories. Si esta vista no aparece en la perspectiva, es posible añadirla a través de Window Show view Others.

(38)

Proyecto OpenFWPA Internacional openFWPA Página 38 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

40 Selección de Vista Task Repositories

Dentro de la ventana Show View, desplegando la carpeta Mylyn, podremos seleccionar la vista Task Respositories.

41 Vista Task Repositories

Una vez dentro de esta vista, con el botón derecho del ratón, se presenta la opción Add Repository, la cual permitirá seleccionar el tipo de repositorio a añadir (en este caso, MantisBT).

(39)

Proyecto OpenFWPA Internacional openFWPA Página 39 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

42 Añadir Task Repository

Una vez seleccionado el tipo de repositorio, es necesario introducir los datos del repositorio de Mantis (url del servidor de integración de Mantis, un nombre para el repositorio, el usuario del propietario del puesto de trabajo y su clave). Es recomendable marcar la opción “Save password” para no tener que hacerlo cada vez que se abra el Eclipse.

(40)

Proyecto OpenFWPA Internacional openFWPA Página 40 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

Para comprobar que los datos introducidos son correctos, bastará con intentar crear una nueva tarea en el repositorio recién instalado. Si todo está correcto, al intentar crear la tarea solicitará la selección del proyecto al que asignar la tarea, debiendo aparecer el proyecto “Soporte openFWPA”.

44 Configuración correcta

2.2.3. Maven2

2.2.3.1. Instalación de Maven2

En primer lugar tenemos que descargarnos el zip de Maven

http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-2.2.1-bin.zip

y descomprimirlo en “C:\desarrollo\java\install”, para seguir con el convenio que hemos definido anteriormente (pruebas realizadas con la versión 2.2.1 de Maven).

(41)

Proyecto OpenFWPA Internacional openFWPA Página 41 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

45 Descargar la versión 2.2.1 de Maven

Al igual que sucedió con el directorio bin del JDK, tendremos que añadir el directorio bin de Maven en el path de búsqueda. Para eso repetimos los pasos realizados en anteriormente, accediendo a inicio, y pulsando con el botón derecho sobre “Mi PC”, seleccionando las propiedades.

(42)

Proyecto OpenFWPA Internacional openFWPA Página 42 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

Después seleccionaremos la pestaña “Opciones avanzadas”, y pulsamos en el botón “Variables de entorno” que está disponible en la parte inferior.

47 Variables de entorno

Ahora vamos a añadir el directorio bin de Maven en el path de búsqueda. Para ello buscamos la variable de entorno llamada “Path”, la seleccionamos y pulsamos en modificar.

(43)

Proyecto OpenFWPA Internacional openFWPA Página 43 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

48 Editar variable Path para añadir el bin de Maven

Como hicimos anteriormente, nos ponemos al final del valor de la variable (detrás de la ruta que añadimos previamente para el bin del JDK), y añadimos “;C:\desarrollo\java\install\apache-maven-2.2.1\bin”.

(44)

Proyecto OpenFWPA Internacional openFWPA Página 44 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

49 Añadir a la variable Path el bin de Maven

Tras finalizar este proceso, tendremos Maven configurado correctamente. Para comprobar que todo este proceso ha sido correcto, al igual que hicimos con el JD, iremos a inicio → Ejecutar y teclearemos el comando “cmd”.

Se abrirá una consola, en la que tras escribir “maven --version”, se mostrará en pantalla la versión de java que acabamos de configurar.

50 Comprobar la versión de Maven

Es posible que la primera vez que ejecutemos este comando tarde un tiempo un rato, porque cada vez que ejecutemos un comando nuevo de Maven, se bajará cosas de Internet.

2.2.3.2. Integración de Maven2 con Eclipse

En este apartado vamos a integrar Maven con Eclipse para agilizar el proceso de desarrollo J2EE sobre openFWPA.

En este caso, utilizaremos un plugin de Eclipse llamado “m2eclipse”. Si deseas obtener más información sobre este componente puedes acceder a http://eclipse.org/m2e/.

Para integrar este plugin en Eclipse iremos a la pestaña “Help”, y seleccionaremos la opción “Install New Software”.

(45)

Proyecto OpenFWPA Internacional openFWPA Página 45 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

51 Instalar nuevo plugin en Eclipse

A continuación añadiremos el repositorio desde el que podemos descargarnos el plugin de Maven. Para eso pulsaremos en el botón “Add” que tendremos disponible en la parte derecha de la ventana.

(46)

Proyecto OpenFWPA Internacional openFWPA Página 46 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

52 Añadir nuevo repositorio al Eclipse

Para añadir el repositorio de Maven, pondremos un nombre con el que podamos identificarlo posteriormente, por ejemplo Maven2, e introduciremos la dirección del repositorio “http://download.eclipse.org/technology/m2e/releases”.

(47)

Proyecto OpenFWPA Internacional openFWPA Página 47 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

53 Añadir el repositorio de Maven al Eclipse

Tras añadir el repositorio de Maven, el Eclipse conectará con la dirección introducida en el apartado anterior, y mostrará las opciones disponibles para que seleccionemos los componentes que deseamos instalar en el Eclipse.

(48)

Proyecto OpenFWPA Internacional openFWPA Página 48 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

54 Repositorio de Maven seleccionado

En este caso hemos seleccionado las dos opciones posibles, únicamente sea obligatorio instalar el componente “m2e – Maven Integration for Eclipse”.

(49)

Proyecto OpenFWPA Internacional openFWPA Página 49 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

55 Selección de los componentes a instalar

Tras pulsar en el botón “Next” situado en la parte inferior de la ventana, se mostrarán los componentes que hemos seleccionado en el paso anterior para que podamos confirmar que la selección realizada ha sido correcta, en cuyo caso volveremos a pulsar en el botón “Next” para continuar.

(50)

Proyecto OpenFWPA Internacional openFWPA Página 50 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

56 Confirmar los componentes a instalar en el Eclipse

Antes de comenzar con la instalación de los componentes seleccionados, tendremos que aceptar la licencia de uso, y pulsar en el botón “Finish”.

(51)

Proyecto OpenFWPA Internacional openFWPA Página 51 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

57 Aceptar términos de la licencia de uso

58 Proceso de instalación de los componentes seleccionados

(52)

Proyecto OpenFWPA Internacional openFWPA Página 52 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

59 Reiniciar el Eclipse para completar el proceso de instalación

2.2.3.3. Configurar el fichero settings.xml de Maven

Antes de terminar con esta sección, debemos tener en cuenta que hay que actualizar el fichero setting.xml que tenemos en el directorio conf de Maven “C:\desarrollo\java\install\apache-maven-2.2.1\conf” y en el directorio “.m2” que se encuentra en el “home” de nuestro usuario.

Los datos de configuración que se deben añadir al fichero settings.xml para conectarse al nexus de la forja son los siguientes:

settings.xml server configuration

<servers> <server> <id>joinup-releases</id> <username>joinup_username</username> <password>joinup_password</password> </server> <server> <id>joinup-snapshots</id> <username>joinup_username</username> <password>joinup_password</password> </server> </servers>

(53)

Proyecto OpenFWPA Internacional openFWPA Página 53 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011 settings.xml profile configuration

<profiles> <profile> <id>joinup</id> <repositories> <repository> <id>joinup-snapshots</id> <url>https://joinup.ec.europa.eu/nexus/content/repositories/snapshots/</url> <releases> <enabled>false</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> <repository> <id>joinup-releases</id> <url>https://joinup.ec.europa.eu/nexus/content/repositories/releases/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> </profile> </profiles> <activeProfiles> <activeProfile>joinup</activeProfile> </activeProfiles> 2.2.4. MySQL

En primer lugar tenemos que descargar MySQL Server (http://dev.mysql.com/downloads/mysql). Nosotros hemos realizado las pruebas con la versión 5.5.18 de MySQL Server.

(54)

Proyecto OpenFWPA Internacional openFWPA Página 54 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

60 Descarga de MySQL Server 5.5.18

A continuación ejecutaremos el instalable de MySQL que acabamos de descargar para comenzar el proceso de instalación.

(55)

Proyecto OpenFWPA Internacional openFWPA Página 55 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

61 Comienzo del proceso de instalación de MySQL

Tendremos que aceptar los términos de uso de la licencia, y pulsar en el botón “Next” que estará disponible en la parte inferior de la ventana para continuar con el proceso de instalación.

(56)

Proyecto OpenFWPA Internacional openFWPA Página 56 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

62 Aceptar términos de uso de la licencia de MySQL

Tras finalizar el proceso de instalación, tendremos disponible en nuestro entorno un servidor de bases de datos MySQL.

(57)

Proyecto OpenFWPA Internacional openFWPA Página 57 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

63 Proceso de instalación de MySQL Server

A modo informativo, aquellos desarrolladores que no estén habituados a trabajar con MySQL desde la línea de comandos podrían instalar los componentes “MySQL Admin” y “MySQL Query Browser”.

2.2.5. Tomcat

2.2.5.1. Instalación de Tomcat

Tras descargar Tomcat 7 (http://tomcat.apache.org/download-70.cgi), lo descomprimiremos en “C:\desarrollo\java\install”, para seguir con el convenio que hemos definido anteriormente.

(58)

Proyecto OpenFWPA Internacional openFWPA Página 58 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

64 Descargar Tomcat 7

Una vez terminado el proceso de instalación, debemos configurar la variable de entorno CATALINA_HOME al directorio donde acabamos de realizar la instalación.

(59)

Proyecto OpenFWPA Internacional openFWPA Página 59 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

Suponiendo que estamos trabajando con un entorno Windows, debemos de ir a “Mi PC”, pulsar sobre el botón derecho, y seleccionar “Propiedades”.

65 Propiedades de Mi PC para configurar variable CATALINA_HOME

Tras pulsar en la pestaña propiedades, se mostrarán las propiedades del sistema, tal y como podemos ver en la siguiente imagen.

(60)

Proyecto OpenFWPA Internacional openFWPA Página 60 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

66 Propiedades del sistema

(61)

Proyecto OpenFWPA Internacional openFWPA Página 61 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

67 Opciones avanzadas

En la parte inferior de la pestaña de “Opciones avanzadas”, pulsaremos en el botón “Variables de entorno”. Para añadir una nueva variable de entorno, pulsaremos en el botón “Nueva” dentro de las variables del sistema.

(62)

Proyecto OpenFWPA Internacional openFWPA Página 62 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

68 Variables de entorno

Establecemos la variable de entorno CATALINA_HOME al directorio donde se ha descomprimido el Tomcat 7 “C:\desarrollo\java\install\apache-tomcat-7.0.22”, tal y como podemos ver en la siguiente imagen.

(63)

Proyecto OpenFWPA Internacional openFWPA Página 63 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

69 Añadir la variable de entorno CATALINA_HOME

Ahora vamos a añadir el directorio bin del Tomcat en el path de búsqueda. Para ello buscamos la variable de entorno llamada “Path”, la seleccionamos y pulsamos en modificar.

(64)

Proyecto OpenFWPA Internacional openFWPA Página 64 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

70 Editar variable de entorno Path para añadir el bin del JDK

Nos ponemos al final del valor de la variable, y añadimos “;%CATALINA_HOME%\bin” (utilizamos la variable CATALINA_HOME creada anteriormente, y añadimos un punto y coma delante para separarlo del resto de los path), tal y como hemos hecho anteriormente con otras variables de entorno.

(65)

Proyecto OpenFWPA Internacional openFWPA Página 65 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

71 Añadimos a la variable de entorno Path el bin del Tomcat 7

Ahora vamos a comprobar que la instalación de Tomcat 7 ha sido correcta. Para ello accedemos al directorio donde se tenemos Tomcat 7 “C:\desarrollo\java\install\apache-tomcat-7.0.22”. Tal y como podemos ver a continuación, encontraremos una serie de directorios.

(66)

Proyecto OpenFWPA Internacional openFWPA Página 66 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

Vamos a comentar brevemente que cada uno de los directorios mostrados en la imagen anterior.

• /bin → en este directorio estarán los scripts de arranque y parada del servidor, además de otros scripts y ejecutables.

• /lib → en este directorio estarán las librerías .jar necesarias para el funcionamiento de Tomcat.

• /temp → en este directorio estarán se almacenarán los archivos temporales.

• /conf → en este directorio estarán los archivos XML y los DTD correspondientes para la configuración de servidor.

• /logs → en este directorio estarán los archivos de registro (log) de Tomcat.

• /webapps → en este directorio estarán las aplicaciones Web.

• /work → este directorio se utilizará para el almacenamiento temporal de ficheros y directorios. Dentro del directorio “bin” existen dos archivos fundamentales, los cuales nos permitirán iniciar y parar el servidor Tomcat.

startup.bat = para iniciar o arrancar Tomcat

shutdown.bat = para parar o detener Tomcat

Para arrancar el servidor accederemos al directorio “bin”, y haremos doble clic sobre el fichero “startup.bat”.

Seguidamente abrimos un navegador web y escribimos en el URL “http://{host}:{port}” donde “{host}:{port}” representa el dominio y el puerto donde corre Tomcat. Por tanto, la dirección quedaría “http://localhost:8080” y aparecerá la página de bienvenida de Apache Tomcat.

(67)

Proyecto OpenFWPA Internacional openFWPA Página 67 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

73 Página de bienvenida de Apache Tomcat

Para acceder a las aplicaciones de gestión y administración de Tomcat, es necesario crear un usuario con determinados permisos para Tomcat. Para eso, accederemos al directorio “C:\desarrollo\java\install\apache-tomcat-7.0.22\conf”, y editaremos el fichero “tomcat-users.xml”. Este archivo permite gestionar los roles y los usuarios de Tomcat.

(68)

Proyecto OpenFWPA Internacional openFWPA Página 68 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

74 Fichero tomcat-users.xml

A diferencia de las versiones anteriores donde el administrador debía tener el rol “manager”, en Tomcat 7 debe tener asignado el rol “manager-gui” para gestionar la parte de administración Web Tomcat 7. A modo informativo, existen otros tres nuevos roles incluidos en Tomcat 7, como son “manager-script”, “manager-jmx” y “manager-status”.

Para verificar que todo funciona, nosotros crearemos dentro del fichero “tomcat-users.xml” un usuario con el rol “manager-gui”, como podemos ver en la siguiente imagen.

75 Nuevo usuario en el fichero tomcat-users.xml

Tras añadir el nuevo usuario al fichero, debemos reiniciar el Tomcat. Después pulsaremos en el botón “Manager App” disponible en la parte derecha de la pantalla, tal y como podemos ver en la siguiente imagen.

(69)

Proyecto OpenFWPA Internacional openFWPA Página 69 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

76 Sección Manager App

Aparecerá una ventana emergente en la tendremos que introducir el usuario y la contraseña que previamente hemos introducido en el fichero “tomcat-users.xml”.

77 Identificación de usuario en Tomcat 7

(70)

Proyecto OpenFWPA Internacional openFWPA Página 70 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

78 Gestor de aplicaciones Web de Tomcat

2.2.5.2. Modificar el puerto por defecto de Tomcat (8080)

En este apartado vamos a comentar los pasos que se deben seguir para modificar los puertos por defecto del Tomcat, y adaptarlos a la configuración por defecto de openFWPA.

Tomcat utiliza por defecto el puerto “8080” para protocolo no seguro, sin embargo openFWPA tiene configurado el puerto “8082”. De todas formas, hay que tener en cuenta que se podría modificar el puerto configurado en openFWPA para trabajar con cualquier otro puerto (ver documento de configuración para el despliegue de las aplicaciones).

Para cambiar el puerto por defecto del Tomcat, accederemos al fichero “server.xml” que se podemos encontrar en “C:\desarrollo\java\install\apache-tomcat-7.0.22\conf”. En dicho fichero, tendremos que reemplazar todas las apariciones del puerto “8080” por el nuevo puerto “8082” (tener en cuenta que hay varias apariciones del texto “8080” comentadas en el fichero, y esas no sería necesario modificarlas, aunque es recomendable para evitar posibles olvidos en el futuro).

Para comprobar que el cambio ha sido correcto, accedemos a “http://localhost:8082”, y al igual que sucedió anteriormente, veremos la página de bienvenida de Tomcat.

2.2.5.3. Instalación de un certificado de seguridad para Tomcat 7

(71)

Proyecto OpenFWPA Internacional openFWPA Página 71 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

En primer lugar tendremos que generar un certificado y una clave privada para Tomcat. Para esto utilizaremos una herramienta “open source” llamada “OpenSLL”, y que podemos descargar por ejemplo desde la siguiente dirección:

www.slproweb.com/download/Win32OpenSSL_Light-1_0_0e.exe

En caso de no tener instalado el componente Microsoft Visual C++ 2008 Redistributable (http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=29), tendrás que instalarlo

antes que openSLL.

Después de instalar openSLL, accedemos al directorio donde lo hayamos instalado, entramos en la carpeta “bin”, y ejecutamos el fichero “opensll.exe”. Se mostrará una consola que utilizaremos para generar tanto el certificado como la clave.

En primer lugar teclearemos “genrsa –des3 –out tomcatkey.pem 2048”. Esto creará en el directorio donde nos encontramos un fichero llamado “tomcatkey.pem” con la clave privada.

En segundo lugar crearemos el certificado. Para ello teclearemos 'req –new –x509 –key

tomcatkey.pem –out tomcatcert.pem –days 1095 -config “C:\Archivos de programa\OpenSSL-Win32\bin\openssl.cfg”', suponiendo que hemos instalado openSSL

ese directorio. Tras responder a las preguntas necesarias para crear el certificado, se creará el fichero “tomcatcert.pem”.

Ahora copiaremos los dos ficheros que acabamos de generar, y los llevaremos al directorio “C:\desarrollo\java\install\apache-tomcat-7.0.22\certificados” dentro de nuestro Tomcat.

Para habilitar el protocolo seguro, editaremos el fichero “server.xml” del Tomcat, que podemos encontrar en “C:\desarrollo\java\install\apache-tomcat-7.0.22\conf”, para realizar los siguientes ajustes:

Comentar la línea

<Connector connectionTimeout="20000" port="8082" protocol="HTTP/1.1" redirectPort="8447"/>

Añadir en su lugar

<Connector port="8082" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false"

redirectPort="8447" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" />

Añadir también

<Connector port="8447" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" disableUploadTimeout="true" acceptCount="100" scheme="https" secure="true" SSLEnabled="true"

(72)

Proyecto OpenFWPA Internacional openFWPA Página 72 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

SSLCertificateFile="${catalina.home}/certificados/tomcatcert.pem" SSLCertificateKeyFile="${catalina.home}/certificados/tomcatkey.pem"

SSLPassword="changeit" /> → donde "changeit" es la contraseña que hemos introducido previamente para generar el certificado.

Como podemos, openFWPA utiliza el puerto “8447” para el protocolo seguro. Sin embargo Tomcat trae configurado por defecto el “8443”. Por ese motivo, se recomienda revisar el fichero “server.xml” y reemplazar las apariciones de “8443” por “8447” para evitar problemas.

2.2.5.4. Integración de Tomcat con Eclipse

En este apartado se comentarán los pasos que debemos seguir para integrar el servidor Tomcat dentro del entorno de desarrollo Eclipse, de forma que desde este entorno se puedan tanto arrancar y parar el Tomcat, como realizar el despliegue de las aplicaciones J2EE en el servidor.

Abrimos por tanto el Eclipse, y vamos a la pestaña “Servers”. Después pulsamos con el botón derecho, y vamos a “New → Server”.

79 Nuevo servidor Tomcat dentro de Eclipse

Seleccionamos la versión del servidor Tomcat, que en este caso es la versión 7, y pulsamos en el botón “Next”, tal y como podemos ver en la siguiente imagen.

(73)

Proyecto OpenFWPA Internacional openFWPA Página 73 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

80 Seleccionar versión de Tomcat

A continuación especificaremos el directorio donde tenemos instalado el servidor Tomcat, que como podemos ver en la siguiente imagen es “C:\desarrollo\java\install\apache-tomcat-7.0.22”. Después pulsamos en el botón “Finish” que podemos encontrar en la parte inferior de la ventana.

(74)

Proyecto OpenFWPA Internacional openFWPA Página 74 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

81 Especificar el directorio de instalación del Tomcat 7

Tras finalizar el proceso, se creará dentro de la pestaña “Servers” un servidor Tomcat 7, que podemos gestionar desde nuestro Eclipse.

(75)

Proyecto OpenFWPA Internacional openFWPA Página 75 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

Como podemos ver en la imagen anterior, pulsando en el botón “Start the server”, se arrancará el Tomcat desde el Eclipse.

Para finalizar la integración de Tomcat con Eclipse, recordar que si hacemos doble clic sobre el servidor que acabamos de configurar dentro del eclipse, accederemos a un panel de configuración del servidor, donde podremos especificar si este servidor compartirá o no los recursos con el que ya habíamos configurado previamente.

A continuación se muestra una imagen de la opción que tendríamos que modificar para que ambos servidores compartieran la información (por defecto no lo hacen).

Configurar servidor Tomcat de Eclipse para compartir recursos con instalación Tomcat local

2.2.5.5. Conector de MySQL en Tomcat

openFWPA utiliza por defecto una base de datos MySQL. Por tanto, se ha de copiar el driver JDBC para MySQL (mysql-connector-java-5.0.8-bin.jar) en el directorio {CATALINA_HOME}/lib.

2.2.6. Configuración inicial de openFWPA 2.2.6.1. Descarga de openFWPA

El código fuente del openFWPA se puede descargar desde la forja joinup: https://joinup.ec.europa.eu/software/openfwpa/release/all

Tras descargar el openFWPA lo descomprimiremos dentro de la carpeta “C:\desarrollo\java\proyectos” (esta debe ser la ruta de nuestro Workspace dentro del Eclipse).

(76)

Proyecto OpenFWPA Internacional openFWPA Página 76 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011 2.2.6.2. Importación de openFWPA en el Eclipse

Para importar openFWPA en el Eclipse, hay que pulsar en “File” y seleccionar la opción “Import”.

83 Opción importar proyecto en el Eclipse

A continuación tendremos que seleccionar la carpeta “Maven”, y dentro de ésta, la opción para crear importar un proyecto de Maven que ya existe “Existing Maven Projects”.

(77)

Proyecto OpenFWPA Internacional openFWPA Página 77 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

84 Importar proyecto existente de Maven

En tercer lugar pulsaremos en el botón “Browse...” que podemos encontrar en la parte derecha para buscar el proyecto que queremos importar.

(78)

Proyecto OpenFWPA Internacional openFWPA Página 78 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

85 Buscar proyecto Maven para importarlo en el Eclipse

Después seleccionaremos nuestro Workspace “C:\desarrollo\java\proyectos” y pulsamos en la carpeta “Aceptar”.

(79)

Proyecto OpenFWPA Internacional openFWPA Página 79 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

86 Seleccionar la carpeta proyectos

Se mostrarán todos los proyectos Maven que tengamos disponibles en la carpeta seleccionada. Seleccionaremos todos los que dependan del openFWPA, como podemos ver en la siguiente imagen, y pulsamos en el botón “Finish” que podemos encontrar en la parte inferior de esta ventana.

(80)

Proyecto OpenFWPA Internacional openFWPA Página 80 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

87 Seleccionar todos los proyectos que dependen de openFWPA de la carpeta seleccionada

Tras importar el openFWPA en el Eclipse se mostrarán todos los subproyectos de openFWPA en la parte izquierda, tal y como podemos ver en la siguiente imagen.

(81)

Proyecto OpenFWPA Internacional openFWPA Página 81 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

88 Subproyectos de openFWPA en el Eclipse

Ahora que ya tenemos importado openFWPA dentro del Eclipse, vamos a integrarlos con el servidor Tomcat configurado en nuestro entorno de desarrollo. Para eso pulsaremos con el botón derecho sobre el servidor, y seleccionaremos la opción “Add and remove”.

(82)

Proyecto OpenFWPA Internacional openFWPA Página 82 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

Se mostrarán los proyectos que se podrán añadir al Tomcat, que serán dos, blankapp (aplicación en blanco) y sampleapp (aplicación de ejemplo con un carrito de la compra).

90 Seleccionar proyectos para integrar con el Tomcat

(83)

Proyecto OpenFWPA Internacional openFWPA Página 83 de 85 Estado Definitivo

Documento Manual de Instalación en Windows

Cluster TIC (www.clustertic.net) 02. ManualInstacionWindows_openFWPA_20111230_v1.0.docx 30/12/2011

91 Confirmar proyectos seleccionados

Finalmente, como podemos comprobar en la siguiente imagen, se han añadido los dos proyectos seleccionados al servidor Tomcat dentro de Eclipse.

92 Proyectos añadidos al Tomcat desde Eclipse

Tras arrancar nuevamente el Tomcat, podremos acceder tanto a la aplicación en blanco como a la aplicación de ejemplo, a través de las siguientes direcciones:

Figure

Updating...

References