MFT(Managed File Transfer) 시작하기
IBM MQ Managed File Transfer(MFT)의 개념
IBM® MQ Managed File Transfer(MFT)는 관리되고 신뢰할 수 있는 안전한 방식으로 시스템 사이에서 파일을 전송합니다. 파일 전송 활동은 로그되며 이는 활동 로깅에 사용될 수 있습니다. MFT(Managed File Transfer) 에이전트를 구성하고 큐 관리자가 전송을 수행하게 할 수 있습니다. MFT(Managed File Transfer)는 두 가지 토폴로지를 제공합니다.
-
단일 큐 관리자 토폴로지: 단일 큐 관리자를 에이전트 큐 관리자, 명령 큐 관리자 및 조정 큐 관리자로 사용합니다. 이러한 용어는 다음 절에 설명되어 있습니다.
-
다중 큐 관리자 토폴로지: 에이전트 큐 관리자, 명령 큐 관리자 및 조정 큐 관리자 역할을 수행하는 다중 큐 관리자를 사용합니다. 보다 구체적으로 이 토폴로지에는 3개 이상의 큐 관리자가 필요합니다. 하나는 조정 큐 관리자 역할을 수행하고 다른 하나는 소스 에이전트 큐 관리자(MFT(Managed File Transfer) 에이전트 작성용) 및 명령 큐 관리자 역할을 수행하고 세 번째 큐 관리자는 대상 에이전트 큐 관리자(또 다른 파일 전송 에이전트 작성용) 및 명령 큐 관리자 역할을 수행합니다.
참고: 다중 큐 관리자 토폴로지에서는 필수 큐 관리자가 모두 클라우드에 있거나 모두 온프레미스에 있거나 이 둘의 혼합일 수 있습니다.
MFT는 IBM MQ Advanced의 통합된 컴포넌트입니다. 이 제품의 최신 전체 세부사항은 IBM Knowledge Center에서 MFT(Managed File Transfer)를 참조하십시오.
IBM MFT의 컴포넌트
IBM MQ Managed File Transfer의 기본 컴포넌트는 세 가지입니다. 이 세 컴포넌트가 아래에 설명되어 있습니다.
- 조정 큐 관리자: 에이전트 상태 수집, 상태 전송 및 활동 정보 전송을 담당합니다.
- 명령 큐 관리자: MFT 명령과 MQ 인프라를 연결하는 인터페이스 큐 관리자입니다. 예를 들어, MFT 파일 전송 명령을 명령 큐 관리자에 제출하여 에이전트가 전송을 시작하거나 취소하도록 지시합니다.
- 에이전트: 각각의 에이전트에는 큐 관리자(에이전트 큐 관리자)와 연관된 자체 큐 세트가 있으며 이 큐 세트는 전송되는 파일을 송수신하는 데 필요한 키입니다. 따라서 파일이 전송될 시스템에서 에이전트가 작성됩니다.
이 튜토리얼에서 다루는 내용은 다음과 같습니다.
-
MQ on Cloud 큐 관리자를 MFT 조정, 명령 및 에이전트 큐 관리자로 구성한 후 MFT 에이전트를 소스 또는 대상 에이전트로 작성합니다. 이 튜토리얼에서는 지원되는 두 토폴로지 모두에 대한 단계를 제공합니다.
- 1.1: 단일 큐 관리자 토폴로지: 단일 큐 관리자가 에이전트 큐 관리자, 명령 큐 관리자 및 조정 큐 관리자로 구성됩니다.
- 1.2: 다중 큐 관리자 토폴로지: 이 토폴로지에서는 다중 큐 관리자가 사용됩니다.
-
파일 전송을 수행하십시오.
전제조건
이 튜토리얼을 진행하려면 다음과 같은 전제조건을 완료하는 것이 필수적입니다.
-
MFT에 대한 기본 지식: MFT가 IBM MQ에서 작동하는 방식을 기본적으로 이해하려면 IBM Knowledge Center에서 IBM MQ에서 MFT의 작동 방식을 참조하십시오.
MFT에 대한 자세한 내용은 IBM Knowledge Center에서 MFT(Managed File Transfer)를 참조하십시오.
-
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를 참조하십시오.
-
IBM MQ Client : 이 학습서를 완료하려면 IBM MQ 명령행 도구 'runmqsc'가 PATH에 설치되어 있어야 합니다. 이 명령이 없는 경우에는 IBM MQ 클라이언트를 설치하여 이 명령을 얻을 수 있습니다. 이 튜토리얼의 끝에 있는 부록 3에 이를 수행하는 방법이 자세히 설명되어 있습니다.
-
IBM MQ MFT 컴포넌트: IBM MQ MFT 컴포넌트를 설치하려면 IBM Knowledge Center에서 MFT(Managed File Transfer) 설치를 참조하십시오.
터미널 환경 설정
-
터미널 창 열기
- 이 터미널은 조정 큐 관리자를 구성하는 데 사용되는 관리 터미널입니다.
-
다음과 같은 단계를 완료하여 관리 터미널의 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, QMSRC 및 QMDEST로 지정합니다. 여기를 클릭하여 단계를 수행하십시오.
2단계: 파일 전송 시작
이 절에서는 파일 전송을 수행하여 MFT 설정을 확인합니다. 현재는 MFT 명령행 인터페이스(CLI)를 사용하거나 MQ 탐색기 도구의 MFT 탭을 사용하여 MFT 파일 전송을 작성할 수 있습니다. 이 튜토리얼은 MFT CLI를 사용한 파일 전송을 보여줍니다.
fteCreateTransfer
명령은 명령행에서 새 파일 전송을 작성하고 시작합니다. 이 명령은 파일 전송을 즉시 시작하고 향후 파일 전송 날짜 및 시간을 스케줄하고 스케줄된 전송을 한 번 이상 반복하고 특정 조건에 따라 파일 전송을 트리거할 수 있습니다.
이 튜토리얼에서는 단순하게 하기 위해 즉시 전송만 작성합니다. 여기의 지시사항을 따라 전송을 시작하십시오.
전송에 대한 자세한 내용은 이 MFT Knowledge Center 링크를 참조하십시오.
부록
부록 1: connection_info.txt
큐 관리자 연결 세부사항이 포함된 connection_info.txt 파일을 검색하려면 다음을 수행하십시오.
- 표에 표시된 관련 서비스를 클릭하여 IBM Cloud 서비스 인스턴스에 로그인합니다.
- 그러면 큐 관리자 보기가 열립니다. 연결 정보를 검색할 대기열 관리자를 선택합니다.
- 접속 정보를 클릭합니다.
- 'JSON 텍스트 형식'으로 이 파일을 다운로드하십시오.
부록 2: platformApiKey.json
관리자 API 키를 작성하거나 재설정하려면 다음을 수행하십시오.
-
표에 표시된 관련 서비스를 클릭하여 IBM Cloud 서비스 인스턴스에 로그인합니다.
-
그러면 큐 관리자 보기가 열립니다. 연결 정보를 검색할 대기열 관리자를 선택합니다.
-
다음으로 관리 탭을 선택합니다.
-
이제 IBM Cloud API 키 재설정/IBM Cloud API 키 작성을 클릭하십시오.
- Note: The previous admin API key for this MQ Username will no longer be valid
- 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.
- Click Download to download platformApiKey.json containing an admin username and apikey
부록 3: IBM MQ C 클라이언트
IBM MQ 클라이언트 명령행 도구 및 샘플(runmqsc, amqsputc, amqsgetc)이 없는 경우 여기서 다운로드할 수 있습니다.
- 아래에 표시된 대로 최신 패키지 선택. 작성 시 최신 버전은 9.0.5
- 아래 그림과 같이 패키지 왼쪽의 상자를 선택하여 '[사용 중인 운영 체제]용 IBM MQC 재배포 가능 클라이언트'를 선택합니다. 파일 이름에 Redist가 있어야 합니다. 이 학습서는 Linux Ubuntu 운영 체제를 사용하여 작성됨
- HTTPS를 통해 다운로드하도록 선택하면 아래에 표시된 대로 브라우저를 통해 직접 클라이언트 다운로드 가능
- 참고: 이 옵션이 없으면 대체 브라우저에서 시도하십시오.
- 계속을 클릭하면 아래 표시된 화면으로 경로가 재지정됩니다. 빨간색 원에 표시된 대로 기호를 클릭하여 다운로드 시작
- 다운로드한 다음, 선택한 디렉토리에 파일 추출
<PATH_TO_MQCLIENT_DIR>
tar -xvzf <IBM-MQC-Redist>.tar.gz <PATH_TO_MQCLIENT_DIR>
- 경로에 명령 추가
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 인증 정보 파일 형식을 참조하십시오.