Download Instalación y uso del entorno de pruebas

Instalación y uso del entorno de pruebas
Antonio García Domínguez
6 de diciembre de 2007
Índice
Índice
1
1.
2
Instalacion del entorno escogido
1.1.
Máquina virtual Java 6 o superior de Sun
1.2.
Contenedor de servlets: Apache Tomcat
. . . . . . . . . . . . . . . . . .
2
. . . . . . . . . . . . . . . . . . .
2
1.3.
Director del proceso de empaquetado y pruebas: Apache Ant 1.7.0
1.4.
Motor BPEL: ActiveBPEL 4.1 modicado . . . . . . . . . . . . . . . . . .
3
1.5.
Entorno de pruebas de unidad para BPEL: BPELUnit 1.0 modicado . . .
4
1.6.
Editor BPEL: NetBeans SOA v6.0
5
. . . .
. . . . . . . . . . . . . . . . . . . . . .
1
3
1.
Instalacion del entorno escogido
A nivel general, añadiremos
${HOME}/bin
a nuestro PATH, para situar en dicha ruta
los diversos guiones que nos van a ser de ayuda. Si usamos el shell
la siguiente línea a
${HOME}/.bashrc:
bash, basta con añadir
export PATH=${PATH}:~/bin
También necesitaremos los paquetes necesarios para compilar programas escritos en C
y C++, los paquetes de las
autotools
y las herramientas
cvs
y
patch.
He supuesto que el archivo de distribución con todo lo necesario ha sido descomprimido
a
/tmp.
Instalaremos a continuación las dependencias del proyecto, que a fecha de hoy (6/12/07)
son:
1.1. Máquina virtual Java 6 o superior de Sun
En teoría todo debería funcionar ya con el JRE 5, pero BPELUnit da fallos de espacios
de nombres de esa forma. Para instalar la máquina virtual Java, es mejor instalar el
paquete especíco de la distribución. Para Ubuntu, basta con:
sudo aptitude install sun-java6-jdk sun-java6-bin
Otras distribuciones seguirán un proceso similar. Hay que asegurarse de que las variables de entorno
JAVA_HOME
y
JDK_HOME
estén debidamente conguradas:
set | grep JAVA_HOME
set | grep JDK_HOME
Si en alguno de los casos no aparece nada, deberemos añadir la línea correspondiente
de estas dos (el valor variará si se usa una distribución distinta de Ubuntu):
export JAVA_HOME=/usr/lib/jvm/java-6-sun
export JDK_HOME=/usr/lib/jvm/java-6-sun
1.2. Contenedor de servlets: Apache Tomcat
En el caso de Tomcat, existen paquetes, pero recomiendo evitarlos: el de Ubuntu, por
ejemplo, no funciona bien con ActiveBPEL. Es mejor descargar la versión
Core
de la web
http://apache.rediris.es/tomcat/tomcat-5/v5.5.25/bin/apache-tomcat-5.
5.25.zip.
Descomprimiremos el ZIP al directorio ${HOME}/bin/tomcat5. Una vez hecho esto,
entraremos a su subdirectorio bin, y compilaremos la herramienta jsvc , con la que
ocial:
podremos iniciar o parar el servidor fácilmente:
2
tar xzf jsvc.tar.gz
cd jsvc-src
chmod +x configure
./configure && make
cp jsvc ..
Situaremos la ruta a Tomcat en la variable de entorno
línea a
${HOME}/.bashrc
si empleamos el shell
bash :
CATALINA_HOME, añadiendo esta
export CATALINA_HOME=~/bin/tomcat5
Copiaremos el guión
Tomcat5.sh
en
${HOME}/bin,
cuidando de cambiar
TOMCAT_USER
a nuestro nombre de usuario. Para levantar o echar abajo el servidor, bastará respectivamente con:
Tomcat5.sh start
Tomcat5.sh stop
Si deseamos comprobar si Tomcat efectivamente funciona, visitaremos la dirección
http://localhost:8080/.
Debería de aparecer la página de prueba de Tomcat.
1.3. Director del proceso de empaquetado y pruebas: Apache Ant 1.7.0
Este programa se ocupará de gestionar la ejecución de varios conjuntos de pruebas y
el empaquetado de los procesos en cheros BPR, usando cheros Ant. Sigue la misma
losofía que el conocido GNU Make.
En Ubuntu basta con instalar el paquete
ant. Otras distribuciones seguirán un proceso
similar.
1.4. Motor BPEL: ActiveBPEL 4.1 modicado
Puesto que he modicado partes del motor BPEL, no sirve con descargar la versión binaria. Hay que descargar el código fuente de ActiveBPEL 4.1 de
http://www.
active-endpoints.com/download-terms-conditions.htm (habremos de aceptar las condiciones de ActiveBPEL), y lo descomprimiremos bajo /src, aprovechando para crear
una copia limpia:
mkdir ~/src
cd src
tar xzf ruta a las fuentes /activebpel-4.1-src.tar.gz
cp -r activebpel-4.1 activebpel-4.1.orig
cd activebpel-4.1
zless /tmp/dist-entorno/ActiveBPEL_delta_4.1.diff.gz | patch -p0 chmod +x *.sh
3
Esto modicará el código debidamente y añadirá tres cheros al directorio actual:
aeEngineConfig.xml con la conguración que usaremos, recompilar.sh para (re)compilar
y (re)instalar ActiveBPEL (junto con la función XPath inspeccionar ), y generarDiferencias.sh
para generar las diferencias con el árbol sin modicaciones que antes creamos.
Tras cambiar las variables
CATALINA_USER
y
CATALINA_GROUP
de
recompilar.sh
a
nuestro grupo y usuario, lo ejecutaremos:
./recompilar.sh
http://localhost:8080/BpelAdmin.
Full, con lo que podremos examinar el ujo de ejecución de los procesos BPEL simplemente mirando los cheros .log
en ${CATALINA_HOME}/AeBpelEngine/process-logs, y los mensajes de despliegue de
procesos en el directorio hermano deployment-logs.
Comprobaremos si todo va bien visitando la dirección
La conguración instalada usará nivel de auditoría
1.5. Entorno de pruebas de unidad para BPEL: BPELUnit 1.0 modicado
Al igual que con ActiveBPEL, he modicado BPELUnit, así que habrá que usar las
fuentes, parchearlas y compilar. Primero necesitaremos la biblioteca XMLBeans 2.1.0
para poder compilar, así que la descargaremos de http://ftp.udc.es/apache-dist/
xmlbeans/binaries/xmlbeans-2.1.0.tgz y la descomprimiremos bajo /bin, para después añadir la variable de entorno XMLBEANS_HOME con esa ruta al chero /.bashrc.
No hay distribuciones de código fuente en este caso: habrá que tomar el código más
reciente del CVS de Sourceforge. Dentro de
/src
ejecutaremos:
cvs -d:pserver:[email protected]:/cvsroot/bpelunit co .
Esto descargará todo el código fuente que necesitamos. Ahora lo parchearemos, compilaremos e instalaremos:
cd org.bpelunit.framework
zless /tmp/dist-entorno/BPELUnit_delta_1.0.diff.gz | patch -p0 cd ../org.bpelunit.build.standalone
ant
mkdir -p ~/bin/bpelunit
cp -r build/* ~/bin/bpelunit
Asignaremos la ruta
en
${HOME}/.bashrc:
${HOME}/bin/bpelunit a una nueva variable de entorno BPELUNIT_HOME
la
export BPELUNIT_HOME=~/bin/bpelunit
Guardaremos el guión
bpelunit.sh en ${HOME}/bin, y luego conguraremos BPELUconfiguration.xml
nit con nuestros ajustes de ActiveBPEL. Para ello, copiaremos nuestro
4
${HOME}/bin/bpelunit/conf/configuration.xml cuidando de
usuario correcto dentro de ActiveBPELDeploymentDirectory.
sobre el chero original
poner el nombre de
Ahora iniciar una única prueba será tan sencillo como:
bpelunit.sh (ruta a chero .bpts)
1.6. Editor BPEL: NetBeans v6.0
Para editar los cheros BPEL, recomiendo NetBeans, en su versión 6.0: las versiones anteriores generan cheros BPEL4WS 1.1 problemáticos. Sólo hay que descargar el
instalador del
bundle
All de
www.netbeans.org,
ejecutarlo y seguir las instrucciones.
Este paquete no incluye un motor BPEL para depurar paso a paso. Para ello, habría
que instalar OpenESB v2.0 de
Addons_NB6.html,
https://open-esb.dev.java.net/Downloads_OpenESB_
que sí lo incluye. Por lo pronto no es necesario.
5