1
Manual Instalación en
producción Aranda Enterprise Service Bus
(AESB)
2
Versión Fecha Descripción Responsable
1.0 16 agosto 2018 Creación Documento Cesar Augusto Gomez
1.1 06 diciembre de 2018 Consideraciones ASDK Cesar Augusto Gomez
1.2 01 abril de 2019 Recursos desacoplados de .CAR
Cesar Augusto Gomez
3
Tabla de contenido
Contenido Manual Instalación en ........................................................................................................................ 1
producción Aranda Enterprise Service Bus (AESB) ............................................................................ 1
Tabla de contenido ......................................................................................................................... 3
Objetivo .......................................................................................................................................... 4
Consideraciones importantes ........................................................................................................ 4
Prerrequisitos de instalacion.......................................................................................................... 4
Paquete de instalación ................................................................................................................... 4
Listado de instaladores ................................................................................................................... 4
Instalación de WSO2 Enterprise Integrator ................................................................................... 6
Instalación Java JDK y JRE............................................................................................................... 8
Configuración de variables de entorno.......................................................................................... 9
Ejecución de WSO2-EI ................................................................................................................... 13
Configuración de base datos motor SQL Server .......................................................................... 16
Poblar Base de datos de WSO-EI .................................................................................................. 22
Configurando el controlador JDBC para Microsoft SQL Server ................................................... 22
Cambiar fuente de datos de WSO2-EI para Microsoft SQL Server ............................................. 23
Permisos de usuarios .................................................................................................................... 28
Configuración de base datos para motor Oracle ......................................................................... 28
Configurando el controlador JDBC para Oracle ........................................................................... 31
Poblar Base de datos de WSO-EI para Oracle .............................................................................. 32
Creación de servicios Windows .................................................................................................... 32
Creación de medios de configuración .......................................................................................... 36
Publicación de medios de integración (.CAR) .............................................................................. 39
Configuración de WSO2-EI ........................................................................................................... 43
Configuracion de EndPoint productos. ........................................................................................ 45
Configuración de Estados Notificables ........................................................................................ 48
Configuración de Homologación de estados ............................................................................... 50
Configuración de campo solución ................................................................................................ 54
Configuración de EndPoints SOAP dinámicos ............................................................................. 56
Configuración de WDSL dinámicos .............................................................................................. 57
Configuración de autenticación del producto ASDK ................................................................... 58
4
Configuración de autenticación del producto AFLS .................................................................... 61
Anexos ........................................................................................................................................... 63
Consideraciones ............................................................................................................................ 64
Objetivo
El presente manual da al lector el contexto y los pasos necesario para la instalación del AESB (Aranda
Enterprise Service Bus).
Consideraciones importantes
1. Utilice Únicamente los instaladores suministrados, no descargue directamente los
productos desde la web del proveedor WSO2.
2. Inhabilite en su sistema las actualizaciones automáticas del producto Java para prevenir
errores de incompatibilidad.
3. Siga al pie de la letra los pasos necesarios tanto instalar el producto como para configurarlo.
4. Utilice únicamente empaquetados. CAR para realizar el despliegue de recursos en el sistema
de integración.
5. Tenga en cuenta que los nombres que se enuncian en este manual están referenciados con
comillas dobles “”, dependiendo del escenario solo copie y pegue el nombre obviando las
comillas.
6. Inhabilite las actualizaciones automáticas para JDK.
Prerrequisitos de instalacion
Version WSO2EI Version Sistema operativo Windows
Enterprise Integrator 6.3.0 Windows 2012, 10, 7, XP SP2 / SP3, 2008 R2 64 bits
Paquete de instalación Junto a este manual encontrará la ruta donde se alojan los instaladores necesarios para su
instalación de su instancia ESB, realice una copia en su ambiente local.
Listado de instaladores Producto Nombre del instalador Versión Ruta
WSO2 EI wso2ei-windows-installer-x64-6.3.0.msi
6.3.0 / 64 bits \InstalacionAESB\WSO2\
Java JDBC mssql-jdbc-6.4.0.jre7.jar 6.4.0.jre7 \InstalacionAESB\Tools\JDBC\
5
Java JDK jdk-8u161-windows-x64.exe 8u161 /Windows/64
\InstalacionAESB\Tools\JDK\
Packer yajsw-stable-11.03 11.03 \InstalacionAESB\Tools\Packer\
6
Instalación de WSO2 Enterprise Integrator
1. Ejecute el instalador correspondiente a WSO2 Enterprise integrator, Dirigirse a la ruta
“\InstalacionAESB\WSO2\ wso2ei-windows-installer-x64-6.3.0.msi”
2. Clic en siguiente.
3. Seleccionar la ruta donde se instalará el producto.
7
4. Clic en Yes para aceptar.
5. Desmarque la casilla “Launch WSO2 Enterprise Integrator 6.3.0”.
6. Clic en Finish.
8
Instalación Java JDK y JRE
1. Realizar la verificación si el host cuenta con una versión de JDK de Java para ello ejecute el
siguiente comando en una consola de Windows.
a. “java –version”
2. Si ya se posee una versión del JDK de Java desinstalarlo.
3. Ejecute el instalador correspondiente al JDK de Java para ello, dirigirse a la ruta
\InstalacionAESB\Tools\JDK\ jdk-8u161-windows-x64.exe.
4. Clic en “Next” y finalice la instalación.
9
Configuración de variables de entorno
1. Terminada la instalación la estructura de instalación por defecto es como se muestra en la
siguiente imagen.
2. Acceda en la “Configuración avanzada del sistema, para ello entre al
a. “Panel de control”.
b. “Sistema”.
c. “Configuración avanzada del sistema”.
10
3. Clic sobre el botón “Variables de entorno”.
4. Clic sobre “Nueva” en la sección variables del sistema.
5. Agregar nuevas variables de entorno.
a. Nombre de la variable: “JAVA_HOME”.
b. Valor de la variable: “C:\Program Files\Java\jdk1.8.0_161”.
Nota: el valor de la variable dependerá de la ruta donde se instaló Java JDK.
11
6. Agregar un nuevo valor dentro la variable “PATH”.
a. Nombre de la variable: “JAVA_HOME”.
7. Seleccione la variable Path y edítela de la siguiente manera.
8. Ubíquese al final del valor de la variable “Variable value”
a. Y agregue el siguiente valor “;%JAVA_HOME%\bin”
Nota: asegúrese de pegar el valor con punto y coma incluido, en el caso de que su Sistema Operativo
no despliegue una nueva ventana emergente para configurar variables independientes como se
muestra a continuación los dos escenarios.
12
Por el contrario, si su S.O no lanza la anterior ventana de dialogo, incluya las comillas para indicar
que es un nuevo valor como se muestra a continuación:
9. Finalice la configuración realizando una prueba de su nueva variable de entorno, para ello
abra una consola de Windows (cmd) y ejecute el siguiente comando, “java -version”, si la
variable está correctamente configurada, mostrara el detalle de esta como se muestra en
la siguiente imagen.
Nota: Se recomienda abrir una nueva consola de comandos después de haber creado la variable
de entorno.
13
Ejecución de WSO2-EI
1. Abrir una consola de Windows CMD en modo “Administrador”.
2. Identificar la ruta donde instaló el producto WSO2-EI, si seleccionó por defecto la ruta por
defecto, el producto se instaló en “C:\Program Files\WSO2\Enterprise
Integrator\6.3.0\bin”.
3. Sitúese en dicho directorio y ejecute el siguiente comando, “integrator.bat”
4. Si la ejecución es exitosa la consola mostrará como mensaje final la ruta y puerto donde
ejecuta una nueva instancia de WSO2-EI.
5. Acceda a esa ruta para entrar a la consola de configuración de AESB.
6. Abrir el explorador de internet de su preferencia y acceder a la ruta que se suministró en la
consola de Windows CMD para este caso.
a. https://192.68.1.166:9443/carbon
14
7. Si el navegador nos muestra una advertencia de seguridad del sitio.
8. Acceder a la opción advance y seleccionar la opción acceder al sitio.
9. En la página principal de WSO2-EI autenticarse con las siguientes credenciales.
a. User: admin
b. Pass: admin
15
10. Una vez confirmado la óptima ejecución de WSO2-EI salir de la consola y cerrar el servicio
11. Salir de la consola.
12. Para detener el servicio de WSO2-EI remítase a la consola que esa ejecutando actualmente
el servicio y presione la combinación de teclas “Ctrl+C” hasta obtener el prompt.
a. Termine batch job <y/n>
b. Si “y”
16
Configuración de base datos motor SQL Server
WSO-EI utiliza para su operación un motor de base de datos H2, siga estos pasos para configurar un
motor de base de datos Microsoft SQL-Server.
1. Ingrese a “Microsoft SQL Server Management Studio”
2. Crear dos bases de datos en blanco para alojar los objetos necesarios para la
implementación local de WSO2-EI, con las siguientes características:
a. Nombre de la base de datos: “WSO2CarbonDB”
3. Cree un usuario con rol “db_owner” y mapee las bases de datos creadas “WSO2CarbonDB”
4. Ahora abra “SQL Server Configuration Manager”, para ello vaya a Inicio programas para
realizar la configuración de su instancia.
17
5. Habilite TCP/IP y desactive Named Pipes, para ello vaya a “SQL Server Network
Configuration” y selección su instancia donde se aloja la Base de datos creada.
6. Haga doble clic en TCP / IP para abrir la ventana de propiedades de TCP / IP y
establezca “Listen ALL” en “Yes” en la pestaña Protocolo.
18
7. En la pestaña Dirección IP, desactive Puertos dinámicos TCP dejándolos en blanco y
proporcione un puerto TCP válido, para que el servidor Microsoft SQL escuche en ese
puerto. (se siguiere hacer bajo el puerto 1433, porque puede usarlo para procesar servicios,
sin embargo, consúltelo con el administrador).
19
8. Del mismo modo, habilite TCP / IP desde SQL Native Client Configuration y
desactive Canalizaciones con nombre (Named Pipes), para ello selección “SQL Native Client
Configuration”.
9. Además, verifique si el puerto está configurado correctamente a 1433, para ello de doble
clic sobre “TCP/IP”.
20
21
10. Por ultimo para que surtan efectos los cambios realizados Reinicie el servicio de SQL Server.
Fuente: https://docs.wso2.com/display/ADMIN44x/Setting+up+Microsoft+SQL
22
Poblar Base de datos de WSO-EI
Los siguientes pasos permiten realizar la creación de los objetos para el producto wso2-ei.
1. Para crear los objetos de WSO2-EI, ejecute el script (mssql.sql) que se encuentra en la
siguiente ruta.
a. “C:\Program Files\WSO2\Enterprise Integrator\6.3.0\dbscripts”
b. Base de datos “WSO2CarbonDB”.
Configurando el controlador JDBC para Microsoft SQL Server
1. Copie los controladores:
a. mssql-jdbc-6.4.0.jre7
b. mssql-jdbc-6.4.0.jre8
c. mssql-jdbc-6.4.0.jre9
2. en la ruta:
a. C:\Program Files\WSO2\Enterprise Integrator\6.3.0\lib
23
Cambiar fuente de datos de WSO2-EI para Microsoft SQL Server
Siga los siguientes pasos para poder cambiar la fuente de datos que viene por defecto el producto
WSO2-EI.
master-datasources
.xml
WSO2-EI
1. Abra archivo de configuración alojado en la siguiente ruta:
a. “C:\Program Files\WSO2\Enterprise Integrator\6.3.0\conf\datasources\master-
datasources.xml” la configuración de origen de datos predeterminada en, como se
muestra a continuación.
2. Proceda a comentar la fuente de datos que viene por defecto (Base de datos H2)
a. Para agregar comentarios utilice la siguiente sintaxis “<!-- comentario -->”.
24
3. Copie y pegue la siguiente configuración de fuente de datos Microsoft SQL Sever
<datasource>
<name>WSO2_CARBON_DB</name>
<description>The datasource used for registry and user
manager</description>
<jndiConfig>
<name>jdbc/WSO2CarbonDB</name>
</jndiConfig>
<definition type="RDBMS">
<configuration>
<url>jdbc:sqlserver://192.168.1.158:1433;databaseName=WSO2CarbonDB</ur
l>
<driverClassName>com.microsoft.sqlserver.jdbc.SQLServerDriver</driverC
lassName>
<username>sa</username>
<password>@r@nd@_852_159_p1$34.*</password>
<maxActive>50</maxActive>
<maxWait>60000</maxWait>
<testOnBorrow>true</testOnBorrow>
<validationQuery>SELECT 1</validationQuery>
<validationInterval>30000</validationInterval>
<defaultAutoCommit>false</defaultAutoCommit>
</configuration>
</definition>
</datasource>
4. Cambie la siguiente configuración apuntar a su motor de base de datos.
a. url:
i. jdbc:sqlserver://{ip}:{puerto};databaseName={nombreDB}
i. ejemplo : jdbc:sqlserver:// 192.168.3.114:4566\desa;databaseName=
AESB_ASDK_AFLS
ii. UserName: sa
iii. Password: >@r@nd@_852_159_p1$34.*
25
5. La nueva configuración debería quedar así:
Configuración completa en código:
<datasources-configuration
xmlns:svns="http://org.wso2.securevault/configuration">
<providers>
<provider>org.wso2.carbon.ndatasource.rdbms.RDBMSDataSourceReader</
provider>
</providers>
<datasources>
<!--
<datasource>
<name>WSO2_CARBON_DB</name>
<description>The datasource used for registry and user
manager</description>
<jndiConfig>
<name>jdbc/WSO2CarbonDB</name>
</jndiConfig>
<definition type="RDBMS">
<configuration>
<url>jdbc:h2:./repository/database/WSO2CARBON_DB;DB_C
LOSE_ON_EXIT=FALSE;LOCK_TIMEOUT=60000</url>
<username>wso2carbon</username>
<password>wso2carbon</password>
<driverClassName>org.h2.Driver</driverClassName>
<maxActive>50</maxActive>
<maxWait>60000</maxWait>
<testOnBorrow>true</testOnBorrow>
<validationQuery>SELECT 1</validationQuery>
<validationInterval>30000</validationInterval>
26
<defaultAutoCommit>false</defaultAutoCommit>
</configuration>
</definition>
</datasource>
-->
<datasource>
<name>WSO2_CARBON_DB</name>
<description>The datasource used for registry and user
manager</description>
<jndiConfig>
<name>jdbc/WSO2CarbonDB</name>
</jndiConfig>
<definition type="RDBMS">
<configuration>
<url>jdbc:sqlserver://192.168.1.158:1433;databaseName=WSO2CARBON_DB</url>
<driverClassName>com.microsoft.sqlserver.jdbc.SQLServerDriver</driverClas
sName>
<username>sa</username>
<password>@r@nd@_852_159_p1$34.*</password>
<maxActive>50</maxActive>
<maxWait>60000</maxWait>
<testOnBorrow>true</testOnBorrow>
<validationQuery>SELECT 1</validationQuery>
<validationInterval>30000</validationInterval>
<defaultAutoCommit>false</defaultAutoCommit>
</configuration>
</definition>
</datasource>
<!-- For an explanation of the properties, see:
http://people.apache.org/~fhanik/jdbc-pool/jdbc-pool.html -->
<!--datasource>
<name>SAMPLE_DATA_SOURCE</name>
<jndiConfig>
<name></name>
<environment>
<property
name="java.naming.factory.initial"></property>
<property name="java.naming.provider.url"></property>
</environment>
</jndiConfig>
<definition type="RDBMS">
<configuration>
<defaultAutoCommit></defaultAutoCommit>
<defaultReadOnly></defaultReadOnly>
<defaultTransactionIsolation>NONE|READ_COMMITTED|READ
_UNCOMMITTED|REPEATABLE_READ|SERIALIZABLE</defaultTransactionIsolation>
<defaultCatalog></defaultCatalog>
<username></username>
<password
svns:secretAlias="WSO2.DB.Password"></password>
<maxActive></maxActive>
<maxIdle></maxIdle>
<initialSize></initialSize>
<maxWait></maxWait>
27
<dataSourceClassName>com.mysql.jdbc.jdbc2.optional.My
sqlXADataSource</dataSourceClassName>
<dataSourceProps>
<property
name="url">jdbc:mysql://localhost:3306/Test1</property>
<property name="user">root</property>
<property name="password">123</property>
</dataSourceProps>
</configuration>
</definition>
</datasource-->
</datasources>
</datasources-configuration>
6. Guarde el archivo de configuración master-datasources.xml
Nota: Modifique los siguientes parámetros dependiendo a su ambiente productivo.
1. “Url” teniendo en cuanta sus respectivas variables
a. jdbc:sqlserver://{ip}:{puerto};databaseName={nombreDB}
2. “userName”
3. “password”
Fuentes:
SQL Server
o https://docs.wso2.com/display/ADMIN44x/Setting+up+Microsoft+SQL
o https://docs.wso2.com/display/ADMIN44x/Changing+to+MSSQL
Oracle
o https://docs.wso2.com/display/ADMIN44x/Changing+to+Oracle
28
Permisos de usuarios
Asigne a los usuarios recién creados las concesiones / permisos necesarios para:
Iniciar sesión
Crear tablas
Insertar
Indexar
Seleccionar
Actualizar y eliminar datos en tablas en la base de datos recién creada.
Estos son el conjunto mínimo de permisos de SQL Server.
Nota: se recomienda utilizar el mismo usuario que se creó para los productos ASDK y/o AFLS,
para la autenticación de la base de datos de ESB.
Configuración de base datos para motor Oracle
WSO-EI utiliza para su operación un motor de base de datos, siga estos pasos para configurar un
motor de base de datos Oracle.
1. Ingrese a su cliente de Oracle de su preferencia
2. Crear dos bases de datos en blanco para alojar los objetos necesarios para la
implementación local de WSO2-EI y WSO2-MB, con las siguientes características:
b. Nombre de la base de datos: “WSO2CarbonDB”
3. Cree un usuario y ejecute el script descrito a continuación para poder asignarles los
permisos requeridos por la aplicación.
4. CREATE USER <USER_NAME> identified BY password account unlock; 5. grant CONNECT TO <USER_NAME>; 6. grant CREATE session, CREATE TABLE, CREATE sequence, CREATE TRIGGER
TO <USER_NAME>;
7. COMMIT;
8. Ahora modifique la fuente de datos maestra del producto WSO1-EI que por defecto está
apuntando a un motor tipo H2, para ello abra el siguiente archivo de configuración
“C:\Program Files\WSO2\Enterprise Integrator\6.3.0\conf\datasources\master-
datasources.xml”
9. Comente la configuración por defecto y copie la siguiente configuración
1. <?xml version="1.0" encoding="UTF-8"?>
2. <datasources-configuration xmlns:svns="http://org.wso2.securevault/configuration">
3. <providers>
4. <provider>org.wso2.carbon.ndatasource.rdbms.RDBMSDataSourceReader</provider>
5. </providers>
6. <datasources>
29
7. <!--<datasource>
8. <name>WSO2_CARBON_DB</name>
9. <description>The datasource used for registry and user
manager</description>
10. <jndiConfig> 11. <name>jdbc/WSO2CarbonDB</name> 12. </jndiConfig> 13. <definition type="RDBMS"> 14. <configuration> 15. <url>jdbc:h2:./repository/database/WSO2CARBON_DB;DB_CLOSE_ON_EXIT
=FALSE;LOCK_TIMEOUT=60000</url>
16. <username>wso2carbon</username> 17. <password>wso2carbon</password> 18. <driverClassName>org.h2.Driver</driverClassName> 19. <maxActive>50</maxActive> 20. <maxWait>60000</maxWait> 21. <testOnBorrow>true</testOnBorrow> 22. <validationQuery>SELECT 1</validationQuery> 23. <validationInterval>30000</validationInterval> 24. <defaultAutoCommit>false</defaultAutoCommit> 25. </configuration> 26. </definition> 27. </datasource>--> 28. <datasource> 29. <name>WSO2_CARBON_DB</name> 30. <description>The datasource used for registry and user
manager</description>
31. <jndiConfig> 32. <name>jdbc/WSO2CarbonDB</name> 33. </jndiConfig> 34. <definition type="RDBMS"> 35. <configuration> 36. <url>jdbc:oracle:thin:@(DESCRIPTION = 37. (ADDRESS = (PROTOCOL = TCP)(HOST = BG-C-SRV2012R2.INTERSEQ.LOCAL)(PORT = 1521)) 38. (CONNECT_DATA = 39. (SERVER = DEDICATED) 40. (SERVICE_NAME = proyectos.INTERSEQ.LOCAL) 41. ))</url> 42. <username>AFLS</username> 43. <password>Aranda123</password> 44. <driverClassName>oracle.jdbc.OracleDriver</driverClassName> 45. <maxActive>80</maxActive> 46. <maxWait>60000</maxWait> 47. <minIdle>5</minIdle> 48. <testOnBorrow>true</testOnBorrow> 49. <validationQuery>SELECT 1 FROM DUAL</validationQuery> 50. <validationInterval>30000</validationInterval> 51. <defaultAutoCommit>false</defaultAutoCommit> 52. </configuration> 53. </definition> 54. </datasource> 55. <!-- For an explanation of the properties, see:
http://people.apache.org/~fhanik/jdbc-pool/jdbc-pool.html -->
56. <!--datasource> 57. <name>SAMPLE_DATA_SOURCE</name> 58. <jndiConfig> 59. <name></name> 60. <environment> 61. <property name="java.naming.factory.initial"></property> 62. <property name="java.naming.provider.url"></property> 63. </environment> 64. </jndiConfig> 65. <definition type="RDBMS"> 66. <configuration> 67. 68. <defaultAutoCommit></defaultAutoCommit> 69. <defaultReadOnly></defaultReadOnly> 70. <defaultTransactionIsolation>NONE|READ_COMMITTED|READ_UNCOMMITTED
|REPEATABLE_READ|SERIALIZABLE</defaultTransactionIsolation>
71. <defaultCatalog></defaultCatalog> 72. <username></username>
30
73. <password svns:secretAlias="WSO2.DB.Password"></password> 74. <maxActive></maxActive> 75. <maxIdle></maxIdle> 76. <initialSize></initialSize> 77. <maxWait></maxWait> 78. 79. <dataSourceClassName>com.mysql.jdbc.jdbc2.optional.MysqlXADataSou
rce</dataSourceClassName>
80. <dataSourceProps> 81. <property
name="url">jdbc:mysql://localhost:3306/Test1</property>
82. <property name="user">root</property> 83. <property name="password">123</property> 84. </dataSourceProps> 85. 86. </configuration> 87. </definition> 88. </datasource--> 89. </datasources> 90. </datasources-configuration>
10. Modifique según su entorno los siguientes parámetros dentro de dicha configuración:
a. url :
b. username
c. password
11. Para determinar correctamente el parámetro “url”, siga estos pasos:
a. Diríjase a la ruta “\client_1\network\admin\tnsnames.ora”
12. Abra el archivo y copie tns name como se muestra a continuación
13. Pegue la configuración dentro de su “master-datasources.xml”, como la anterior
configuración.
31
Configurando el controlador JDBC para Oracle
1. Copie los controladores, de la ruta de instalación “InstalacionAESB\Tools\JDBC\Oracle”:
a. ojdbc5.jar
b. ojdbc6.jar
2. en la ruta:
a. C:\Program Files\WSO2\Enterprise Integrator\6.3.0\lib
32
Poblar Base de datos de WSO-EI para Oracle
Los siguientes pasos permiten realizar la inserción de los datos para el producto wso2-ei.
1. Para crear los objetos de WSO2-EI, ejecute el script (oracle.sql) que se encuentra en la
siguiente ruta.
a. “C:\Program Files\WSO2\Enterprise Integrator\6.3.0\dbscripts”
b. Base de datos “WSO2CarbonDB”.
Creación de servicios Windows
En este punto se detallan los pasos para poder crear los servicios Windows para el producto WSO2-
EI.
1. Verificar que la variable de entorno “EI_HOME” este creada como variable de entorno, si
no es asi, proceder a crearla,
a. Nombre: “EI_HOME”
b. Valor: “C:\Program Files\WSO2\Enterprise Integrator\6.3.0”
2. Cree la carpeta WinServices en la siguiente ruta “C:\Program Files\WSO2\WinServices”
3. Cree la carpeta ei_service en la siguiente ruta “C:\Program
Files\WSO2\WinServices\ei_service”
4. Descomprima el contenido del archivo “yajsw-stable-11.03.zip” en la ruta creada en el paso
anterior: “C:\Program Files\WSO2\WinServices\ei_home\”
5. Su estructura de archivos debe ser de la siguiente manera:
a. ”C:\Program Files\WSO2\WinServices\ei_home\yajsw-stable-11.03”.
33
34
6. Copiar el archivo wrapper.conf de la carpeta de instalación
“ESBInstall\InstalacionAESB\Tools\Packer\WSO2-EI\Ejemplo Server 136”
7. Reemplazar el wrapper.conf, que se encuentra en la ruta “C:\Program
Files\WSO2\WinServices\ei_service\yajsw-stable-11.03\conf”
8. Abra una consola de Windows
9. Ubicarse en la siguiente ruta
a. “C:\Program Files\WSO2\WinServices\ei_service\yajsw-stable-11.03\bat”
10. Ejecutar la siguiente instrucción
b. installService.bat
11. si el resultado es exitoso obtendrá una respuesta como la siguiente
12. Para confirmar que los servicios fueron instalados correctamente abra la opción de
Windows para listar los servicios instalados en el sistema, para ello vaya a panel de control
Herramientas administrativas servicios.
35
13. Corroborar que el servicio fue creado.
14. Regrese a las consolas de Windows y ejecuta el siguiente comando para iniciar los servicios
respectivamente.
c. startService.bat
Nota:
Si se requiere detener el servicio ejecute el siguiente comando
El inicio del servicio puede tardar uno minutos…. Aproximadamente 3 dependiendo del
performance del host.
stopService.bat
Si se requiere ejecutar la desinstalación del servicio ejecute el siguiente servicio
uninstallServiceService.bat
15. Realizar la prueba de que los servicios están ejecutándose correctamente para ello siga los
siguientes pasos respectivamente
d. WSO2-EI: https://localhost:9443/carbon/
Fuente: https://docs.wso2.com/display/EI630/Installing+as+a+Windows+Service
36
Creación de medios de configuración
Siga los siguientes pasos para crear los archivos de configuracion con los que trabaja ESB.
1. Entre a su consola de Enterprise integrator
2. Autentíquese como usuario administrador
a. User: admin
b. Pass: admin
3. Vaya a la sección “Registry” de recursos ubicada en el extremo inferior izquierdo como se
muestra en la figura.
4. Cree la misma estructura de archivos que se encuentra disponible en el siguiente directorio
“InstalacionAESB\Tools\ConfigurationResources\AESB”, a partir de la carpeta repository,
como se muestra a continuación.
37
5. La siguiente imagen ilustra cómo debería quedar su estructura de archivos.
Opción para agregar un directorio
Opción para agregar un archivo
38
39
Publicación de medios de integración (.CAR)
Una vez la instancia de Enterprise esté en funcionamiento y la creación de recursos internos
creados, procederemos a realizar la respectiva publicación de medios, necesarios para que le
integración funcione.
Advertencia: no ejecute este paso si no ha culminado por completo la creación de recursos internos.
1. Abra la consola de WSO2-EI https://localhost:9443/carbon/
2. Autenticarse con usuario administrador
a. Usuario: “admin”
b. Password: “admin”
3. Dentro de la consola dirigirse a la sección Manage
40
4. En carbón aplications
5. Pulse add para agregar un nuevo conjunto de recursos (.car)
6. Clic en choose file para seleccionar el archivo de publicación, que se encuentra en el
directorio “\InstalacionAESB\Tools\Car”
7. Finalmente, clic en upload para poder realizar la publicación.
8. Aparecerá una ventana emergente informando el estado de la publicación
41
9. Presione “F5” para recargar la sección de medios, si la publicación fue exitosa mostrara el
detalle del archivo .car publicado.
10. Si requiere ver el detalle de la publicación y que medios se publicaron hacer clic sobre el link
Aranda_ASDK_AFLS_EICompositeApplication
11. Verifique que los servicios tipo Rest fueron publicado
12. Diríjase a la sección Apis
42
13. Ya se puede observar las apis estarán disponibles
14. Si se requiere realizar un RollBack (eliminar la publicación) realizar los siguientes pasos
e. Entrar a la sección de publicación de recursos .CAR
f. Dar clic sobre el icono de papelera del archivo que desea eliminar
Nota:
Recuerde que al realizar la eliminación de un. CAR se eliminarán todos los recursos que fueron
publicados bajo el empaquetado. CAR
43
Configuración de WSO2-EI
A continuación, se detallan todas las configuraciones necesarias para el correcto funcionamiento
del ESB.
Para poder utilizar el xpath fn:replace dentro de WSO2-EI, el cual es necesario para que los
recursos desplegados funcionan correctamente y haga uso de esta funcionalidad realice los
siguientes pasos:
1. Abra el archivo “synapse.properties“
2. Ruta de acceso: “C:\Program Files\WSO2\Enterprise Integrator\6.3.0\conf”
3. Descomente la línea “synapse.xpath.dom.failover.enabled=true”
Para el correcto funcionamiento de adjuntar archivos es necesario realizar el en el siguiente
archivo de configuración:
Abra el archivo axis2.xml ubicado en la siguiente ruta:
“C:\Program Files\WSO2\Enterprise Integrator\6.3.0\conf\axis2\axis2.xml”
Descomente las siguientes configuraciones:
1. <messageBuilder contentType="multipart/form-
data" class="org.wso2.carbon.relay.BinaryRelayBuilder"/>
2. <messageFormatter contentType="multipart/form-
data" class="org.wso2.carbon.relay.ExpandingMessageFormatter"/>
Reinicie el Servicio del ESB, para que los cambios tenga efecto en su instancia
Para quitar las actualizaciones de JRE
Ejecutar “C:\Program Files\Java\jre1.8.0_181\bin\javacpl.exe” deshabilitar
actualizaciones automáticas
44
45
Configuracion de EndPoint productos.
La configuración de endpoints, Urls de los servicios que se va a integrar por medio del ESB se realiza
desde los archivos de configuración. Siga detalladamente estos pasos para configurar sus instancias
de los productos Aranda Service Desk y Aranda Field Service.
Pasos:
1. Entre a su consola de Enterprise integrator
2. Autentíquese como usuario administrador
a. User: admin
b. Pass: admin
3. Vaya a la sección “Registry” de recursos ubicada en el extremo inferior izquierdo como se
muestra en la figura.
46
4. Clic en la sección de Browse y expanda la estructura como se muestra a continuación, y
edite el archivo de configuración “AESB_GeneralConfiguration.xml”
47
5. A continuación, se presenta la estructura que debe ser configurada:
a. AFLS -> base: Ruta base del producto AFLS
b. aflsinstance -> ruta expuesta del producto AFLS en el ESB
c. ASDK -> base: Ruta base del producto ASDK
d. asdkinstance -> ruta expuesta del producto ASDK en el ESB
6. <?xml version="1.0" encoding="UTF-8"?> 7. <generalconfiguration> 8. <!--configuracion del producto AFLS--> 9. <!--instancia del producto AFLS--> 10. <afls>
11. <base>http://192.168.3.116/AFLS</base>
12. <aflsinstance>http://192.168.56.1:8280/afls</aflsinstan
ce>
13. <!--autenticacion usuarios integracion-->
14. <authenticationAdditionalFields>
15. <applicationId>34</applicationId>
16. <columnOrder>Id</columnOrder>
17. <concept>34001</concept>
18. <model>true</model>
19. <project>1</project>
20. <userId>5</userId>
21. </authenticationAdditionalFields>
22. </afls>
23. <!--configuracion del producto ASDK-->
24. <!--instancia del producto ASDK-->
25. <asdk>
26. <base>http://192.168.3.116/ASDKV8</base>
27. <asdkinstance>http://192.168.1.158:8280/services/</asdk
instance>
28. <!--autenticacion usuarios integracion-->
29. <authentication>
30. <username>administrator</username>
31. <password>123</password>
32. <consoleid>1</consoleid>
33. <isAnonymous>true</isAnonymous>
34. </authentication>
35. </asdk>
36. </generalconfiguration>
48
Configuración de Estados Notificables
AESB permite la notificación de cambios de estados, tanto desde el producto AFLS como ASDK, siga
los siguientes pasos para definir qué estados deben ser notificables en la integración de los dos
productos.
Pasos:
1. Entre a su consola de Enterprise integrator
2. Autentíquese como usuario administrador
a. User: admin
b. Pass: admin
3. Vaya a la sección “Registry” de recursos ubicada en el extremo inferior izquierdo como se
muestra en la figura.
4. Clic en la sección de Browse y expanda la estructura como se muestra a continuación, hasta
llegar a la sección de “Resources”
49
5. Abra el archivo de configuración para este fin “AESB_ReportableStates.xml”
<notification xmlns="aranda">
<row>
<thirdPartyName>AFLS</thirdPartyName>
<notifiableStates>1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20</notifiableStates>
</row>
<row>
<thirdPartyName>ASDK</thirdPartyName>
<notifiableStates>1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20</notifiableStates>
</row>
</notification>
6. Cada tag “ThirdPartyName” representa el producto y “notifiableStates” los estados que
deben ser reportados, de cada uno de los productos.
50
Configuración de Homologación de estados
AESB permite la homologación de campos entre los productos Aranda Service Desk y Aranda Field
Service, siga los siguientes pasos para definir los campos en cada uno de los productos y sus
respectivos homónimos en el otro producto.
Pasos:
1. Entre a su consola de Enterprise integrator
2. Autentíquese como usuario administrador
a. User: admin
b. Pass: admin
3. Vaya a la sección “Registry” de recursos ubicada en el extremo inferior izquierdo como se
muestra en la figura.
4. Clic en la sección de Browse y expanda la estructura como se muestra a continuación, hasta
llegar a la sección de “Resources”
51
Realizar las siguientes consultas para poder obtener los estados de cada uno de los productos:
ASDK o Select * from AFW_STATUS WHERE stat_app_category = 6
AFLS o SELECT from AFW_STATEMACHINE_STATES
Utilice el formato “FormatoHomologacionEstadosESB.XLSX”
52
5. Abra el archivo de configuración para este fin “AESB_HomologationFields.xml”
6. <?xml version="1.0" encoding="UTF-8"?>
7. <homologationFields xmlns="aranda">
8. <row>
9. <projectId>1</projectId>
10. <sourceProductName>ASDK</sourceProductName> 11. <targetProductName>AFLS</targetProductName> 12. <parameterName>state</parameterName> 13. <itemSource>30</itemSource> 14. <itemTarget>1</itemTarget> 15. </row> 16. <row> 17. <projectId>1</projectId> 18. <sourceProductName>ASDK</sourceProductName> 19. <targetProductName>AFLS</targetProductName> 20. <parameterName>state</parameterName> 21. <itemSource>32</itemSource> 22. <itemTarget>2</itemTarget> 23. </row> 24. <row> 25. <projectId>1</projectId> 26. <sourceProductName>ASDK</sourceProductName> 27. <targetProductName>AFLS</targetProductName> 28. <parameterName>state</parameterName> 29. <itemSource>34</itemSource> 30. <itemTarget>4</itemTarget> 31. </row> 32. <row> 33. <projectId>1</projectId> 34. <sourceProductName>ASDK</sourceProductName> 35. <targetProductName>AFLS</targetProductName> 36. <parameterName>state</parameterName> 37. <itemSource>34</itemSource> 38. <itemTarget>5</itemTarget> 39. </row> 40. <row> 41. <projectId>1</projectId> 42. <sourceProductName>AFLS</sourceProductName> 43. <targetProductName>ASDK</targetProductName> 44. <parameterName>state</parameterName> 45. <itemSource>1</itemSource> 46. <itemTarget>30</itemTarget> 47. </row> 48. <row> 49. <projectId>1</projectId> 50. <sourceProductName>AFLS</sourceProductName> 51. <targetProductName>ASDK</targetProductName> 52. <parameterName>state</parameterName> 53. <itemSource>2</itemSource> 54. <itemTarget>32</itemTarget> 55. </row> 56. <row> 57. <projectId>1</projectId> 58. <sourceProductName>AFLS</sourceProductName> 59. <targetProductName>ASDK</targetProductName> 60. <parameterName>state</parameterName> 61. <itemSource>4</itemSource> 62. <itemTarget>34</itemTarget> 63. </row> 64. <row> 65. <projectId>1</projectId> 66. <sourceProductName>AFLS</sourceProductName> 67. <targetProductName>ASDK</targetProductName> 68. <parameterName>state</parameterName> 69. <itemSource>5</itemSource> 70. <itemTarget>34</itemTarget> 71. </row> 72. </homologationFields>
53
1. Cada nodo row es una homologación entre los dos productos
a. projectId: identificador del proyecto ASDK que se va a configurar.
b. sourceProductName: nombre del producto origen
c. targetProductName: nombre del producto destino
d. parameterName: nombre del campo que se quiere homologar, para esta
integración utilizaremos el campo “state”
e. itemSource: identificador del estado origen
f. itemTarget: identificador del estado destino
54
Configuración de campo solución
AESB permite la notificación del campo solución, un campo dentro del producto AFLS que se notifica
al producto ASDK, para configurar siga los siguientes pasos:
Pasos:
1. Entre a su consola de Enterprise integrator
2. Autentíquese como usuario administrador
a. User: admin
b. Pass: admin
3. Vaya a la sección “Registry” de recursos ubicada en el extremo inferior izquierdo como se
muestra en la figura.
4. Clic en la sección de Browse y expanda la estructura como se muestra a continuación, hasta
llegar a la sección de “Resources”
55
Abra el archivo de configuración para este fin “AESB_SolutionFields.xml”
1. <?xml version="1.0" encoding="UTF-8"?>
2. <solutionField xmlns="aranda">
3. <integration source="AFLS" target="ASDK">
4. <solution sourceField="1" />
5. </integration>
6. <integration source="ASDK" target="AFLS">
7. <solution sourceField="1" />
8. </integration>
9. </solutionField>
1. Configure el identificador del campo adicional para cada uno de los productos que
corresponde al campo solución, para esta tarea se recomienda realizar la siguiente consulta
directamente en la base de datos del producto AFLS:
SELECT * FROM AFW_ADDITIONAL_FIELD
56
Configuración de EndPoints SOAP dinámicos
AESB permite configuracion de endpoint dinámicos para servicios SOAP, para realizar esta
configuracion siga los siguientes pasos:
Pasos:
1. Entre a su consola de Enterprise integrator
2. Autentíquese como usuario administrador
a. User: admin
b. Pass: admin
3. Vaya a la sección “Registry” de recursos ubicada en el extremo inferior izquierdo como se
muestra en la figura.
4. Clic en la sección de Browse y expanda la estructura como se muestra a continuación, hasta
llegar a la sección de “Resources/DynamicEndPoints/Aranda/ASDK/v8/”
5. Edite cada uno de los endpoints, asegurándose de configurar la Uri, port y Service de los
servicios que requiera.
57
a. Ejemplo:
6. Repita la edición con los servicios disponibles.
Configuración de WDSL dinámicos
AESB permite configuracion de wsdl (contratos) dinámicos, para realizar esta configuracion siga los
siguientes pasos:
Pasos:
1. Entre a su consola de Enterprise integrator
2. Autentíquese como usuario administrador
a. User: admin
b. Pass: admin
3. Vaya a la sección “Registry” de recursos ubicada en el extremo inferior izquierdo como se
muestra en la figura.
4. Clic en la sección de Browse y expanda la estructura como se muestra a continuación, hasta
llegar a la sección de “Resources/Wsdl/Aranda/ASDK/v8/”
58
5. Edite cada uno de los wsdl, asegurándose de configurar “Uri” de “Location” tanto para el
servicio como su puerto.
6. Repita, el mismo procedimiento para todos los wsdl (contratos)
Configuración de autenticación del producto ASDK
AESB permite la autenticación dinámica con el producto Aranda Service Desk, para realizar esta
configuración siga a continuación los siguientes pasos.
Nota: recuerde que la autenticación debe ser con el usuario de integración que posea todos los
privilegios de integración, este usuario debe estar creado tanto en ASDK como AFLS.
Pasos:
7. Entre a su consola de Enterprise integrator
8. Autentíquese como usuario administrador
a. User: admin
b. Pass: admin
59
9. Vaya a la sección “Registry” de recursos ubicada en el extremo inferior izquierdo como se
muestra en la figura.
10. Clic en la sección de Browse y expanda la estructura como se muestra a continuación, hasta
llegar a la sección de “Resources”
11. Abra el archivo de configuración para este fin “ASDK_Authentication.xml”
<?xml version="1.0" encoding="UTF-8"?>
<authentication>
<username>administrator</username>
<password>123</password>
<consoleid>1</consoleid>
<isAnonymous>true</isAnonymous>
60
</authentication>
12. Username: nombre de usuario administrador
13. Password: contraseña del usuario administrador
14. consoleId: identificador de la consola en ASDK
15. isAnonumous: modo de autenticación por defecto true
61
Configuración de autenticación del producto AFLS
AESB permite la autenticación dinámica con el producto Aranda Field Service, para realizar esta
configuración siga a continuación los siguientes pasos.
Nota: Antes de realizar la configuración de autenticación, cree el usuario tipo WEB en el producto
Aranda Field Service con las siguientes características:
1. nombre: IntegratorInventory
2. usuario: IntegratorInventory
3. correo: [email protected]
4. roles: Despachador, Gestor de inventario
Pasos:
1. Entre a su consola de Enterprise integrator
2. Autentíquese como usuario administrador
a. User: admin
b. Pass: admin
3. Vaya a la sección “Registry” de recursos ubicada en el extremo inferior izquierdo como se
muestra en la figura.
62
4. Clic en la sección de Browse y expanda la estructura como se muestra a continuación, hasta
llegar a la sección de “Resources”
5. Abra el archivo de configuración para este fin “AFLS_Authentication.xml”
6. <?xml version="1.0" encoding="UTF-8"?>
7. <authentication>
8. <username>IntegratorInventory</username>
9. <password>654321</password>
10. </authentication>
63
11. Username: nombre de usuario administrador
12. Password: contraseña del usuario administrador
13. consoleId: identificador de la consola en ASDK
14. isAnonumous: modo de autenticación por defecto true.
Anexos
1. Para integraciones donde la infraestructura sea Cloud y además se tenga programado el
apagado automático de la virtual Machine se aconseja crear una tarea programada de
Windows para poder iniciar el servicio del ESB, siga los siguientes pasos para iniciar el ESB.
a. Cree un archivo con extensión .bat de nombre “StartWSO2.bat”
b. Edite dicho archivo y pegue la siguiente línea de código
i. NET START {nombre del servicio ESB}
ii. Ejemplo NET START WSO2EI
c. Guarde los cambios
d. Crear la carpeta “StartService” en la siguiente ruta: “C:\Program Files\WSO2”
e. Copie el archivo “StartWSO2.bat” en el siguiente directorio creado en el paso “d”
f. Abrir el programador de tareas de Windows
g. Configure la tarea con los siguientes parámetros
i. Nombre: StartESB
1. Habilitar la opción, correr con todos los privilegios
ii. Descripción: Permite iniciar el servicio de ESB
iii. Desencadenadores: Al iniciar el sistema => Habilitado
iv. Acciones: Iniciar un programa => Detalles => Programa o Script =>
"C:\Program Files\WSO2\StartService\StartWSO2.bat"
64
Consideraciones
1. Para poder crear usuarios mediante la API de usuarios de ASDK es necesario tener un
proyecto por defecto para consultarlo ejecute el siguiente script:
a. SELECT * FROM SETINGENERAL where SETID = 2128
b. Para consultar los identificadores del proyecto
i. SELECT * FROM ASDK_PROJECTS –Proyectos
2. De igual manera poder crear usuarios mediante la API de usuarios de ASDK es necesario
tener creada la plantilla de correo necesaria en el momento de crear dicho usuario, para
comprobar que está creada en BD ejecutar el siguiente script:
a. SELECT * FROM AFW_CONFIG_MAIL
Top Related