manual instalación en producción aranda enterprise service

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

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”.

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

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 “”.

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>




<jndiConfig>


</jndiConfig>


<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>

26


</configuration>

</definition>

</datasource>

-->

<datasource>




<jndiConfig>


</jndiConfig>


<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>







</configuration>

</definition>

</datasource>



<!--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>


<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

https://docs.wso2.com/display/ADMIN44x/Setting+up+Microsoft+SQL

https://docs.wso2.com/display/ADMIN44x/Changing+to+MSSQL

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>

http://www.oracle.com/pls/db92/db92.drilldown?word=CREATE

http://www.oracle.com/pls/db92/db92.drilldown?word=USER

http://www.oracle.com/pls/db92/db92.drilldown?word=BY

http://www.oracle.com/pls/db92/db92.drilldown?word=CONNECT

http://www.oracle.com/pls/db92/db92.drilldown?word=TO



http://www.oracle.com/pls/db92/db92.drilldown?word=TABLE



http://www.oracle.com/pls/db92/db92.drilldown?word=TRIGGER

http://www.oracle.com/pls/db92/db92.drilldown?word=TRIGGER

http://www.oracle.com/pls/db92/db92.drilldown?word=TO

http://www.oracle.com/pls/db92/db92.drilldown?word=COMMIT

29

7.  28. <datasource> 29. <name>WSO2_CARBON_DB</name> 30. <description>The datasource used for registry and user


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. 

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”.

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

https://localhost:9443/carbon/

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

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

https://localhost:9443/carbon/

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

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:



a. User: admin

b. Pass: admin



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.  9.  10. <afls>

11. <base>http://192.168.3.116/AFLS</base>

12. <aflsinstance>http://192.168.56.1:8280/afls</aflsinstan

ce>

13. 

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. 

24. 

25. <asdk>

26. <base>http://192.168.3.116/ASDKV8</base>

27. <asdkinstance>http://192.168.1.158:8280/services/</asdk

instance>

28. 

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:



a. User: admin

b. Pass: admin



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:



a. User: admin

b. Pass: admin





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”


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:



a. User: admin

b. Pass: admin





55

Abra el archivo de configuración para este fin “AESB_SolutionFields.xml”


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

https://192.168.1.158:9443/carbon/resources/resource.jsp?region=region3&item=resource_browser_menu&viewType=std&path=/_system/config/repository/AESB/Resources/AESB_SolutionFields.xml

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:



a. User: admin

b. Pass: admin




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:



a. User: admin

b. Pass: admin




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:



a. User: admin

b. Pass: admin

59





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:



a. User: admin

b. Pass: admin



mailto:[email protected]

62



5. Abra el archivo de configuración para este fin “AFLS_Authentication.xml”


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

manual instalación en producción aranda enterprise service

Documents