시나리오: mqsimigratemsgflows 명령
을 사용하여
You have migrated your 버전 2.1 및 버전 5.0메시지 플로우
를 Workbench로 이주했지만,
이를 브로커 아카이브 파일(bar)에 추가할 수 없습니다.
해결책: 이주한 메시지 플로우가 Workbench에서 종료된
프로젝트로 표시됩니다. 메시지 플로우 를 bar 파일에 추가할 수 있도록 하려면
다음을 수행하십시오.
프로젝트를 마우스 오른쪽 단추로 누르고 Project > 프로젝트 열기를 눌러 프로젝트를 여십시오.
프로젝트를 마우스 오른쪽 단추로 누른 후 정리를 눌러 프로젝트를 정리하십시오. 그러면, 오류가 표시되고 프로젝트 자원을 bar 파일에 추가할 수 있게 됩니다.
브로커 아카이브 파일을 브로커로 끌어 놓을 수 없음
시나리오: 브로커 아카이브(bar) 파일을 브로커로 끌어 놓을 수 없습니다.
설명: bar 파일은 실행 그룹에만 전개할 수 있습니다. 끌어 놓기를 사용할 때, 브로커 토폴로지
편집기 또는 도메인 네비게이터에서 bar 파일을 브로커로 끌어올
수 없습니다.
해결책: 도메인 네비게이터에서 bar 파일을 실행 그룹에 끌어 놓거나 전개
대화 상자에서 실행 그룹을 선택하십시오.
컴파일된 메시지 플로우(.cmf)파일이 생성되지 않음
시나리오: 컴파일된 메시지 플로우(.cmf) 파일이 생성되지 않았습니다. 따라서, 이 파일이 브로커 아카이브 파일에 추가되지 않으므로 전개할 수 없습니다.
설명: 맵핑 파일을 작성할 때, Windows 파일 시스템의 제한으로 인해
전체 파일 경로 길이는 256자를 초과해서는 안 됩니다. 경로 길이가 256자를 초과하는 맵핑 또는 ESQL 파일로 브로커 아카이브 파일에
메시지 플로우를 추가하는 경우, 컴파일된 메시지 플로우가 생성되지 않으므로 전개할 수 없습니다.
해결책: 경로 길이가 256자를 넘지 않도록 하려면 다음 이름을 가능한 한 짧게 만드십시오.
설치 경로
임의 프로젝트 이름 및 브로커 스키마 이름
임의 ESQL 및 맵핑 파일 이름
메시지 플로우가 테스트 시스템에서만 전개되고 다른 시스템에서는 실패함
시나리오: 개발한 메시지 플로우가 테스트 시스템에는 전개됩니다.
해결책: 다음 점검을 수행하십시오.
반드시 브로커를 작성 및 시작하고 단일 실행 그룹을 전개하여
설치를 확인하십시오. 이는 WebSphere Event Broker 및 브로커 데이터베이스가 제위치에
있음을 표시합니다.
브로커 아카이브(BAR) 파일의 broker.xml 파일에 새 시스템에 올바른
자원에 대한 참조가 있는지 확인하십시오.
대상 시스템에서 데이터베이스 자원에
액세스할 수 없거나 권한이 부여되어 있지 않으면 전개에 실패합니다. 분산
시스템에서는 WebSphere Event Broker에서 사용자의 데이터베이스에 액세스할 수 있도록 데이터베이스를
ODBC 소스로 정의해야 합니다.
또한, 데이터베이스에 액세스할 수 있도록 브로커 환경을
설정하십시오. (Linux 또는
UNIX 시스템에서는 프로파일을 실행해야 할 수도 있습니다.)
전개시 브로커가 존재하지 않는다고 표시됨
시나리오: 전개를 시작했으나, 브로커가 존재하지 않음을 표시하는 오류가 수신됩니다.
설명: 전개의 첫 번째 단계 중 구성 관리자는 구성 데이터 스트림을 각 대상
브로커의 SYSTEM.BROKER.ADMIN.QUEUE 큐에 송신합니다. 구성 데이터가 모든
관련 브로커에 송신되면 제어가 리턴됩니다. 전개의
이 첫 번째 단계 중 오류가 감지되면 전개를 중지하므로 구성 데이터는
어떤 브로커에게도 송신되지 않고 로그에 오류 메시지가 표시됩니다.
해결책: 브로커와 연관된 올바른 큐 관리자를 지정했는지 확인하십시오. 올바른 경우,
대상 큐 관리자에서 전개 메시지가 송신된 큐(SYSTEM.BROKER.ADMIN.QUEUE)를
찾을 수 없기 때문에 전개 메시지를 전달할 수 없을 수도 있습니다. 이는 WebSphere MQ 이유 코드
2085를 리턴합니다.
큐가 삭제된 경우, 브로커 환경이 손상되었으므로 복구해야 합니다.
구성 관리자가 존재하지 않는 브로커로
전개하려고 함
시나리오:구성 관리자가 존재하지 않는
브로커로 전개하려고 합니다.
설명: 이 상황은 다음과 같은 여러 이유로 인해 발생할 수 있습니다.
브로커 구성요소를 Message Brokers Toolkit에서 먼저 제거하지 않고 삭제했습니다.
Message Brokers Toolkit에서 브로커 이름을 잘못
입력하여 실제로 존재하지 않는 브로커에 대한 참조를 작성합니다.
올바른 브로커 삭제 프로시저를 따르지 않았습니다.
연결설 문제점으로 인해 브로커가 존재하지 않는 것으로 표시될 수 있습니다.
해결책:
브로커가 존재해야 하는 컴퓨터에서 자원을 나열할
mqsilist 명령을 사용하여
브로커가 존재하는지 점검하십시오.
전개 조작을 재시도하십시오. 문제가 계속 발생하면 maxJVMHeapSize 매개변수를 다시
늘리십시오.
z/OS에서 전개 시 오류 메시지 발행됨
시나리오: z/OS에서 전개 시 다음 메시지가 로그에 기록됩니다.
+(MQ05BRK) 0 BIP2070E: WebSphere MQ 큐 SYSTEM.BROKER.ADMIN.REPLY,
MQPUT for WebSphere MQ queue SYSTEM.BROKER.ADMIN.REPLY, WebSphere MQ queue
manager QM_01. MQCC=2, MQRC=2030.
+(MQ05BRK) 0 BIP2068E: 브로커가 내부 구성 메시지를
메시지 큐 SYSTEM.BROKER.ADMIN.REPLY.에 넣지 못했습니다.
설명: 트랜스미션 큐가 WebSphere Event Broker에서
발행한 메시지를 넣을 수 있을 만큼 충분히 크지 않습니다.
해결책: 트랜스미션 큐의 크기를 늘리는 방법에 대한 자세한 내용은 WebSphere MQ 문서를 참조하십시오.
z/OS에서 메시지 플로우의 다중 인스턴스를
처리하는 공유 큐에 대해 예상된 입력 직렬화가 수행되지 않음
시나리오:z/OS에서
메시지 플로우의 다중 인스턴스를 처리하는 공유 큐에 대해 예상된 입력 직렬화가 수행되지 않습니다.
설명:z/OS에서, WebSphere MQ는 응용프로그램이 큐 공유 그룹에 참여하는
큐 관리자에 연결할 때 연결 태그(직렬화 토큰)를 사용하여 공유 큐와 같은 공유 자원에 대한 직렬화 액세스를 지원합니다.
다음과 같은 여러 가지 원인으로 인해 이 문제점이 발생할 수 있습니다.
사용자가 공유 큐에서 메시지를 가져오는 플로우의 입력 노드에 다른
직렬화 토큰을 지정했을 수 있습니다.
메시지 플로우가 동일한 실행 그룹에서 실행 중일 수 있습니다. 직렬화는 큐 관리자가 같은 큐 공유 그룹에 참여하는 동일한 브로커 또는 다른 브로커의
서로 다른 실행 그룹에서 실행 중인 플로우 간에만 영향을 미칩니다.
브로커가 실행 중인 큐 관리자가 큐 공유 그룹에 참여하지 않거나 동일한
큐 공유 그룹에 참여하지 않습니다.
해결책: 다음 점검을 수행하십시오.
공유 큐를 사용하는 각 플로우의 MQInput 노드에 대해 동일한 z/OS 직렬화
토큰이 구성되었는지 점검하십시오.
메시지 플로우가 서로 다른 실행 그룹에서 실행 중인지 점검하십시오.
브로커 큐 관리자가 동일한 큐 공유 그룹에 속하고
z/OS 시스템 로그(SDSF 로그)에서
큐 관리자가 보고한 오류가 없는지 점검하십시오.
버전 6.0 브로커에게 전개 후 MQe 노드가 예상대로 작동하지 않음
시나리오: MQe 노드를 포함하는 메시지 플로우가 이전 버전 브로커에서 작동하지만
버전 6.0 브로커에게 전개할 때는 실패합니다.
설명:WebSphere Event Broker 버전
6.0에서는 MQeInput
및 MQeOutput 노드를 포함하는 메시지 플로우 사용이 지원되지 않습니다.
버전 6.0에서 이전 버전으로 전개하여 사용할 수는 있습니다. 버전 6.0 브로커에게 전개할 때는
MQe 노드가 MQ 노드로 변환됩니다.
시나리오: 하나의 사용자 ID를 사용하여 실행하도록
구성 관리자를 정의했으며 다른 사용자 ID를
사용하여 다른 컴퓨터에서 실행하도록 브로커를 정의했습니다. 전개에 성공했으나 메시지 플로우 를 브로커에게 전개할 때 오류 메시지 BIP1536이 표시됩니다.
설명: 브로커는 하나의 ID에서 실행되고
구성 관리자는 다른 ID에서 실행되므로
구성 관리자는 브로커와 함께 내부 Subscription에
등록할 수 없습니다. 브로커 및 구성 관리자는
publish/subscribe를 통해 내부 메시지를 앞뒤로 릴레이합니다.
이러한 메시지는 특정 권한 부여가 필요한 WebSphere MQ를
통해 전달됩니다.
해결책:
브로커의 사용자 ID가 mqm 및 mqbrkrs 그룹의 구성원인지 확인하십시오.
구성 관리자가 실행 중인 컴퓨터에 브로커의 사용자 ID를 정의하십시오.
브로커가 실행 중인 컴퓨터에 구성 관리자의 사용자 ID를 정의하십시오.
컴퓨터들 간에 호환 가능하도록 모든 ID가 소문자인지
확인하십시오.
메시지 BIP1536 및 BIP7017
시나리오: 오류 메시지 BIP1536 및 BIP7017이 표시됩니다.
설명: 브로커 상태 변경을 처리하기 위해 토픽에
대한 내부 subscription을 등록하는 과정에서 구성 관리자에
문제가 발생합니다. 여기에서는 전체 구성을 전개할 때마다 등록을
시도합니다.
문제점의 원인은 메시지 BIP7017에서 제공됩니다. 이 메시지는
구성된 사용자 이름 서버를 실행 중이지만 전개 중인
브로커에는 사용자 캐시의 구성 관리자 서비스 사용자 ID가
없음을 표시합니다.
해결책: 다음을 확인하십시오. 문제점을 식별하고 수정하면 다음에 전개할 때
subscription이 올바르게 등록됩니다.
사용자 이름 서버가 시작되었는지 확인하십시오.
사용자 이름 서버 및 브로커 사이의 WebSphere MQ 채널이 시작되었는지 확인하십시오.
사용자 ID가 사용자 이름 서버의 도메인에 있는지 확인하십시오.
메시지 BIP2045
시나리오: 전개 후 Message Brokers Toolkit에 오류 메시지 BIP2045가 표시됩니다.
설명: 브로커가 정의되면 각 브로커는 구성 관리자에 저장된 UUID(Universally Unique Identifier)로 식별됩니다. 브로커가 첫 번째 전개 메시지를 수신하면 UUID도 브로커에 저장됩니다. 브로커가 다른 UUID를 포함하는 전개 메시지를 수신하면 전개 메시지를 거부하고 오류 메시지
BIP2045를 표시합니다. 이것은 다음 상황에서 발생할 수 있습니다.
두 번째 구성 관리자에서 전개 시도. 이 시나리오는 지원되지 않습니다.
구성 관리자를 다시 작성했으나 브로커는 다시 작성하지 않음
브로커를 삭제하고 다시 작성하는 동안 WebSphere MQ 채널에 문제점 발생
해결책: 두 개 이상의 구성 관리자을 사용하여 단일 브로커를 제어하지 않도록 하십시오. 이것이 문제가 아닌 경우 BIP2045 오류 메시지의 지시사항에 따라 브로커를 다시 빌드하고 메시지 플로우 응용프로그램을 다시 전개하여 브로커의 제어를 다시 확보하십시오.
메시지 BIP2066
시나리오: 오류 메시지 BIP2066가 표시됩니다.
설명: 브로커 시간 종료 ConfigurationTimeout에
ConfigurationDelayTimeout(디폴트 60초)을 더한 값이 만기되기 전에
실행 그룹에서 전개 요청 수신을 확인하지 않았습니다.
해결책: mqsicreatebroker 및
mqsichangebroker 명령의
-g 및
-k 매개변수를 사용하여 이 시간 종료를 변경하십시오.
메시지
BIP2242
시나리오: 오류 메시지 BIP2242가 표시됩니다.
설명: 브로커 시간 종료 ConfigurationTimeout(디폴트 300초)가
만기되기 전에 전개(구성 변경) 요청이
승인되지 않았습니다. 시간 종료는 메시지 플로우가
현재 메시지 처리를 완료한 후 전개 요청을 승인할 수 있을 만큼 길어야 합니다.
해결책: mqsicreatebroker 및
mqsichangebroker 명령의
-g 및
-k 매개변수를 사용하여 이 시간 종료를 설정하십시오.
시나리오: 브로커에게 전개할 때는 오류 메시지 BIP7053S가 표시됩니다.
설명: 이 오류는 다중 TCP/IP 스택 환경에서 발생하며,
USS(UNIX System Services) TCP/IP 환경이 올바르게 설정되지 않았음을 나타냅니다.
WebSphere Event Broker은 USS 기능을 사용하여 특정 시스템에 대한 호스트 이름을 가져옵니다. USS 환경에서 디폴트 호스트 이름이 올바르게 설정되지 않으면 다음 오류 메시지가 표시됩니다.
오류 메시지에 보고되는 호스트 이름은
gethostname 호출의 결과로 브로커에게 리턴된 호스트 이름입니다.
해결책: TCP/IP 환경이 USS에서 올바르게 구성되었는지 확인하십시오.
전개를 취소할 때 mqsilist는 실행 그룹의 메시지 플로우를 표시하지만 도구 지정은 표시하지 않음
시나리오: canceling a deployment, mqsilist은 실행 그룹의 메시지 플로우를 표시하지만
도구 지정은 이를 표시하지 않습니다. 실행 그룹에 대한 전개를 취소했으나 전개가 수행되고
mqsilist에 의해 표시됩니다.
해결책: 실행 그룹을 삭제하십시오. 전개된 그룹이 하나뿐인 경우 mqsilist는 계속해서 이전 실행 그룹을 표시합니다.
도구 지정에서 실행 그룹을 다시 작성하면 브로커를 재활용할 때까지 mqsilist에 의해 두 번 나열됩니다.
전개 결과가 알려지지 않음
시나리오: 브로커 토폴로지 편집기를 닫고 변경사항을 저장한 후
전개를 요청했으나 구성 전개 결과가 알려지지 않습니다.
설명: 편집기를 닫을 때 구성 관리자와의
통지 링크가 끊어지게 되므로 Workbench에 전개 결과가
알려지지 않습니다. 결과로서 발생하는 실패 통지인 경우에도
이와 마찬가지입니다.
해결책: 통지를 수신하려면 편집기를 닫지 않은 상태에서 저장한 후
구성 관리자에서 응답 대기 중 경고가 사라질 때까지
기다리십시오. 편집기가 구성 관리자의
모든 예상된 응답을 수신하면 이 경고가 자동으로 제거됩니다.
전개의 성공을 알리는 확인이 수신되지 않음
시나리오: 전개를 시작했으나 전개가 완료되었다는 확인이
수신되지 않았습니다.
해결책: 이 링크에 실패한 경우
Workbench가 즉시
오류를 표시하므로 Workbench에서
구성 관리자로의 통신이 작동 중인 것으로
가정하십시오. 다음 단계에 따라 전개 확인의 수신을 방해하는 통신 문제가 있는지
확인하십시오.
mqsistop 명령을 사용하여 브로커를 정지하십시오.
브로커 큐 관리자에서 SYSTEM.BROKER.ADMIN.QUEUE 큐를 점검하십시오. 이 큐에 메시지가 있는 경우 브로커 오류일 수 있습니다. 브로커 시스템의
로컬 오류 로그를 보십시오.
큐가 비어 있으면 다음 단계로 계속
진행하십시오.
메시지 플로우를 다시 전개하십시오.
브로커 큐 관리자에서 SYSTEM.BROKER.ADMIN.QUEUE 큐를 다시
점검하십시오. 큐 용량이 증가되지 않는 경우, 구성 관리자와 브로커 간의 채널에
문제가 있는 것이므로 WebSphere MQ 로그를 점검하십시오. 큐 용량이 1로 증가된 경우, 다음 단계를 계속 진행하십시오.
구성 관리자를 정지하고 브로커를 시작하십시오.
그러면
브로커가 구성 변경을 처리하고 응답을 송신할 수 있습니다. 브로커가 메시지를 처리할 때까지 기다리십시오.
처리 시간은 약간의 시간이 걸릴 수 있습니다. 메시지를 처리하는 데 5분 이상
걸리면 전개된 메시지에 문제가 있는 것이며, 브로커 시스템의
로컬 오류 로그에 실패 이유를 알리는 실패 메시지가
표시됩니다.
구성 관리자 큐 관리자에서
SYSTEM.BROKER.ADMIN.REPLY 큐를 점검하십시오. 큐에 응답이 들어 있어야 합니다. 그렇지 않을 경우, 브로커에서 구성 관리자로의 채널이 실행 중인지 확인하십시오.
구성 관리자를 재시작하십시오.
구성 관리자 큐 관리자에서 SYSTEM.BROKER.ADMIN.REPLY 큐가 메시지를 읽었는지
점검하십시오. 그렇지 않은 경우 구성 관리자 시스템에
오류가 있는지 로컬 오류 로그를 확인하십시오.
Workbench에서 이벤트 로그 편집기를 새로 고치십시오.
이제
응답이 수신될 것입니다.
전개된 메시지 플로우 를 볼 수 없음
시나리오: 브로커 아카이브(BAR) 파일을 전개한 후 실행 그룹에서 전개된 메시지 플로우
를 볼 수 없습니다.
설명: 전개 후 구성 관리자에서 전개가 시작되었는지 여부가 정보 대화 상자에 표시됩니다. 전개가 시작된 후 완료하는 데 걸리는
시간은 구성 크기 및 컴퓨터에서의 작업 오버로드에 따라 다릅니다. 그러나 어느 정도의
시간이 경과한 후에도 이벤트 로그 편집기에 전개와 관련한 메시지가 표시되지 않으면
이는 브로커가 전개 요청에 응답하지 않았음을 의미합니다.
해결책: 브로커가 실행 중인지 및 구성 관리자와
브로커 사이의 모든 WebSphere MQ 큐 관리자와
채널이 실행 중인지 확인하십시오. 이벤트 로그 편집기에 메시지가 표시되면
변경사항이 활성화되지 않았음을 의미하는 오류가 발생했는지 확인하십시오.
도메인 네비게이터에 삭제한 브로커가 남아있음
시나리오: 브로커를 삭제하고 변경사항을 전개한 후에도
브로커가 도메인 네비게이터에 있습니다.
설명: 삭제에 실패했음을 알리는 실패 응답을 수신하지는 않았지만
이벤트 로그 편집기가 전개 결과에 관한 메시지 세트와 함께 자동으로 갱신 되었고 삭제가
완료되었으나 Workbench에 이 삭제가 알려지지 않았습니다.
해결책: 브로커 토폴로지가 실제 구성 관리자 컨텐츠를 반영하도록 하려면
브로커 토폴로지를 새로 고치십시오.
브로커 토폴로지가 열려 있으면
되돌리기를 누르십시오.