IBM Cloud Docs
MFT(Managed File Transfer) 시작하기

MFT(Managed File Transfer) 시작하기

IBM MQ Managed File Transfer(MFT)의 개념

IBM® MQ Managed File Transfer(MFT)는 관리되고 신뢰할 수 있는 안전한 방식으로 시스템 사이에서 파일을 전송합니다. 파일 전송 활동은 로그되며 이는 활동 로깅에 사용될 수 있습니다. MFT(Managed File Transfer) 에이전트를 구성하고 큐 관리자가 전송을 수행하게 할 수 있습니다. MFT(Managed File Transfer)는 두 가지 토폴로지를 제공합니다.

  1. 단일 큐 관리자 토폴로지: 단일 큐 관리자를 에이전트 큐 관리자, 명령 큐 관리자 및 조정 큐 관리자로 사용합니다. 이러한 용어는 다음 절에 설명되어 있습니다.

  2. 다중 큐 관리자 토폴로지: 에이전트 큐 관리자, 명령 큐 관리자 및 조정 큐 관리자 역할을 수행하는 다중 큐 관리자를 사용합니다. 보다 구체적으로 이 토폴로지에는 3개 이상의 큐 관리자가 필요합니다. 하나는 조정 큐 관리자 역할을 수행하고 다른 하나는 소스 에이전트 큐 관리자(MFT(Managed File Transfer) 에이전트 작성용) 및 명령 큐 관리자 역할을 수행하고 세 번째 큐 관리자는 대상 에이전트 큐 관리자(또 다른 파일 전송 에이전트 작성용) 및 명령 큐 관리자 역할을 수행합니다.

    참고: 다중 큐 관리자 토폴로지에서는 필수 큐 관리자가 모두 클라우드에 있거나 모두 온프레미스에 있거나 이 둘의 혼합일 수 있습니다.

MFT는 IBM MQ Advanced의 통합된 컴포넌트입니다. 이 제품의 최신 전체 세부사항은 IBM Knowledge Center에서 MFT(Managed File Transfer)를 참조하십시오.

IBM MFT의 컴포넌트

IBM MQ Managed File Transfer의 기본 컴포넌트는 세 가지입니다. 이 세 컴포넌트가 아래에 설명되어 있습니다.

  1. 조정 큐 관리자: 에이전트 상태 수집, 상태 전송 및 활동 정보 전송을 담당합니다.
  2. 명령 큐 관리자: MFT 명령과 MQ 인프라를 연결하는 인터페이스 큐 관리자입니다. 예를 들어, MFT 파일 전송 명령을 명령 큐 관리자에 제출하여 에이전트가 전송을 시작하거나 취소하도록 지시합니다.
  3. 에이전트: 각각의 에이전트에는 큐 관리자(에이전트 큐 관리자)와 연관된 자체 큐 세트가 있으며 이 큐 세트는 전송되는 파일을 송수신하는 데 필요한 키입니다. 따라서 파일이 전송될 시스템에서 에이전트가 작성됩니다.

이 튜토리얼에서 다루는 내용은 다음과 같습니다.

  1. MQ on Cloud 큐 관리자를 MFT 조정, 명령 및 에이전트 큐 관리자로 구성한 후 MFT 에이전트를 소스 또는 대상 에이전트로 작성합니다. 이 튜토리얼에서는 지원되는 두 토폴로지 모두에 대한 단계를 제공합니다.

    • 1.1: 단일 큐 관리자 토폴로지: 단일 큐 관리자가 에이전트 큐 관리자, 명령 큐 관리자 및 조정 큐 관리자로 구성됩니다.
    • 1.2: 다중 큐 관리자 토폴로지: 이 토폴로지에서는 다중 큐 관리자가 사용됩니다.
  2. 파일 전송을 수행하십시오.


전제조건

이 튜토리얼을 진행하려면 다음과 같은 전제조건을 완료하는 것이 필수적입니다.

  1. MFT에 대한 기본 지식: MFT가 IBM MQ에서 작동하는 방식을 기본적으로 이해하려면 IBM Knowledge Center에서 IBM MQ에서 MFT의 작동 방식을 참조하십시오.

    MFT에 대한 자세한 내용은 IBM Knowledge Center에서 MFT(Managed File Transfer)를 참조하십시오.

  2. IBM MQ on Cloud 큐 관리자 작성

    아직 IBM MQ on Cloud 큐 관리자가 없으면 다음과 같은 안내 둘러보기를 수행하여 작성할 수 있습니다. IBM MQ on Cloud 시작하기 안내 둘러보기 또는 동일한 페이지에 제공된 수동 단계를 따르거나 기존 MQ on Cloud 큐 관리자를 사용하는 경우 다음을 수행해야 합니다.

    • MQ on Cloud 큐 관리자
    • connection_info.txt 파일에 다운로드된 연결 세부사항
      • 이 파일이 없는 경우 이 튜토리얼의 맨 아래에 있는 부록 1을 참조하십시오.
    • platformApiKey.json 파일에 다운로드된 관리 사용자 이름 및 API 키
      • 이 파일이 없는 경우 이 튜토리얼의 맨 아래에 있는 부록 2를 참조하십시오.
  3. IBM MQ Client : 이 학습서를 완료하려면 IBM MQ 명령행 도구 'runmqsc'가 PATH에 설치되어 있어야 합니다. 이 명령이 없는 경우에는 IBM MQ 클라이언트를 설치하여 이 명령을 얻을 수 있습니다. 이 튜토리얼의 끝에 있는 부록 3에 이를 수행하는 방법이 자세히 설명되어 있습니다.

  4. IBM MQ MFT 컴포넌트: IBM MQ MFT 컴포넌트를 설치하려면 IBM Knowledge Center에서 MFT(Managed File Transfer) 설치를 참조하십시오.


터미널 환경 설정

  1. 터미널 창 열기

    • 이 터미널은 조정 큐 관리자를 구성하는 데 사용되는 관리 터미널입니다.
  2. 다음과 같은 단계를 완료하여 관리 터미널의 MQSERVER 환경 변수에 큐 관리자 세부사항을 지정하십시오.

    • runmqsc cli를 사용하려면 연결해야 하는 원격 큐 관리자를 식별하기 위해 환경 변수가 설정되어야 합니다. 관리 터미널에서 다음 명령을 사용하여 MQSERVER 변수를 내보내십시오.

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

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

      • <HOSTNAME> - connection_info.txt 파일의 'hostname'
      • <PORT> - connection_info.txt 파일의 'listenerPort'

큐 관리자의 원격 관리에 사용될 모든 새 터미널에서 이 단계가 필수입니다(예: runmqsc cli를 사용하는 경우).


1단계: MFT(Managed File Transfer)를 위해 MQ on Cloud 큐 관리자 구성

이 절에서는 MQ on Cloud 큐 관리자를 에이전트 큐 관리자로 구성하는 방법에 대해 안내합니다. 이 구성을 위해 두 가지 토폴로지가 광범위하게 사용됩니다. 둘 중 하나를 선택한 후 적절한 절을 따르십시오.

  • 1.1. 단일 큐 관리자 토폴로지 - 이 토폴로지에서는 모든 MFT 오퍼레이션을 수행하기 위해 동일한 큐 관리자가 구성됩니다. 해당 큐 관리자를 조정 큐 관리자, 명령 큐 관리자 및 에이전트 큐 관리자로 구성하여 이를 수행합니다. 여기를 클릭하여 단계를 수행하십시오.

  • 1.2. 다중 큐 관리자 토폴로지 - 이 토폴로지에서는 세 개의 큐 관리자를 작성하여 MFT 오퍼레이션을 수행합니다. 이러한 큐 관리자의 이름을 QMCOORD, QMSRCQMDEST로 지정합니다. 여기를 클릭하여 단계를 수행하십시오.


2단계: 파일 전송 시작

이 절에서는 파일 전송을 수행하여 MFT 설정을 확인합니다. 현재는 MFT 명령행 인터페이스(CLI)를 사용하거나 MQ 탐색기 도구의 MFT 탭을 사용하여 MFT 파일 전송을 작성할 수 있습니다. 이 튜토리얼은 MFT CLI를 사용한 파일 전송을 보여줍니다. fteCreateTransfer 명령은 명령행에서 새 파일 전송을 작성하고 시작합니다. 이 명령은 파일 전송을 즉시 시작하고 향후 파일 전송 날짜 및 시간을 스케줄하고 스케줄된 전송을 한 번 이상 반복하고 특정 조건에 따라 파일 전송을 트리거할 수 있습니다.

이 튜토리얼에서는 단순하게 하기 위해 즉시 전송만 작성합니다. 여기의 지시사항을 따라 전송을 시작하십시오.

전송에 대한 자세한 내용은 이 MFT Knowledge Center 링크를 참조하십시오.


부록

부록 1: connection_info.txt

큐 관리자 연결 세부사항이 포함된 connection_info.txt 파일을 검색하려면 다음을 수행하십시오.

  1. 표에 표시된 관련 서비스를 클릭하여 IBM Cloud 서비스 인스턴스에 로그인합니다. 서비스 인스턴스를 보여주는 이미지
  2. 그러면 큐 관리자 보기가 열립니다. 연결 정보를 검색할 대기열 관리자를 선택합니다. 대기열 관리자 목록을 보여주는 이미지
  3. 접속 정보를 클릭합니다. 대기열 관리자 연결 정보 이미지
  4. 'JSON 텍스트 형식'으로 이 파일을 다운로드하십시오.

부록 2: platformApiKey.json

관리자 API 키를 작성하거나 재설정하려면 다음을 수행하십시오.

  1. 표에 표시된 관련 서비스를 클릭하여 IBM Cloud 서비스 인스턴스에 로그인합니다. 서비스 인스턴스를 보여주는 이미지

  2. 그러면 큐 관리자 보기가 열립니다. 연결 정보를 검색할 대기열 관리자를 선택합니다. 대기열 관리자 목록을 보여주는 이미지

  3. 다음으로 관리 탭을 선택합니다. 대기열 관리자 관리 탭이 강조 표시된 이미지

  4. 이제 IBM Cloud API 키 재설정/IBM Cloud API 키 작성을 클릭하십시오.

    • 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

부록 3: IBM MQ C 클라이언트

IBM MQ 클라이언트 명령행 도구 및 샘플(runmqsc, amqsputc, amqsgetc)이 없는 경우 여기서 다운로드할 수 있습니다.

  1. 아래에 표시된 대로 최신 패키지 선택. 작성 시 최신 버전은 9.0.5IBM MQ 클라이언트 버전을 표시하는 이미지
  2. 아래 그림과 같이 패키지 왼쪽의 상자를 선택하여 '[사용 중인 운영 체제]용 IBM MQC 재배포 가능 클라이언트'를 선택합니다. 파일 이름에 Redist가 있어야 합니다. 이 학습서는 Linux Ubuntu 운영 체제를 사용하여 작성됨운영 체제와 호환되는 재배포 가능 MQ C 클라이언트 선택을 표시하는 이미지
  3. HTTPS를 통해 다운로드하도록 선택하면 아래에 표시된 대로 브라우저를 통해 직접 클라이언트 다운로드 가능HTTPS가 선택된 여러 다운로드 옵션을 보여주는 이미지
    • 참고: 이 옵션이 없으면 대체 브라우저에서 시도하십시오.
  4. 계속을 클릭하면 아래 표시된 화면으로 경로가 재지정됩니다. 빨간색 원에 표시된 대로 기호를 클릭하여 다운로드 시작빨간색 원으로 표시된 이미지 클릭
  5. 다운로드한 다음, 선택한 디렉토리에 파일 추출<PATH_TO_MQCLIENT_DIR>
    • tar -xvzf <IBM-MQC-Redist>.tar.gz <PATH_TO_MQCLIENT_DIR>
  6. 경로에 명령 추가
    • export PATH=$PATH:<PATH_TO_MQCLIENT_DIR>/bin:<PATH_TO_MQCLIENT_DIR>/samp/bin

부록 4: 샘플 MQMFTCredentials.xml 파일

이 유형의 파일은 에이전트 프로세스에 대한 인증 정보를 저장합니다. 이러한 파일은 MQ on Cloud 큐 관리자에 대해 인증하는 데 사용되는 사용자 이름 및 비밀번호를 포함할 수 있습니다. 참조할 수 있는 샘플 파일은 다음과 같습니다.

<?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.   
  • 큐 관리자의 platformApiKey.json 파일에 있는 <ADMIN_API_KEY> = 'apiKey'입니다.

MQMFTCredentials.xml 파일에 대한 자세한 정보는 IBM Knowledge Center에서 MFT 인증 정보 파일 형식을 참조하십시오.