NOTA: durante la configuración, los comandos introducidos corresponden al terminal expresados con el carácter del dólar ($).

Transcripción

1 Software El software necesario se detalla a continuación. Si bien la versión indicada puede no llegar a ser la última, se recomienda respetarla, ya que las pruebas realizadas funcionan correctamente bajo éstas. Ubuntu v11.10 Java SE Runtime Environment v7 Apache Tomcat v7.0 MySQL v Eclipse Indigo IDE for Java EE Developers v3.7.2 MySQL Workbench v (opcional) Esta configuración dista en algunos aspectos de la utilizada en las aulas de prácticas. Sin embargo, es perfectamente válida para el uso docente que se hace de ella. NOTA: durante la configuración, los comandos introducidos corresponden al terminal expresados con el carácter del dólar ($). Instalación Ubuntu v11.10 Para instalar el sistema operativo no es necesario realizar ajustes importantes. Eso sí, se recomienda la siguiente configuración de directorios para un espacio en disco de 8 GB (para un disco de mayor capacidad, la configuración sería proporcional): / (3 GB) /tmp (1 GB) /home (1 GB) /usr (2 GB) swap (1 GB) NOTA: se recomienda no marcar la casilla Instalar ese software de terceros. Además, el usuario creado es isg3. Una vez finalizada la instalación y, puesto que el resto de instalaciones y configuraciones las realizaremos sobre el usuario root, se procede a activarlo: $ sudo passwd root [sudo] password for isg3: Introduzca la nueva contraseña de UNIX:

2 Vuelva a escribir la nueva contraseña de UNIX: passwd: contraseña actualizada correctamente Una vez activado el usuario, todos los comandos ejecutados serán con este usuario. Para cambiar al usuario root: $ su - Contraseña: Para asegurarnos de que el sistema operativo está actualizado, ejecutamos los siguientes comandos: $ apt-get upgrade $ updatedb Java SE Runtime Environment v7 Ante todo es necesario descargar el archivo desde Seleccionaremos la JRE de Java SE 7u3 (ésta es la última versión en el momento de creación de este manual) y lo descargaremos en el directorio de descarga. El fichero que hay que descargar dependerá de la arquitectura de la máquina, pero es importante descargar el tar.gz. Tras esto, abriremos un terminal y ejecutaremos los siguientes comandos: $ cd /home/isg3/descargas $ tar -xvf jre-7u3-linux-i586.tar.gz $ mkdir /usr/lib/jvm $ mv jre1.7.0_03 /usr/lib/jvm/ $ chown -R root:root /usr/lib/jvm/jre1.7.0_03 Ahora queda indicarle al sistema operativo que ahí tiene la máquina virtual de Java: $ update-alternatives --install /usr/bin/java java /usr/lib/jvm/jre1.7.0_03/bin/java 1 $ update-alternatives --config java Solo hay una alternative en el grupo de enlaces java: /usr/lib/jvm/jre1.7.0_03/bin/java

3 $ java -version java version 1.7.0_03 Java(TM) SE Runtime Environment (build 1.7.0_03-b04) Java HotSpot(TM) Client VM (build 22.1-b02, mixed mode) NOTA: si el utilizar el comando update-alternatives --config java aparecen varias opciones, hay que seleccionar la que hemos instalado. Apache Tomcat v7.0 Para realizar la instalación de Tomcat no es necesario descargar ningún fichero, ya que está en los repositorios oficiales de Ubuntu: $ apt-get install tomcat7 Desea continuar [S/n]? S Para evitar que Eclipse entre en conflicto con Tomcat cuando lo despliegue, ejecutaremos el siguiente commando: $ /etc/init.d/tomcat7 stop MySQL v Este software también está disponible en los repositorios oficiales: $ apt-get install mysql-server Desea continuar [S/n]? S Durante la instalación el sistema preguntará por la contraseña del usuario root de MySQL. Esta contraseña será la utilizada para la conexión a la base de datos. En este manual, la contraseña utilizada es practica. Eclipse Indigo IDE for Java EE Developers v3.7.2 Ante todo es necesario descargar el archivo desde Seleccionaremos la descarga Eclipse IDE for Java EE Developers y lo descargaremos en el directorio de descarga.

4 El fichero que hay que descargar dependerá de la arquitectura de la máquina, pero es importante descargar el tar.gz. NOTA: también existe Eclipse en los repositorios oficiales, pero éste no corresponde a la versión J2EE. Tras esto, abriremos un terminal y ejecutaremos los siguientes comandos: $ cd /home/isg3/descargas $ tar -xvf eclipse-jee-indigo-sr2-linux-gtk.tar.gz $ mv eclipse.. $ chown -R isg3:isg3 eclipse MySQL Workbench v Ante todo es necesario descargar el archivo desde Seleccionaremos la plataforma Ubuntu Linux y lo descargaremos en el directorio de descarga. El fichero que hay que descargar dependerá de la arquitectura de la máquina y de la versión del sistema operativo. En este caso es Ubuntu Linux ver Esta vez buscaremos el fichero en el directorio de descarga y lo ejecutaremos haciendo doble click para instalarlo. USVirtual Ajustes iniciales Para el correcto despliegue de la aplicación web es necesario configurar algunos aspectos de la máquina virtual de Java y del Tomcat. Para ello, ejecutaremos los siguientes comandos en el terminal: $ apt-get install libsvn-java Desea continuar [S/n]? S Después hay que añadir la siguiente línea al fichero eclipse.ini dentro de la carpeta eclipse ubicada en la Carpeta personal.

5 -Djava.library.path=/usr/lib/jni Esta línea hay que añadirla tras la línea -vmargs. Así estableceremos en el arranque de Eclipse dónde están ubicadas las librerías de conexión a los repositorios de Subversion. De nuevo por la línea de comandos: $ cd /usr/share/tomcat7 $ ln -s /var/lib/tomcat7/conf conf $ ln -s /etc/tomcat7/policy.d/03catalina.policy conf/catalina.policy $ ln -s /var/log/tomcat7 log $ chmod +r conf/* Así estableceremos la configuración correcta para añadir el servidor Tomcat en Eclipse. Subversion Lo primero que necesitamos es instalar el plugin Subclipse. Para ello nos vamos al Market desde el menú Help Eclipse Marketplace... Tomcat Lo siguiente es indicar en qué servidor web desplegaremos la aplicación, por lo que crearemos un proyecto de tipo Server Server.

6 En la siguiente ventana seleccionaremos el servidor Apache Tomcat v7.0 Server. Después hay que indicar que nuestro servidor está instalado en /usr/share/tomcat7, tal y como se muestra en la imagen. Luego, pulsamos sobre Finish y ahora tendremos el servidor Tomcat en nuestro espacio de trabajo. Eclipse Una vez creado en el espacio de trabajo el servidor, vamos a recuperar la URL de descarga del proyecto, por lo que debemos dirigirnos a la página web de la asignatura. En la sección de enlaces aparece USVirtual en google code.

7 Ese enlace nos llevará al repositorio del proyecto, donde deberemos seleccionar la pestaña Source y luego Checkout. En la URL que aparece dentro del contenido de esta pestaña, sólo nos interesa usvirtual.googlecode.com/svn/trunk/, por lo que deberemos anotarla para utilizarla posteriormente. Ahora necesitamos crear un proyecto de tipo SVN Checkout Projects from SVN. Es en este momento donde deberemos indicar la anterior URL para crear una nueva localización de repositorio. En la siguiente ventana seleccionamos el proyecto isg3-usvirtual y en la siguiente nos aseguramos de que hemos marcado la opción Check out as a project configure using the New Project Wizard. Una vez que le demos a Finish, nos aparecerá la ventana de creación de nuevo proyecto. Seleccionamos Web Dynamic Web Project y le damos un nombre al proyecto (en este manual se ha usado el nombre USVirtual). También deberemos indicar en Target runtime que queremos Apache Tomcat v7.0. En este momento, también tendremos un proyecto web en el espacio de trabajo de Eclipse.

8 Después de realizar esta configuración, aún existen errores en el proyecto web, pero no son verdaderos errores, sino más bien errores de Eclipse que no afectan al despliegue del proyecto. MySQL Para que la aplicación funcione correctamente, necesitamos crear la base de datos junto con las tablas necesarias para el proyecto web. Para ello, haremos uso de los ficheros dbconfiguration.properties y creacionbds.sql del proyecto web que están ubicados en Java Resources src.

9 Abrimos un terminal y ejecutamos los siguientes comandos: $ mysql -u root p Enter password: mysql> create database usvirtual; Query OK, 1 row affected (0.07 sec) mysql> exit Bye $ mysql usvirtual -u root -p < /home/isg3/workspace/usvirtual/src/creacionbds.sql Enter password: Hay que prestar especial atención a que en el fichero dbconfiguration.properties el valor para la clave password sea la contraseña de root que hemos indicado en la instalación de MySQL. Despliegue Para el despliegue, pulsamos sobre el botón derecho del proyecto web en Eclipse y seleccionamos Run As Run on Server. Seleccionamos el único servidor que tenemos instalado y marcamos la casilla Always use this server when running this project. En Eclipse aparecerá una pestaña con un navegador incrustado:

10 Si abrimos un navegador y escribimos la dirección también aparecerá la página web inicial del proyecto web. NOTA: el usuario y contraseña de acceso es practica (sin las comillas).