Instalar Java+Eclipse+Tomcat en Ubuntu 8.04

Por fin uno de esos post que me gustan escribir. Hace mucho tiempo ya escribi un tutorial parecido, pero como los tiempos “cambian” y las cosas se hacen mas sencillas, he
decidido actualizarlo.

Este tutorial esta orientado a desarrolladores o a todo aquel que tenga ganas de instalar un entorno para empezar a programar en Java.

Actualmente java esta en los repositorios, eso significa que podemos instalar muchos paquetes relacionados, ejecutando un solo comando, mediante la consola y usando apt-get o synaptic.

P.ej para ver que paquetes podemos instalar relacionados con
Java, podriamos ejecutar:

$ apt-cache search java

Obtendriamos algo parecido a:

...
sun-java6-plugin - The Java(TM) Plug-in, Java SE 6
sun-java6-source - Sun Java(TM) Development Kit (JDK) 6 source files
sun-javadb-client - Java DB client
sun-javadb-common - Java DB common files
sun-javadb-core - Java DB core
sun-javadb-demo - Java DB demo
sun-javadb-doc - Java DB documentation
sun-javadb-javadoc - Java DB javadoc
sunwderby - Java(TM) DB
tightvnc-java - TightVNC java applet and command line program
....

es decir una lista con todos los paquetes instalables y una pequeña descripcion.

De esta manera, si quisieramos instalar Eclipse (un entorno de
desarrollo en Java), Tomcat (un contenedor de servlets y JSP que podemos
usar como un pequeño servidor web) y el JDK (Java development Kit)
que nos permite compilar nuestras clases en Java, bastaria con
ejecutar:

$ sudo apt-get install eclipse sun-java6-jdk tomcat5.5 tomcat5.5-webapps

¿Facil, no?

En este caso Tomcat se nos instala en los siguientes directorios:

/etc/tomcat5.5 , los ficheros de configuracion de tomcat
p.ej aqui esta server.xml donde podemos cambiar el puerto de arranque,
etc..

/usr/share/tomcat5.5, el directorio principal de tomcat
p.ej en la subcarpeta /bin estan los scripts que nos permiten iniciar
y parar tomcat de manera manual

y

/usr/share/tomcat5.5-webapps, las aplicaciones web desplegados en tomcat
o las aplicaciones de ejemplo que trae Tomcat.

Por cierto si quieres administrar tomcat de manera web, no te olvides
de instalar tambien:

$ sudo apt-get install tomcat5.5-admin

Podemos parar/arrancar tomcat como root ejecutando:

$ sudo /etc/init.d/tomcat5.5 start
* Starting Tomcat servlet engine tomcat5.5                           [ OK ]

y
$ sudo /etc/init.d/tomcat5.5 stop
* Stopping Tomcat servlet engine tomcat5.5                           [ OK ]

Pero esta no es la forma mas “idonea” para arrancar y parar el servidor.
en nuestro desarrollo diario usaremos eclipse y nos interesara parar/arrancar el servidor tomcat desde el propio eclipse, y para eso lo que usaremos entonces son los script “startup.sh” y “shutdown.sh” que se encuentran en la carpeta /bin

$ cd /usr/share/tomcat5.5/bin
./startup.sh
Para arrancar y

$ cd /usr/share/tomcat5.5/bin
./shutdown.sh

Para parar el servidor.

Si nos da algun error seguramente sea porque no esta definida
la variable JAVA_HOME, obtendriamos al intentar arrancar un mensaje parecido a este:

Neither the JAVA_HOME nor the JRE_HOME environment variable is defined
At least one of these environment variable is needed to run this program

La variable JAVA_HOME es una variable de entorno que el sistema
usa para conocer el JDK que queremos utilizar. P.ej en el caso de
que tuvieramos varios instalados.

Si has instalado el JDK como te comentaba al principio:

$ sudo apt-get install sun-java6-jdk

Entonces lo tendras instalado en el siguiente directorio:

/usr/lib/jvm/java-6-sun

que realmente es una ligadura y que apunta a

/usr/lib/jvm/java-6-sun-1.6.0.06

No nos importa. Lo que tenemos que hacer es crear una variable de la
forma:

JAVA_HOME=/usr/lib/jvm/java-6-sun

Que podemos guardar en nuestro profile.
Yo lo que suelo hacer es añadir esta cadena:

JAVA_HOME=/usr/lib/jvm/java-6-sun

Al principio del script catalina.sh

$ cd /usr/share/tomcat5.5/bin
$ gedit catalina.sh

y al comienzo del script añadimos ya la ruta a donde esta nuestro JDK:

JAVA_HOME=/usr/lib/jvm/java-6-sun

Y nos despreocupamos. Ahora si intentamos volver a arrancar:

$ ./startup.sh

root@soledad:/usr/share/tomcat5.5/bin# pwd
/usr/share/tomcat5.5/bin
root@soledad:/usr/share/tomcat5.5/bin# ./startup.sh
Using CATALINA_BASE:   /usr/share/tomcat5.5
Using CATALINA_HOME:   /usr/share/tomcat5.5
Using CATALINA_TMPDIR: /usr/share/tomcat5.5/temp
Using JRE_HOME:       /usr/lib/jvm/java-6-sun

Ya deberia poder arrancar tomcat. Puedes comprobarlo, abriendo Firefox
y escribiendo la siguiente direccion:

http://localhost:8180

Ojo, que el puerto podria ser diferente si has cambiado el valor del puerto en el fichero
“server.xml”, por lo general los valores de los puertos por defecto suelen ser 8080, 8081 o algun valor similar.

Si no hay ningun problema, Entonces ya, Deberias poder ver al “gatico”:

Aviso importante: Si estamos en Eclipse e intentamos arrancar Tomcat y nos da un error de que el “puerto esta ocupado”, seguramente ya tengamos Tomcat arrancado o ese puerto este pillado por otro proceso. Si se trata del primer caso, tendremos que parar Tomcat, puede ser
que lo hayamos arrancado previamente con /etc/init.d/tomcat5.5 start
y despues hayamos entrado en Eclipse, e intentado arrancarlo de nuevo.
Naturalmente nos dara error pues el proceso ya esta en pie.
Y si se trata del segundo caso, el unico remedio sera editar el fichero
“web.xml” y cambiar los puertos que usa Tomcat, para que no choque con
los del otro proceso que esta levantado.

Bien, hagamos un resumen en este punto.

Si has llegado hasta aqui, ya tenemos tomcat, eclipse y el JDK instalados.

Podriamos arrancar eclipse con:

$ ./eclipse &

o desde Aplicaciones > Programacion > Eclipse

Sin embargo la version de eclipse instalada, es muy “basica”, no lleva por ejemplo las “WebTools” instaladas. Si no desarrollas aplicaciones web, te dara igual.
Pero si desarrollas webapps o te interesa gestionar Tomcat (u algun otro
servidor como pueden ser Bea, Jboss, Geronimo, etc..) desde Eclipse, entonces tendras que instalar las Webtools (del proyecto WTP).

Desde Eclipse puedes hacerlo desde el gestor de actualizaciones.

Arranca Eclipse y ve a:

Help > Software Updates > Find and install…

Se abrira el asistente de actualizaciones de Software y podremos seleccionar
que plugins adicionales instalar.

Seleccionariamos el origen desde donde descargar las actualizaciones:

El servidor que nos pille mas cerca a nuestra region:

Despues seleccionariamos aquellos plugins que queremos instalar (en nuestro caso marcariamos WebTools):

Nos dara un error porque dependen de otros que no tenemos instalados. Pero en este caso, basta con pulsar el boton “Select Required”, asi se instalaran los plugins seleccionados y todos aquellos de los que dependan y tambien necesitemos instalar.

Pulsamos en continuar y ya comienza la descarga e instalacion de todo lo seleccionado en Eclipse:

Pero en este punto paro.
se me instalaron bien las WebTools, pero cuando intentaba crear un Proyecto web dinamico, me daba un error que me obligaba a cerrar Eclipse y me quedaba sin poder continuar.
Ya no se si es un bug de Eclipse o de Hardy Heron, asi que decidi instalar eclipse de otra forma. Bajandome la ultima version de Eclipse, eclipse europa, y no actualizando ni instalando eclipse desde los repositorios. Es decir:
nada de:

$ sudo apt-get install eclipse

La instalacion de eclipse descargandolo es igualmente sencilla.

Te vas al sitio web y descargas el .tar.gz con el contenido de la distribucion. En este caso yo me descargue la version J2EE que ya lleva incluidos por ejemplo las WebTools, asi que luego no es
necesario hacer luego la actualizacion.
Pero preferi comentar la primera opcion de como se hace una actualizacion, pues viene bien que la conozcais o la useis para instalar otros plugins que os puedan interesar: Modelado de bases de datos,
Interfaces graficas, XML/XSLT, etc…

bien, instalar este eclipse europa descargado es descomprimir el fichero .tar.gz en la carpeta
donde queramos y despues ejecutar, entrar en esa carpeta y ejecutar:

$ ./eclipse &

Asi y si no vuelve a haber problemas ^^, ya arranca el editor:

Eso si, antes y lo primero que te pide es un espacio de trabajo (workspace).
es un directorio donde ira dejando los proyectos que vayas creando.
Elige la ruta que te propone o la que quieras y continua.

Si al entrar en el entorno te sale un popup con el siguiente error:

Could not initialize the application's security component

sencillo, te sales del entorno. y creas el siguiente directorio:

/home/tu_usurio/.mozilla/eclipse

es decir, en tu directorio home te aseguras que exista la carpeta .mozilla/eclipse

la carpeta “eclipse” estara vacia, pero con eso ya evitas que te vuelva a salir este error.

Bien chicos!!! ya lo tenemos todo; eclipse, java, tomcat… vamos a programar…

Como lo que queremos es poder parar/arrancar Tomcat o incluso ponerlo
en modo debug cuando estemos depurando la aplicacion web, lo primero que tenemos que crear es una asociacion Eclipse-Servidor_web, para ello vamos a:

Window > Show View > Other…

y de la lista de Vistas que aparecen y que podemos usar, seleccionamos “Server” > “Servers”

Se abre una ventana nueva con una pestaña y el titulo “servidores“:

Esta precisamente es la vista de Eclipse que nos permite configurar
nuestros servidores web (podemos tener varios), y administrarlos: Pararlos, arrancarlos, desplegar aplicaciones en esos servidores (deploy), ponerlos en modo depuracion, etc..

Vamos a dar de alta, el servidor tomcat que tenemos instalado.

Haz clic derecho sobre un area vacia de la misma y selecciona del menu emergente:

New > Server

Se abre una ventana nueva donde debermos indicar el tipo de servidor
y la ruta donde se encuentra. Seleccionamos:

Tomcat 5.5
y como ruta del servidor: /usr/share/tomcat5.5

Continuamos y al aceptar, ya aparece el servidor en la vista de servidores.

Bien!! ya tenemos un servidor configurado, podemos probar a pararlo
y arrancarlo desde Eclipse. Click derecho sobre el y del menu emergente, seleccionamos “Start”:

En consola aparecen las trazas de arranque de Tomcat.

y si poner la URL en un navegador, deberias poder acceder.

Si haces doble click sobre el servidor podras ver sus propiedades
(y cambiarlas)

Bien, desde esta Vista, tambien podemos desplegar nuestras aplicaciones
web en el servidor, o activar el modo de depuracion.
No tenemos ninguna aplicacion desplegada en el servidor, vamos a crear
una. Si queremos paramos el servidor Tomcat:

Para crear una nueva aplicacion web, nos vamos a:

File > New > Other…

y luego seleccionamos:

Web > Dinamic Web Project

De nombre le damos p.ej TEST

y como servidor destino de la aplicacion web (target) seleccionamos Tomcat5.5:

Se crea la estructura basica de la aplicacion web, y ya aparece en la
vista del Navegador:

Aqui ya podriamos empezar a escribir las clases java y servlets, y añadir recursos como imagenes, flash, librerias .jar, escribir JSPs,etc.. creando la aplicacion web, todo esto queda fuera del objetivo
de este pequeño tutorial. Asi que solo vamos a escribir un sencillito JSP que muestre algo
en la pantalla. Vamos a el directorio WebContent y seleccionamos New > File > Other

creando un nuevo fichero al que le damos de nombre index.html

y como contenido podiamos poner algo como:

<HTML>
<B> Hola Ubuntu Life </B>
</HTML>

Ok,
vamos a empaquetar la aplicacion y desplegarla en el servidor Tomcat.
para ello volvemos a la vista de servers y del menu seleccionamos.

Add or remove Projects

Seleccionamos el proyecto TEST y lo añadimos al server

Si te fijas ahora del servidor, cuelga un elemento nuevo, indica
que esa aplicacion sera desplegada en el servidor.

Reiniciamos el servidor tomcat, y en la URL de firefox ponemos:

http://localhost:8180/TEST/

o Sustituyendo TEST, por el nombre que le hayas dado a tu aplicacion web.

Y voilá, aparece nuestro texto, el de nuestra aplicacion web dinamica:

Genial!! lo demas, si te gusta, ya es cosa tuya…

Hay una serie de Plugins, que nos pueden interesar, pertenecen al proyecto Amateras.

Y es que documentar nuestro codigo siempre es “MUY” importante…

Ya sea porque luego seran otras personas quienes lo mantengan, o porque luego pasados 2 meses ya ni nos acordaremos de lo que hicimos…

El primer plugin se llama AmaterasUML y nos permite de manera muy sencilla realizar los diagramas UML de nuestros desarrollos.

El otro plugin es AmaterasERD y nos permite diseñar el modelo entidad-relacion de la base de datos:

No los necesitas para programar, pero si te interesa documentar tus proyectos no son una mala opcion. Para instalarlos te los descargas desde la pagina web, y despues los descomprimes dentro de la carpeta /plugins donde tengas instalado Eclipse. Reinicias Eclipse y ya puedes acceder a ellos desde File > New.

Para los que esteis empezando, unos pocos recursos de Eclipse. Mis sitios preferidos son naturalmente el sitio oficial de Eclipse, en el encontraras mucha documentacion. Tambien visito Javahispano y Adictos al trabajo. Ultimamente los consulto menos, llevo mas de 10 años trabajando con Java, asi que mis “snippets” o esos trozos de codigo que uso habitualmente para practicamente hacer siempre lo mismo ya los tengo a buen recaudo en mi google gmail ^^

Ya aprovecho tambien y os paso la direccion de unos chicos que me escribieron por correo, han creado un foro nuevo de programadores y en ese sitio  podreis consultar muchas preguntas o plantear las vuestras. podreis acceder en la siguiente direccion:

http://www.picandocodigo.net/foro/

Bueno… “a programar”… nos queda pendiente lo de la base de datos, eso lo vemos otro dia.