Creación de un dominio WebLogic para SOA, OSB, BPM y BAM

En nuestra máquina con sistema operativo Oracle Linux 64 bits se creará un dominio WebLogic con la siguiente configuración:

• Se usará JRockit como JVM, no el JDK de Sun, para asemejarlo a un entorno de producción.
• La base de datos del repositorio de la SOA estará instalada en otra máquina: soa11db.
• Un servidor para el administrador del dominio: AdminServer.
• Un servidor administrado para la SOA Suite, BPM Suite y Oracle Service Bus: soa_osb_server1.
• Un servidor administrado para el BAM: bam_server1.

Para conseguir lo anterior, primero se crea el dominio para el OSB y luego se extiende ese dominio para la SOA, BPM y el BAM.

Antes de poder crear el dominio se deben realizar las siguientes acciones:

a) Tener instalados los esquemas RCU en el servidor de Base de Datos soa11db.
b) Instalar JRockit 6
c) Instalar WebLogic Server 10.3.6.0
d) Instalar Oracle Service Bus 11.1.1.7.0
e) Instalar Oracle SOA Suite 11.1.1.7.0

 

Indice

1. Creación de un dominio WebLogic para OSB
2. Extensión del dominio para agregar SOA y BPM
3. Extensión del dominio para agregar BAM
4. Subir toda la plataforma SOA 

Instalación de Oracle SOA Suite en Linux

Se instalará Oracle SOA Suite 11.1.1.7.0 en nuestra máquina con Oracle Linux 64 bits. Se descargan desde oracle los 2 archivos del instalador:

ofm_soa_generic_11.1.1.7.0_disk1_1of2.zip
ofm_soa_generic_11.1.1.7.0_disk1_2of2.zip 

Se descomprimen en la ruta /home/oracle/jflores/SOA.

1. Ejecutar el instalador: se usa JRockit como el jre para ejecutar el instalador.
cd /home/oracle/jflores/SOA/Disk1
./runInstaller -jreLoc /home/oracle/jrockit-jdk1.6.0_45-R28.2.7-4.1.0/

2. Install Software Updates: seleccionar Skip, para no buscar updates en Internet.

3. Prerequisite Checks: pasa todos los prerequisitos OK. 

4. Specify Installation Location: elegir los valores por default. Oracle Home de la SOA: Oracle_SOA1.

5. Application Server: elegir el default WebLogic Server.

6. Installation Summary: click en Install.

7. Installation Complete.

Y ahora...

...ya estamos listos para crear nuestro dominio WebLogic soadomain con los productos SOA, OSB, BPM y BAM.

 

---
EOF
---

Instalación de Oracle Service Bus en Linux

Se instalará Oracle Service Bus 11.1.1.7.0 en nuestra máquina con Oracle Linux 64 bits. Se descarga desde oracle el archivo del instalador: 

ofm_osb_generic_11.1.1.7.0_disk1_1of1.zip

Se descomprime en la ruta /home/oracle/jflores/OSB.

1. Ejecutar el instalador: se usa JRockit como el jre para ejecutar el instalador.
cd /home/oracle/jflores/OSB/Disk1
./runInstaller -jreLoc /home/oracle/jrockit-jdk1.6.0_45-R28.2.7-4.1.0/ 

2. Specify Inventory directory: path por defecto: /home/oracle/oraInventory

3. Ejecutar script como usuario root
/home/oracle/oraInventory/createCentralInventory.sh

4. Install Software Updates: seleccionar "Skip Software Updates".

5. Installation Location: se eligen los path por default. El Oracle Middleware Home ya existe porque se instaló WebLogic Server. El directorio para el OSB será Oracle_OSB1.

6. Installation Type: se elige Custom para sólo elegir instalar OSB Server. El OSB IDE se instalará en un PC con Windows que será usado como equipo de desarrollo básico.

7. Components to Install: sólo se deja Oracle Service Bus Server.
  
8. Prerequisite Cheks: se pasan todos OK.

9. Product Home Location: WebLogic Server location: se deja el valor default.

10. Installation Summary: click Install. La instalación de OSB es exitosa.

Y ahora...

...instalamos Oracle SOA Suite.

---
EOF
---

Oracle Service Bus - Tutorial 1: Routing a Loan Application

El objetivo de este tutorial es revisar uno de los ejemplos que vienen en la instalación de Oracle Service Bus. Específicamente se revisará el tutorial 1 Routing a Loan Application.  En la documentación oficial de oracle este ejemplo se revisa usando el entorno gráfico que provee la consola del OSB, pero aquí se verá usando Eclipse OEPE.

Antes de poder desarrollar este tutorial es necesario haber creado un dominio weblogic para OSB. 

El servicio que se desea crear hará uso de 2 webservices externos. Como estamos en un entorno de desarrollo estos webservices se deployarán en el mismo dominio WebLogic donde está instalado el OSB.

Estas son las secciones que componen el tutorial:

1. Deploy de los webservices externos
2. Revisión de los XML usados por los webservices
3. Pseudocódigo del servicio OSB
4. Creación del Proyecto OSB en Eclipse
5. Deploy del proyecto en el servidor OSB
6. Probando nuestro servicio OSB

Instalación de WebLogic Server 10.3.6.0

Se instalará WebLogic Server en nuestra máquina con sistema operativo Oracle Linux 64bits. Se descarga desde oracle el archivo de weblogic genérico wls1036_generic.jar. Este instalador no provee un JDK por lo que se debe instalar JRockit antes de WebLogic, ya que en el proceso de instalación se debe elegir un JDK.

Me baso en la documentación oficial de instalación.

1. Ejecutar el archivo instalador:
java -d64 -jar wls1036_generic.jar

El comando java ya existe en el sistema operativo, por lo que no es necesario setear la variable PATH. Se agrega la opción -d64 porque se usa un JDK de 64bits.

2. Choose Middleware Home Directory:
Middleware Home Type: Create a new Middleware Home.
Se elige el default: /home/oracle/Oracle/Middleware 

3. Registro para Security Updates: Se saca el flag porque no se desea recibir updates de seguridad. Seleccionar el flag "I wish to remain uninformed of security issues..."

4. Tipo de Instalación: Se escoje Custom, para ver las componentes a instalar. 

5. Choose products and components: Se dejan las opciones por default (sólo los ejemplos no son instalados). 

6. JDK Selection: Se busca el directorio de JRockit recién instalado:
/home/oracle/jrockit-jdk1.6.0_45-R28.2.7-4.1.0

Se quita el flag del JDK de /usr/lib/...

7. Directorios de instalación: Se dejan los paths por defecto:
/home/oracle/Oracle/Middleware/wlserver_10.3
/home/oracle/Oracle/Middleware/coherence_3.7

8. Installation Summary: Click Next.

Y ahora...

...instalamos Oracle Service Bus.


---
EOF
---

Instalación de JRockit

El primer paso en la creación de nuestro dominio SOA es instalar JRockit de 64bits. Se descarga desde oracle el archivo de instalación: jrockit-jdk1.6.0_45-R28.2.7-4.1.0-linux-x64.bin.

1. Se le da permiso de ejecución
chmod +x jrockit-jdk1.6.0_45-R28.2.7-4.1.0-linux-x64.bin

2. Ejecutar el instalador de JRockit
./jrockit-jdk1.6.0_45-R28.2.7-4.1.0-linux-x64.bin    

3. Product installation directory: se elige el directorio default:
/home/oracle/jrockit-jdk1.6.0_45-R28.2.7-4.1.0

4. Optional Components: no se selecciona ninguna.

Y ahora...

...instalamos WebLogic Server 10.3.6.0.

---
EOF
---

Instalación de esquemas RCU para SOA

Después de la instalación de la Base de Datos Oracle 11g, se crearán los esquemas necesarios para la SOA Suite. Para ello se utiliza el Repository Creation Utility 11.1.1.7.0.  Se descarga desde oracle el archivo instalador: 

ofm_rcu_linux_11.1.1.7.0_64_disk1_1of1.zip

Se descomprime en la ruta /home/oracle/jflores/RCU.

La BD debe estar arriba.

1. Ejecutar el instalador del RCU
[oracle@soa11db ~]$ cd /home/oracle/jflores/RCU/rcuHome/bin
[oracle@soa11db ~]$ ./rcu

2. Create Repository: seleccionar la opción Create (es el default).

3. Databse Connectios Details
Database type: Oracle Database
Hostname: soa11db
Port: 1521
Service name: dbora11
Username: sys
Password: oracle
Role: SYSDBA 

4. Select Components: seleccionar "SOA and BPM Infraestructure". Se crearán 4 esquemas, con el prefijo por default DEV.

5. Schema Passwords: se elige la misma password para todos los esquemas: oracle 

6. Map Tablespaces: click en Manage Tablespaces. Para los 4 tablespaces DEV_* (menos el tablespace temporal DEV_IAS_TEMP) se configura su tamaño máximo a Unlimited: 

Click en el datafile > Edit Datafile.
Se activa el flag "Unlimited", para el tamaño máximo de cada datafile.
Click Next.
Click Create.

---
EOF
---

Instalación de Base de Datos Oracle 11g en Oracle Enterprise Linux 64 bits

Se instalará la Base de Datos Oracle 11gR2 en una máquina virtual con sistema operativo  Oracle Linux 64 bits. Sólo se usará 1G para la máquina virtual, ya que será para pruebas y desarrollos personales en SOA Suite.

 

Configuración inicial como usuario root

1. Configurar IP y nombre de host: se cambia el nombre de la máquina por soa11db y se setea IP fija:

vi /etc/sysconfig/network 
Cambiar HOSTNAME a soa11db

vi /etc/hosts
Se agrega la línea:
172.16.1.135 soa11db soa11db.localdomain

También se debe cambiar la IP en las propiedades de red (Network Connections).

2. Crear grupos de sistema operativo requeridos: crear los grupos oinstall y dba:

/usr/sbin/groupadd oinstall
/usr/sbin/groupadd dba
/usr/sbin/usermod -g oinstall -G dba oracle
 
3. Configurar Parámetros del Kernel
vi /etc/sysctl.conf
 
Agregar al final del archivo: 

kernel.sem = 250    32000    100    128
net.ipv4.ip_local_port_range = 9000    65500
net.core.rmem_default = 262144
net.core.rmem_max = 4194304
net.core.wmem_default = 262144
net.core.wmem_max = 1048586
fs.aio-max-nr = 1048576
fs.file-max = 6815744

Ingresar el siguiente comando para cargar en el kernel los parámetros especificados en el archivo /etc/sysctl.conf:

/sbin/sysctl -p

No cambié los siguientes parámetros porque sus valores son mayores a los recomendados.
Recomendados:
kernel.shmall = 2097152
kernel.shmmax = 536870912
kernel.shmmni = 4096
Valores en el servidor linux: (/sbin/sysctl -a | grep shm)
kernel.shmmax = 68719476736
kernel.shmall = 4294967296
kernel.shmmni = 4096
vm.hugetlb_shm_group = 0

Instalación de Oracle Enterprise Linux 64 bits

Se quiere instalar una máquina virtual con el sistema operativo Oracle Enterprise Linux de 64 bits para luego instalar en ella un entorno de desarrollo SOA. La idea es tener algo más cercano a un entorno de producción que sólo tener una máquina de desarrollo con Windows.

Se descarga de oracle.com el archivo iso para instalar Oracle Linux Release 6 Update 4 for x86_64 (64 Bit): V37084-01.iso. Se creará una máquina usando un tamaño de disco de 40GB. Se almacenará el disco virtual en un solo archivo vmdk. 

 

Fase inicial de instalación 

1. Welcome to Oracle: seleccionar "Install".

2. Disc Found: seleccionar Skip, para no hacer una prueba de validación del archivo iso (no es necesario).

3. Lenguaje de instalación: se elige el default, inglés.

4. Seleccionar el teclado apropiado: Latin American.
 

5. What type of devices will.... se elige el default: Basic Storage Devices. Click en "Yes, discard any data".

6. Hostname: se elige el nombre oralinux64.

7. Selected city: se elige el valor: "America/Santiago".

8. Root Password: oracle 

9. Wich type of installation... se elige el valor default: Replace Existing Linux System(s). Click en "Write changes to disk".

10. The default installation of Oracle Linux Server is a basic.... seleccionar Desktop. En la parte de abajo de la ventana hacer click en "Customize now".

Creación del Dominio WebLogic para Oracle Service Bus en Windows

Después de instalar OEPE y el OSB, se creará en nuestra máquina de desarrollo una instancia de WebLogic Server con Oracle Service Bus. Se debe ejecutar el Configuration Wizard que viene en el menú junto con OEPE (menú Inicio > Oracle Enterprise Pack for Eclipse > WebLogic Server 11gR1 > Tools > Configuration Wizard). No se debe usar el que viene con JDeveloper ya que es de una versión diferente de WebLogic Server.

1. Seleccionar la opción: "Crear nuevo dominio de weblogic".

2. Generar un dominio configurado con: seleccionar Oracle Service Bus for developers. Se seleccionan automáticamente otros productos requeridos.

3. Introduzca el nombre y la ubicación del dominio
Nombre: osbdomain 
Ubicación: C:\Oracle\OracleServiceBus\user_projects\domains (es el valor default)

4. Configurar nombre de usuario y contraseña del administrador
Nombre     : weblogic
Password  : welcome1 

5. Configurar modo de inicio: se usan los valores por default: Development, JDK que viene en la instalación del OEPE.

6. Configurar esquema de componentes JDBC: el esquema DEV_SOAINFRA se crea por default en la base de datos osbexamples, localhost, puerto 1527. Se le cambia la password a oracle.

7. Probar esquema de componentes: como la base de datos local no ha sido creada, la prueba fallará. No importa. Esta base de datos se levanta cuando se inicie el administrador de WebLogic.

8. Seleccionar configuración opcional: no seleccionar ningún flag. La creación del dominio es exitosa. 

Seleccionar el flag Iniciar servidor de administración, para revisar la instalación del dominio osbdomain.

URL Consola de Administración de WebLogic: 
http://soadev:7001/console

URL Consola OSB 
http://soadev:7001/sbconsole

Y ahora...

...ya podemos realizar un tutorial de Oracle Service Bus.

---
EOF
---

Configuración Inicial OEPE

Después de la instalación de OEPE, ahora se realizará la configuración de Eclipse recomendada por el libro The Definitive Guide to SOA - Oracle Service Bus.

Ejecutar Oracle Enterprise Pack for Eclipse, desde el menú Inicio de Windows, o directamente desde la ruta C:\Oracle\OracleServiceBus\oepe_11.1.1.8.0\eclipse.exe

1. Se elige un workspace: C:\jflores\SOA_Desarrollo. Se marca el flag para usarla como default y que no pregunte denuevo.

2. Creando Librerías
- Seleccionar Menu > Windows > Preferences.  
- Seleccionar Java > Build Path > User Libraries
- Click en New... : La primera librería a agregar es un cliente para probar web services.
  - Nombre: WebLogic Web Service Client
  - Click en "Add JARs".
  - Navegar a la ruta:  
  C:\Oracle\OracleServiceBus\wlserver_10.3\server\lib      
  - Seleccionar los archivos: weblogic.jar, webserviceclient.jar

3. Configurando Ant: hay que agregar weblogic.jar al classpath de Ant. 
- Menu > Windows > Preferences.
- Seleccionar Ant > Runtime, Tab Classpath
- Click en "Ant Home Entries"
- Click en "Add External JARs"

- Navegar a C:\Oracle\OracleServiceBus\wlserver_10.3\server\lib y seleccionar weblogic.jar.

---
EOF
---

Instalación de Oracle Service Bus en Windows

Después de la instalación de OEPE, ahora se instalará en nuestra máquina de desarrollo Windows, el Oracle Service Bus. 

Archivo instalador: ofm_osb_generic_11.1.1.7.0_disk1_1of1.zip.

Se descomprime el archivo. Se debe ejecutar el setup.exe que viene en ./Disk1/. Abrir una ventana de cmd y ejecutar el siguiente comando pasando como parámetro la ruta del JDK instalado con OEPE:

cd C:\jflores\OSB\ofm_osb_generic_11.1.1.7.0_disk1_1of1\Disk1
setup.exe -jreLoc C:\Oracle\OracleServiceBus\jdk160_29

1. Instalar Actualizaciones de Software: se debe seleccionar: Omitir actualizaciones de software

2. Ubicación de instalación: se selecciona: C:\Oracle\OracleServiceBus. Es la misma ruta donde se instaló el OEPE.

3. Tipo de instalación: Personalizada.

4. Componentes a instalar: se seleccionan todas las opciones (por default viene así).

5. Comprobaciones de requisitos: todas pasan OK.

6. Ubicación del directorio raíz del producto: se dejan los valores default.
 

NOTA: si aparece el siguiente mensaje de error se debe a que en la instalación del OEPE no se seleccionaron todas las opciones necesarias de WebLogic Server, en particular la 

base de datos de evaluación:

INST-07417: Evaluation Database no se ha instalado en Weblogic Server Location que ha especificado. 

Proporcione otra ubicación

Proporcione Weblogic Server Location diferente

7. Click en Instalar.

---
EOF
---

Instalación de Oracle Enterprise Pack for Eclipse

Se desea crear un entorno de desarrollo para Oracle Service Bus (OSB) en una máquina con Windows 7. Se quiere poder usar el IDE del OSB. Para ello es necesario instalar el Eclipse más los plugins necesarios para desarrollar servicios del OSB.

El instalador es: oepe-wls-indigo-installer-11.1.1.8.0.201110211138-10.3.6-win32.exe
 
OEPE = Oracle Enterprise Pack for Eclipse
WLS = WebLogic Server
Indigo = Una versión del IDE Eclipse.

El instalador viene con Eclipse (Indigo), con los plugins para desarrollar servicios OSB (OEPE) y también viene con el instalador del WebLogic Server 10.3.6. El OSB Server se instalará posteriormente.
 

Pasos para la instalación del OEPE:

1. Seleccionar Directorio raíz de Middleware: no se elige el que ya existe, porque ese es usado por la instalación de JDeveloper.

Tipo de directorio raíz: Crear un nuevo directorio raíz. 
Se crea un directorio especial para el Oracle Service Bus:
C:\Oracle\OracleServiceBus

2. Registrar actualizaciones de seguridad: se quita el flag.

3. Seleccionar tipo de instalación: Personalizada.

4. Seleccionar productos y componentes
- Se elige WebLogic Server
- Se elige Oracle Enterprise Pack for Eclipse
- No se instala Oracle Coherence ni Oracle ADF.

5. Selección de JDK: se deja la opción default.

6. Seleccionar Directorio de instalación de productos: se dejan los valores default.

7. Instalar servicio de Windows: se elige la opción No, para no instalar el Node Manager.

8. Seleccionar ubicación de método abreviado: se elige el valor default (todos los usuarios).

Y ahora...

...que está terminada la instalación, podemos realizar la configuración inicial de Eclipse para WebLogic. Luego, procedemos a instalar Oracle Service Bus.

---
EOF
---

Instalación de JDeveloper 11.1.1.7.0

Se detallan los pasos de instalación en Windows 7.


1. Se crea el Middleware Home por default: C:\Oracle\Middleware 

2. Tipo de instalación: Personalizada.

3. Seleccionar Productos y Componentes
Sólo se elige JDeveloper Studio, el wizard automáticamente elige otras opciones.

4. Selección de JDK 
Se elige la opción default: se usa SUN SDK 1.6.0_24.

5. Instalar servicio de Windows
Se elige No, para no crear el servicio del Node Manager.

6. Seleccionar Ubicación de Método Abreviado 
Se elige el default: Todos los usuarios.

7. Instalación Terminada 
Dejar el check seleccionado de Quickstart.

Seleccionar Launch Oracle JDeveloper 11g.

8. Select Role
Seleccionar Default Role.
Quitar el check para que no levante más esta ventana.

9. Configure File Type Associations
Seleccionar las 2 primeras opciones: JDeveloper Application, JDeveloper Project.

10. Oracle Usage Tracking
Quitar el check para no enviar información a Oracle.

11. Tip of the Day
Se quita el check.

12. Instalación de extensiones 

Se instalan la extensiones Oracle SOA Composite Editor y Oracle BPM Studio, las que se pueden descargar desde los siguientes enlaces:

soa-jdev-extension.zip
bpm-jdev-extension.zip

Seleccionar desde el menú: Help > Check for Updates > Install from local file.

NOTA: las extensiones también se pueden instalar online.

Todas las extensiones para JDeveloper:
Oracle Extensions for Oracle JDeveloper Update Center

Las extensiones específicas para Fusion Middleware:
Oracle Fusion Middleware Products Update Center

Y ahora...

...que ya tenemos instalado JDeveloper, podemos instalar Eclipse OEPE para desarrollar servicios en Oracle Service Bus.

---
EOF
---