03. manualinstacionlinux openfwpa 20111230 v1 - … · documento manual de instalación en linux...
Post on 31-Aug-2018
216 Views
Preview:
TRANSCRIPT
openFWPA Internacional
openFWPA
Manual de Instalación en Linux (ManualInstacionLinux_openFWPA_20111230_v1.0)
Proyecto OpenFWPA Internacional
openFWPA
Página 2 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_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..........................................................................................................................................7
2.2.2.1. Integración de MantisBT con Eclipse............................................................................15 2.2.3. Maven2..................................................................................................................................26
2.2.3.1. Instalación de Maven2 ...................................................................................................26 2.2.3.2. Integración de Maven2 con Eclipse ...............................................................................27 2.2.3.3. Configurar el fichero settings.xml de Maven.................................................................35
2.2.4. MySQL..................................................................................................................................36 2.2.5. Tomcat ..................................................................................................................................36
2.2.5.1. Instalación de Tomcat ....................................................................................................36 2.2.5.2. Modificar el puerto por defecto de Tomcat (8080)........................................................41 2.2.5.3. Instalación de un certificado de seguridad para Tomcat 7.............................................42 2.2.5.4. Integración de Tomcat con Eclipse................................................................................42 2.2.5.5. Conector de MySQL en Tomcat ....................................................................................46
2.2.6. Configuración inicial de openFWPA....................................................................................46 2.2.6.1. Descarga de openFWPA ................................................................................................46 2.2.6.2. Importación de openFWPA en el Eclipse ......................................................................47
Proyecto OpenFWPA Internacional
openFWPA
Página 3 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
1. Control del documento
1.1. Información general
Título Manual de Instalación en Linux
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
1.0 Definitivo 30/12/2011
Proyecto OpenFWPA Internacional
openFWPA
Página 4 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_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 Linux. Se recomienda trabajar con la siguiente estructura de directorios por ejemplo dentro del home del usuario 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 5 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_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 Linux x86.
Proyecto OpenFWPA Internacional
openFWPA
Página 6 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
2 Selección de la versión para nuestro sistema operativo
Una vez finalizada la descarga, accederemos a la carpeta donde se ha descargado el fichero, y le añadimos permisos para que se pueda ejecutar. Ejecutaremos el instalador. Si por ejemplo hemos accedido mediante un terminar, ejecutaríamos el siguiente comando: chmod +x jdk-6u27-linux-i586.bin
A continuación ejecutaremos el comando: ./jdk-6u27-linux-i586.bin
Se generará una carpeta “jdk1.6.0_27” que moveremos a la carpeta “/url/local/” con el comando: mv jdk1.6.0_27/ /url/local/
Ahora entraremos en “/home/<usuario>/desarrollo/java/install”, y crearemos un enlace simbólico desde “/usr/local/jdk1.6.0_27” llamado “jdk1.6.0_27”: ln -s /usr/local/jdk1.6.0_27/ jdk1.6.0_27
Proyecto OpenFWPA Internacional
openFWPA
Página 7 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
Ahora vamos a crear configurar la variable de entorno JAVA_HOME al directorio donde acabamos de realizar la instalación, y a incluir la carpeta “bin” del JDK en el path de búsqueda. Para eso editaremos el fichero “/etc/bash.bashrc” y añadiremos al final del mismo las siguientes líneas. JAVA_HOME=/usr/local/jdk1.6.0_27 export JAVA_HOME PATH=$PATH:$JAVA_HOME/bin export PATH
Para verificar que la configuración se ha realizado correctamente, debemos ejecutar en una terminal el comando: java -version
Y se mostrará la siguiente información: java version "1.6.0_27" Java(TM) SE Runtime Environment (build 1.6.0_27-b07 ) Java HotSpot(TM) Client VM (build 20.2-b06, mixed m ode, sharing)
Si en lugar de mostrarse la versión que acabamos de configurar apareciera una versión anterior, tenemos que ejecutar: update-alternatives --install "/usr/bin/java" "java " "/usr/local/jdk1.6.0_27/jre/bin/java"
Ahora tenemos que seleccionar esta nueva versión. Para eso ejecutamos: update-alternatives --config java
Se mostrarán las opciones que tenemos disponibles, y tendremos que elegir el número que se corresponda con esta nueva versión. Si ahora ejecutamos el comando: java -version
Se mostrará la siguiente información: java version "1.6.0_27" Java(TM) SE Runtime Environment (build 1.6.0_27-b07 ) Java HotSpot(TM) Client VM (build 20.2-b06, mixed m ode, sharing)
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
Proyecto OpenFWPA Internacional
openFWPA
Página 8 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
entorno para Java EE Developers (este manual se ha elaborado sobre el Eclipse Indigo), tal y como podemos ver en la siguiente imagen.
3 Descarga del Eclipse
A continuación descomprimimos el contenido del fichero .zip que acabamos de descargar dentro de la carpeta “install” que se encuenta en “/home/<usuario>/desarrollo/java/install”, y después entramos en “/home/<usuario>/desarrollo/java/install/eclipse”. y hacemos doble clic sobre el archivo ejecutable “eclipse”. Seleccionamos como espacio de trabajo el directorio “/home/<usuario>/desarrollo/proyectos” y pulsamos en el botón “OK” (por defecto nos mostrará un workspace que tendremos que reemplazar por el que hemos definido anteriormente).
Proyecto OpenFWPA Internacional
openFWPA
Página 9 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
4 Introducir el 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”.
Proyecto OpenFWPA Internacional
openFWPA
Página 10 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
5 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. A continuación vamos a comentar los pasos a seguir en caso de que no estuviera seleccionado por defecto, como sucede en la siguiente imagen.
Proyecto OpenFWPA Internacional
openFWPA
Página 11 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
6 Configurar el JRE dentro del Eclipse
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.
Proyecto OpenFWPA Internacional
openFWPA
Página 12 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
7 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 13 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
8 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:
Proyecto OpenFWPA Internacional
openFWPA
Página 14 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
9 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 15 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
10 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 16 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_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”.
11 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 17 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
12 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/”.
Proyecto OpenFWPA Internacional
openFWPA
Página 18 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
13 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 19 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
14 Repositorio de Mylyn seleccionado
Finalmente, es necesario seleccionar la opción “Mylyn-Mantis connector”.
Proyecto OpenFWPA Internacional
openFWPA
Página 20 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
15 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 21 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
16 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”.
Proyecto OpenFWPA Internacional
openFWPA
Página 22 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
17 Aceptar términos de la licencia de uso
18 Proceso de instalación de los componentes seleccionados
Proyecto OpenFWPA Internacional
openFWPA
Página 23 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
Para completar el proceso de instalación, tendremos que reiniciar el Eclipse.
19 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 24 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
20 Selección de Vista Task Repositories
Dentro de la ventana Show View, desplegando la carpeta Mylyn, podremos seleccionar la vista Task Respositories.
21 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).
Proyecto OpenFWPA Internacional
openFWPA
Página 25 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
22 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.
23 Parámetros del repositorio de MantisBT
Proyecto OpenFWPA Internacional
openFWPA
Página 26 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_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”.
24 Configuración correcta
2.2.3. Maven2
2.2.3.1. Instalación de Maven2
En primer lugar tenemos que descargarnos el .tag.gz de Maven. http://www.apache.org/dyn/closer.cgi/maven/binaries/apache-maven-2.2.1-bin.tar.gz A continuación lo descomprimimos en “/home/<usuario>/desarrollo/java/install”, para seguir con el convenio que hemos definido anteriormente (pruebas realizadas con la versión 2.2.1 de Maven).
Proyecto OpenFWPA Internacional
openFWPA
Página 27 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
25 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, es decir, editaremos el fichero “/etc/bash.bashrc” y añadiremos al final del mismo las siguientes líneas. M2_HOME=/home/<usuario>/desarrollo/java/install/apa che-maven-2.2.1 export M2_HOME PATH=$PATH:$M2_HOME/bin export PATH
Para verificar que la configuración se ha realizado correctamente, debemos reiniciar el equipo, y después ejecutar en una terminal el comando: mvn -v
Y se mostrará la siguiente información (o similar): Apache Maven 2.2.1 (r801777; 2009-08-06 21:16:01+02 00) Java version: 1.6.0_27 Java home: /usr/local/jdk1.6.0_27/jre Default locale: es_ES, platform encoding: UTF-8 OS name: "linux" version: "2.6.32-5-686" arch: "i38 6" Family: "unix"
Es posible que la primera vez que ejecutemos este comando tarde un rato, porque cada vez aque ejecutamos 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/.
Proyecto OpenFWPA Internacional
openFWPA
Página 28 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
Para integrar este plugin en Eclipse iremos a la pestaña “Help”, y seleccionaremos la opción “Install
New Software”.
26 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 29 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
27 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”.
Proyecto OpenFWPA Internacional
openFWPA
Página 30 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
28 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 31 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
29 Repositorio de Maven seleccionado
En este caso hemos seleccionado las dos opciones posibles, únicamente sea obligatorio instalar el componente “m2e – Maven Integration for Eclipse”.
Proyecto OpenFWPA Internacional
openFWPA
Página 32 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
30 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 33 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
31 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”.
Proyecto OpenFWPA Internacional
openFWPA
Página 34 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
32 Aceptar términos de la licencia de uso
33 Proceso de instalación de los componentes seleccionados
Para completar el proceso de instalación, tendremos que reiniciar el Eclipse.
Proyecto OpenFWPA Internacional
openFWPA
Página 35 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
34 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, “/home/<usuario>/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>
settings.xml profile configuration <profiles>
Proyecto OpenFWPA Internacional
openFWPA
Página 36 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
<profile> <id>joinup</id> <repositories> <repository> <id>joinup-snapshots</id> <url>https://joinup.ec.europa.eu/ne xus/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/repo sitories/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
Para instalar MySQL debemos ejecutar en una terminar el siguiente comando: apt-get install mysql-server mysql-client
Una vez terminado el proceso de instalación, tenemos que asignar la clave de root, para lo que ehecutaremos: /usr/bin/mysqladmin -u root password nuestro_passwo rd
Ahora, para acceder a mysql basta con ejecutaremos mysql -u root -p
Introduciendo la clave que le asignamos previamente una vez que el sistema nos la solicite.
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 “/home/<usuario>/desarrollo/java/install”, para seguir con el convenio que hemos definido anteriormente.
Proyecto OpenFWPA Internacional
openFWPA
Página 37 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
35 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. CATALINA_HOME=/home/<usuario>/desarrollo/java/insta ll/apache-tomcat-7.0.23 export CATALINA_HOME PATH=$PATH:CATALINA_HOME/bin export PATH
Ahora vamos a comprobar que la instalación de Tomcat 7 ha sido correcta. Para ello accedemos al directorio donde se tenemos Tomcat 7 “/home/<usuario>/desarrollo/java/install\apache-tomcat-7.0.23”. Vamos a comentar brevemente que cada uno de los directorios disponibles en “apache-tomcat-7.0.23”.
• /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.sh = para iniciar o arrancar Tomcat • shutdown.sh = para parar o detener Tomcat
Proyecto OpenFWPA Internacional
openFWPA
Página 38 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
Para arrancar el servidor accederemos al directorio “/home/<usuario>/desarrollo/java/install\apache-tomcat-
7.0.23/bin” dentro de a través de una terminal, y ejecutaremos el fichero “startup.sh”. ./startup.sh
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.
36 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 “/home/<usuario>/desarrollo/java/install/apache-tomcat-7.0.2/conf”, y editaremos el fichero “tomcat-
users.xml”. Este archivo permite gestionar los roles y los usuarios de Tomcat. nano 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
Proyecto OpenFWPA Internacional
openFWPA
Página 39 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
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”. A continuación se muestra el contenido del fichero: <?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="manager-gui"/> <user username="tomcat" password="tomcat" roles=" manager-gui"/> </tomcat-users>
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.
37 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”.
Proyecto OpenFWPA Internacional
openFWPA
Página 40 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
38 Identificación de usuario en Tomcat 7
Tras identificarnos, accederemos al gestor de aplicaciones Web de Tomcat 7.
Proyecto OpenFWPA Internacional
openFWPA
Página 41 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
39 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 Manual de Configuración de openFWPA). Para cambiar el puerto por defecto del Tomcat, accederemos al fichero “server.xml” que se podemos encontrar en “/home/<usuario>/desarrollo/java/install/apache-tomcat-7.0.23\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.
Proyecto OpenFWPA Internacional
openFWPA
Página 42 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
2.2.5.3. Instalación de un certificado de seguridad para Tomcat 7
Ahora vamos a configurar el servidor Tomcat para habilitar en protocolo seguro https. A continuación vamos a generar el certificado. Para eso entraremos en la carpeta bin del JDK y ejecutar el comando “keytool -genkey -alias tomcat”, o bien ponemos la ruta completa en una terminal junto con la instrucción anterior, tal y como se muestra en el siguiente ejemplo. /home/<usuario>/desarrollo/java/install/jdk1.6.0_27 /bin/keytool -genkey -alias tomcat
Después de realizar esta instrucción, se creará en el directorio home del usuario un fichero llamado “.keystore”, que utilizaremos para configurar el fichero “sever.xml” del Tomcat. Para habilitar el protocolo seguro, editaremos el fichero “server.xml” del Tomcat, que podemos encontrar en “/home/desarrollo/java/install/apache-tomcat-7.0.23\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" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS"
keystoreFile="/home/cluster/.keystore" /> → suponemos que se ha introducido la contraseña por
defecto para entorno seguro "changeit". En caso contrario, tendríamos que añadir un nuevo atributo
“keystorePass” al conector para especificar la contraseña utilizada. • 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.
Ahora vamos a configurar el servidor Tomcat para habilitar en protocolo seguro https.
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”.
Proyecto OpenFWPA Internacional
openFWPA
Página 43 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
40 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 44 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
41 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 “/home/<usuario>/desarrollo/java/install/apache-tomcat-7.0.23”. Después pulsamos en el botón “Finish” que podemos encontrar en la parte inferior de la ventana.
Proyecto OpenFWPA Internacional
openFWPA
Página 45 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
42 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.
43 Servidor Tomcat disponible en Eclipse
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
Proyecto OpenFWPA Internacional
openFWPA
Página 46 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
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.1.18-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 “/home/<usuario>/desarrollo/java/proyectos” (esta debe ser la ruta de nuestro Workspace dentro del Eclipse). Pendientes de cambiar la dirección desde la que se habilite la descarga de openFWPA.
Proyecto OpenFWPA Internacional
openFWPA
Página 47 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_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”.
44 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”.
Proyecto OpenFWPA Internacional
openFWPA
Página 48 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
45 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 49 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
46 Buscar proyecto Maven para importarlo en el Eclipse
Después seleccionaremos nuestro Workspace “/home/<usuario>/desarrollo/java/proyectos” y pulsamos en la carpeta “Aceptar”. 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 50 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
47 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.
Proyecto OpenFWPA Internacional
openFWPA
Página 51 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
48 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”.
49 Añadir proyectos al servidor Tomcat desde Eclipse
Proyecto OpenFWPA Internacional
openFWPA
Página 52 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_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).
50 Seleccionar proyectos para integrar con el Tomcat
Tras seleccionar ambos proyectos, pulsaremos en el botón “Finish” para completar el proceso.
Proyecto OpenFWPA Internacional
openFWPA
Página 53 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
51 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.
52 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:
Proyecto OpenFWPA Internacional
openFWPA
Página 54 de 55
Estado Definitivo
Documento Manual de Instalación en Linux
Cluster TIC (www.clustertic.net) 03. ManualInstacionLinux_openFWPA_20111230_v1.0.docx 30/12/2011
• http://localhost:8082/appblank para la aplicación en blanco.
• http://localhost:8082/carrito para la aplicación de ejemplo.
Si por ejemplo tecleamos “http://localhost:8082/appblank”, se mostrará un formulario para identificarnos en la aplicación en blanco. Para acceder a la parte interna, podremos utilizar el usuario “admin” y la contraseña “admin”.
53 Formulario de validación para la aplicación en blanco
Tras identificación en la aplicación en blanco, si todo ha ido bien, se mostrará la página de inicio de la aplicación en blanco. Como podremos comprobar en la URL, se está utilizando el protocolo seguro https a través del puerto “8447” que hemos configurado previamente.
54 Página de inicio de la aplicación en blanco
Si por el contrario queremos acceder a la aplicación de ejemplo, tras teclear “http://localhost:8082/carrito”, se mostrará también un formulario de acceso, y en este caso introduciendo el usuario “cliente” y la contraseña “cliente” accederemos a la zona privada.
top related