Preparación del entorno para dividir el proceso entre diversos servidores de integración

Al dividir el proceso de flujo de mensajes entre servidores de integración diferentes, debe configurar un direccionador de datos y un agente de conectividad. Los servidores de integración puede estar ejecutándose en distintos nodos de integración.

Acerca de esta tarea

Cuando se divide el proceso entre servidores de integración diferentes, los flujos se comunican de forma segura mediante un servidor de conmutación y agentes de conectividad. El servidor de conmutación es un servidor de integración especial que direcciona datos. Los agentes de conectividad contienen los certificados que los flujos necesitan para comunicarse de forma segura con el servidor de conmutación. Un agente de conectividad debe estar en ejecución en cada servidor de integración donde haya desplegado flujos de mensajes.

Si los flujos invocables y los flujos que los llaman se despliegan todos en local, debe crear y configurar el servidor de conmutación en local. Debe ejecutar un mandato que cree algunos archivos de configuración. Utilizará uno de los archivos de configuración para crear el servidor de conmutación y el otro archivo para configurar agentes de conectividad para cada servidor de integración donde ha desplegado flujos invocables o flujos que los invocan. En este tema se proporcionan los pasos para este procedimiento.

Este escenario local solo está soportado en Windows y Linux® .

Si distribuye el procesamiento entre IBM App Connect Enterprise, IBM y App Connect Enterprise as a Service, el servidor Switch se crea y gestiona automáticamente en la nube. Debe descargar un archivo de configuración de agente de la nube y utilizarlo para configurar el agente de conectividad local para cada servidor de integración. Para obtener más información sobre cómo configurar los agentes de conectividad para su uso con App Connect Enterprise as a Service, consulte «Preparación del entorno para dividir el procesamiento entre IBM App Connect Enterprise y IBM » en App Connect Enterprise as a Service.

Para preparar el entorno para dividir el proceso entre servidores de integración localmente, realice los pasos siguientes.

1. Inicie un entorno de mandatos de App Connect Enterprise .
2. Cree los archivos de configuración necesarios, ejecutando el mandato iibcreateswitchcfg .
   Es necesario ejecutar el mandato en un directorio sobre el que tenga permiso de grabación. De forma alternativa, puede especificar un directorio de salida. Por ejemplo, el mandato siguiente crea los archivos de configuración y los guarda en el directorio temp.

   En Windows:

   iibcreateswitchcfg /output c:\temp

   En Linux:

   iibcreateswitchcfg -output /temp

   Si este mandato se ejecuta satisfactoriamente, verá las siguientes respuestas:

   BIP9382I: Generated the self-signed certificate file 'c:\temp\adminClient.p12'.
   BIP9383I: Generated the switch server configuration file 'c:\temp\switchserver.json'.
   BIP9384I: Generated the connectivity agents configuration file 'c:\temp\switchclient.json'.

   Este mandato crea dos archivos de configuración JSON y un certificado, que se reserva para su uso futuro. El archivo switchserver.json se utiliza para crear el servidor de conmutación. El archivo switchclient.json se utiliza para configurar el agente para cada servidor de integración donde se despliegan los flujos.
3. Para crear el servidor de conmutación, ejecute el mandato iibswitch para utilizar el archivo de configuración switchserver.json , tal como se muestra en los ejemplos siguientes.
   En Windows, ejecute el mandato siguiente.

   iibswitch create switchserver /config c:\temp\switchserver.json

   En Linux, ejecute el mandato siguiente:

   iibswitch create switchserver -c /temp/switchserver.json

   Cuando se crea el servidor de conmutación, verá unSuccessful command completionRespuesta. El servidor Switch se crea en un nodo de integración especial denominado ACESWITCH_NODE_V13.
4. Opcional: Para probar que el servidor de conmutación se ha creado y está en ejecución, ejecute el mandato siguiente.

   mqsilist ACESWITCH_NODE_V13

   Si el servidor de conmutación se está ejecutando, verá la respuesta siguiente.

   BIP1286I: Integration server 'ACESWITCH_SERVER' on integration node 'ACESWITCH_NODE_V13' is running.
   BIP8071I: Successful command completion.

5. Para configurar agentes de conectividad, copie el archivo de configuración switchclient.json en el directorio switch de cada servidor de integración donde ha desplegado flujos invocables o de llamada.
   • Para un servidor de integración independiente, el directorio switch está en work directory/config/switch.
   • Para un servidor de integración bajo un nodo de integración, el directorio switch se encuentra en $MQSI_WORKPATH/config/Node_name/Server_name/switch.
   Para cada servidor de integración afectado, el agente se conecta al servidor de conmutación automáticamente y verá un mensaje de confirmación. Se muestra el mensaje siguiente para un servidor de integración independiente en la consola de App Connect Enterprise .

   The connection agent for remote callable flows has established a connection to the Switch server with URL 'wss://localhost:9011'.
   The integration server component 'switchclient' has been started.

   En el registro de aplicaciones de Windows , verá los mensajes siguientes para un servidor de integración (N101ISAA) bajo un nodo de integración (NODEIPL01).

   ( NODEIPL01.N101ISAA ) The connection agent for remote callable flows has established a connection to the Switch server with URL ''wss://localhost:9011''.   
   A connection agent for remote callable flows has been configured on this integration server. The connection agent has successfully connected to the Switch server.   
   No response required.  
   ––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––––-
   ( NODEIPL01.N101ISAA ) The integration server component ''switchclient'' has been started.   
   The specified component has been started and is available for use.   
   No response required.