Blog de la Comunidad de PHD 2014 Consultores - Bus de Servicio Empresarial.

www.phd2014consultores.com

miércoles, 18 de junio de 2014

WSO2 - Taller 1: Instalación y Ejecución (Linux)


       ¿Qué haremos?

1.                  Ejercicio #1: Descargar WSO2 – Enterprise Service Bus.

2.                  Ejercicio #2: Instalar Pre-requisitos WSO2 – Enterprise Service Bus.

3.                  Ejercicio #3: Instalar WSO2 – Enterprise Service Bus.

4.                  Ejercicio #4: Ejecutar WSO2 – Enterprise Service Bus.


Ejercicio #1: Descargar WSO2 – Enterprise Service Bus

Siga las siguientes instrucciones para descargar WSO2 ESB. También puede descargar y generar el código fuente.

1.                  En su navegador web vaya a http://wso2.com/products/enterprise-service-bus/.

2.                  Sí es la primera vez que descargas un producto WSO2 deberás registrarte e iniciar sesión.

3.                  Luego de que inicies sesión deberás hacer clic en el botón “Binary” en la esquina superior derecha de la página.

4.                  La distribución binaria contiene los archivos binarios ESB para los sistemas operativos Linux y Windows. Comprimidos en un único archivo ZIP. Se recomienda esta distribución para muchos usuarios.


Ejercicio #2: Instalar Pre-requisitos WSO2 – Enterprise Service Bus

Instalación de Java:

1.                  Verifique que Java y Java Development Kit (JDK) sea la versión de Java por defecto se su Sistema Operativo. Para eso haga:

$> java -version



Si obtiene una respuesta parecida a la siguiente es porque no tiene instalada ninguna versión de Java en su Sistema.

The program 'java' can be found in the following packages:
 * default-jre
 * gcj-4.6-jre-headless
 * openjdk-6-jre-headless
 * gcj-4.5-jre-headless
 * openjdk-7-jre-headless
Try: apt-get install <selected package>

Si tienes instalada una versión obsoleta de Java, elimínala y crea un directorio para almacenar los binarios de JDK 7. Esto evitará que haya conflictos y confusión entre las distintas versiones de Java.     

$> sudo mkdir -p /usr/local/java

2.                  Descarga Jdk (última versión). Asegúrate de seleccionar los binarios correctos para tu sistema operativo.           

3.                  Copia los binarios en el directorio: “usr/local/java”, creado en el paso 1.

En la mayoría de los casos los binarios de JDK se descargan en: “home/<usuario>/Downloads”.

$> cd /home/<usuario>/Downloads
$> sudo cp -r <archivo_java>.tar.gz /usr/local/java/
$> cd /usr/local/java/

4.                  Ejecuta los siguientes comandos en los archivos “tar.gz” descargados. Asegúrate de hacerlo como root.

$> sudo -s
$> sudo chmod a+x <archivo_java>.tar.gz
$> sudo tar -xvzf <archivo_java>.tar.gz


5.                  Revisa los directorios. Hasta este momento deberás tener dos (2) directorios binarios en “/usr/local/java/”.     

6.                  Edita el archivo PATH del sistema “/etc/profile” y agrega las siguientes variables de sistema al PATH. Usa el editor de texto de tu preferencia, pero asegúrate de hacerlo como root para abrir “/etc/profile”.


$> sudo gedit /etc/profile

7.                  Desplázate hacia el final del archivo y agrega las siguientes líneas:

JAVA_HOME=/usr/local/java/jdk<versión>
PATH=$PATH:$HOME/bin:$JAVA_HOME/bin
export JAVA_HOME
export PATH

8.                  Guarda el archivo y salte.

9.                  Informa a tu sistema donde está ubicado el JDK. Esto le dirá a tu sistema que hay una nueva versión nueva de Java.

$> sudo update-alternatives --install "/usr/bin/java" "java" "/usr/local/java/jdk<versión>/bin/java" 1

Este comando notifica al sistema que JRE está listo para usarse.

$> sudo update-alternatives --install "/usr/bin/javac" "javac" "/usr/local/java/jdk<versión>/bin/javac" 1

Este comando notifica al sistema que JDK está listo para usarse.

$> sudo update-alternatives --install "/usr/bin/javaws" "javaws" "/usr/local/java/jdk<version>/bin/javaws" 1

Este comando notifica al sistema que Java Web Start está listo para usarse.

10.               Informa a tu sistema que el Java que acabas de instalar debe ser el Java por defecto.

$> sudo update-alternatives --set java  /usr/local/java/jdk<versión>/bin/java


$> sudo update-alternatives --set javac /usr/local/java/jdk<versión>/bin/javac


$> sudo update-alternatives --set javaws /usr/local/java/jdkversión>/bin/javaws

11.               Vuelve a cargar el PATH de tu sistema:

$> su - <nombre_usuario>

Este comando carga el archivo
“/etc/profile”. El PATH se volverá a cargar después de reiniciar tu sistema.       

12.               Prueba si el Java se instaló correctamente en tu sistema.         

$> java -version


Instalación de Apache Ant

1.                  Descargue la última versión de Apache Ant desde la página oficial http://ant.apache.org/bindownload.cgi

2.                  Coloquese en el directorio donde desea realizar la instalación, se recomienda “/home/<usuario>/app/”, realice los siguientes pasos:     

3.                  Descomprima el archivo con el siguiente comando:

$> tar -xvzf apache-ant-<version>-bin.tar.gz

4.                  Una vez terminada la instalación se recomienda cambiar el nombre del directorio “apache-ant-<version>-bin” a simplemente “ant”; quedando instalado en una ruta absoluta: “/home/<usuario>/app/ant/”.   

5.                  Ant requiere configurarse con diversas variables de entorno para su correcta operación.

6.                  Abra con un editor de texto el archivo “/etc/profile” y copie al final del mismo las siguientes líneas.          

ANT_HOME=/home/<usuario>/app/ant
PATH=$PATH:$ANT_HOME/bin
export ANT_HOME
export PATH

7.                  Luego cargue el archivo y reinicia tu sistema para cargar el PATH.

$> su - <nombre_usuario>


Instalación de Apache Maven

1.                  Descargue la última versión de Apache Maven desde la página oficial http://maven.apache.org/download.cgi

2.                  Colóquese en el directorio donde desea realizar la instalación, se recomienda “/home/<usuario>/app/”, realice los siguientes pasos:     

3.                  Descomprima el archivo con el siguiente comando:       

$> tar -xvzf apache-maven-<version>-bin.tar.gz

4.                  Maven requiere configurarse con diversas variables de entorno para su correcta operación.

5.                  Abra con un editor de texto el archivo “/etc/profile” y copie al final del mismo las siguientes líneas.

MAVEN_HOME=/home/<usuario>/app/apache-maven-<version>-bin
PATH=$PATH:$MAVEN_HOME/bin
export MAVEN_HOME
export PATH

6.                  Luego cargue el archivo y reinicia tu sistema para cargar el PATH.

$> su - <nombre_usuario>



Ejercicio #3: Instalar WSO2 – Enterprise Service Bus

1.                  Si no lo ha hecho, descargue la última versión del WSO2 ESB siguiendo los pasos del Ejercicio #1.

2.                  Descomprima el archivo “wso2esb-<version>.zip” en el directorio “/home/<usuario>/app”.

$> sudo cp -r wso2esb-<version>.zip /home/<usuario>/app/
$> sudo unzip wso2esb-<version>.zip
$> sudo rm *.zip


Ejercicio #4: Ejecutar WSO2 – Enterprise Service Bus

Iniciar el Servidor

1.                  Para iniciar el servidor, ejecuta el script “wso2server” en el directorio “bin/”.



2.                  Pero antes debemos asegurarnos de que sudo tenga correctamente configuradas las variables de entorno. Esto es porque cuando ejecutamos un comando con sudo se restean las variables de entorno para evitar que estemos tratando de engañar al comando que ejecutamos con sudo.       

Ahora bién,      

$> su - <usuario>
$> cd /home/<usuario>/app/wso2esb-<version>/bin/
$> sudo -E ./wso2server.sh

Con la opción -E podemos preservar el entorno del usuario <usuario>.

3.                  Cuando se ejecuta el servidor, el log muestra el mensaje:

WSO2 Carbon started in <n> sec

Ejecutar la Consola de Administración

1.                  Una vez que el servidor se ha iniciado, puede ejecutar la consola de administración, abra un navegador web y escriba la dirección URL de la consola de administración. La URL se muestra en el log. Por ejemplo:     

[2014-04-03 19:16:10,041]  INFO - CarbonUIServiceComponent Mgt Console URL  : https://10.230.187.97:9443/carbon/

2.                  Usted puede utilizar esta URL para acceder a la consola de administración en su ordenador desde cualquier otro ordenador conectado a Internet o LAN. Al acceder a la consola de administración desde el mismo servidor donde está instalado, puede escribir “localhost” en lugar de la dirección IP.

3.                  Puedes iniciar sesión con las credenciales “admin/admin”. Luego, puede utilizar la consola de administración para gestionar el WSO2 ESB. Las fichas y los elementos del menú en el panel de navegación de la izquierda pueden variar dependiendo de las características que se instalan. En nuestro caso, la Consola de Administración para WSO2 ESB.






4.                  Para obtener información de alguna página en particular haga clic en el enlace “Help”. Para abrir la documentación del WSO2 ESB haga clic en el enlace “Docs”.

5.                  Si deja la Consola de Administración desatendida, la sesión se interrumpirá. El valor de tiempo de espera predeterminado es de 15 minutos, pero se puede cambiar en el archivo: “/home/<usuario>/app/wso2esb-4.8.1/repository/conf/tomcat/carbon/WEB-INF/web.xml”.

<session-config>
    <session-timeout>15</session-timeout>
</session-config>


Detener el Servidor

1.                  Para detener el servidor es suficiente con presionar “Ctrl+C” o hacer clic en el enlace “Shutdown/Restart ” de la Consola de Administración.