La versión oficial de Kaleido viene en un archivo de extension dmg la cual es utilizada en MacOS X para archivos comprimidos o instaladores sencillos, desafortunadamente no hay una utilidad sencilla para abrir estos archivos en Ubuntu, pero afortunadamente encontre una herramienta que permite convertir estos archivos en imagenes iso las cuales si se pueden "montar" en Ubuntu.

Descargar la version para mac de Kaleido :

• Ir a la pagina de descarga
  http://kaleido.media.mit.edu/download
• Descargar desde linea de comando
  wget http://kaleido.media.mit.edu/sites/kaleido.media.mit.edu/tub/kaleido_001.dmg

Para convertir el archivo dmg a iso utilize el DGMExtravtor disponible en http://hem.bredband.net/catacombae/dmgx.html el cual esta escrito y puede instalarse via Java Web Start, luego se selecciona el archivo y se genera el archivo iso.

Para montar la imagen se realizaron los siguientes pasos :

• Abrir una consola
• Ir al directorio donde esta el archivo iso
  cd directorio
• Crear un directorio donde se montara la imagen
  mkdir kaleidomac
• Montar la imagen
  mount -o loop -t hfsplus kaleido_001.iso

Se descargo la version de Processing para Linux :

• Descargar Processing para Linux
  http://processing.org/download
• Descomprimir

Se copiaron los directorios de Kaliedo con las librerias y el theme a la carpeta de Processing y con esto se construyo la distribucion para Linux.

Para descargar la version no oficial 0.0.1 de Kaleido para Linuxvaya a :
http://code.google.com/p/mprocessinglibs/downloads/list

Problemas :

• Al momento de ejecutar el sketch creado con la version para Linux se congela la pantalla de Ubuntu aunque es posible conectarse al equipo remotamene para apagarlo.
• Al momento de arrastar y soltar los componentes graficos se lanza la excepcion :
  Exception in thread "AWT-EventQueue-0" java.lang.NullPointerException
  at processing.app.graph.kGraph.getDropTarget(kGraph.java:172)

Instalacion OpenJDK :

• Abra una consola
• Actualice la lista de paquetes
  sudo apt-get update
• Instalar el OpenJDK
  sudo apt-get install openjdk-6-jdk

Instalaciones Paquetes de Oracle (su-java6-jdk) :

• Abra una consola
• Adicionar el repositorio de Partners
  sudo add-apt-repository “deb http://archive.canonical.com/ubuntu lucid partner”
• Actualice la lista de paquetes
  sudo apt-get update
• Instalar el JDK
  sudo apt-get install sun-java6-jdk

Pasos :

• Abrir una terminal o conectarse remotamente como administradores del servidor
• Instalar el Java (es importante instalar la distribucion Java de Sun Microsystems para evitar conflictos)
  sudo apt-get install sun-java6-jdk
• Descargar el Glassfish version 2.1 para Linux
  https://glassfish.dev.java.net/downloads/v2.1-b60e.html
• Descargar utilizando wget
  cd /tmp
  wget http://download.java.net/javaee5/v2.1_branch/promoted/Linux/glassfish-installer-v2.1-b60e-linux.jar
• Crear el usuario bajo el cual se ejecutara el Glassfish, en este caso el usuario se llama glassfish
  sudo adduser --system glassfish
• Instalar el Glassfish
  sudo -u glassfish java -Xmx256M -jar glassfish-installer-v2.1-b60e-linux.jar
• Aceptar la licencia
• Mover el glassfish al directorio de opt u otro directorio donde se quiere tener la instalacion
  sudo mv glassfish /opt
• Cambiar los permisos del directorio para poder entrar sin ser superusuario
  sudo chgrp -R admin /opt/glassfish/
• Ir al directorio de Glassfish
cd /opt/glassfish/
• Volver ejecutables los scripts de ANT
  sudo chmod -R +x lib/ant/bin/
• Ejecutar la configuracion
  sudo -u glassfish lib/ant/bin/ant -f setup.xml
• Iniciar un dominio
  sudo -u glassfish bin/asadmin start-domain domain1
  (esto puede tomar algun tiempo)
• Abrir un navegador y cargar la pagina :

  http://<servidor>:4848

• Debe cargar el administrador del Glassfish
• Para acceder, utilice el usuario admin y la clave adminadmin
• Para cambiar la clave :
  vaya a Application Server
  pestaña Administrator Password

Creacion de los Scripts para el inicio automatico del Glassfish cuando se enciende la maquina :

• Crear con un editor el siguiente script, por ejemplo :
  sudo vi /etc/init.d/glassfish
• Digitar el siguiente contenido :

  #! /bin/sh
  
  GLASSFISHPATH=/opt/glassfish/bin
  
  case "$1" in
  	start)
  		echo "starting glassfish from $GLASSFISHPATH"
  		sudo -u glassfish $GLASSFISHPATH/asadmin start-domain domain1
  	;;
  	restart)
  		$0 stop
  		$0 start
  	;;
  	stop)
  		echo "stopping glassfish from $GLASSFISHPATH"
  		sudo -u glassfish $GLASSFISHPATH/asadmin stop-domain domain1
  	;;
  	*)
  		echo $"usage: $0 {start|stop|restart}"
  		exit 3
  	;;
  esac

• Darle permisos de ejecucion al script
  sudo chmod a+x /etc/init.d/glassfish
• Pruebe el script deteniendo el servicio
  sudo /etc/init.d/glassfish stop
• Reinicie el servicio y compruebe que todo funcione
  sudo /etc/init.d/glassfish start
• Cree los scripts para el inicio automatico del Glassfish
  sudo update-rc.d glassfish defaults 90 10
• Ahora el servidor inicia y se detiene junto con la maquina

Esta guia esta basada en su totalidad de la guia en ingles de Installing Glassfish 2 on Ubuntu en TuxTrainig, que me salvo la vida el dia de hoy !!!

Enlaces :

• Installing Glassfish 2 on Ubuntu
  http://tuxtraining.com/2008/11/14/installing-glassfish-2-on-ubuntu-710
• Pagina Oficial del Desarrollo de Glassfish
  https://glassfish.dev.java.net/
• Sun GlassFish Enterprise Server
  http://www.sun.com/software/products/appsrvr/

De estos Servidores de Aplicacion para J2EE, existen de todos los tamaños, sabores y colores; pero el soportado oficialmente por Sun Microsystem se llama Glassfish el cual viene en una version comercial llamada el Sun GlassFish Enterprise Server y en una version de codigo abierto llamada simplemente Glassfish, la cual posee dos licencias la CDDL y el GPL.

Asi que Glassfish es el servidor de aplicaciones para Java en su version J2EE, que permite la creacion de aplicaciones empresariales con componentes web, transaccionales y de persistencia.

Enlaces :

• Pagina Oficial del Desarrollo de Glassfish
  https://glassfish.dev.java.net/
• Sun GlassFish Enterprise Server
  http://www.sun.com/software/products/appsrvr/

Para competir en esta maraton se deben tener encuenta varios requisitos :

1. Ser estudiante universitario
2. Tener una carga académica de medio tiempo o mas.
   
3. Haber comenzado la carrera por lo menos en los 3 años anteriores
   (estudiantes de 1 a 6 semestre)
   
4. Tener menos de 23 años al momento de la realización de la maratón
   
5. No haber participado mas de cinco veces en la maratón
   
6. Solo se puede participar por una institucion durante el año
   
7. No haber pariticipado en dos maratones mundiales

Para participar se deben crear equipos de tres estudiantes que cumplan los requisitos anteriores, cada equipo tiene un entrenador (Coach) que es el encargado de la inscripcion de los estudiantes en el sistema de registro de la Maraton de ACM y es el representante del grupo ante la organizacion. El Coach generalmente es un docente de la universidad a la cual pertenecen los estudiantes y ademas de registrar los equipos, debe asegurarse que cumplen los requisitos para la participacion, acompañar al equipo en la prueba durante la cual el coach presentara su equipo completo para su registro, los acompañara durante el Calentamiento (Warm Up) y realizara los reclamos despues de finalizar la maraton si existen. Las universidades pueden registrar un maximo de tres equipos, los cuales pueden tener el mismo Coach y enviara a ACIS una carta en la que avala la participacion de los equipos, como tambien se compromete a pagar el costo de la inscripcion a la maraton antes de que esta se realice. Para la realizacion de la maraton la organizacion tiene varias sedes a nivel nacional, los equipos deben registrarse en la sede mas cercana geograficamente, tipicamente las sedes son : Bogota, Bucaramanga, Cali, Cartagena, Medellin y Manizales

El dia de la maraton el coach debe presentarse con su equipo a las 8am para su registro, la entrega de identificaciones y camisetas que el coach y los miembros del equipo deben traer durante el transcurso de la maraton. Despues del registro de todos los equipos se toma un refrigerio, para pasar al Warm Up durante el cual a los equipos se les asigna el puesto de trabajo donde previamente se han instalado los ambientes de desarrollo (C,C++,Java) y el cliente PC² software que permite probar las soluciones a los problemas, enviar las soluciones al sistema para ser evaluadas, realizar consultas al jurado durante la prueba. Durante el calentamiento se entregan dos problemas que los equipos deben resolver, para identificar problemas con las herramientas de desarrollo y probar el correcto funcionamiento del software para enviar las soluciones (durante este calentamiento el Coach puede estar presente), al final del calentamiento se pasa a un almuerzo ligero antes de la competencia.

La competencia generalmente comienza a la 1 de la tarde y tiene una duracion de 5 horas, se entregan los enunciados de los problemas los cuales describen el problema que debe ser solucionado, los nombres de los archivos que se deben crear, las entradas suministradas y las salidas (estos enunciados estan en Ingles, por lo cual es importante que los integrantes del equipo tengan buen conocimiento del idioma), cada equipo es responsable de dar solucion a los problemas utilizando los ambientes de desarrollo, libros, codigo impreso y hojas (es recomendable llevar diccionario ingles para los que no manejan el idioma). La estrategia de solucion de los problemas es responsabilidad de cada equipo (se recomienda antes de ir a la maraton realizar simulacros en las universidades).

A medida que los equipos van solucionando un problema, se envia el archivo fuente al PC²el cual evaluara la solucion, verificando el programa con casos de prueba y verificara que la solucion pueda ser compilada, no tenga errores de sintaxis, se ejecute en menos del tiempo exigido y arroje los resultados esperados, despues de esta evaluacion se puede consultar el sistema que indicara si fue satisfactorio o sucedio algun error, si es satisfactorio se colocara un globo del color asignado al problema sobre el computador que tiene asignado el equipo, de esta forma los otros equipos pueden saber quienes y que problemas se han solucionado. Adicionalmente existe una pagina web que puede ser vista por los equipos que reporta el estado de todos los equipos a nivel nacional, con el numero de intentos, el tiempo y los problemas que se han desarrollado. Faltando una hora para terminar la maraton, la pagina no se actualiza mas y se deben esperar los resultados finales, unos dias despues (por lo menos tres dias) para ver las posiciones finales de los equipos. Al finalizar la maraton los equipos pueden de nuevo hablar con el Coach y transmitirles las quejas que se tengan, las cuales deben ser reportadas por el Coach al Jurado Local.

Por cada sede se selecciona una representacion que participara en la maraton nacional la cual funciona de la misma manera y se va clasificando de esta manera hasta llegar a la mundial.

Notas :

• Los participantes no pueden comunicarse con equipos diferentes al suyo durante la competencia.
• El Coach debe registrar los equipos antes de la maraton, suministrado el nombre del equipo y los nombres y correos de los integrantes.
• El Coach no participa en el concurso, es el representante del grupo ante la organizacion.
• No se pueden ingresar telefonos moviles, memorias, dispositivos de almacenamiento o equipos electronicos cuando se desarrolla la maraton.
• Los equipos deben tratar de desarrollar programas que den soluciones a los enunciados de los problemas, de la manera mas rapida, teniendo en cuenta que el programa no se puede demorar mas de lo estipulado.
• Se puede trabajar en lenguaje C,C++ o Java

Mas adelante estaremos hablando de los tipos de problemas que se deben resolver en esta maraton.

Enlaces :

• ACIS : Maratones de Programacion
  http://www.acis.org.co/index.php?id=556
• The ACM-ICPC International Collegiate Programming Contest
  http://cm.baylor.edu/welcome.icpc
• PC²
  http://www.ecs.csus.edu/pc2/

soapUI de eviware es una herramienta que permite rapidamente a traves de una interface grafica, obtener informacion de los webservices, realizar llamados generando las peticiones para cada metodo del webservice y visualizando las respuestas enviadas por el servidor, permitiendo rapidamente identificar las operaciones asociadas con el webservice y permitiendo hacer pruebas rapidamente del funcionamiento de los webservices sin necesidad de recurrir a escribir codigo para crear clientes que consuman los webservices.

soapUI es una de las herramientas que todo desarrollador web debe tener en su arsenal y esta disponible en una version gratuita que puede ser descargada o ejecutada desde el sitio utilizando Java Web Start, para lo cual necesitamos instalar el JRE de Java o tambien una version Pro con caracteristicas avanzadas para aquellos desarrolladores que necesitan herramientas mas potentes. soapUI incluye en sus versiones actuales soporte para servicios web REST, pruebas funcionales y simulacion de webservices.

Para ilustrar su uso, lo utilizaremos para consumir el webservice de Calculadora creado en Java del cual se hablo en una entrada anterior del blog : Publicar Web Service en Java sin Servidor Web

Requisitos :

• Tener instalado Java

Pasos :

• Ir a la pagina oficial de soapUI
  http://www.soapui.org
• Buscar el boton WebStart Now ! o ir al siguiente enlace para ejecutar la version 2.5.1 :
  http://www.soapui.org/jnlp/2.5.1/soapui.jnlp
• Esto ejecuta el Java Web Start encargado de instalar la aplicacion en el computador
• Puede tardar algunos minutos, deacuerdo a la velocidad de acceso a Internet
• Ir al menu File y seleccionar la opcion New soapUI Project
• Suministrar la siguiente informacion :
  Project Name : Calculadora
  Initial WSDL/WADL : http://localhost:4444/CalculadoraService?wsdl
• Habilitar la opcion :
  Create sample request for all operations
• Pulsar el boton Ok
• En el navegador ir al item sumar y doble click
• Click en Request1
• Suministrar los valores de los argumentos a enviar a la suma
• Pulsar boton verde en la ventana del request para ejecutar el llamado
• La respuesta se visualiza en la otra parte de la ventana con el resultado de la suma

Enlaces :

• soapUI
  http://www.soapui.org

Para que los webservices funcionen es necesario instalar una version igual o superior a la 3.2.1 la cual instalamos en el anterior post (enlace), como tambien realizar un pequeño cambio en el sel codigo (enlace) Servidor donde se reemplaza la lectura de datos via RAW por una lectura de la entrada de datos php://input, quedando de la siguiente forma el archivo servicio.php

 
<?php
	require_once('nusoap.php');
	require_once('sumar.php');
 
	$server = new nusoap_server();
	$server->register('sumar');
 
	$HTTP_RAW_POST_DATA = file_get_contents("php://input");
	$server->service($HTTP_RAW_POST_DATA);
?>
 

De esta forma es posible ejecutar el servicio web encualquier plataforma o servidor que soporte Java.

Enlaces :

• Resin Application Server
  http://caucho.com/resin/doc
  
• Quercus : Implementacion Java del lenguaje PHP
  http://quercus.caucho.com
• Introduction to NuSOAP
  http://www.scottnichol.com/nusoapintro.htm

Ejecutar Servidor :

• Abrir una terminal
• Instalar Java
  sudo apt-get install sun-java6-jdk
• Descargar una version de Resin
  http://caucho.com/download
• En este caso descargaremos la version estable 3.2.1 en version GPL
  wget http://caucho.com/download/resin-3.2.1.zip
• Descomprimimos el archivo
  unzip resin-3.2.1
• Cambiamos de directorio
  cd resin-3.2.1
• Ejecutamos el servidor
  java -jar lib/resin.jar start
• Abrimo el navegador y cargamos la pagina :
  http://localhost:8080
• Debe mostrar la pagina por defecto del servidor con enlaces para la administración y documentación
  Si no es asi, verifique que no exista ningun servicio ejecutandose en el puerto 8080, como por ejemplo un servidor Tomcat

Crear Script en PHP :

• Creamos el directorio donde se alojara la el script PHP
  mkdir webapps/hola_php
• Vamos al directorio
  cd webapps/hola_php
• Creamos el archivo index.php con el siguiente contenido
  <?php echo "Hola Mundo" ?>
• Cargamos en el navegador la siguiente direccion :
  http://localhost:8080/hola_php
• Debe mostrarnos una pagina con el texto : Hola Mundo

Detener el Servidor :

• Ir al directorio raiz del Resin y ejecutar el comando :
  java -jar lib/resin.jar stop

Aunque no es una prueba completa del funcionamiento del soporte del lenguaje PHP en Resin, es el primer paso para comenzar a realizar mas pruebas con scripts mas complejos, frameworks y aplicaciones.

Enlaces :

• Resin Application Server
  http://caucho.com/resin/doc
  
• Quercus : Implementacion Java del lenguaje PHP
  http://quercus.caucho.com

Requisitos :

• Kit de Desarrollo de Java
  En este caso utilizaremos el Java Development Kit 6 update 13
• Para el ejemplo utilizaremos el Sistema Operativo Ubuntu 9.04

Generar Codigo para el Cliente en Java :

• Abrir una terminal
• Ejecutar el comando para generar el cliente del servicio web
  wsimport http://localhost:4444/CalculadoraService?wsdl
• Esto genera el paquete serviciosweb con las clases necesarias para llamar el web service

Utilizar el Cliente :

• Crear un archivo Cliente.java con el siguiente codigo :

 
package serviciosweb;
 
public class Cliente
{
        public static void main(String[] args)
        {
                CalculadoraService servicio = new CalculadoraService();
                Calculadora calculadora = servicio.getCalculadoraPort();
 
                System.out.println(calculadora.sumar(3,4));
        }
}
 

• Java utiliza una clase que representa el servicio completo y un Puerto que implementa los metodos del sevicio, por tal motivo se debe crear el servicio y obtener el puerto para poder consumir el servicio
• Compilar el cliente :
  javac -d . Cliente.java
• Ejecutar el Cliente
  java Cliente

Enlaces :

• Creating a Simple Web Service and Client with JAX-WS
  http://java.sun.com/webservices/docs/2.0/tutorial/doc/JAXWS3.html#wp115211

La mayoria de las veces los webservices los implementamos sobre aplicaciones web por lo que se hace necesario tener un servidor como Tomcat o GlassFish para ejecutar la aplicacion web y adicionalmente publicar los servicios web, pero algunas veces solo necesitamos publicar el servicio web para realizar pruebas sin la necesidad un servidor web completo. Esto es ahora posible utilizando un Endpoint que se encarga de publicar el servicio web en una direccion especifica, la cual atiende los llamados al servicio, como tambien genera el WSDL el cual describe el servicio.

A continuación crearemos un servicio web llamado Calculadora el cual posee un metodo llamado sumar que recibe dos numero y retorna la suma de ellos.

Requisitos :

• Kit de Desarrollo de Java
  En este caso utilizaremos el Java Development Kit 6 update 13
• Para el ejemplo utilizaremos el Sistema Operativo Ubuntu 9.04

Implementar el WebService en Java :

• Abrir una terminal
• Crear un archivo llamado Calculadora.java con el siguiente código :

 
package serviciosweb;
 
import javax.jws.WebMethod;
import javax.jws.WebService;
 
@WebService
public class Calculadora
{
        @WebMethod
        public int sumar(int x, int y)
        {
                return x + y;
        }
}
 

• Es necesario suministrar el nombre de paquete el cual sera utilizado como namespace en el webservice.
• Se utilizan anotaciones para especificar que la clase es un webservice y el metodo sumar esta incluido en el webservice.

Crear el Publicador del WebService :

• Crear un archivo llamado Publicador.java con el siguiente código :

 
package serviciosweb;
 
import javax.xml.ws.Endpoint;
 
public class Publicador
{
        public static void main(String[] args)
        {
                Calculadora calculadora = new Calculadora();
                Endpoint endpoint = Endpoint.create(calculadora);
                endpoint.publish("http://localhost:4444/CalculadoraService");
        }
}
 

• Este crea un Endpoint el cual crea un servidor web pequeño que recibe las peticiones hechas al webservice
• Se debe especificar la ruta en la cual queremos publicar el webservice en forma de direccion web, por ejemplo : http://localhost:4444/CalculadoraService

Compilar el WebService :

• Compilar el codigo fuente del servicio web :
  javac -d . Calculadora.java
• Compilar el publicador :
  javac -d . Publicador.java
• Generar los archivos asociados con las anotaciones y el webservice
  apt Calculadora.java

Publicar el Servicio Web :

• Ejecutar el Publicador del webservice
  java serviciosweb.Publicador
• Visualizar el WSDL generado para el servicio (utilizar la url donde se publico el servicio)

  http://localhost:4444/CalculadoraService?wsdl

Con esto ya tenemos publicado nuestro servicio web, sin necesidad de tener un servidor web como Tomcat o Glassfish, lo que permite realizar pruebas de una forma rapida.

Enlaces :

• JAX-WS Web Services Without Java EE Containers
  http://today.java.net/pub/a/today/2007/07/03/jax-ws-web-services-without-ee-containers.html