MFT(Managed File Transfer) 시작하기

IBM MQ MFT의 구성 요소

IBM MQ 관리형 파일 전송에는 세 가지 주요 구성 요소가 있습니다: 에이전트 상태, 전송 상태 및 전송 활동 정보 수집을 담당하는 조정 대기열 관리자, MFT 명령과 IBM MQ 인프라를 연결하는 인터페이스 대기열 관리자인 명령 대기열 관리자, 대기열 관리자(에이전트 대기열 관리자)와 연결된 자체 대기열 세트가 각각 있으며 전송되는 파일을 주고받는 핵심이 되는 에이전트 (파일이 전송되는 시스템에서 생성되는 에이전트).

이 튜토리얼에는 다음과 같은 연습 문제가 포함되어 있습니다:

1. IBM MQ as a Service 대기열 관리자를 MFT 조정, 명령 및 에이전트 대기열 관리자로 구성한 다음 MFT 에이전트(소스 또는 대상 에이전트로)를 만듭니다. 이 튜토리얼에서는 지원되는 두 토폴로지 모두에 대한 단계를 제공합니다.
   • 단일 큐 관리자 토폴로지: 단일 큐 관리자는 상담원 큐 관리자, 명령 큐 관리자 및 조정 큐 관리자로 구성됩니다.
   • 다중 큐 관리자 토폴로지: 이 토폴로지에서는 여러 대기열 관리자가 사용됩니다.
2. 파일 전송을 수행합니다.

전제조건

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

1. MFT에 대한 기본 지식: MFT의 작동 방식에 대한 기본적인 이해는 IBM MQ, IBM 기본 문서에서 관리형 파일 전송을 참조하세요.

2. IBM MQ as a Service 대기열 관리자를 만듭니다. 아직 IBM MQ as a Service 대기열 관리자가 없는 경우 IBM MQ as a Service 시작하기 를 참조하여 대기열 관리자를 만들 수 있습니다. 그래야 합니다:
   • IBM MQ as a Service 대기열 관리자
   • connection_info.txt 파일에 다운로드된 연결 세부 정보( connection_info.txt 검색 참조).
   • platformApiKey.json 파일에서 다운로드한 관리자 사용자 아이디와 apikey( platformApiKey.json 검색 참조)
3. IBM MQ 클라이언트. 이 튜토리얼을 완료하려면 IBM MQ 명령줄 도구( runmqsc )가 설치되어 있고 경로에 있어야 합니다. 이러한 명령이 없는 경우 IBM MQ 클라이언트를 설치하여 얻을 수 있습니다( IBM MQ C 클라이언트 참조).
4. IBM MQ MFT 컴포넌트. IBM MQ MFT 구성 요소를 설치하려면 IBM 기본 문서에서 관리형 파일 전송 설치하기를 참조하세요.

터미널 환경 설정

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 의 '호스트 이름' 입니다.

     • <PORT>

       - 파일 connection_info.txt 의 'listenerPort '입니다.

이 단계는 대기열 관리자의 원격 관리에 사용할 새 터미널(예: runmqsc CLI를 사용할 때)에서 필요합니다.

1단계: 관리형 파일 전송(MFT)을 위한 IBM MQ as a Service 대기열 관리자 구성하기

이 섹션에서는 IBM MQ as a Service 대기열 관리자를 상담원 대기열 관리자로 구성하는 방법을 안내합니다. 이 구성을 위해 두 가지 토폴로지가 광범위하게 사용됩니다. 둘 중 하나를 선택한 후 적절한 절을 따르십시오.

• 단일 대기열 관리자 토폴로지. 이 토폴로지에서는 동일한 큐 관리자가 모든 MFT 작업을 수행하도록 구성됩니다. 조정 대기열 관리자, 명령 대기열 관리자 및 상담원 대기열 관리자로 구성하여 이를 수행합니다. 관리형 파일 전송에 대한 단일 대기열 관리자 토폴로지를 참조하세요.
• 다중 대기열 관리자 토폴로지. 이 토폴로지에서는 3개의 대기열 관리자를 생성하여 MFT 작업을 수행합니다. QMCOORD, QMSRC 및 QMDEST로 명명되었습니다. 관리형 파일 전송에 대한 여러 대기열 관리자 토폴로지를 참조하세요.

2단계: 파일 전송 시작

이 섹션에서는 파일 전송을 수행하여 MFT 설정을 확인합니다. 이 튜토리얼은 MFT CLI를 사용한 파일 전송을 보여줍니다. fteCreateTransfer 명령으로 명령행에서 새 파일 전송을 작성하고 시작할 수 있습니다. 이 명령은 파일 전송을 즉시 시작하거나 향후 파일 전송 시간 및 날짜를 스케줄하고 스케줄된 전송을 한 번 이상 반복하고 특정 조건에 따라 파일 전송을 트리거할 수 있습니다.

간단하게 설명하기 위해 이 튜토리얼에서는 즉시 전송을 생성합니다. 관리되는 파일 전송 시작하기의 지침에 따라 전송을 시작합니다. fteCreateTransfer 에 대한 자세한 내용은 fteCreateTransfer.

검색 중 connection_info.txt

대기열 관리자 연결 세부 정보가 포함된 connection_info.txt 파일을 검색하려면 다음과 같이 하세요:

1. 귀하의 위치로 이동 IBM MQ as a Service IBM MQ as a Service 시작하기 의 지침에 따라 UI를 설정합니다.
2. 대기열 관리자 보기가 열립니다. 연결 정보를 검색할 대기열 관리자를 선택합니다.
   
3. 연결 정보를 클릭합니다.
   
4. 이 파일을 JSON 텍스트 형식으로 다운로드하세요.

검색 중 platformApiKey.json

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

1. 귀하의 위치로 이동 IBM MQ as a Service IBM MQ as a Service 시작하기 의 지침에 따라 UI를 설정합니다.
2. 대기열 관리자 보기가 열립니다. 연결 정보를 검색할 대기열 관리자를 선택합니다:
   
3. 다음으로 관리 탭을 선택합니다:
   
4. API 키 재설정 버튼을 클릭합니다. 이 IBM MQ 사용자 아이디에 대한 이전 관리자 API 키는 더 이상 유효하지 않습니다.
   
   (버튼에 API 키 생성이라고 표시되면 이전에 이 방법으로 API 키를 생성한 적이 없는 것입니다. CreateAPI 키 버튼을 클릭합니다.
5. Download 을 클릭하여 관리자 사용자 아이디와 apikey가 포함된 platformApiKey.json 파일을 다운로드합니다.
   

IBM MQ C 클라이언트

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

1. 최신 패키지를 선택합니다.
2. 아래 그림과 같이 패키지 왼쪽의 상자를 선택하여 운영 체제에 맞는 IBM MQ C 재배포 가능 클라이언트를 선택합니다. 파일 이름에 Redist가 있어야 합니다. 이 학습서는 Linux Ubuntu 운영 체제를 사용하여 작성되었습니다.
3. 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