IBM Cloud Docs
Iniciación a Managed File Transfer

Iniciación a Managed File Transfer

¿Qué es IBM MQ Managed File Transfer (MFT)?

IBM® MQ Managed File Transfer (MFT) transfiere archivos entre sistemas de forma fiable, gestionada y segura. Las actividades de transferencia de archivos se registran y esto se puede utilizar para el registro de actividades. Puede configurar agentes de Managed File Transfer y habilitar gestores de colas para que realice transferencias. Managed File Transfer (MFT) ofrece dos topologías:

  1. Topología de un solo gestor de colas: utiliza un solo gestor de colas como gestor de colas de agente, gestor de colas de mandatos y gestor de colas de coordinación. Estos términos se describen en la siguiente sección.

  2. Topología de varios gestores de colas: utiliza varios gestores de colas que actúan como gestor de colas de agente, gestor de colas de mandatos y gestor de colas de coordinación. En concreto, esta topología requiere como mínimo 3 gestores de colas: uno que actúa como gestor de colas de coordinación, uno como gestor de colas de agente de origen (para crear un agente de Managed File Transfer) y como gestor de colas de mandatos, y un tercer gestor de colas que actúa como gestor de colas de agente de destino (para crear otro agente de transferencia de archivos) y como gestor de colas de mandatos.

    Nota: en la topología de varios gestores de colas, puede tener todos los gestores de colas necesarios en la nube, todos en el entorno local o una combinación de ambos.

MFT es un componente integrado de IBM MQ Advanced. Para ver los detalles más recientes y completos sobre este producto, consulte Managed File Transfer en IBM Knowledge Center.

Componentes de IBM MFT

Hay tres componentes principales de IBM MQ Managed File Transfer. Estos tres componentes se describen a continuación:

  1. Gestor de colas de coordinación: responsable de la recopilación del estado del agente, del estado de la transferencia y de la información sobre la actividad de transferencia.
  2. Gestor de colas de mandatos: el gestor de colas de interfaz que enlaza los mandatos de MFT y la infraestructura MQ. Por ejemplo, podemos enviar un mandato de transferencia de archivos MFT a un gestor de colas de mandatos que indique al agente que inicie o cancele una transferencia.
  3. Agentes: cada agente tiene su propio conjunto de colas asociadas con un gestor de colas (gestor de colas de agente) y es la clave para enviar y recibir los archivos que se transfieren. Por lo tanto, los agentes se crean en el sistema desde el que se transfieren o al que se transfieren los archivos.

En esta guía de aprendizaje se incluye lo siguiente:

  1. Configuración de gestores de colas de MQ on Cloud como gestores de colas de coordinación, de mandatos y de agente de MFT y creación de agentes de MFT (como agentes de origen y de destino). En la guía de aprendizaje se proporcionan los pasos a seguir para ambas topologías soportadas.

    • 1.1: Topología de un solo gestor de colas: se configura un solo gestor de colas como gestor de colas de agente, gestor de colas de mandatos y gestor de colas de coordinación.
    • 1.2: Topología de varios gestores de colas: en esta topología se utilizan varios gestores de colas.
  2. Realización de una transferencia de archivos


Requisitos previos

Para continuar con esta guía de aprendizaje, es vital que haya completado los requisitos previos siguientes:

  1. Conocimiento básico de MFT: para obtener una idea básica de cómo funciona MFT con IBM MQ, consulte ¿Cómo funciona MFT con IBM MQ? en IBM Knowledge Center.

    Para obtener información más detallada sobre MFT, consulte Managed File Transfer en IBM Knowledge Center.

  2. Cree un gestor de colas de IBM MQ on Cloud

    Si todavía no tiene un gestor de colas de IBM MQ on Cloud, puede crear uno siguiendo la visita guiada aquí: Iniciación a IBM MQ on Cloud Después de seguir la visita guiada, o los pasos manuales proporcionados en la misma página, o si va a utilizar un gestor de colas MQ on Cloud existente, debería tener:

    • Un gestor de colas MQ on Cloud
    • Detalles de conexión descargados en un archivo connection_info.txt
      • Consulte el Apéndice 1 que hay al final de esta guía de aprendizaje si no tiene este archivo
    • Un nombre de usuario de administrador y una clave de API descargados en un archivo platformApiKey.json
      • Consulte el Apéndice 2 que hay al final de esta guía de aprendizaje si no tiene este archivo
  3. Cliente de IBM MQ: Para completar esta guía de aprendizaje, necesitará la herramienta de línea de mandatos de IBM MQ 'runmqsc' instalada y en la vía de acceso. Si no tiene estos mandatos, puede conseguirlos mediante la instalación del Cliente IBM MQ. En el Apéndice 3 al final de esta guía de aprendizaje se detalla cómo hacerlo.

  4. Componente MFT de IBM MQ: Para instalar el componente MFT de IBM MQ, consulte Instalación de Managed File Transfer en IBM Knowledge Center.


Configuración del entorno de terminal

  1. Abra una ventana del terminal

    • Este terminal será el terminal de administración, que se utiliza para configurar el gestor de colas de coordinación.
  2. Especifique los detalles del gestor de colas en una variable de entorno MQSERVER en el terminal de administración siguiendo los pasos siguientes:

    • La CLI de runmqsc necesita que se especifique una variable de entorno para identificar el gestor de colas remoto al que se debe conectar. En el terminal de administración, exporte la variable MQSERVER con el siguiente mandato:

    • Para Windows: SET MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)

    • Para Linux: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<HOSTNAME>(<PORT>)"

      • <HOSTNAME> - es 'hostname' en el archivo connection_info.txt
      • <PORT> - es 'listenerPort' en el archivo connection_info.txt

Este paso es necesario en cualquier terminal nuevo que se vaya a utilizar para la administración remota de un gestor de colas, por ejemplo cuando se utiliza runmqsc cli


Paso 1: Configurar MQ on Cloud Queue Manager para Managed File Transfer (MFT)

En esta sección se le guiará por el proceso de configuración de un gestor de colas de MQ en Cloud como gestor de colas de agente. Existen dos topologías ampliamente utilizadas para esta configuración. Puede elegir cualquiera de las configuraciones y luego seguir la sección adecuada:

  • 1.1. Topología de un solo gestor de colas: en esta topología se configura un gestor de colas de modo que realice todas las operaciones de MFT. Para ello, se debe configurar como gestor de colas de coordinación, gestor de colas de mandatos y gestor de colas de agente. Pulse aquí para seguir los pasos.

  • 1.2. Topología de varios gestores de colas: en esta topología, se crean tres gestores de colas que realizarán las operaciones de MFT. Los llamaremos QMCOORD, QMSRC y QMDEST. Pulse aquí para seguir los pasos.


Paso 2: Iniciar una transferencia de archivos

En esta sección, verificamos nuestra configuración de MFT realizando una transferencia de archivos. En la actualidad, las transferencias de archivos MFT se pueden crear mediante la interfaz de línea de mandatos (CLI) de MFT o mediante el separador MFT de la herramienta MQ Explorer. En esta guía de aprendizaje se realiza la transferencia de archivos mediante la CLI de MFT. El mandato fteCreateTransfer crea e inicia una nueva transferencia de archivos desde la línea de mandatos. Este mandato puede iniciar una transferencia de archivos inmediatamente, planificar una transferencia de archivos para una fecha y hora futuras, repetir una transferencia planificada una o varias veces y desencadenar una transferencia de archivos en función de determinadas condiciones.

Para simplificar, en esta guía de aprendizaje solo crearemos una transferencia inmediata. Siga las instrucciones que encontrará aquí para iniciar una transferencia.

Para obtener más detalles sobre la transferencia, consulte este enlace de MFT Knowledge Center


Apéndice

Apéndice 1: connection_info.txt

Para recuperar el archivo connection_info.txt que contiene detalles de conexión del gestor de colas:

  1. Inicie sesión en la instancia de servicio IBM Cloud haciendo clic en el servicio correspondiente que se muestra en la tabla Imagen que muestra la instancia de servicio
  2. Se abrirá la vista del gestor de colas. Seleccione el gestor de colas del que desea recuperar la información de conexión Imagen que muestra la lista de gestores de colas
  3. Haga clic en Información de la conexión. Imagen de la información de conexión del gestor de colas
  4. Descargue este archivo en 'formato de texto JSON'

Apéndice 2: platformApiKey.json

Para crear o restablecer la clave de api de administrador:

  1. Inicie sesión en la instancia de servicio IBM Cloud haciendo clic en el servicio correspondiente que se muestra en la tabla Imagen que muestra la instancia de servicio

  2. Se abrirá la vista del gestor de colas. Seleccione el gestor de colas del que desea recuperar la información de conexión Imagen que muestra la lista de gestores de colas

  3. A continuación, seleccione la pestaña Administración. Imagen que muestra la pestaña Administración del gestor de colas resaltada

  4. Ahora pulse Restablecer clave de API de IBM Cloud / Crear clave de API de IBM Cloud

    • Note: The previous admin API key for this MQ Username will no longer be valid

    Image showing administration API key create button highlighted

    • Note: If the button says Create IBM Cloud API Key, then you have not created an api key in this way before. Click the Create IBM Cloud API Key button.
    1. Click Download to download platformApiKey.json containing an admin username and apikey Image showing the Download button for the admin new API key highlighted

Apéndice 3: Cliente C de IBM MQ

Si no tiene la herramienta de línea de mandatos del Cliente IBM MQ y los ejemplos (runmqsc, amqsputc, amqsgetc), puede descargarlos desde aquí

  1. Seleccione el paquete más reciente como se muestra a continuación, la última versión en el momento de redactar esto es la 9.0.5 Imagen que muestra las versiones de cliente de IBM MQ
  2. Seleccione el cliente redistribuible IBM MQC para [Su sistema operativo]' marcando la casilla situada a la izquierda del paquete, como se muestra a continuación. Debería contener Redist en el nombre de archivo. Esta guía de aprendizaje se ha creado utilizando el sistema operativo Linux Ubuntu Imagen que muestra la selección del cliente de MQ C redistribuible compatible con un sistema operativo
  3. Seleccione descargar por HTTPS, esto le permitirá descargar el cliente directamente a través de su navegador, como se muestra a continuación Imagen que muestra diversas opciones de descarga con HTTPS seleccionado
    • Nota: si no tiene esta opción, inténtelo con otro navegador.
  4. Después de pulsar continuar, se le redirigirá a la pantalla que se muestra a continuación. Pulse en el símbolo resaltado con un círculo rojo para comenzar la descarga Pulse en el icono indicado con un círculo rojo
  5. Una vez descargado, extraiga el archivo a un directorio de su elección <PATH_TO_MQCLIENT_DIR>
    • tar -xvzf <IBM-MQC-Redist>.tar.gz <PATH_TO_MQCLIENT_DIR>
  6. Añada mandatos a la variable path
    • export PATH=$PATH:<PATH_TO_MQCLIENT_DIR>/bin:<PATH_TO_MQCLIENT_DIR>/samp/bin

Apéndice 4: Ejemplo de archivo MQMFTCredentials.xml

Los archivos de este tipo almacenan información de credenciales para los procesos de agente. Pueden contener nombres de usuario y contraseñas que se utilizan para autenticarse con el gestor de colas de MQ on Cloud. A continuación se muestra un archivo de ejemplo al que se puede hacer referencia:

<?xml version="1.0" encoding="UTF-8"?>

<?xml version="1.0" encoding="UTF-8"?>
<tns:mqmftCredentials xmlns:tns="http://wmqfte.ibm.com/MQMFTCredentials" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://wmqfte.ibm.com/MQMFTCredentials MQMFTCredentials.xsd">
<tns:qmgr name="<QUEUE_MANAGER_NAME>" mqUserId="<ADMIN_MQ_USER>" mqPassword="<ADMIN_API_KEY>" useMQCSPAuthentication="true" />
</tns:mqmftCredentials>

- `<ADMIN_MQ_USER>` - this is 'mqUsername' in the file platformApiKey.json of your queue manager.
- `<QUEUE_MANAGER_NAME>` - this is 'queueManagerName' in the file connection_info.json of your queue manager.   
  • <ADMIN_API_KEY> = 'apiKey' en el archivo platformApiKey.json del gestor de colas.

Para ver más información sobre el archivo MQMFTCredentials.xml, consulte el formato de archivo de credenciales de MFT en IBM Knowledge Center.