녹화된 메시지 재생하기(녹음 및 재생)

문제 해결 또는 감사를 지원하기 위해 기록 및 재생 기능을 사용하여 구성된 IBM® App Connect Enterprise 메시지 흐름을 통과하는 메시지를 확인하십시오. 그런 다음 선택한 메시지를 큐에 IBM MQ 다시 재생할 수 있습니다.

이 태스크에 대한 정보

메시지 흐름에 대해 기록 및 재생을 사용 설정하면 App Connect Enterprise 메시지 흐름에 대해 기록 및 재생을 사용 설정하면 메시지 흐름 노드에서 각 이벤트를 지정된 주제에 게시하도록 흐름 모니터링 이벤트를 구성합니다. 녹화 기능은 이러한 모니터링 이벤트를 구독하여 데이터베이스에 저장합니다. 그런 다음 특정 메시지를 큐로 IBM MQ 전송하여 재재생할 수 있습니다. 자세한 내용은 문서의 App Connect Enterprise 기록 및 재생 항목을 참조하십시오.

레코드 앤 리플레이 기능이 활성화된 메시지 흐름을 배포할 때 App Connect, 필요한 데이터베이스 및 IBM MQ 큐에 대한 세부 정보를 제공하는 구성을 런타임에 추가합니다. 런타임의 데이터 탭에서 배포된 플로우에 대해 기록된 메시지를 보고 다운로드할 수 있습니다. 적절한 권한이 있다면, 선택한 메시지를 지정된 IBM MQ 큐로 전송하여 재전송할 수 있습니다.

레코드 및 재생을 위해 배포된 메시지 흐름 구성하기

시작하기 전에

  • 에서 메시지를 재생할 수 있습니다 App Connect 에서 기록 및 재생이 활성화된 메시지 흐름의 경우 App Connect Enterprise. 에서 데이터 기록을 사용하려면 App Connect Enterprise 에서 데이터 저장소를 구성하고 모니터링 이벤트를 사용하여 기록할 데이터를 지정해야 합니다. 자세한 내용은 데이터 기록하기 문서에서 App Connect Enterprise 문서를 참조하세요.
  • 큐에 IBM MQ 대한 접근 권한이 있어야 합니다.
  • 다음 지원되는 데이터베이스 중 하나에 액세스할 수 있어야 합니다.
    • IBM Db2®
    • Microsoft SQL Server
    • Oracle
    • PostgreSQL
    자세한 내용은 데이터 기록을 위한 데이터베이스 구성하기 문서를 참조하세요 App Connect Enterprise 문서를 참조하세요.

프로시저

다음 지침에서는 기록 및 재생이 활성화된 메시지 플로우를 배포할 때 적용해야 하는 App Connect Enterprise 메시지 플로우를 배포할 때 적용해야 하는 구성에 대해 설명합니다.

  1. App Connect 에서 관리 페이지의 구성 탭에서 다음 구성을 만듭니다.
    자세한 내용은 구성 유형을 참조하세요.
    server.conf.yaml
    server.conf.yaml 구성을 생성하여 기록 및 재생 데이터의 데이터 저장소, 소스 및 대상을 구성합니다.
    • IBM MQ 매니저의 세부 정보가 포함된 구성의 Policy project 이름으로 remoteDefaultQueueManager 설정하십시오.
    • recordReplayEnabled 이 주석 처리되지 않고 true 으로 설정되어 있는지 확인합니다.
    • 생성하려는 스토어 및 소스에 대한 스토어 및 소스 템플릿을 복사하고 사용자 지정합니다. 자세한 내용은 데이터 기록 구성하기 문서에서 App Connect Enterprise 문서를 참조하세요.
    • 메시지를 전송하려는 IBM MQ 대기열에 대해 '목적지' 템플릿을 복사하고 사용자 정의하십시오. 자세한 내용은 문서의 App Connect Enterprise 데이터 재생 부분을 참조하십시오.
    다음 예는 server.conf.yaml 파일의 기록 및 재생 섹션을 보여줍니다.
    RecordReplay:
      recordReplayEnabled: true        
      Stores:
        MBRECORD_store:
          backoutQueue: 'SYSTEM.BROKER.DC.BACKOUT'  
          dataSource: 'USERDB'
          schema: 'myDatabaseSchema'
          storeMode: 'all'
      Sources:
        MBRECORD_source:
          topic: '$SYS/Broker/integration_server/Monitoring/#/#/#' 
          store: 'MBRECORD_store' 
      Destinations:
        MQDestination:
          endpointType: 'WMQDestination'             
          endpoint: 'wmq:/msg/queue/SYSTEM.BROKER.DC.REPLAY'
    Policy project
    IBM MQ 관리자에 대한 세부 정보를 제공하기 위한 구성을 Policy project 생성하십시오.

    정책 프로젝트 빌더를 사용하여 정책 프로젝트 구성을 생성하거나 업데이트할 수 있습니다. (자세한 내용은 정책 프로젝트 구성 생성을 참조하십시오.) 또는 IBM App Connect Enterprise 도구 키트에서 정책을 MQEndpoint 생성하고, 해당 정책을 .zip 구성 파일에 추가한 후, 이를 구성에 App Connect 가져와 설정을 생성하십시오. (자세한 내용은 문서의 ' App Connect Enterprise 도구 App Connect Enterprise 키트로 정책 만들기' 및 'MQEndpoint 정책' 항목을 참조하십시오.)

    다음 예는 MQEndpoint 정책에 대한 XML 파일의 내용을 보여줍니다. securityIdentity 속성 값은 대기열 관리자에 대한 setdbparms.txt 구성의 resource 속성 값과 일치해야 합니다.
    <?xml version="1.0" encoding="UTF-8"?>
    <policies>
      <policy policyType="MQEndpoint" policyName="mqPolicy" policyTemplate="MQEndpoint">
        <connection>CLIENT</connection>
        <destinationQueueManagerName>queue manager name</destinationQueueManagerName>
        <queueManagerHostname>queue manager hostname</queueManagerHostname>
        <listenerPortNumber>1414</listenerPortNumber>
        <channelName>channel name</channelName>
        <CCDTUrl></CCDTUrl>
        <securityIdentity>MQ</securityIdentity>
        <useSSL>false</useSSL>
        <SSLPeerName></SSLPeerName>
        <SSLCipherSpec></SSLCipherSpec>
        <SSLCertificateLabel></SSLCertificateLabel>
        <MQApplName></MQApplName>
        <reconnectOption>default</reconnectOption>
      </policy>
    </policies>
    db2cli.ini
    데이터베이스를 IBM Db2 사용하는 경우, 데이터베이스의 세부 정보를 제공하는 구성 db2cli.ini 파일을 생성하십시오. 자세한 내용은 db2cli.ini 구성 항목을 참조하십시오. 이 구성은 IBM Db2 데이터베이스에만 필요합니다.
    다음 예는 db2cli.ini 파일을 보여줍니다.
    [USERDB]
    Database=USERDB
    Protocol=TCPIP
    Hostname=localhost
    Port=9000
    odbc.ini
    odbc.ini 구성을 생성하여 데이터베이스에 대한 ODBC 연결 세부 정보를 지정합니다. 자세한 내용은 odbc.ini 구성 항목을 참조하십시오.
    다음 예시는 설정이 IBM Db2 포함된 파일의 odbc.ini 일반적인 형식을 보여줍니다. 지원되는 다른 데이터베이스를 구성하는 방법에 대한 자세한 내용은 ‘ App Connect Enterprise ’ 문서의 ‘데이터 기록을 위한 데이터베이스 생성 및 구성’ 섹션을 참조하십시오.
    ;#######################################
    ;#### List of data sources stanza ######
    ;#######################################
    
    [ODBC Data Sources]
    USERDB=IBM Data Server Driver included in App Connect Enterprise
    
    ;###########################################
    ;###### Individual data source stanzas #####
    ;###########################################
    
    ;# IBM Data Server Driver included in App Connect Enterprise
    ;# Use of this driver requires additional configuration of Db2 configuration files 'db2cli.ini'
    ;# or 'db2dsdriver.cfg', and the setting of additional environment variables.
    ;# Refer to the documentation for details of the required configuration.
    [USERDB]
    DRIVER=/opt/ibm/ace-13/server/ODBC/dsdriver/odbc_cli/clidriver/lib/libdb2o.so
    Description=IBM Db2 ODBC Database accessed by using the IBM Data Server Driver included in App Connect Enterprise
    Database=USERDB
    
    ;##########################################
    ;###### Mandatory information stanza ######
    ;##########################################
    
    [ODBC]
    InstallDir=/opt/ibm/ace-13/server/ODBC/drivers
    UseCursorLib=0
    IANAAppCodePage=4
    UNICODE=UTF-8
    setdbparms.txt
    두 개의 setdbparms.txt 구성을 생성하십시오: 하나는 데이터베이스에 대한 자격 증명을 지정하고, 다른 하나는 큐 IBM MQ 관리자에 대한 자격 증명을 지정합니다. 자세한 내용은 setdbparms.txt 구성 항목을 참조하십시오.
    setdbparms.txt 파일에는 하나 이상의 mqsisetdbparms 명령이 포함되어 있습니다. 다음 예는 데이터베이스에 대한 자격 증명이 포함된 mqsisetdbparms 명령을 보여줍니다.
    mqsisetdbparms -w /home/aceuser/ace-server -n USERDB -u myUserID -p myPassword
    다음 예제는 큐 IBM MQ 매니저에 대한 자격 증명을 포함한 명령을 mqsisetdbparms 보여줍니다. resource 속성 값은 MQEndpoint 정책 파일의 securityIdentity 속성과 일치해야 하며 접두사 mq:: 가 있어야 합니다.
    mqsisetdbparms --work-dir /home/aceuser/ace-server/ --resource mq::securityIdentityName -u myUserID -p myPassword
  2. 기록 및 재생이 활성화된 메시지 흐름이 포함된 BAR 파일을 가져와 배포합니다.
    자세한 내용은 ‘통합 기능 배포’를 참조하세요.
  3. 배포 프로세스의 구성 섹션에서 생성한 6개의 구성을 선택합니다.
  4. 배포 중인 항목에 대한 요약을 확인한 다음 배포를 클릭합니다.

기록된 데이터 재생

시작하기 전에

에서 메시지를 재생하려면 App Connect 에서 메시지를 재생하려면 편집기 또는 관리자 액세스 권한이 있어야 합니다. 뷰어 액세스 권한이 있는 경우 메시지 탭만 볼 수 있고 트랜잭션을 볼 수는 있지만 선택하거나 다시 재생할 수는 없습니다. 자세한 내용은 IBM webMethods Hybrid Integration 문서의 ‘액세스 관리’ 섹션을 참조하십시오.

프로시저

다음 지침에서는 기록 및 재생이 활성화된 배포된 메시지 흐름에 대한 메시지를 보고 재생하는 방법에 대해 설명합니다.

  1. 관리 페이지의 런타임 탭에서 녹화 및 재생을 위해 구성된 런타임을 엽니다.
  2. 선택한 런타임의 데이터 탭으로 이동합니다.
    데이터 탭에는 배포된 메시지 흐름에 대해 구성된 데이터 저장소가 나열됩니다.
    선택한 런타임에는 두 개의 데이터 저장소가 표시되는 데이터 탭이 있습니다.
  3. 데이터 저장소를 클릭하여 엽니다.

    메시지 탭을 사용하여 메시지 흐름에 있는 메시지에 대한 정보를 보고, 다시보기 탭을 사용하여 메시지를 다시 재생할 수 있습니다.

    메시지 탭에는 메시지 플로우를 통과하면서 기록된 모든 메시지가 나열됩니다. 데이터를 오름차순 또는 내림차순으로 정렬하려면 열 머리글을 클릭합니다. 메시지를 필터링하려면 필터를 클릭한 다음 조건을 추가합니다.
    필터를 클릭하면 쿼리 작성 대화 상자가 열립니다. 조건 추가를 클릭하여 필터링할 조건을 추가한 다음 적용을 클릭합니다.
    메시지 표에 표시될 데이터를 설정하려면 [ 표 사용자 지정 아이콘사용자 지정]을 클릭하세요. 보려는 데이터 유형을 선택한 다음 저장을 클릭합니다.
    테이블 사용자 지정 대화 상자에는 플로우 이름, 이벤트 소스, 라이브러리 이름, 로컬 트랜잭션 ID 등의 데이터 유형 목록이 표시됩니다. 각 데이터 유형에는 확인란이 있습니다. 선택한 데이터 유형은 메시지 테이블의 열로 표시됩니다.
    이벤트 시간 열에서 타임스탬프를 클릭하면 해당 트랜잭션에 대한 자세한 내용을 볼 수 있습니다.
    • 속성 탭에는 입력 대기열의 이름 및 메시지 플로우 노드와 같은 메시지에 대한 정보가 표시됩니다.
      속성 탭에는 ID, 애플리케이션 이름, 이벤트 이름, 이벤트 소스 등 선택한 메시지에 대한 세부 정보가 표시됩니다.
    • 데이터 탭에는 메시지 흐름을 통과한 데이터가 표시됩니다. 이 탭에서 데이터를 다운로드할 수도 있습니다.
      데이터 탭에는 선택한 메시지의 데이터가 표시됩니다. 데이터를 다운로드하려면 이 비트스트림 다운로드를 클릭합니다.
  4. 트랜잭션을 재생하려면 확인란을 사용하여 표에서 트랜잭션을 선택한 다음 재생을 위해 표시를 클릭합니다.
    표에서 메시지를 선택하면 다시 보기용 표시 링크가 나타납니다.

    표시된 트랜잭션은 데이터 저장소의 재생 탭에 나열됩니다.

    이 트랜잭션을 재생하지 않으려면 확인란을 사용하여 선택한 다음 제거를 클릭합니다.

  5. 재생 탭에서 트랜잭션을 재생할 대상 대기열을 선택합니다.
    리플레이 대상 필드에는 사용자가 구성한 IBM MQ 대기열이 나열됩니다.
    리플레이 대상 필드에는 구성한 IBM MQ 대기열이 나열됩니다. 메시지를 재생할 대기열을 선택합니다.
  6. 트랜잭션을 선택한 다음 재생을 클릭합니다.
    다시보기 탭에서 메시지를 선택하면 다시보기 링크가 나타납니다. 링크를 클릭하면 선택한 대기열에 메시지를 재생할 수 있습니다.

결과

재생 상태가 재생 중으로 변경됩니다. 메시지가 성공적으로 재생된 경우 재생 상태 열의 값이 성공으로 변경됩니다. 메시지가 성공적으로 재생되지 않은 경우 상태는 실패입니다. 로그에서 실패를 설명하는 메시지를 확인하세요. 자세한 내용은 ‘로그 뷰어에서 로그 메시지 확인’을 참조하십시오.