Configurar un servidor de integración modificando el archivo " server.conf.yaml

Puede configurar su servidor de integración de IBM® App Connect Enterprise modificando las propiedades en un server.conf.yaml archivo de configuración. La ubicación del archivo server.conf.yaml que ha de modificar depende de si está configurando un servidor de integración independiente o un servidor de integración gestionado por un nodo de integración.

Antes de empezar

Configure su entorno de comandos, como se describe en ' Configurar un entorno de comandos.

Acerca de esta tarea

Cuando se crea un servidor de integración, se establecen propiedades en el archivo ' server.conf.yaml ' para configurar el funcionamiento del servidor de integración y los recursos asociados. Por ejemplo, puede establecer un puerto de administración REST y un puerto HTTPS. O bien, puede configurar el nivel de seguimiento, el registro de actividades, JVM y la generación de informes de datos estadísticos para su servidor de integración. También puede configurar el servidor de integración para registrar todos los mensajes que pasan a través de un flujo de mensajes y, a continuación, utilizar estos mensajes registrados para generar pruebas de unidad.

En el caso de un servidor de integración independiente, el archivo de configuración " server.conf.yaml " se crea automáticamente cuando se utiliza el comando " mqsicreateworkdir " para crear un directorio de trabajo para el servidor de integración. El archivo server.conf.yaml se crea en la raíz del directorio de trabajo especificado: <work directory>/server.conf.yaml.

Si utiliza cualquiera de los mandatos que modifican el servidor de integración, se crea un directorio de alteraciones temporales bajo el directorio de trabajo para el servidor de integración. Este directorio overrides contiene un archivo de configuración extra ' server.conf.yaml ', que contiene valores de propiedades que son establecidos por comandos; por ejemplo, ' <work directory>/overrides/server.conf.yaml. Los valores de las propiedades de este archivo ' overrides/server.conf.yaml ' anulan cualquier valor que establezca en el archivo ' server.conf.yaml del servidor de integración (<work directory>/server.conf.yaml).

Si se ha establecido una propiedad en el archivo server.conf.yaml del servidor de integración, y también en el directorio overrides (/overrides/server.conf.yaml), se utiliza el valor de propiedad establecido en el directorio overrides. Por lo tanto, si un servidor de integración no está utilizando la configuración esperada, compruebe si el valor de la propiedad esperada en el archivo ' server.conf.yaml del directorio overrides está anulado por un comando. Para anular manualmente los ajustes resultantes de los comandos, edite la propiedad en el archivo ' server.conf.yaml ' del directorio overrides, o elimine la entrada del directorio overrides y modifique el archivo base ' server.conf.yaml.

En el caso de los servidores de integración gestionados por un nodo de integración, cada servidor tiene su propio archivo de configuración server.conf.yaml que altera temporalmente los valores comunes del archivo de configuración node.conf.yaml del nodo de integración. Al crear un nodo de integración, el archivo " node.conf.yaml " se encuentra en " $MQSI_WORKPATH/components/<Node name>/node.conf.yaml.

Si utiliza mandatos para modificar el nodo de integración, los cambios se guardan en el archivo node.conf.yaml de sustitución del nodo de integración. Este archivo se encuentra en ' $MQSI_WORKPATH/components/<Node name>/overrides/node.conf.yaml, tal y como se describe en Creación de un nodo de integración mediante la línea de comandos. Cuando se crea un servidor de integración gestionado para un nodo de integración, se crean valores específicos del servidor para el mismo en su propio archivo server.conf.yaml. El archivo específico del servidor está en ' $MQSI_WORKPATH/components/<Node name>/servers/<Server name>/server.conf.yaml.

Si utiliza mandatos para modificar este servidor de integración, los cambios se guardan en: $MQSI_WORKPATH/components/<Node name>/servers/<Server name>/overrides/server.conf.yaml. Los valores de las propiedades en este archivo ' overrides/server.conf.yaml ' anulan cualquier valor que establezca en el archivo ' <Node name>/servers/<Server name>/server.conf.yaml.

Procedimiento

  1. Si el servidor de integración todavía no existe, puede crearlo siguiendo las instrucciones de Creación de un servidor de integración.
  2. Utilice un editor YAML para abrir el archivo server.conf.yaml .

    Puede editar el archivo utilizando el editor YAML integrado que se proporciona en el kit de herramientas IBM App Connect Enterprise. Haga doble clic en el archivo en la vista Desarrollo de aplicaciones o haga clic con el botón derecho del ratón en el archivo y seleccione Abrir con > Editor YAML. Si edita el archivo utilizando un editor de texto plano, no incluya ningún carácter de tabulación (que no son válidos en YAML) y utilice una herramienta de validación de YAML para validar el contenido de su archivo.

  3. Modifique las propiedades que quiera cambiar en el archivo. Todas las propiedades se describen en el archivo YAML.
    Por ejemplo, puede modificar las siguientes propiedades.
    • En la sección " RestAdminListener ", establezca un valor para la propiedad " Port " que utilizará el puerto de administración REST, que es el método principal de comunicación con el servidor de integración. (Valor predeterminado de 7600).
    • En la sección ' ResourceManagers / HTTPConnector ', establece un valor para el ' ListenerPort ' para que puedas enviar mensajes a un flujo que esté utilizando un nodo HTTPInput. (Valor predeterminado de 7800).
    • En la sección ' ResourceManagers / JVM ', establece un valor para el ' jvmDebugPort ' para que puedas utilizar el Depurador de Flujo. Por ejemplo, establezca esta propiedad en 6511.

    También puede configurar el servidor de integración para que registre todos los mensajes que pasan por un flujo de mensajes, estableciendo propiedades en la sección ' RecordedMessageManager del archivo ' server.conf.yaml '. A continuación, puede utilizar estos mensajes grabados para generar pruebas unitarias para el flujo, como se describe en " Generación de pruebas a partir de mensajes grabados en un flujo de mensajes.

  4. Guarde los cambios en el archivo server.conf.yaml .

    Si ejecuta cualquier comando que modifique el servidor de integración después de establecer las propiedades en el archivo ' server.conf.yaml ', se creará un directorio overrides bajo el directorio de trabajo para el servidor de integración. Este directorio overrides contiene otro archivo de configuración ' server.conf.yaml ', que contiene valores de propiedades que se establecen mediante comandos; por ejemplo, ' <work directory>/overrides/server.conf.yaml. Los valores de las propiedades en este archivo ' overrides/server.conf.yaml ' anulan cualquier valor que establezcas en el archivo ' server.conf.yaml del servidor de integración (<work directory>/server.conf.yaml). Para anular manualmente los valores resultantes de los comandos, edite la propiedad en el archivo ' server.conf.yaml ' del directorio overrides, o elimine la entrada del directorio overrides y modifique el archivo base ' server.conf.yaml '.

  5. Especifique las credenciales de seguridad que utilizará el servidor de integración cuando se conecte a un recurso protegido (como una base de datos).
    • Puede configurar un servidor de integración independiente para conectarse a recursos protegidos utilizando credenciales almacenadas en formato cifrado en una caja fuerte de App Connect Enterprise . Puede configurar las credenciales de seguridad mediante el comando mqsicredentials o la API REST administrativa. Especifique el directorio de trabajo del servidor de integración que ha creado en el paso 1. Las credenciales cifradas se almacenan en la bóveda del servidor de integración, que puedes configurar mediante el comando mqsivault. Para obtener más información, consulte Configuración de credenciales de seguridad cifradas. Por ejemplo, para crear la caja fuerte del servidor de integraciones:
      mqsivault --work-dir c:\myaceworkdir --vault-key vaultKey --create
      Para configurar credenciales de seguridad:
      mqsicredentials --work-dir c:\myaceworkdir --vault-key vaultkey --create --credential-type jdbc --credential-name secID --username iibuser --password password

      Para obtener más información sobre los tipos de credenciales, consulte Tipos de credenciales.

    • De forma alternativa, puede utilizar el mandato mqsisetdbparms . Utilice el parámetro ' -w ' para especificar el directorio de trabajo del servidor de integración que creó en el paso 1, como se muestra en el siguiente ejemplo.
      mqsisetdbparms -w c:\myaceworkdir -n jdbc::secID -u iibuser -p password

      Cuando ejecuta este comando, el ID de usuario y la contraseña se almacenan de forma segura en el almacén de credenciales de IBM App Connect Enterprise. Para obtener más información sobre el uso del mqsisetdbparms comando, consulte el comando mqsisetdbparms.

  6. Opcional: ' ' Puede configurar las aplicaciones para que se ejecuten cuando se inicie el servidor de integración, añadiendo el archivo BAR a la carpeta ' run del directorio de trabajo del servidor de integración. Para obtener más información, consulte el comando mqsibar.
  7. Reinicie el servidor de integración. Las propiedades que ha establecido en el archivo server.conf.yaml entrarán en vigor cuando se inicie el servidor de integración. Si vuelve a modificar estas propiedades, debe volver a iniciar el servidor de integración para que entren en vigor los cambios siguientes. Para obtener más información, consulte Inicio de un servidor de integración.

    Si el servidor de integración no se reinicia, compruebe si el fallo se debe a un error de análisis de YAML. Para un servidor de integración independiente, se notifican los errores de análisis en el registro stderr. Para un servidor de integración gestionado por un nodo de integración, se notifican los errores de análisis YAML en el archivo console.txt del servidor de integración. Para obtener más información, consulte Registros estándar del sistema.